Re: [PATCH 0/4] Sync fio(1) man page with HOWTO (remaining sections)

[Jens Axboe <axboe@kernel.dk>]

On 08/13/2017 01:18 PM, kusumi.tomohiro@gmail.com wrote:
> From: Tomohiro Kusumi <tkusumi@tuxera.com>
> 
> This is the continuation of below series of patches to sync the man page
> with HOWTO. It starts off from where it left off, which is job parameters
> section.
> 
> [PATCH 0/7] Sync fio(1) man page with HOWTO
> http://www.spinics.net/lists/fio/msg06008.html
> 
> These patches basically just sync the existing man page contents with
> HOWTO, and add/backport some minor fixes to HOWTO. They do not create
> any new contents that do not exist in either of the documents, while
> formats (e.g. indentations, directives, quotations, etc) are modified
> for some sections so that the entire man page has consistent style and
> resembles HOWTO.
> 
> The patch 1/4 covers the entire job parameters section which consists
> of huge amount of diffs. I didn't separate them into smaller patches
> (e.g. 1 patch for 1 job parameter category sub section), because the
> entire syncing includes huge amount of reordering plus modification
> within the entire file, as the job parameters in the existing man page
> were not categorized by the parameter types, and separating them into
> smaller patches doesn't make them any clear, but rather unclear.
> 
> Above applies to patch 2/4 as well which covers the rest of the HOWTO.
> 
> Also note that there are still sections in HOWTO that are not in the
> man page. For example, these patches add all the missing options and
> parameters, but do not cover details of writing the job files with
> examples of job files, as they have never been covered in the man page.
> They could be imported to the man page as well (depending on whether
> we want the man page to be identical to HOWTO), but I have separated
> the creation of new sections from syncing the existing ones with HOWTO.
> 
> The man page size (not ./fio.1 size) has increased by about 300+ lines,
> from around 1700 to 2000. Counting from prior to the previous series of
> the patches (i.e. since bdd88be^), it has increased by about 400 lines.

Are you resending this series with the issues fixed up?

-- 
Jens Axboe