Hi folks, Here's take two of my proposed man page changes.
Among the revisions:
* Summarize commits in Bernhard Volker's style.
* Use a more portable method of protecting literals from hyphenation.
* Clarify and correct commit messages.
* Stop using 'x' column modifier in tables due to its unportability.
* Stop supplying man(7) macros more than six arguments, which is not
portable.
* Apply a highly permissive license (CC0) to these changes; see below.
$ git log --oneline --reverse origin..HEAD | nl
1 5bf00aa2 find.1: drop unportable tbl(1) 'x' modifier
2 f8126c7c doc: populate man pages' headers and footers more
3 cb93df25 find.1: fix typo in *roff syntax
4 5df574f2 doc: delete blank lines from man page sources
5 b5dc28c6 find.1: use AT&T troff-compatible syntax
6 28cec37d doc: use man(7) macros to style command synopses
7 0000bdc9 doc: improve typography of synopses
8 8e7bd222 doc: improve formatting of command synopses (1/2)
9 b8506556 doc: improve formatting of command synopses (2/2)
10 0eee756e locate.1: improve table formatting
11 c37b99bb find.1: quote multi-word `SH`, `SS` call arguments
12 5b4261e0 find.1: improve table formatting
13 f72ac61d find.1: access " character somewhat portably
14 821aecc2 find.1: access ' character portably
15 08ec667f find.1: access ` character portably
16 aa5c53a7 find.1: set quotation marks as such in roman
17 0acbdc24 find.1: use em dash for linguistic pausa
18 301ea4f5 doc: access en dash character portably
19 e8ace72d find.1: improve cosmetics of *roff logic
20 04226c02 find.1: access ~ character portably
21 e42ffc30 find.1: use new ~ string for pastable tilde
22 36ec4be8 find.1: access “ and ” portably
23 588df271 find.1: set file name literals in italics
24 a3d4e600 xargs.1: use portable typographer's quotes
25 894e3c99 locatedb.5: fix unescaped hyphens
26 be602389 locate.1: access ^ character portably
27 d0235d00 xargs.1: overcome limited portability of \~
28 50a037e9 xargs.1: access ' character portably
29 db397afb xargs.1: add styling to text
30 6558e552 xargs.1: fix truncated examples on old troff
31 d84314c6 xargs.1: set "findutils" in italics
32 9690f1c7 xargs.1: use quotation marks
33 5f4c4c37 xargs.1: set file names in italics
34 776f7489 xargs.1: use ellipses in synopsis
35 d5a15ddc xargs.1: fix font markup nit
36 1aadf4ae xargs.1: hyphenate attributive phrase
37 ce748bb2 xargs.1: clarify
38 f611b500 xargs.1: fix unescaped hyphens
39 7435f19a xargs.1: fix markup nit
40 13fe62c8 xargs.1: fix markup nit
41 3e2bbdaa xargs.1: fix markup nit
42 e3ef56e6 xargs.1: revise option formatting
I hereby license all of these patches under CC0 1.0 Universal.
https://creativecommons.org/publicdomain/zero/1.0/legalcode
Regards,
Branden
signature.asc
Description: PGP signature
