Package: man-db Version: 2.5.7-5 Severity: wishlist Tags: upstream patch Hi,
According to man(1), *bold text* is meant to be “type[d] exactly as shown”. Even if these “conventions apply to the SYNOPSIS section[, it] can be used as a guide in other sections”. So here is a patch against your current Bazaar repository, in order to respect this guideline for a few remaining comma (note that you already respected it in other parts of manual pages). Note that I volunteer to gracefully unfuzzy existing translation if you consider correcting this issue (even if it sounds like nip-ticking issue, I find it interesting that man-db applies this kind of advice for manual page writing, as an example of good practice). Regards David
=== modified file 'man/man1/apropos.man1' --- man/man1/apropos.man1 2008-09-18 01:01:42 +0000 +++ man/man1/apropos.man1 2010-10-12 14:50:30 +0000 @@ -60,13 +60,13 @@ may need to be run manually after new manual pages have been installed. .SH OPTIONS .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-v, \-\-verbose +.if !'po4a'hide' .B \-v\fP, \fB\-\-verbose Print verbose warning messages. .TP -.if !'po4a'hide' .B \-r, \-\-regex +.if !'po4a'hide' .B \-r\fP, \fB\-\-regex Interpret each keyword as a regular expression. This is the default behaviour. Each keyword will be matched against the page names and the descriptions @@ -74,7 +74,7 @@ It can match any part of either. The match is not limited to word boundaries. .TP -.if !'po4a'hide' .B \-w, \-\-wildcard +.if !'po4a'hide' .B \-w\fP, \fB\-\-wildcard Interpret each keyword as a pattern containing shell style wildcards. Each keyword will be matched against the page names and the descriptions independently. @@ -86,15 +86,15 @@ Otherwise the keyword is also allowed to match on word boundaries in the description. .TP -.if !'po4a'hide' .B \-e, \-\-exact +.if !'po4a'hide' .B \-e\fP, \fB\-\-exact Each keyword will be exactly matched against the page names and the descriptions. .TP -.if !'po4a'hide' .B \-a, \-\-and +.if !'po4a'hide' .B \-a\fP, \fB\-\-and Only display items that match all the supplied keywords. The default is to display items that match any keyword. .TP -.if !'po4a'hide' .B \-l, \-\-long +.if !'po4a'hide' .B \-l\fP, \fB\-\-long Do not trim output to the terminal width. Normally, output will be truncated to the terminal width to avoid ugly results from poorly-written @@ -121,7 +121,7 @@ .PP .B \-m .I system\c -.RB \|[\|,.\|.\|.\|]\| , +.RB \|[\|,.\|.\|.\|]\|, .BI \-\-systems= system\c \|[\|,.\|.\|.\|] .RS @@ -144,7 +144,7 @@ environment variable. .RE .TP -.BI \-M\ path ,\ \-\-manpath= path +.BI \-M\ path \fR,\fB\ \-\-manpath= path Specify an alternate set of colon-delimited manual page hierarchies to search. By default, @@ -158,7 +158,7 @@ This option overrides the contents of .RB $ MANPATH . .TP -.BI \-L\ locale ,\ \-\-locale= locale +.BI \-L\ locale \fR,\fB\ \-\-locale= locale .B %program% will normally determine your current locale by a call to the C function .BR setlocale (3) @@ -175,14 +175,14 @@ Output such as the help message will always be displayed in the initially determined locale. .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "EXIT STATUS" .TP === modified file 'man/man1/lexgrog.man1' --- man/man1/lexgrog.man1 2008-05-25 17:30:18 +0000 +++ man/man1/lexgrog.man1 2010-10-12 14:53:53 +0000 @@ -44,7 +44,7 @@ file is compressed, a decompressed version will be read automatically. .SH OPTIONS .TP -.if !'po4a'hide' .B \-m, \-\-man +.if !'po4a'hide' .B \-m\fP, \fB\-\-man Parse input as man page source files. This is the default if neither .B \-\-man @@ -52,14 +52,14 @@ .B \-\-cat is given. .TP -.if !'po4a'hide' .B \-c, \-\-cat +.if !'po4a'hide' .B \-c\fP, \fB\-\-cat Parse input as preformatted man pages (\(lqcat pages\(rq). .B \-\-man and .B \-\-cat may not be given simultaneously. .TP -.if !'po4a'hide' .B \-w, \-\-whatis +.if !'po4a'hide' .B \-w\fP, \fB\-\-whatis Display the name and description from the man page's header, as used by .B apropos and @@ -70,7 +70,7 @@ .B \-\-filters is given. .TP -.if !'po4a'hide' .B \-f, \-\-filters +.if !'po4a'hide' .B \-f\fP, \fB\-\-filters Display the list of filters needed to preprocess the man page before formatting with .B nroff @@ -81,10 +81,10 @@ Override the guessed character set for the page to .IR encoding . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "EXIT STATUS" .TP === modified file 'man/man1/man.man1' --- man/man1/man.man1 2010-03-21 22:05:16 +0000 +++ man/man1/man.man1 2010-10-12 15:00:44 +0000 @@ -522,14 +522,14 @@ previous argument value. .SS "General options" .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-D, \-\-default +.if !'po4a'hide' .B \-D\fP, \fB\-\-default This option is normally issued as the very first option and resets .B %man%'s behaviour to its default. @@ -552,14 +552,14 @@ for a list of available warning names. .SS "Main modes of operation" .TP -.if !'po4a'hide' .B \-f, \-\-whatis +.if !'po4a'hide' .B \-f\fP, \fB\-\-whatis Equivalent to .BR %whatis% . Display a short description from the manual page, if available. See .BR %whatis% (1) for details. .TP -.if !'po4a'hide' .B \-k, \-\-apropos +.if !'po4a'hide' .B \-k\fP, \fB\-\-apropos Equivalent to .BR %apropos% . Search the short manual page descriptions for keywords and display any @@ -568,7 +568,7 @@ .BR %apropos% (1) for details. .TP -.if !'po4a'hide' .B \-K, \-\-global\-apropos +.if !'po4a'hide' .B \-K\fP, \fB\-\-global\-apropos Search for text in all manual pages. This is a brute-force search, and is likely to take some time; if you can, you should specify a section to reduce the number of pages that need to be @@ -578,7 +578,7 @@ .B \-\-regex option is used. .TP -.if !'po4a'hide' .B \-l, \-\-local\-file +.if !'po4a'hide' .B \-l\fP, \fB\-\-local\-file Activate `local' mode. Format and display local manual files instead of searching through the system's manual collection. @@ -594,16 +594,16 @@ option was supplied, using the name as a filename and looking for an exact match. .TP -.if !'po4a'hide' .B \-w, \-\-where, \-\-location +.if !'po4a'hide' .B \-w\fP, \fB\-\-where\fP, \fB\-\-location Don't actually display the manual pages, but do print the location(s) of the source nroff files that would be formatted. .TP -.if !'po4a'hide' .B \-W, \-\-where\-cat, \-\-location\-cat +.if !'po4a'hide' .B \-W\fP, \fB\-\-where\-cat\fP, \fB\-\-location\-cat Don't actually display the manual pages, but do print the location(s) of the cat files that would be displayed. If \-w and \-W are both specified, print both separated by a space. .TP -.if !'po4a'hide' .B \-c, \-\-catman +.if !'po4a'hide' .B \-c\fP, \fB\-\-catman This option is not for general use and should only be used by the .B %catman% program. @@ -621,7 +621,7 @@ hierarchy. .SS "Finding manual pages" .TP -.BI \-L\ locale ,\ \-\-locale= locale +.BI \-L\ locale \fR,\fB\ \-\-locale= locale .B %program% will normally determine your current locale by a call to the C function .BR setlocale (3) @@ -670,7 +670,7 @@ environment variable. .RE .TP -.BI \-M\ path ,\ \-\-manpath= path +.BI \-M\ path \fR,\fB\ \-\-manpath= path Specify an alternate manpath to use. By default, .B %man% @@ -690,7 +690,7 @@ .B \-l option. .TP -.BI \-S\ list ,\ \-s\ list ,\ \-\-sections= list +.BI \-S\ list \fR,\fB\ \-s\ list \fR,\fB\ \-\-sections= list List is a colon- or comma-separated list of `order specific' manual sections to search. This option overrides the @@ -700,7 +700,7 @@ .B \-s spelling is for compatibility with System V.) .TP -.BI \-e\ sub-extension ,\ \-\-extension= sub-extension +.BI \-e\ sub-extension \fR,\fB\ \-\-extension= sub-extension Some systems incorporate large packages of manual pages, such as those that accompany the .B Tcl @@ -734,11 +734,11 @@ will restrict the search to pages having an extension of .BR *tcl . .TP -.if !'po4a'hide' .B \-i, \-\-ignore\-case +.if !'po4a'hide' .B \-i\fP, \fB\-\-ignore\-case Ignore case when searching for manual pages. This is the default. .TP -.if !'po4a'hide' .B \-I, \-\-match\-case +.if !'po4a'hide' .B \-I\fP, \fB\-\-match\-case Search for manual pages case-sensitively. .TP .if !'po4a'hide' .B \-\-regex @@ -775,7 +775,7 @@ .BR whatis (1). Otherwise, no effect. .TP -.if !'po4a'hide' .B \-a, \-\-all +.if !'po4a'hide' .B \-a\fP, \fB\-\-all By default, .B %man% will exit after displaying the most suitable manual page it finds. @@ -783,7 +783,7 @@ .B %man% to display all the manual pages with names that match the search criteria. .TP -.if !'po4a'hide' .B \-u, \-\-update +.if !'po4a'hide' .B \-u\fP, \fB\-\-update This option causes .B %man% to perform an `inode level' consistency check on its database caches to @@ -821,7 +821,7 @@ .fi .SS "Controlling formatted output" .TP -.BI \-P\ pager ,\ \-\-pager= pager +.BI \-P\ pager \fR,\fB\ \-\-pager= pager Specify which output pager to use. By default, .B %man% @@ -843,7 +843,7 @@ wrapper script, which may take the file to display either as an argument or on standard input. .TP -.BI \-r\ prompt ,\ \-\-prompt= prompt +.BI \-r\ prompt \fR,\fB\ \-\-prompt= prompt If a recent version of .B less is used as the pager, @@ -908,7 +908,7 @@ .RB $ MANLESS environment variable described below. .TP -.if !'po4a'hide' .B \-7, \-\-ascii +.if !'po4a'hide' .B \-7\fP, \fB\-\-ascii When viewing a pure .IR ascii (7) manual page on a 7 bit terminal or terminal emulator, some characters may @@ -1022,7 +1022,7 @@ documentation instead; for instance, you can use the ".na", ".nf", ".fi", and ".ad" requests to temporarily disable adjusting and filling. .TP -.BI \-p\ string ,\ \-\-preprocessor= string +.BI \-p\ string \fR,\fB\ \-\-preprocessor= string Specify the sequence of preprocessors to run before .B nroff or @@ -1041,7 +1041,7 @@ .B %zsoelim% is always run as the very first preprocessor. .TP -.if !'po4a'hide' .B \-t, \-\-troff +.if !'po4a'hide' .B \-t\fP, \fB\-\-troff Use .I %troff% to format the manual page to stdout. @@ -1093,7 +1093,7 @@ .B \-T with the X75, X75-12, X100, or X100-12 device respectively. .TP -.if !'po4a'hide' .B \-Z, \-\-ditroff +.if !'po4a'hide' .B \-Z\fP, \fB\-\-ditroff .B groff will run .B troff @@ -1110,10 +1110,10 @@ .BR \-t . .SS "Getting help" .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "EXIT STATUS" .TP === modified file 'man/man1/manconv.man1' --- man/man1/manconv.man1 2008-05-29 23:40:00 +0000 +++ man/man1/manconv.man1 2010-10-12 14:55:21 +0000 @@ -58,16 +58,16 @@ Convert the manual page to .IR encoding . .TP -.if !'po4a'hide' .B \-q, \-\-quiet +.if !'po4a'hide' .B \-q\fP, \fB\-\-quiet Do not issue error messages when the page cannot be converted. .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "SEE ALSO" .if !'po4a'hide' .IR man (1), === modified file 'man/man1/manpath.man1' --- man/man1/manpath.man1 2008-09-18 01:01:42 +0000 +++ man/man1/manpath.man1 2010-10-12 15:04:28 +0000 @@ -36,18 +36,18 @@ and the user's environment. .SH OPTIONS .TP -.if !'po4a'hide' .B \-q, \-\-quiet +.if !'po4a'hide' .B \-q\fP, \fB\-\-quiet Do not issue warnings. .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-c, \-\-catpath +.if !'po4a'hide' .B \-c\fP, \fB\-\-catpath Produce a catpath as opposed to a manpath. Once the manpath is determined, each path element is converted to its relative catpath. .TP -.if !'po4a'hide' .B \-g, \-\-global +.if !'po4a'hide' .B \-g\fP, \fB\-\-global Produce a manpath consisting of all paths named as `global' within the man-db configuration file. .\" @@ -60,7 +60,7 @@ .PP .B \-m .I system\c -.RB \|[\|,.\|.\|.\|]\| , +.RB \|[\|,.\|.\|.\|]\|, .BI \-\-systems= system\c \|[\|,.\|.\|.\|] .RS @@ -83,14 +83,14 @@ environment variable. .RE .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH ENVIRONMENT .TP === modified file 'man/man1/whatis.man1' --- man/man1/whatis.man1 2008-09-18 01:01:42 +0000 +++ man/man1/whatis.man1 2010-10-12 15:06:43 +0000 @@ -70,13 +70,13 @@ .IR /usr/man . .SH OPTIONS .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-v, \-\-verbose +.if !'po4a'hide' .B \-v\fP, \fB\-\-verbose Print verbose warning messages. .TP -.if !'po4a'hide' .B \-r, \-\-regex +.if !'po4a'hide' .B \-r\fP, \fB\-\-regex Interpret each .I name as a regular expression. @@ -87,7 +87,7 @@ .B %whatis% to be somewhat slower due to the nature of database searches. .TP -.if !'po4a'hide' .B \-w, \-\-wildcard +.if !'po4a'hide' .B \-w\fP, \fB\-\-wildcard Interpret each .I name as a pattern containing shell style wildcards. @@ -98,7 +98,7 @@ .B %whatis% to be somewhat slower due to the nature of database searches. .TP -.if !'po4a'hide' .B \-l, \-\-long +.if !'po4a'hide' .B \-l\fP, \fB\-\-long Do not trim output to the terminal width. Normally, output will be truncated to the terminal width to avoid ugly results from poorly-written @@ -125,7 +125,7 @@ .PP .B \-m .I system\c -.RB \|[\|,.\|.\|.\|]\| , +.RB \|[\|,.\|.\|.\|]\|, .BI \-\-systems= system\c \|[\|,.\|.\|.\|] .RS @@ -148,7 +148,7 @@ environment variable. .RE .TP -.BI \-M\ path ,\ \-\-manpath= path +.BI \-M\ path \fR,\fB\ \-\-manpath= path Specify an alternate set of colon-delimited manual page hierarchies to search. By default, @@ -162,7 +162,7 @@ This option overrides the contents of .RB $ MANPATH . .TP -.BI \-L\ locale ,\ \-\-locale= locale +.BI \-L\ locale \fR,\fB\ \-\-locale= locale .B %program% will normally determine your current locale by a call to the C function .BR setlocale (3) @@ -179,14 +179,14 @@ Output such as the help message will always be displayed in the initially determined locale. .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "EXIT STATUS" .TP === modified file 'man/man1/zsoelim.man1' --- man/man1/zsoelim.man1 2008-09-18 00:48:32 +0000 +++ man/man1/zsoelim.man1 2010-10-12 15:07:46 +0000 @@ -54,7 +54,7 @@ support for compressed manual pages. .SH OPTIONS .TP -.if !'po4a'hide' .B \-C, \-\-compatible +.if !'po4a'hide' .B \-C\fP, \fB\-\-compatible This flag is available for compatibility with other .B soelim programs. @@ -62,10 +62,10 @@ whitespace. As this is already the default behaviour, it is ignored. .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH "SEE ALSO" .if !'po4a'hide' .BR nroff (1), === modified file 'man/man8/accessdb.man8' --- man/man8/accessdb.man8 2008-01-07 11:14:26 +0000 +++ man/man8/accessdb.man8 2010-10-12 15:09:35 +0000 @@ -42,10 +42,10 @@ .fi .SH OPTIONS .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH AUTHOR .nf === modified file 'man/man8/catman.man8' --- man/man8/catman.man8 2008-09-18 01:01:42 +0000 +++ man/man8/catman.man8 2010-10-12 15:11:10 +0000 @@ -54,22 +54,22 @@ need to be formatted. .SH OPTIONS .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.BI \-M\ path ,\ \-\-manpath= path +.BI \-M\ path \fR,\fB\ \-\-manpath= path Specify an alternate colon-delimited manual page hierarchy search path. By default, this is all paths indicated as system hierarchies in the man-db configuration file. .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Print a help message and exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Display version information. .SH ENVIRONMENT .TP === modified file 'man/man8/mandb.man8' --- man/man8/mandb.man8 2008-12-05 22:28:03 +0000 +++ man/man8/mandb.man8 2010-10-12 15:14:11 +0000 @@ -74,21 +74,21 @@ option to re-create the databases from scratch. .SH OPTIONS .TP -.if !'po4a'hide' .B \-d, \-\-debug +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug Print debugging information. .TP -.if !'po4a'hide' .B \-q, \-\-quiet +.if !'po4a'hide' .B \-q\fP, \fB\-\-quiet Produce no warnings. .TP -.if !'po4a'hide' .B \-s, \-\-no-straycats +.if !'po4a'hide' .B \-s\fP, \fB\-\-no-straycats Do not spend time looking for or adding information to the databases regarding stray cats. .TP -.if !'po4a'hide' .B \-p, \-\-no-purge +.if !'po4a'hide' .B \-p\fP, \fB\-\-no-purge Do not spend time checking for deleted manual pages and purging them from the databases. .TP -.if !'po4a'hide' .B \-c, \-\-create +.if !'po4a'hide' .B \-c\fP, \fB\-\-create By default, .B %mandb% will try to update any previously created databases. @@ -100,17 +100,17 @@ This may be necessary if a database becomes corrupt or if a new database storage scheme is introduced in the future. .TP -.if !'po4a'hide' .B \-u, \-\-user-db +.if !'po4a'hide' .B \-u\fP, \fB\-\-user-db Create user databases only, even with write permissions necessary to create system databases. .TP -.if !'po4a'hide' .B \-t, \-\-test +.if !'po4a'hide' .B \-t\fP, \fB\-\-test Perform correctness checks on manual pages in the hierarchy search path. With this option, .B %mandb% will not alter existing databases. .TP -.if !'po4a'hide' .B \-f, \-\-filename +.if !'po4a'hide' .B \-f\fP, \fB\-\-filename Update only the entries for the given filename. This option is not for general use; it is used internally by .B %man% @@ -124,14 +124,14 @@ and .BR \-s . .TP -.BI \-C\ file ,\ \-\-config\-file= file +.BI \-C\ file \fR,\fB\ \-\-config\-file= file Use this user configuration file rather than the default of .IR ~/.manpath . .TP -.if !'po4a'hide' .B \-h, \-\-help +.if !'po4a'hide' .B \-h\fP, \fB\-\-help Show the usage message, then exit. .TP -.if !'po4a'hide' .B \-V, \-\-version +.if !'po4a'hide' .B \-V\fP, \fB\-\-version Show the version, then exit. .SH "EXIT STATUS" .TP
signature.asc
Description: OpenPGP digital signature
