Recent changes (master)

[Jens Axboe <axboe@kernel.dk>]

The following changes since commit 01fd7497328f55622ec989a8edb015f2cccb94eb:

  Merge branch 'lintian-manpage-fixes' of https://github.com/hoexter/fio (2022-11-28 12:54:53 -0700)

are available in the Git repository at:

  git://git.kernel.dk/fio.git master

for you to fetch changes up to 967c5441fa3d3932ec50ea5623411cc6e8589463:

  docs: description for experimental_verify (2022-11-29 17:09:41 -0500)

----------------------------------------------------------------
Vincent Fu (2):
      docs: synchronize fio.1 and HOWTO changes
      docs: description for experimental_verify

 HOWTO.rst | 11 +++++++----
 fio.1     |  6 ++++--
 2 files changed, 11 insertions(+), 6 deletions(-)

---

Diff of recent changes:

diff --git a/HOWTO.rst b/HOWTO.rst
index 4419ee1b..2ea84558 100644
--- a/HOWTO.rst
+++ b/HOWTO.rst
@@ -1054,7 +1054,7 @@ Target file/device
 
 	When running a random write test across an entire drive many more
 	zones will be open than in a typical application workload. Hence this
-	command line option that allows to limit the number of open zones. The
+	command line option that allows one to limit the number of open zones. The
 	number of open zones is defined as the number of zones to which write
 	commands are issued.
 
@@ -1446,7 +1446,7 @@ I/O type
 	supplied as a value between 0 and 100.
 
 	The second, optional float is allowed for **pareto**, **zipf** and **normal** distributions.
-	It allows to set base of distribution in non-default place, giving more control
+	It allows one to set base of distribution in non-default place, giving more control
 	over most probable outcome. This value is in range [0-1] which maps linearly to
 	range of possible random values.
 	Defaults are: random for **pareto** and **zipf**, and 0.5 for **normal**.
@@ -3612,7 +3612,10 @@ Verification
 
 .. option:: experimental_verify=bool
 
-	Enable experimental verification.
+        Enable experimental verification. Standard verify records I/O metadata
+        for later use during the verification phase. Experimental verify
+        instead resets the file after the write phase and then replays I/Os for
+        the verification phase.
 
 Steady state
 ~~~~~~~~~~~~
@@ -4503,7 +4506,7 @@ Trace file format v2
 ~~~~~~~~~~~~~~~~~~~~
 
 The second version of the trace file format was added in fio version 1.17.  It
-allows to access more than one file per trace and has a bigger set of possible
+allows one to access more than one file per trace and has a bigger set of possible
 file actions.
 
 The first line of the trace file has to be::
diff --git a/fio.1 b/fio.1
index a28ec032..746c4472 100644
--- a/fio.1
+++ b/fio.1
@@ -3324,7 +3324,9 @@ Verify that trim/discarded blocks are returned as zeros.
 Trim this number of I/O blocks.
 .TP
 .BI experimental_verify \fR=\fPbool
-Enable experimental verification.
+Enable experimental verification. Standard verify records I/O metadata for
+later use during the verification phase. Experimental verify instead resets the
+file after the write phase and then replays I/Os for the verification phase.
 .SS "Steady state"
 .TP
 .BI steadystate \fR=\fPstr:float "\fR,\fP ss" \fR=\fPstr:float
@@ -4213,7 +4215,7 @@ This format is not supported in fio versions >= 1.20\-rc3.
 .TP
 .B Trace file format v2
 The second version of the trace file format was added in fio version 1.17. It
-allows one to access more then one file per trace and has a bigger set of possible
+allows one to access more than one file per trace and has a bigger set of possible
 file actions.
 .RS
 .P