diff options
Diffstat (limited to 'man/man1/man.man1')
-rw-r--r-- | man/man1/man.man1 | 29 |
1 files changed, 20 insertions, 9 deletions
diff --git a/man/man1/man.man1 b/man/man1/man.man1 index 6319d5b5..38251f41 100644 --- a/man/man1/man.man1 +++ b/man/man1/man.man1 @@ -139,7 +139,7 @@ Conventional section names include .BR ENVIRONMENT , .BR FILES , .BR VERSIONS , -.BR CONFORMING\ TO , +.BR STANDARDS , .BR NOTES , .BR BUGS , .BR EXAMPLE , @@ -413,7 +413,7 @@ previous argument value. .TP .BI \-C\ file \fR,\ \fB\-\-config\-file= file Use this user configuration file rather than the default of -.IR ~/.manpath . +.IR \(ti/.manpath . .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Print debugging information. @@ -436,13 +436,19 @@ pages. .I warnings is a comma-separated list of warning names; if it is not supplied, the default is "mac". +To disable a +.I groff +warning, prefix it with "!": for example, +.B \-\-warnings=mac,!break +enables warnings in the "mac" category and disables warnings in the "break" +category. See the \(lqWarnings\(rq node in .B info groff for a list of available warning names. .SS "Main modes of operation" .TP .if !'po4a'hide' .BR \-f ", " \-\-whatis -Equivalent to +Approximately equivalent to .BR %whatis% . Display a short description from the manual page, if available. See @@ -450,7 +456,7 @@ See for details. .TP .if !'po4a'hide' .BR \-k ", " \-\-apropos -Equivalent to +Approximately equivalent to .BR %apropos% . Search the short manual page descriptions for keywords and display any matches. @@ -471,7 +477,8 @@ option is used. Note that this searches the .I sources of the manual pages, not the rendered text, and so may include false -positives due to things like comments in source files. +positives due to things like comments in source files, or false negatives +due to things like hyphens being written as "\e-" in source files. Searching the rendered text would be much slower. .TP .if !'po4a'hide' .BR \-l ", " \-\-local\-file @@ -485,10 +492,12 @@ correct format. .\" usual filters. No cat file is produced. If '\-' is listed as one of the arguments, input will be taken from stdin. -When this option is not used, and man fails to find the page required, -before displaying the error message, it attempts to act as if this -option was supplied, using the name as a filename and looking for an -exact match. +.IP +If this option is not used, then +.B %man% +will also fall back to interpreting manual page arguments as local file +names if the argument contains a "/" character, since that is a good +indication that the argument refers to a path on the file system. .TP .if !'po4a'hide' .BR \-w ", " \-\-where ", " \-\-path ", " \-\-location Don't actually display the manual page, but do print the location of the @@ -1264,6 +1273,8 @@ man-db configuration file. .TP .if !'po4a'hide' .I /usr/share/man A global manual page hierarchy. +.SH STANDARDS +POSIX.1\-2001, POSIX.1\-2008, POSIX.1\-2017. .SH "SEE ALSO" .if !'po4a'hide' .BR %apropos% (1), .if !'po4a'hide' .BR groff (1), |