4 Commits

Author	SHA1	Message	Date
Zdenek Kabelac	353718785f	man: typography ... With to use .TP where it's easy and doesn't change layout (since .HP is marked as deprecated) - but .TP is not always perfetc match. Avoid submitting empty lines to troff and replace them mostly with .P and use '.' at line start to preserve 'visual' presence of empty line while editing man page manually when there is no extra space needed. Fix some markup. Add some missing SEE ALSO section. Drop some white-space at end-of-lines. Improve hyphenation logic so we do not split options. Use '.IP numbers' only with first one the row (others in row automatically derive this value) Use automatic enumeration for .SH titles. Guidelines in-use: https://man7.org/linux/man-pages/man7/groff.7.html https://www.gnu.org/software/groff/manual/html_node/Man-usage.html https://www.gnu.org/software/groff/manual/html_node/Lists-in-ms.html	2021-04-14 11:04:04 +02:00
Heinz Mauelshagen	36cac41115	man-generator/man/help: simplify hyphen escaping ... Commits a29bb6a14b ... 5c199d99f4 narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers	2017-03-27 16:49:39 +02:00
Heinz Mauelshagen	5eec3de41f	man: escape all single '-'	2017-03-24 02:46:11 +01:00
Alasdair G Kergon	b0430b975b	man: Reinstate previous lvmsar and lvmsadc pages. ... Avoid listing all the common options for obsolete commands.	2017-03-16 01:49:40 +00:00