On 08/13/2017 01:18 PM, kusumi.tomohiro@xxxxxxxxx wrote: > From: Tomohiro Kusumi <tkusumi@xxxxxxxxxx> > > 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 -- To unsubscribe from this list: send the line "unsubscribe fio" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
