diff options
Diffstat (limited to 'man/man1/apropos.man1')
| -rw-r--r-- | man/man1/apropos.man1 | 267 |
1 files changed, 267 insertions, 0 deletions
diff --git a/man/man1/apropos.man1 b/man/man1/apropos.man1 new file mode 100644 index 0000000..43c3b3d --- /dev/null +++ b/man/man1/apropos.man1 @@ -0,0 +1,267 @@ +.\" Man page for %apropos% +.\" +.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) +.\" +.\" You may distribute under the terms of the GNU General Public +.\" License as specified in the file COPYING that comes with the +.\" man-db distribution. +.\" +.\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) +.\" +.pc +.TH %thapropos% 1 "%date%" "%version%" "Manual pager utils" +.SH NAME +%apropos% \- search the manual page names and descriptions +.SH SYNOPSIS +.B %apropos% +.RB [\| \-dalv?V \|] +.RB [\| \-e \||\| \-w \||\| \-r\c +\|] +.RB [\| \-s +.IR list \|] +.RB [\| \-m +.IR system \|[\|,.\|.\|.\|]\|] +.RB [\| \-M +.IR path \|] +.RB [\| \-L +.IR locale \|] +.RB [\| \-C +.IR file \|] +.I keyword +\&.\|.\|. +.SH DESCRIPTION +Each manual page has a short description available within it. +.B %apropos% +searches the descriptions for instances of +.IR keyword . + +.I keyword +is usually a regular expression, as if +.RB ( \-r ) +was used, or +may contain wildcards +.RB ( \-w ), +or match the exact keyword +.RB ( \-e ). +Using these options, it may be necessary to quote the +.I keyword +or escape (\\) the special characters to stop the shell from interpreting +them. + +The standard matching rules allow matches to be made against the page name +and word boundaries in the description. + +The database searched by +.B %apropos% +is updated by the +.B %mandb% +program. +Depending on your installation, this may be run by a periodic cron job, or +may need to be run manually after new manual pages have been installed. +.SH OPTIONS +.TP +.if !'po4a'hide' .BR \-d ", " \-\-debug +Print debugging information. +.TP +.if !'po4a'hide' .BR \-v ", " \-\-verbose +Print verbose warning messages. +.TP +.if !'po4a'hide' .BR \-r ", " \-\-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 +independently. +It can match any part of either. +The match is not limited to word boundaries. +.TP +.if !'po4a'hide' .BR \-w ", " \-\-wildcard +Interpret each keyword as a pattern containing shell style wildcards. +Each keyword will be matched against the page names and the descriptions +independently. +If +.B \-\-exact +is also used, +a match will only be found if an expanded keyword matches an entire +description or page name. +Otherwise the keyword is also allowed to match on word boundaries in the +description. +.TP +.if !'po4a'hide' .BR \-e ", " \-\-exact +Each keyword will be exactly matched against the page names and the +descriptions. +.TP +.if !'po4a'hide' .BR \-a ", " \-\-and +Only display items that match all the supplied keywords. +The default is to display items that match any keyword. +.TP +.if !'po4a'hide' .BR \-l ", " \-\-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 +.B NAME +sections. +.TP +\fB\-s\fP \fIlist\fP, \fB\-\-sections\fP \fIlist\fP, \fB\-\-section\fP \fIlist\fP +Search only the given manual sections. +.I list +is a colon- or comma-separated list of sections. +If an entry in +.I list +is a simple section, for example "3", then the displayed list of +descriptions will include pages in sections "3", "3perl", "3x", and so on; +while if an entry in +.I list +has an extension, for example "3perl", then the list will only include +pages in that exact part of the manual section. +.\" +.\" Due to the rather silly limit of 6 args per request in some `native' +.\" *roff compilers, we have do the following to get the two-line +.\" hanging tag on one line. .PP to begin a new paragraph, then the +.\" tag, then .RS (start relative indent), the text, finally .RE +.\" (end relative indent). +.\" +.PP +.B \-m +.I system\c +\|[\|,.\|.\|.\|]\|, +.BI \-\-systems= system\c +\|[\|,.\|.\|.\|] +.RS +If this system has access to other operating system's manual page +descriptions, they can be searched using this option. +To search NewOS's manual page descriptions, use the option +.B \-m +.BR NewOS . + +The +.I system +specified can be a combination of comma-delimited operating system names. +To include a search of the native operating system's +.B whatis +descriptions, include the system name +.B man +in the argument string. +This option will override the +.RB $ SYSTEM +environment variable. +.RE +.TP +.BI \-M\ path \fR,\ \fB\-\-manpath= path +Specify an alternate set of colon-delimited manual page hierarchies to +search. +By default, +.B %program% +uses the +.RB $ MANPATH +environment variable, unless it is empty or unset, in which case it will +determine an appropriate manpath based on your +.RB $ PATH +environment variable. +This option overrides the contents of +.RB $ MANPATH . +.TP +.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) +which interrogates various environment variables, possibly including +.RB $ LC_MESSAGES +and +.RB $ LANG . +To temporarily override the determined value, use this option to supply a +.I locale +string directly to +.BR %program% . +Note that it will not take effect until the search for pages actually +begins. +Output such as the help message will always be displayed in the initially +determined locale. +.TP +.BI \-C\ file \fR,\ \fB\-\-config\-file= file +Use this user configuration file rather than the default of +.IR ~/.manpath . +.TP +.if !'po4a'hide' .BR \-? ", " \-\-help +Print a help message and exit. +.TP +.if !'po4a'hide' .BR \-\-usage +Print a short usage message and exit. +.TP +.if !'po4a'hide' .BR \-V ", " \-\-version +Display version information. +.SH "EXIT STATUS" +.TP +.if !'po4a'hide' .B 0 +Successful program execution. +.TP +.if !'po4a'hide' .B 1 +Usage, syntax or configuration file error. +.TP +.if !'po4a'hide' .B 2 +Operational error. +.TP +.if !'po4a'hide' .B 16 +Nothing was found that matched the criteria specified. +.SH ENVIRONMENT +.TP +.if !'po4a'hide' .B SYSTEM +If +.RB $ SYSTEM +is set, it will have the same effect as if it had been specified as the +argument to the +.B \-m +option. +.TP +.if !'po4a'hide' .B MANPATH +If +.RB $ MANPATH +is set, its value is interpreted as the colon-delimited manual page +hierarchy search path to use. +.TP +.if !'po4a'hide' .B MANWIDTH +If +.RB $ MANWIDTH +is set, its value is used as the terminal width (see the +.B \-\-long +option). +If it is not set, the terminal width will be calculated using the value of +.RB $ COLUMNS , +an +.BR ioctl (2) +if available, or falling back to 80 characters if all else fails. +.TP +.if !'po4a'hide' .B POSIXLY_CORRECT +If +.RB $ POSIXLY_CORRECT +is set, even to a null value, the default +.B %apropos% +search will be as an extended regex +.RB ( \-r ). +Nowadays, this is the default behaviour anyway. +.SH FILES +.TP +.if !'po4a'hide' .I /usr/share/man/index.(bt|db|dir|pag) +A traditional global +.I index +database cache. +.TP +.if !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag) +An FHS +compliant global +.I index +database cache. +.TP +.if !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis +A traditional +.B whatis +text database. +.SH "SEE ALSO" +.if !'po4a'hide' .BR %man% (1), +.if !'po4a'hide' .BR %whatis% (1), +.if !'po4a'hide' .BR %mandb% (8) +.SH AUTHOR +.nf +.if !'po4a'hide' Wilf. (G.Wilford@ee.surrey.ac.uk). +.if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). +.if !'po4a'hide' Colin Watson (cjwatson@debian.org). +.fi |