diff options
author | Alejandro Colomar <alx@kernel.org> | 2023-10-25 17:03:25 +0200 |
---|---|---|
committer | Alejandro Colomar <alx@kernel.org> | 2023-10-25 17:03:27 +0200 |
commit | 5a3a191d6b977a789206cad30c6411a2e583751e (patch) | |
tree | 5890bd3093f7279da66addca7b905231e3ff4ed3 /man1 | |
parent | cdbfb8b4bfcde800640ff49db63920bb471919ae (diff) |
man*/: ffix (Place short options after long options)
This increases the chances that the paragraph will start in the same
line as the tag, wasting less vertical space.
The result seems visually better to me.
On Wed, Oct 25, 2023 at 09:11:03AM -0500, G. Branden Robinson wrote:
> I also like your suggestion that if we really want to economize on
> space, we could present a command's long option form before its short,
> old-style Unix synonym, which will work well when the short option (plus
> its argument, if any) fits within the space for the paragraph tag. This
> might be a good idea for another reason; in GNU user space, the long
> option is the much more self-documenting form, and the single-character
> option name a kind of "expert mode" alternative. As a general rule,
> when presenting technical material, one should not lead with "expert
> mode".
Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man1')
-rw-r--r-- | man1/getent.1 | 20 | ||||
-rw-r--r-- | man1/iconv.1 | 28 | ||||
-rw-r--r-- | man1/ldd.1 | 16 | ||||
-rw-r--r-- | man1/locale.1 | 28 | ||||
-rw-r--r-- | man1/localedef.1 | 16 | ||||
-rw-r--r-- | man1/pldd.1 | 8 | ||||
-rw-r--r-- | man1/sprof.1 | 20 |
7 files changed, 68 insertions, 68 deletions
diff --git a/man1/getent.1 b/man1/getent.1 index 4fcc27abf..6a599c676 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -325,41 +325,41 @@ in succession to and display the result. .SH OPTIONS .TP -.BI \-s\~ service -.TQ .BI \-\-service\~ service +.TQ +.BI \-s\~ service .\" commit 9d0881aa76b399e6a025c5cf44bebe2ae0efa8af (glibc) Override all databases with the specified service. (Since glibc 2.2.5.) .TP -.BI \-s\~ database : service -.TQ .BI \-\-service\~ database : service +.TQ +.BI \-s\~ database : service .\" commit b4f6f4be85d32b9c03361c38376e36f08100e3e8 (glibc) Override only specified databases with the specified service. The option may be used multiple times, but only the last service for each database will be used. (Since glibc 2.4.) .TP -.B \-i -.TQ .B \-\-no\-idn +.TQ +.B \-i .\" commit a160f8d808cf8020b13bd0ef4a9eaf3c11f964ad (glibc) Disables IDN encoding in lookups for .BR ahosts / getaddrinfo (3) (Since glibc-2.13.) .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Print a usage summary and exit. .TP .B \-\-usage Print a short usage summary and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Print the version number, license, and disclaimer of warranty for .BR getent . .SH EXIT STATUS diff --git a/man1/iconv.1 b/man1/iconv.1 index 3319c1c03..14ee488b1 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -34,16 +34,16 @@ from the current locale's character encoding. .SH OPTIONS .TP -.BI \-f\~ from-encoding -.TQ .BI \-\-from\-code= from-encoding +.TQ +.BI \-f\~ from-encoding Use .I from-encoding for input characters. .TP -.BI \-t\~ to-encoding -.TQ .BI \-\-to\-code= to-encoding +.TQ +.BI \-t\~ to-encoding Use .I to-encoding for output characters. @@ -66,42 +66,42 @@ looking characters. Characters that are outside of the target character set and cannot be transliterated are replaced with a question mark (?) in the output. .TP -.B \-l -.TQ .B \-\-list +.TQ +.B \-l List all known character set encodings. .TP .B \-c Silently discard characters that cannot be converted instead of terminating when encountering such characters. .TP -.BI \-o\~ outputfile -.TQ .BI \-\-output= outputfile +.TQ +.BI \-o\~ outputfile Use .I outputfile for output. .TP -.B \-s -.TQ .B \-\-silent +.TQ +.B \-s This option is ignored; it is provided only for compatibility. .TP .B \-\-verbose Print progress information on standard error when processing multiple files. .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Print a usage summary and exit. .TP .B \-\-usage Print a short usage summary and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Print the version number, license, and disclaimer of warranty for .BR iconv . .SH EXIT STATUS diff --git a/man1/ldd.1 b/man1/ldd.1 index 1e115b9d7..87a2c9d34 100644 --- a/man1/ldd.1 +++ b/man1/ldd.1 @@ -114,26 +114,26 @@ shows the entire dependency tree of the executable. Print the version number of .BR ldd . .TP -.B \-v -.TQ .B \-\-verbose +.TQ +.B \-v Print all information, including, for example, symbol versioning information. .TP -.B \-u -.TQ .B \-\-unused +.TQ +.B \-u Print unused direct dependencies. (Since glibc 2.3.4.) .TP -.B \-d -.TQ .B \-\-data\-relocs +.TQ +.B \-d Perform relocations and report any missing objects (ELF only). .TP -.B \-r -.TQ .B \-\-function\-relocs +.TQ +.B \-r Perform relocations for both data objects and functions, and report any missing objects or functions (ELF only). .TP diff --git a/man1/locale.1 b/man1/locale.1 index db85098b1..2579dd19f 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -35,9 +35,9 @@ or the option (or one of their long-format equivalents) is specified, the behavior is as follows: .TP -.B \-a -.TQ .B \-\-all\-locales +.TQ +.B \-a Display a list of all available locales. The .B \-v @@ -45,9 +45,9 @@ option causes the .B LC_IDENTIFICATION metadata about each locale to be included in the output. .TP -.B \-m -.TQ .B \-\-charmaps +.TQ +.B \-m Display the available charmaps (character set description files). To display the current character set for the locale, use \fBlocale \-c charmap\fR. @@ -74,9 +74,9 @@ the values of all keywords in that category are displayed. .PP When arguments are supplied, the following options are meaningful: .TP -.B \-c -.TQ .B \-\-category\-name +.TQ +.B \-c For a category name argument, write the name of the locale category on a separate line preceding the list of keyword values for that category. @@ -90,9 +90,9 @@ It can be combined with the .B \-k option. .TP -.B \-k -.TQ .B \-\-keyword\-name +.TQ +.B \-k For each keyword whose value is being displayed, include also the name of that keyword, so that the output has the format: @@ -107,23 +107,23 @@ The .B locale command also knows about the following options: .TP -.B \-v -.TQ .B \-\-verbose +.TQ +.B \-v Display additional information for some command-line option and argument combinations. .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Display a summary of command-line options and arguments and exit. .TP .B \-\-usage Display a short usage message and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Display the program version and exit. .SH FILES .TP diff --git a/man1/localedef.1 b/man1/localedef.1 index c59a9c8c5..34f04fcff 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -206,15 +206,15 @@ Use to look up aliases for locale names. There is no default aliases file. .TP -.B \-c -.TQ .B \-\-force +.TQ +.B \-c Write the output files even if warnings were generated about the input file. .TP -.B \-v -.TQ .B \-\-verbose +.TQ +.B \-v Generate extra warnings about errors that are normally ignored. .TP .B \-\-big\-endian @@ -278,9 +278,9 @@ Supported warnings are and .IR intcurrsym . .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Print a usage summary and exit. Also prints the default paths used by .BR localedef . @@ -288,9 +288,9 @@ Also prints the default paths used by .B \-\-usage Print a short usage summary and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Print the version number, license, and disclaimer of warranty for diff --git a/man1/pldd.1 b/man1/pldd.1 index 3a7c02b92..eb5e91bb3 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -19,17 +19,17 @@ The list includes the libraries that have been dynamically loaded using .BR dlopen (3). .SH OPTIONS .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Display a help message and exit. .TP .B \-\-usage Display a short usage message and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Display program version information and exit. .SH EXIT STATUS On success, diff --git a/man1/sprof.1 b/man1/sprof.1 index 1f99bc932..b86735443 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -27,22 +27,22 @@ in the current directory. The following command-line options specify the profile output to be produced: .TP -.B \-c -.TQ .B \-\-call\-pairs +.TQ +.B \-c Print a list of pairs of call paths for the interfaces exported by the shared object, along with the number of times each path is used. .TP -.B \-p -.TQ .B \-\-flat\-profile +.TQ +.B \-p Generate a flat profile of all of the functions in the monitored object, with counts and ticks. .TP -.B \-q -.TQ .B \-\-graph +.TQ +.B \-q Generate a call graph. .PP If none of the above options is specified, @@ -50,17 +50,17 @@ then the default behavior is to display a flat profile and a call graph. .PP The following additional command-line options are available: .TP -.B \-? -.TQ .B \-\-help +.TQ +.B \-? Display a summary of command-line options and arguments and exit. .TP .B \-\-usage Display a short usage message and exit. .TP -.B \-V -.TQ .B \-\-version +.TQ +.B \-V Display the program version and exit. .SH STANDARDS GNU. |