# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2018-01-22 10:13+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: ../../man/man1/apropos.man1:12 ../../man/man1/lexgrog.man1:9 ../../man/man1/man.man1:15 ../../man/man1/manconv.man1:9 ../../man/man1/manpath.man1:12 ../../man/man1/whatis.man1:12 ../../man/man1/zsoelim.man1:12 ../../man/man8/accessdb.man8:12 ../../man/man8/catman.man8:12 ../../man/man8/mandb.man8:13 #, no-wrap msgid "Manual pager utils" msgstr "" #. type: SH #: ../../man/man1/apropos.man1:13 ../../man/man1/lexgrog.man1:10 ../../man/man1/man.man1:16 ../../man/man1/manconv.man1:10 ../../man/man1/manpath.man1:13 ../../man/man1/whatis.man1:13 ../../man/man1/zsoelim.man1:13 ../../man/man5/manpath.man5:14 ../../man/man8/accessdb.man8:13 ../../man/man8/catman.man8:13 ../../man/man8/mandb.man8:14 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:15 msgid "%apropos% - search the manual page names and descriptions" msgstr "" #. type: SH #: ../../man/man1/apropos.man1:15 ../../man/man1/lexgrog.man1:12 ../../man/man1/man.man1:18 ../../man/man1/manconv.man1:12 ../../man/man1/manpath.man1:15 ../../man/man1/whatis.man1:15 ../../man/man1/zsoelim.man1:15 ../../man/man8/accessdb.man8:16 ../../man/man8/catman.man8:15 ../../man/man8/mandb.man8:16 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:32 msgid "" "B<%apropos%> [\\|B<-dalv?V>\\|] [\\|B<-e>\\||\\|B<-w>\\||\\|B<-r>\\|] " "[\\|B<-s> I\\|] [\\|B<-m> I\\|[\\|,.\\|.\\|.\\|]\\|] [\\|B<-M> " "I\\|] [\\|B<-L> I\\|] [\\|B<-C> I\\|] I " "\\&.\\|.\\|." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:32 ../../man/man1/lexgrog.man1:20 ../../man/man1/man.man1:150 ../../man/man1/manconv.man1:20 ../../man/man1/manpath.man1:22 ../../man/man1/whatis.man1:32 ../../man/man1/zsoelim.man1:20 ../../man/man5/manpath.man5:16 ../../man/man8/accessdb.man8:20 ../../man/man8/catman.man8:24 ../../man/man8/mandb.man8:29 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:37 msgid "" "Each manual page has a short description available within it. B<%apropos%> " "searches the descriptions for instances of I." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:50 msgid "" "I is usually a regular expression, as if (B<-r>) was used, or may " "contain wildcards (B<-w>), or match the exact keyword (B<-e>). Using these " "options, it may be necessary to quote the I or escape (\\e) the " "special characters to stop the shell from interpreting them." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:53 msgid "" "The standard matching rules allow matches to be made against the page name " "and word boundaries in the description." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:61 msgid "" "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." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:61 ../../man/man1/lexgrog.man1:45 ../../man/man1/man.man1:558 ../../man/man1/manconv.man1:50 ../../man/man1/manpath.man1:37 ../../man/man1/whatis.man1:71 ../../man/man1/zsoelim.man1:55 ../../man/man8/accessdb.man8:29 ../../man/man8/catman.man8:55 ../../man/man8/mandb.man8:80 #, no-wrap msgid "OPTIONS" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:65 ../../man/man1/lexgrog.man1:49 ../../man/man1/man.man1:572 ../../man/man1/manconv.man1:66 ../../man/man1/manpath.man1:44 ../../man/man1/whatis.man1:75 ../../man/man8/accessdb.man8:33 ../../man/man8/catman.man8:59 ../../man/man8/mandb.man8:84 msgid "Print debugging information." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:68 ../../man/man1/whatis.man1:78 msgid "Print verbose warning messages." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:76 msgid "" "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." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:88 msgid "" "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." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:92 msgid "" "Each keyword will be exactly matched against the page names and the " "descriptions." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:96 msgid "" "Only display items that match all the supplied keywords. The default is to " "display items that match any keyword." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:103 ../../man/man1/whatis.man1:107 msgid "" "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 sections." msgstr "" #. type: TP #: ../../man/man1/apropos.man1:103 ../../man/man1/whatis.man1:107 #, no-wrap msgid "B<-s> I, B<--sections> I, B<--section> I" msgstr "" # #. 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). #. type: Plain text #: ../../man/man1/apropos.man1:123 ../../man/man1/whatis.man1:127 msgid "" "Search only the given manual sections. I is a colon- or " "comma-separated list of sections. If an entry in I 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 has an extension, for example \"3perl\", then the list will " "only include pages in that exact part of the manual section." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:129 ../../man/man1/man.man1:701 ../../man/man1/manpath.man1:66 ../../man/man1/whatis.man1:133 msgid "" "B<-m> I\\|[\\|,.\\|.\\|.\\|]\\|, " "B<--systems=>I\\|[\\|,.\\|.\\|.\\|]" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:135 msgid "" "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> B." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:147 msgid "" "The I specified can be a combination of comma-delimited operating " "system names. To include a search of the native operating system's " "B descriptions, include the system name B in the argument " "string. This option will override the $B environment variable." msgstr "" #. type: TP #: ../../man/man1/apropos.man1:148 ../../man/man1/man.man1:720 ../../man/man1/whatis.man1:152 ../../man/man8/catman.man8:59 #, no-wrap msgid "B<-M\\ >I,\\ B<--manpath=>I" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:162 ../../man/man1/whatis.man1:166 msgid "" "Specify an alternate set of colon-delimited manual page hierarchies to " "search. By default, B<%program%> uses the $B environment variable, " "unless it is empty or unset, in which case it will determine an appropriate " "manpath based on your $B environment variable. This option overrides " "the contents of $B." msgstr "" #. type: TP #: ../../man/man1/apropos.man1:162 ../../man/man1/man.man1:671 ../../man/man1/whatis.man1:166 #, no-wrap msgid "B<-L\\ >I,\\ B<--locale=>I" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:179 ../../man/man1/man.man1:695 ../../man/man1/whatis.man1:183 msgid "" "B<%program%> will normally determine your current locale by a call to the C " "function B(3) which interrogates various environment variables, " "possibly including $B and $B. To temporarily override " "the determined value, use this option to supply a I string directly " "to B<%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." msgstr "" #. type: TP #: ../../man/man1/apropos.man1:179 ../../man/man1/man.man1:565 ../../man/man1/manpath.man1:85 ../../man/man1/whatis.man1:183 ../../man/man8/catman.man8:64 ../../man/man8/mandb.man8:131 #, no-wrap msgid "B<-C\\ >I,\\ B<--config-file=>I" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:183 ../../man/man1/man.man1:569 ../../man/man1/manpath.man1:89 ../../man/man1/whatis.man1:187 ../../man/man8/catman.man8:68 ../../man/man8/mandb.man8:135 msgid "Use this user configuration file rather than the default of I<~/.manpath>." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:186 ../../man/man1/lexgrog.man1:89 ../../man/man1/man.man1:1179 ../../man/man1/manconv.man1:69 ../../man/man1/manpath.man1:92 ../../man/man1/whatis.man1:190 ../../man/man1/zsoelim.man1:67 ../../man/man8/accessdb.man8:36 ../../man/man8/catman.man8:71 msgid "Print a help message and exit." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:189 ../../man/man1/lexgrog.man1:92 ../../man/man1/man.man1:1182 ../../man/man1/manpath.man1:95 ../../man/man1/whatis.man1:193 ../../man/man8/accessdb.man8:39 ../../man/man8/catman.man8:74 ../../man/man8/mandb.man8:141 msgid "Print a short usage message and exit." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:192 ../../man/man1/lexgrog.man1:95 ../../man/man1/man.man1:1185 ../../man/man1/manconv.man1:72 ../../man/man1/manpath.man1:98 ../../man/man1/whatis.man1:196 ../../man/man1/zsoelim.man1:70 ../../man/man8/accessdb.man8:42 ../../man/man8/catman.man8:77 msgid "Display version information." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:192 ../../man/man1/lexgrog.man1:95 ../../man/man1/man.man1:1185 ../../man/man1/whatis.man1:196 ../../man/man8/mandb.man8:144 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:196 ../../man/man1/lexgrog.man1:99 ../../man/man1/man.man1:1189 ../../man/man1/whatis.man1:200 ../../man/man8/mandb.man8:148 msgid "Successful program execution." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:199 ../../man/man1/man.man1:1192 ../../man/man1/whatis.man1:203 msgid "Usage, syntax or configuration file error." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:202 ../../man/man1/man.man1:1195 ../../man/man1/whatis.man1:206 ../../man/man8/mandb.man8:154 msgid "Operational error." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:205 ../../man/man1/whatis.man1:209 msgid "Nothing was found that matched the criteria specified." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:205 ../../man/man1/man.man1:1201 ../../man/man1/manpath.man1:98 ../../man/man1/whatis.man1:209 ../../man/man8/catman.man8:77 #, no-wrap msgid "ENVIRONMENT" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:214 ../../man/man1/man.man1:1302 ../../man/man1/manpath.man1:124 ../../man/man1/whatis.man1:218 msgid "" "If $B is set, it will have the same effect as if it had been " "specified as the argument to the B<-m> option." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:220 ../../man/man1/whatis.man1:224 ../../man/man8/catman.man8:94 msgid "" "If $B is set, its value is interpreted as the colon-delimited " "manual page hierarchy search path to use." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:232 ../../man/man1/whatis.man1:236 msgid "" "If $B 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 $B, an B(2) if available, or falling " "back to 80 characters if all else fails." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:241 msgid "" "If $B is set, even to a null value, the default " "B<%apropos%> search will be as an extended regex (B<-r>). Nowadays, this is " "the default behaviour anyway." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:241 ../../man/man1/man.man1:1367 ../../man/man1/manpath.man1:124 ../../man/man1/whatis.man1:236 ../../man/man8/catman.man8:94 ../../man/man8/mandb.man8:191 #, no-wrap msgid "FILES" msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:247 ../../man/man1/man.man1:1379 ../../man/man1/whatis.man1:242 ../../man/man8/catman.man8:103 ../../man/man8/mandb.man8:207 msgid "A traditional global I database cache." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:253 ../../man/man1/man.man1:1385 ../../man/man1/whatis.man1:248 ../../man/man8/mandb.man8:200 msgid "An FHS compliant global I database cache." msgstr "" #. type: Plain text #: ../../man/man1/apropos.man1:258 ../../man/man1/whatis.man1:253 msgid "A traditional B text database." msgstr "" #. type: SH #: ../../man/man1/apropos.man1:258 ../../man/man1/lexgrog.man1:197 ../../man/man1/man.man1:1385 ../../man/man1/manconv.man1:72 ../../man/man1/manpath.man1:128 ../../man/man1/whatis.man1:253 ../../man/man1/zsoelim.man1:70 ../../man/man8/catman.man8:109 ../../man/man8/mandb.man8:213 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: SH #: ../../man/man1/apropos.man1:262 ../../man/man1/lexgrog.man1:207 ../../man/man1/manconv.man1:75 ../../man/man1/manpath.man1:132 ../../man/man1/whatis.man1:257 ../../man/man1/zsoelim.man1:75 ../../man/man8/accessdb.man8:42 ../../man/man8/catman.man8:113 ../../man/man8/mandb.man8:223 #, no-wrap msgid "AUTHOR" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:12 msgid "lexgrog - parse header information in man pages" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:20 msgid "" "B [\\|B<-m>\\||\\|B<-c>\\|] [\\|B<-dfw?V>\\|] [\\|B<-E> " "I\\|] I \\&.\\|.\\|." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:36 msgid "" "B is an implementation of the traditional \\(lqgroff guess\\(rq " "utility in B. It reads the list of files on its command line as either " "man page source files or preformatted \\(lqcat\\(rq pages, and displays " "their name and description as used by B and B, the list of " "preprocessing filters required by the man page before it is passed to " "B or B, or both." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:45 msgid "" "If its input is badly formatted, B will print \\(lqparse " "failed\\(rq; this may be useful for external programs that need to check man " "pages for correctness. If one of B's input files is \\(lq-\\(rq, " "it will read from standard input; if any input file is compressed, a " "decompressed version will be read automatically." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:57 msgid "" "Parse input as man page source files. This is the default if neither " "B<--man> nor B<--cat> is given." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:64 msgid "" "Parse input as preformatted man pages (\\(lqcat pages\\(rq). B<--man> and " "B<--cat> may not be given simultaneously." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:75 msgid "" "Display the name and description from the man page's header, as used by " "B and B. This is the default if neither B<--whatis> nor " "B<--filters> is given." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:82 msgid "" "Display the list of filters needed to preprocess the man page before " "formatting with B or B." msgstr "" #. type: TP #: ../../man/man1/lexgrog.man1:82 #, no-wrap msgid "B<-E> I, B<--encoding> I" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:86 msgid "Override the guessed character set for the page to I." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:102 msgid "Usage error." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:106 msgid "B failed to parse one or more of its input files." msgstr "" #. type: SH #: ../../man/man1/lexgrog.man1:106 ../../man/man1/man.man1:280 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:116 #, no-wrap msgid "" " $ lexgrog man.1\n" " man.1: \"man - an interface to the on-line reference manuals\"\n" " $ lexgrog -fw man.1\n" " man.1 (t): \"man - an interface to the on-line reference manuals\"\n" " $ lexgrog -c whatis.cat1 \n" " whatis.cat1: \"whatis - display manual page descriptions\"\n" " $ lexgrog broken.1\n" " broken.1: parse failed\n" msgstr "" #. type: SH #: ../../man/man1/lexgrog.man1:117 #, no-wrap msgid "WHATIS PARSING" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:128 msgid "" "B<%mandb%> (which uses the same code as B) parses the B " "section at the top of each manual page looking for names and descriptions of " "the features documented in each. While the parser is quite tolerant, as it " "has to cope with a number of different forms that have historically been " "used, it may sometimes fail to extract the required information." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:134 msgid "" "When using the traditional I macro set, a correct B section looks " "something like this:" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:140 #, no-wrap msgid "" "CW<\\&.SH NAME\n" "foo \\e- program to do something>\n" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:148 msgid "" "Some manual pagers require the \\(oq\\e-\\(cq to be exactly as shown; " "B<%mandb%> is more tolerant, but for compatibility with other systems it is " "nevertheless a good idea to retain the backslash." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:158 msgid "" "On the left-hand side, there may be several names, separated by commas. " "Names containing whitespace will be ignored to avoid pathological behaviour " "on certain ill-formed B sections. The text on the right-hand side is " "free-form, and may be spread over multiple lines. If several features with " "different descriptions are being documented in the same manual page, the " "following form is therefore used:" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:166 #, no-wrap msgid "" "CW<\\&.SH NAME\n" "foo, bar \\e- programs to do something\n" "\\&.br\n" "baz \\e- program to do nothing>\n" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:172 msgid "" "(A macro which starts a new paragraph, like CW<.PP>, may be used instead of " "the break macro CW<.br>.)" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:178 msgid "" "When using the BSD-derived I macro set, a correct B section " "looks something like this:" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:185 #, no-wrap msgid "" "CW<\\&.Sh NAME\n" "\\&.Nm foo\n" "\\&.Nd program to do something>\n" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:197 msgid "" "There are several common reasons why whatis parsing fails. Sometimes " "authors of manual pages replace \\(oq.SH NAME\\(cq with \\(oq.SH " "MYPROGRAM\\(cq, and then B<%mandb%> cannot find the section from which to " "extract the information it needs. Sometimes authors include a NAME section, " "but place free-form text there rather than \\(oqname \\e- description\\(cq. " "However, any syntax resembling the above should be accepted." msgstr "" #. type: SH #: ../../man/man1/lexgrog.man1:202 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:207 msgid "" "B attempts to parse files containing .so requests, but will only be " "able to do so correctly if the files are properly installed in a manual page " "hierarchy." msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:211 msgid "The code used by B to scan man pages was written by:" msgstr "" #. type: Plain text #: ../../man/man1/lexgrog.man1:219 msgid "" "Colin Watson wrote the current incarnation of the command-line front-end, as " "well as this man page." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:18 msgid "%man% - an interface to the on-line reference manuals" msgstr "" #. The general command line #. The apropos command line #. type: Plain text #: ../../man/man1/man.man1:67 msgid "" "B<%man%> [\\|B<-C> I\\|] [\\|B<-d>\\|] [\\|B<-D>\\|] " "[\\|B<--warnings>\\|[\\|=I\\|]\\|] [\\|B<-R> I\\|] " "[\\|B<-L> I\\|] [\\|B<-m> I\\|[\\|,.\\|.\\|.\\|]\\|] " "[\\|B<-M> I\\|] [\\|B<-S> I\\|] [\\|B<-e> I\\|] " "[\\|B<-i>\\||\\|B<-I>\\|] [\\|B<--regex>\\||\\|B<--wildcard>\\|] " "[\\|B<--names-only>\\|] [\\|B<-a>\\|] [\\|B<-u>\\|] [\\|B<--no-subpages>\\|] " "[\\|B<-P> I\\|] [\\|B<-r> I\\|] [\\|B<-7>\\|] [\\|B<-E> " "I\\|] [\\|B<--no-hyphenation>\\|] [\\|B<--no-justification>\\|] " "[\\|B<-p> I\\|] [\\|B<-t>\\|] [\\|B<-T>\\|[\\|I\\|]\\|] " "[\\|B<-H>\\|[\\|I\\|]\\|] [\\|B<-X>\\|[\\|I\\|]\\|] " "[\\|B<-Z>\\|] [\\|[\\|I
\\|] I[.\\|I
\\|]\\ " "\\|.\\|.\\|.\\|]\\ .\\|.\\|.\\&" msgstr "" #. The --global-apropos command line #. type: Plain text #: ../../man/man1/man.man1:75 msgid "B<%man%> B<-k> [\\|I I\\|] I \\&.\\|.\\|.\\&" msgstr "" #. The whatis command line #. type: Plain text #: ../../man/man1/man.man1:86 msgid "" "B<%man%> B<-K> [\\|B<-w>\\||\\|B<-W>\\|] [\\|B<-S> I\\|] " "[\\|B<-i>\\||\\|B<-I>\\|] [\\|B<--regex>\\|] [\\|I
\\|] I\\ " ".\\|.\\|.\\&" msgstr "" #. The --local command line #. type: Plain text #: ../../man/man1/man.man1:94 msgid "B<%man%> B<-f> [\\|I I\\|] I \\&.\\|.\\|.\\&" msgstr "" #. The --where/--where-cat command line #. type: Plain text #: ../../man/man1/man.man1:127 msgid "" "B<%man%> B<-l> [\\|B<-C> I\\|] [\\|B<-d>\\|] [\\|B<-D>\\|] " "[\\|B<--warnings>\\|[\\|=I\\|]\\|] [\\|B<-R> I\\|] " "[\\|B<-L> I\\|] [\\|B<-P> I\\|] [\\|B<-r> I\\|] " "[\\|B<-7>\\|] [\\|B<-E> I\\|] [\\|B<-p> I\\|] " "[\\|B<-t>\\|] [\\|B<-T>\\|[\\|I\\|]\\|] " "[\\|B<-H>\\|[\\|I\\|]\\|] [\\|B<-X>\\|[\\|I\\|]\\|] " "[\\|B<-Z>\\|] I \\&.\\|.\\|.\\&" msgstr "" #. The --catman command line #. type: Plain text #: ../../man/man1/man.man1:137 msgid "" "B<%man%> B<-w>\\||\\|B<-W> [\\|B<-C> I\\|] [\\|B<-d>\\|] [\\|B<-D>\\|] " "I \\&.\\|.\\|.\\&" msgstr "" #. --help and --version #. type: Plain text #: ../../man/man1/man.man1:147 msgid "" "B<%man%> B<-c> [\\|B<-C> I\\|] [\\|B<-d>\\|] [\\|B<-D>\\|] I " "\\&.\\|.\\|.\\&" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:150 msgid "B<%man%> [\\|B<-?V>\\|]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:181 msgid "" "B<%man%> is the system's manual pager. Each I argument given to " "B<%man%> is normally the name of a program, utility or function. The " "I associated with each of these arguments is then found and " "displayed. A I
, if provided, will direct B<%man%> to look only in " "that I
of the manual. The default action is to search in all of " "the available I following a pre-defined order (\"%sections%\" by " "default, unless overridden by the B
directive in " "I<%manpath_config_file%>), and to show only the first I found, even if " "I exists in several I." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:185 msgid "" "The table below shows the I
numbers of the manual followed by the " "types of pages they contain." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:191 #, no-wrap msgid "Executable programs or shell commands" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:194 #, no-wrap msgid "System calls (functions provided by the kernel)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:197 #, no-wrap msgid "Library calls (functions within program libraries)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:200 #, no-wrap msgid "Special files (usually found in I)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:203 #, no-wrap msgid "File formats and conventions eg I" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:206 #, no-wrap msgid "Games" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:210 #, no-wrap msgid "" "Miscellaneous (including macro packages and conventions),\n" "e.g.\\& B(7), B(7)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:213 #, no-wrap msgid "System administration commands (usually only for root)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:216 #, no-wrap msgid "Kernel routines [\\|Non standard\\|]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:222 msgid "A manual I consists of several sections." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:242 msgid "" "Conventional section names include B, B, B, " "B, B, B, B, B, " "B, B, B, B, B, " "B, B, B, and B." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:246 msgid "" "The following conventions apply to the B section and can be used " "as a guide in other sections." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:250 #, no-wrap msgid "B" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:252 #, no-wrap msgid "type exactly as shown." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:253 #, no-wrap msgid "I" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:255 #, no-wrap msgid "replace with appropriate argument." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:256 #, no-wrap msgid "[\\|B<-abc>\\|]" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:258 #, no-wrap msgid "any or all arguments within [ ] are optional." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:259 #, no-wrap msgid "B<-a\\|>|\\|B<-b>" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:261 #, no-wrap msgid "options delimited by | cannot be used together." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:262 #, no-wrap msgid "I .\\|.\\|." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:264 #, no-wrap msgid "I is repeatable." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:265 #, no-wrap msgid "[\\|I\\|] .\\|.\\|." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:267 #, no-wrap msgid "entire I\\ within [ ] is repeatable." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:273 msgid "" "Exact rendering may vary depending on the output device. For instance, man " "will usually not be able to render italics when running in a terminal, and " "will typically use underlined or coloured text instead." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:280 msgid "" "The command or function illustration is a pattern that should match all " "possible invocations. In some cases it is advisable to illustrate several " "exclusive invocations as is shown in the B section of this manual " "page." msgstr "" #. type: TP #: ../../man/man1/man.man1:281 #, no-wrap msgid "B<%man%>I<\\ ls>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:287 msgid "Display the manual page for the I (program) I." msgstr "" #. type: TP #: ../../man/man1/man.man1:287 #, no-wrap msgid "B<%man% >I.I<7>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:292 msgid "Display the manual page for macro package I from section I<7>." msgstr "" #. type: TP #: ../../man/man1/man.man1:292 #, no-wrap msgid "B<%man%\\ -a>I<\\ intro>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:298 msgid "" "Display, in succession, all of the available I manual pages contained " "within the manual. It is possible to quit between successive displays or " "skip any of them." msgstr "" #. type: TP #: ../../man/man1/man.man1:298 #, no-wrap msgid "B<%man% -t >I|I< lpr -Pps>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:315 msgid "" "Format the manual page referenced by `I', usually a shell manual " "page, into the default B or B format and pipe it to the " "printer named I. The default output for B is usually " "PostScript. B<%man% --help> should advise as to which processor is bound to " "the B<-t> option." msgstr "" #. type: TP #: ../../man/man1/man.man1:315 #, no-wrap msgid "B<%man% -l -T>IB< E >I<./foo.1x.dvi>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:331 msgid "" "This command will decompress and format the nroff source manual page " "I<./foo.1x.gz> into a B file. The redirection is " "necessary as the B<-T> flag causes output to be directed to B with " "no pager. The output could be viewed with a program such as B or " "further processed into PostScript using a program such as B" msgstr "" #. type: TP #: ../../man/man1/man.man1:331 #, no-wrap msgid "B<%man%\\ -k>I<\\ printf>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:339 msgid "" "Search the short descriptions and manual page names for the keyword " "I as regular expression. Print out any matches. Equivalent to " "B<%apropos%>I<\\ printf>B<.>" msgstr "" #. type: TP #: ../../man/man1/man.man1:339 #, no-wrap msgid "B<%man%\\ -f>I<\\ smail>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:346 msgid "" "Lookup the manual pages referenced by I and print out the short " "descriptions of any found. Equivalent to B<%whatis%>I<\\ smail>B<.>" msgstr "" #. type: SH #: ../../man/man1/man.man1:346 #, no-wrap msgid "OVERVIEW" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:352 msgid "" "Many options are available to B<%man%> in order to give as much flexibility " "as possible to the user. Changes can be made to the search path, section " "order, output processor, and other behaviours and operations detailed below." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:374 msgid "" "If set, various environment variables are interrogated to determine the " "operation of B<%man%>. It is possible to set the `catch all' variable " "$B to any string in command line format with the exception that any " "spaces used as part of an option's argument must be escaped (preceded by a " "backslash). B<%man%> will parse $B prior to parsing its own command " "line. Those options requiring an argument will be overridden by the same " "options found on the command line. To reset all of the options set in " "$B, B<-D> can be specified as the initial command line option. This " "will allow %man% to `forget' about the options specified in $B " "although they must still have been valid." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:395 msgid "" "The manual pager utilities packaged as B make extensive use of " "B database caches. These caches contain information such as where " "each manual page can be found on the filesystem and what its I " "(short one line description of the man page) contains, and allow B<%man%> to " "run faster than if it had to search the filesystem each time to find the " "appropriate manual page. If requested using the B<-u> option, B will " "ensure that the caches remain consistent, which can obviate the need to " "manually run software to update traditional I text databases." msgstr "" #. `User' manual page hierarchies will have #. .B index #. caches created `on the fly'. #. type: Plain text #: ../../man/man1/man.man1:417 msgid "" "If B<%man%> cannot find a B<%mandb%> initiated B database for a " "particular manual page hierarchy, it will still search for the requested " "manual pages, although file globbing will be necessary to search within that " "hierarchy. If B<%whatis%> or B<%apropos%> fails to find an B it will " "try to extract information from a traditional I database instead." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:437 msgid "" "These utilities support compressed source nroff files having, by default, " "the extensions of B<.Z>, B<.z> and B<.gz>. It is possible to deal with any " "compression extension, but this information must be known at compile time. " "Also, by default, any cat pages produced are compressed using B. Each " "`global' manual page hierarchy such as I or " "I may have any directory as its cat page hierarchy. " "Traditionally the cat pages are stored under the same hierarchy as the man " "pages, but for reasons such as those specified in the B, it may be better to store them elsewhere. For details on " "how to do this, please read B(5). For details on why to do this, " "read the standard." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:450 msgid "" "International support is available with this package. Native language " "manual pages are accessible (if available on your system) via use of " "I functions. To activate such support, it is necessary to set " "either $B, $B or another system dependent environment " "variable to your language locale, usually specified in the B " "based format:" msgstr "" # #. Need a \c to make sure we don't get a space where we don't want one #. type: Plain text #: ../../man/man1/man.man1:461 msgid "EIE[\\|B<_>EIE\\|[\\|B<.>EIE\\|[\\|B<,>EIE\\|]\\|]\\|]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:466 msgid "" "If the desired page is available in your I, it will be displayed in " "lieu of the standard (usually American English) page." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:473 msgid "" "Support for international message catalogues is also featured in this " "package and can be activated in the same way, again if available. If you " "find that the manual pages and message catalogues supplied with this package " "are not available in your native language and you would like to supply them, " "please contact the maintainer who will be coordinating such activity." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:476 msgid "" "For information regarding other features and extensions available with this " "manual pager, please read the documents supplied with the package." msgstr "" #. type: SH #: ../../man/man1/man.man1:476 #, no-wrap msgid "DEFAULTS" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:496 msgid "" "B<%man%> will search for the desired manual pages within the I " "database caches. If the B<-u> option is given, a cache consistency check is " "performed to ensure the databases accurately reflect the filesystem. If " "this option is always given, it is not generally necessary to run B<%mandb%> " "after the caches are initially created, unless a cache becomes corrupt. " "However, the cache consistency check can be slow on systems with many manual " "pages installed, so it is not performed by default, and system " "administrators may wish to run B<%mandb%> every week or so to keep the " "database caches fresh. To forestall problems caused by outdated caches, " "B<%man%> will fall back to file globbing if a cache lookup fails, just as it " "would if no cache was present." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:508 msgid "" "Once a manual page has been located, a check is performed to find out if a " "relative preformatted `cat' file already exists and is newer than the nroff " "file. If it does and is, this preformatted file is (usually) decompressed " "and then displayed, via use of a pager. The pager can be specified in a " "number of ways, or else will fall back to a default is used (see option " "B<-P> for details). If no cat is found or is older than the nroff file, the " "nroff is filtered through various programs and is shown immediately." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:513 msgid "" "If a cat file can be produced (a relative cat directory exists and has " "appropriate permissions), B<%man%> will compress and store the cat file in " "the background." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:525 msgid "" "The filters are deciphered by a number of means. Firstly, the command line " "option B<-p> or the environment variable $B is interrogated. If " "B<-p> was not used and the environment variable was not set, the initial " "line of the nroff file is parsed for a preprocessor string. To contain a " "valid preprocessor string, the first line must resemble" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:528 msgid "B<'\\e\"> EBE" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:534 msgid "" "where B can be any combination of letters described by option B<-p> " "below." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:537 msgid "" "If none of the above methods provide any filter information, a default set " "is used." msgstr "" #. ******************************************************************** #. type: Plain text #: ../../man/man1/man.man1:558 msgid "" "A formatting pipeline is formed from the filters and the primary formatter " "(B or [B]B with B<-t>) and executed. Alternatively, if an " "executable program I (or I with B<-t>) exists in " "the man tree root, it is executed instead. It gets passed the manual source " "file, the preprocessor string, and optionally the device specified with " "B<-T> or B<-E> as arguments." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:564 msgid "" "Non argument options that are duplicated either on the command line, in " "$B, or both, are not harmful. For options that require an argument, " "each duplication will override the previous argument value." msgstr "" #. type: SS #: ../../man/man1/man.man1:564 #, no-wrap msgid "General options" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:582 msgid "" "This option is normally issued as the very first option and resets " "B<%man%'s> behaviour to its default. Its use is to reset those options that " "may have been set in $B. Any options that follow B<-D> will have " "their usual effect." msgstr "" #. type: TP #: ../../man/man1/man.man1:582 #, no-wrap msgid "B<--warnings>[=I]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:594 msgid "" "Enable warnings from I. This may be used to perform sanity checks on " "the source text of manual pages. I is a comma-separated list of " "warning names; if it is not supplied, the default is \"mac\". See the " "\\(lqWarnings\\(rq node in B for a list of available warning " "names." msgstr "" #. type: SS #: ../../man/man1/man.man1:594 #, no-wrap msgid "Main modes of operation" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:603 msgid "" "Equivalent to B<%whatis%>. Display a short description from the manual " "page, if available. See B<%whatis%>(1) for details." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:612 msgid "" "Equivalent to B<%apropos%>. Search the short manual page descriptions for " "keywords and display any matches. See B<%apropos%>(1) for details." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:622 msgid "" "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 searched. Search terms may be simple " "strings (the default), or regular expressions if the B<--regex> option is " "used." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:628 msgid "" "Note that this searches the I of the manual pages, not the rendered " "text, and so may include false positives due to things like comments in " "source files. Searching the rendered text would be much slower." msgstr "" #. Compressed nroff source files with a supported compression #. extension will be decompressed by man prior to being displaying via the #. usual filters. #. type: Plain text #: ../../man/man1/man.man1:644 msgid "" "Activate `local' mode. Format and display local manual files instead of " "searching through the system's manual collection. Each manual page argument " "will be interpreted as an nroff source file in the correct format. 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." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:648 msgid "" "Don't actually display the manual pages, but do print the location(s) of the " "source nroff files that would be formatted." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:653 msgid "" "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." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:658 msgid "" "This option is not for general use and should only be used by the " "B<%catman%> program." msgstr "" #. type: TP #: ../../man/man1/man.man1:658 #, no-wrap msgid "B<-R\\ >I,\\ B<--recode>=I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:670 msgid "" "Instead of formatting the manual page in the usual way, output its source " "converted to the specified I. If you already know the encoding of " "the source file, you can also use B<%manconv%>(1) directly. However, this " "option allows you to convert several manual pages to a single encoding " "without having to explicitly state the encoding of each, provided that they " "were already installed in a structure similar to a manual page hierarchy." msgstr "" #. type: SS #: ../../man/man1/man.man1:670 #, no-wrap msgid "Finding manual pages" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:708 msgid "" "If this system has access to other operating system's manual pages, they can " "be accessed using this option. To search for a manual page from NewOS's " "manual page collection, use the option B<-m> B." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:719 msgid "" "The I specified can be a combination of comma delimited operating " "system names. To include a search of the native operating system's manual " "pages, include the system name B in the argument string. This option " "will override the $B environment variable." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:733 msgid "" "Specify an alternate manpath to use. By default, B<%man%> uses B<%manpath%> " "derived code to determine the path to search. This option overrides the " "$B environment variable and causes option B<-m> to be ignored." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:740 msgid "" "A path specified as a manpath must be the root of a manual page hierarchy " "structured into sections as described in the man-db manual (under \"The " "manual page system\"). To view manual pages outside such hierarchies, see " "the B<-l> option." msgstr "" #. type: TP #: ../../man/man1/man.man1:740 #, no-wrap msgid "B<-S\\ >I,\\ B<-s\\ >I,\\ B<--sections=>I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:750 msgid "" "List is a colon- or comma-separated list of `order specific' manual sections " "to search. This option overrides the $B environment variable. " "(The B<-s> spelling is for compatibility with System V.)" msgstr "" #. type: TP #: ../../man/man1/man.man1:750 #, no-wrap msgid "B<-e\\ >I,\\ B<--extension=>I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:784 msgid "" "Some systems incorporate large packages of manual pages, such as those that " "accompany the B package, into the main manual page hierarchy. To get " "around the problem of having two manual pages with the same name such as " "B(3), the B pages were usually all assigned to section B. As " "this is unfortunate, it is now possible to put the pages in the correct " "section, and to assign a specific `extension' to them, in this case, " "B(3tcl). Under normal operation, B<%man%> will display B(3) in " "preference to B(3tcl). To negotiate this situation and to avoid " "having to know which section the page you require resides in, it is now " "possible to give B<%man%> a I string indicating which package " "the page must belong to. Using the above example, supplying the option " "B<-e\\ tcl> to B<%man%> will restrict the search to pages having an " "extension of B<*tcl>." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:788 msgid "Ignore case when searching for manual pages. This is the default." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:791 msgid "Search for manual pages case-sensitively." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:801 msgid "" "Show all pages with any part of either their names or their descriptions " "matching each I argument as a regular expression, as with " "B(1). Since there is usually no reasonable way to pick a \"best\" " "page when searching for a regular expression, this option implies B<-a>." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:816 msgid "" "Show all pages with any part of either their names or their descriptions " "matching each I argument using shell-style wildcards, as with " "B(1) B<--wildcard>. The I argument must match the entire " "name or description, or match on word boundaries in the description. Since " "there is usually no reasonable way to pick a \"best\" page when searching " "for a wildcard, this option implies B<-a>." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:825 msgid "" "If the B<--regex> or B<--wildcard> option is used, match only page names, " "not page descriptions, as with B(1). Otherwise, no effect." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:833 msgid "" "By default, B<%man%> will exit after displaying the most suitable manual " "page it finds. Using this option forces B<%man%> to display all the manual " "pages with names that match the search criteria." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:842 msgid "" "This option causes B<%man%> to perform an `inode level' consistency check on " "its database caches to ensure that they are an accurate representation of " "the filesystem. It will only have a useful effect if B<%man%> is installed " "with the setuid bit set." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:854 msgid "" "By default, B<%man%> will try to interpret pairs of manual page names given " "on the command line as equivalent to a single manual page name containing a " "hyphen or an underscore. This supports the common pattern of programs that " "implement a number of subcommands, allowing them to provide manual pages for " "each that can be accessed using similar syntax as would be used to invoke " "the subcommands themselves. For example:" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:863 msgid "To disable this behaviour, use the B<--no-subpages> option." msgstr "" #. type: SS #: ../../man/man1/man.man1:870 #, no-wrap msgid "Controlling formatted output" msgstr "" #. type: TP #: ../../man/man1/man.man1:871 #, no-wrap msgid "B<-P\\ >I,\\ B<--pager=>I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:892 msgid "" "Specify which output pager to use. By default, B<%man%> uses B<%pager%>, " "falling back to B<%cat%> if B<%pager%> is not found or is not executable. " "This option overrides the $B environment variable, which in turn " "overrides the $B environment variable. It is not used in conjunction " "with B<-f> or B<-k>." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:898 ../../man/man1/man.man1:1259 msgid "" "The value may be a simple command name or a command with arguments, and may " "use shell quoting (backslashes, single quotes, or double quotes). It may " "not use pipes to connect multiple commands; if you need that, use a wrapper " "script, which may take the file to display either as an argument or on " "standard input." msgstr "" #. type: TP #: ../../man/man1/man.man1:898 #, no-wrap msgid "B<-r\\ >I,\\ B<--prompt=>I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:906 msgid "" "If a recent version of B is used as the pager, B<%man%> will attempt " "to set its prompt and some sensible options. The default prompt looks like" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:910 msgid "B<\\ Manual page>I<\\ name>B<(>IB<)>B<\\ line>I<\\ x>" msgstr "" #. The default options are #. .BR \-six8 . #. The actual default will depend on your chosen #. .BR locale . #. type: Plain text #: ../../man/man1/man.man1:925 msgid "" "where I denotes the manual page name, I denotes the section it " "was found under and I the current line number. This is achieved by using " "the $B environment variable." msgstr "" #. You may need to do this if your #. version of #. .B less #. rejects the default options or if you prefer a different prompt. #. type: Plain text #: ../../man/man1/man.man1:938 msgid "" "Supplying B<-r> with a string will override this default. The string may " "contain the text B<$MAN_PN> which will be expanded to the name of the " "current manual page and its section name surrounded by `(' and `)'. The " "string used to produce the default could be expressed as" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:940 msgid "B<\\e\\ Manual\\e\\ page\\e\\ \\e$MAN_PN\\e\\ ?ltline\\e\\ %lt?L/%L.:>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:942 msgid "B" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:944 msgid "B<(press h for help or q to quit)>" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:959 msgid "" "It is broken into three lines here for the sake of readability only. For " "its meaning see the B(1) manual page. The prompt string is first " "evaluated by the shell. All double quotes, back-quotes and backslashes in " "the prompt must be escaped by a preceding backslash. The prompt string may " "end in an escaped $ which may be followed by further options for less. By " "default B<%man%> sets the B<-ix8> options." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:964 msgid "" "The $B environment variable described below may be used to set a " "default prompt string if none is supplied on the command line." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:990 msgid "" "When viewing a pure I(7) manual page on a 7 bit terminal or terminal " "emulator, some characters may not display correctly when using the " "I(7) device description with B B. This option allows " "pure I manual pages to be displayed in I with the I " "device. It will not translate any I text. The following table " "shows the translations performed: some parts of it may only be displayed " "properly when using B B's I(7) device." msgstr "" #. type: tbl table #: ../../man/man1/man.man1:999 #, no-wrap msgid "Description" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:999 #, no-wrap msgid "Octal" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:1003 #, no-wrap msgid "continuation hyphen" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:1006 #, no-wrap msgid "bullet (middle dot)" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:1009 #, no-wrap msgid "acute accent" msgstr "" #. type: tbl table #: ../../man/man1/man.man1:1012 #, no-wrap msgid "multiplication sign" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1034 msgid "" "If the I column displays correctly, your terminal may be set up for " "I characters and this option is not necessary. If the I and " "I columns are identical, you are reading this page using this option " "or B<%man%> did not format this page using the I device " "description. If the I column is missing or corrupt, you may need to " "view manual pages with this option." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1045 msgid "" "This option is ignored when using options B<-t>, B<-H>, B<-T>, or B<-Z> and " "may be useless for B other than B." msgstr "" #. type: TP #: ../../man/man1/man.man1:1045 #, no-wrap msgid "B<-E\\ >I,\\ B<--encoding>=I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1056 msgid "" "Generate output for a character encoding other than the default. For " "backward compatibility, I may be an B device such as " "B, B, or B as well as a true character encoding such as " "B." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1065 msgid "" "Normally, B will automatically hyphenate text at line breaks even in " "words that do not contain hyphens, if it is necessary to do so to lay out " "words on a line without excessive spacing. This option disables automatic " "hyphenation, so words will only be hyphenated if they already contain " "hyphens." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1074 msgid "" "If you are writing a manual page and simply want to prevent B from " "hyphenating a word at an inappropriate point, do not use this option, but " "consult the B documentation instead; for instance, you can put " "\"\\e%\" inside a word to indicate that it may be hyphenated at that point, " "or put \"\\e%\" at the start of a word to prevent it from being hyphenated." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1081 msgid "" "Normally, B will automatically justify text to both margins. This " "option disables full justification, leaving justified only to the left " "margin, sometimes called \"ragged-right\" text." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1088 msgid "" "If you are writing a manual page and simply want to prevent B from " "justifying certain paragraphs, do not use this option, but consult the " "B documentation instead; for instance, you can use the \".na\", " "\".nf\", \".fi\", and \".ad\" requests to temporarily disable adjusting and " "filling." msgstr "" #. type: TP #: ../../man/man1/man.man1:1088 #, no-wrap msgid "B<-p\\ >I,\\ B<--preprocessor=>I" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1107 msgid "" "Specify the sequence of preprocessors to run before B or " "B/B. Not all installations will have a full set of " "preprocessors. Some of the preprocessors and the letters used to designate " "them are: B (B), B (B), B (B

), B (B), " "B (B), B (B). This option overrides the $B " "environment variable. B<%zsoelim%> is always run as the very first " "preprocessor." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1117 msgid "" "Use I<%troff%> to format the manual page to stdout. This option is not " "required in conjunction with B<-H>, B<-T>, or B<-Z>." msgstr "" #. type: TP #: ../../man/man1/man.man1:1117 #, no-wrap msgid "B<-T>[I], B<--troff-device>[=I]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1129 msgid "" "This option is used to change B (or possibly B) output to " "be suitable for a device other than the default. It implies B<-t>. " "Examples (provided with Groff-1.17) include B, B, B, " "B, B and B." msgstr "" #. type: TP #: ../../man/man1/man.man1:1129 #, no-wrap msgid "B<-H>[I], B<--html>[=I]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1145 msgid "" "This option will cause B to produce HTML output, and will display " "that output in a web browser. The choice of browser is determined by the " "optional I argument if one is provided, by the $B " "environment variable, or by a compile-time default if that is unset (usually " "B). This option implies B<-t>, and will only work with B " "B." msgstr "" #. type: TP #: ../../man/man1/man.man1:1145 #, no-wrap msgid "B<-X>[I], B<--gxditview>[=I]" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1159 msgid "" "This option displays the output of B in a graphical window using the " "B program. The I (dots per inch) may be 75, 75-12, 100, or " "100-12, defaulting to 75; the -12 variants use a 12-point base font. This " "option implies B<-T> with the X75, X75-12, X100, or X100-12 device " "respectively." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1175 msgid "" "B will run B and then use an appropriate post-processor to " "produce output suitable for the chosen device. If I<%troff%> is B, " "this option is passed to B and will suppress the use of a " "post-processor. It implies B<-t>." msgstr "" #. type: SS #: ../../man/man1/man.man1:1175 #, no-wrap msgid "Getting help" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1198 msgid "A child process returned a non-zero exit status." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1201 msgid "At least one of the pages/files/keywords didn't exist or wasn't matched." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1208 msgid "" "If $B is set, its value is used as the path to search for manual " "pages." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1219 msgid "" "The contents of $B are added to the command line every time " "B invokes the formatter (B, B, or B)." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1226 msgid "" "If $B is set, its value is used to determine the set of " "preprocessors to pass each manual page through. The default preprocessor " "list is system dependent." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1236 ../../man/man8/catman.man8:88 msgid "" "If $B is set, its value is a colon-delimited list of sections and " "it is used to determine which manual sections to search and in what order. " "The default is \"%sections%\", unless overridden by the B

directive " "in I<%manpath_config_file%>." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1253 msgid "" "If $B or $B is set ($B is used in preference), " "its value is used as the name of the program used to display the manual " "page. By default, B<%pager%> is used, falling back to B<%cat%> if " "B<%pager%> is not found or is not executable." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1278 msgid "" "If $B is set, its value will be used as the default prompt string " "for the B pager, as if it had been passed using the B<-r> option (so " "any occurrences of the text B<$MAN_PN> will be expanded in the same way). " "For example, if you want to set the prompt string unconditionally to \\(lqmy " "prompt string\\(rq, set $B to \\(oqB<-Psmy\\ prompt\\ " "string>\\(cq. Using the B<-r> option overrides this environment variable." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1294 msgid "" "If $B is set, its value is a colon-delimited list of commands, each " "of which in turn is used to try to start a web browser for B " "B<--html>. In each command, I<%s> is replaced by a filename containing the " "HTML output from B, I<%%> is replaced by a single percent sign (%), " "and I<%c> is replaced by a colon (:)." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1317 msgid "" "If $B is set, it will be parsed prior to B<%man%'s> command line and " "is expected to be in a similar format. As all of the other B<%man%> " "specific environment variables can be expressed as command line options, and " "are thus candidates for being included in $B it is expected that " "they will become obsolete. N.B. All spaces that should be interpreted as " "part of an option's argument must be escaped." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1331 msgid "" "If $B is set, its value is used as the line length for which " "manual pages should be formatted. If it is not set, manual pages will be " "formatted with a line length appropriate to the current terminal (using the " "value of $B, an B(2) if available, or falling back to 80 " "characters if neither is available). Cat pages will only be saved when the " "default formatting can be used, that is when the terminal line length is " "between 66 and 80 characters." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1342 msgid "" "Normally, when output is not being directed to a terminal (such as to a file " "or a pipe), formatting characters are discarded to make it easier to read " "the result without special tools. However, if $B is " "set to any non-empty value, these formatting characters are retained. This " "may be useful for wrappers around B<%man%> that can interpret formatting " "characters." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1355 msgid "" "Normally, when output is being directed to a terminal (usually to a pager), " "any error output from the command used to produce formatted versions of " "manual pages is discarded to avoid interfering with the pager's display. " "Programs such as B often produce relatively minor error messages " "about typographical problems such as poor alignment, which are unsightly and " "generally confusing when displayed along with the manual page. However, " "some users want to see them anyway, so, if $B is set to any " "non-empty value, error output will be displayed as usual." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1367 msgid "" "Depending on system and implementation, either or both of $B and " "$B will be interrogated for the current message locale. " "B<%man%> will display its messages in that locale (if available). See " "B(3) for precise details." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1371 ../../man/man1/manpath.man1:128 ../../man/man8/catman.man8:98 ../../man/man8/mandb.man8:195 msgid "man-db configuration file." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1374 msgid "A global manual page hierarchy." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1403 msgid "the man-db package manual, B" msgstr "" #. type: SH #: ../../man/man1/man.man1:1403 #, no-wrap msgid "HISTORY" msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1405 msgid "" "1990, 1991 \\(en Originally written by John W.\\& Eaton " "(jwe@che.utexas.edu)." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1408 msgid "" "Dec 23 1992: Rik Faith (faith@cs.unc.edu) applied bug fixes supplied by " "Willem Kasdorp (wkasdo@nikhefk.nikef.nl)." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1412 msgid "" "30th April 1994 \\(en 23rd February 2000: Wilf. (G.Wilford@ee.surrey.ac.uk) " "has been developing and maintaining this package with the help of a few " "dedicated people." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1416 msgid "" "30th October 1996 \\(en 30th March 2001: Fabrizio Polacco " "Efpolacco@debian.orgE maintained and enhanced this package for the " "Debian project, with the help of all the community." msgstr "" #. type: Plain text #: ../../man/man1/man.man1:1418 msgid "" "31st March 2001 \\(en present day: Colin Watson " "Ecjwatson@debian.orgE is now developing and maintaining man-db." msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:12 msgid "%manconv% - convert manual page from one encoding to another" msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:20 msgid "" "B<%manconv%> B<-f> I\\|[:I\\|.\\|.\\|.] B<-t> " "I [\\|B<-dqhV>\\|] [\\|I\\|]" msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:30 msgid "" "B<%manconv%> converts a manual page from one encoding to another, like " "B. Unlike B, it can try multiple possible input encodings in " "sequence. This is useful for manual pages installed in directories without " "an explicit encoding declaration, since they may be in UTF-8 or in a legacy " "character set." msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:36 msgid "" "If an encoding declaration is found on the first line of the manual page, " "that declaration overrides any input encodings specified on B<%manconv%>'s " "command line. Encoding declarations have the following form:" msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:44 msgid "or (if manual page preprocessors are also to be declared):" msgstr "" #. type: TP #: ../../man/man1/manconv.man1:51 #, no-wrap msgid "B<-f> I, B<--from-code> I" msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:56 msgid "" "Try each of I (a colon-separated list) in sequence as the input " "encoding." msgstr "" #. type: TP #: ../../man/man1/manconv.man1:56 #, no-wrap msgid "B<-t> I, B<--to-code> I" msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:60 msgid "Convert the manual page to I." msgstr "" #. type: Plain text #: ../../man/man1/manconv.man1:63 msgid "Do not issue error messages when the page cannot be converted." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:15 msgid "%manpath% - determine search path for manual pages" msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:22 msgid "" "B<%manpath%> [\\|B<-qgdc?V>\\|] [\\|B<-m> I\\|[\\|,.\\|.\\|.\\|]\\|] " "[\\|B<-C> I\\|]" msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:32 msgid "" "If $B is set, B<%manpath%> will simply display its contents and " "issue a warning. If not, B<%manpath%> will determine a suitable manual page " "hierarchy search path and display the results." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:37 msgid "" "The colon-delimited path is determined using information gained from the " "man-db configuration file - (I<%manpath_config_file%>) and the user's " "environment." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:41 msgid "Do not issue warnings." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:49 msgid "" "Produce a catpath as opposed to a manpath. Once the manpath is determined, " "each path element is converted to its relative catpath." msgstr "" # #. 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). #. type: Plain text #: ../../man/man1/manpath.man1:60 msgid "" "Produce a manpath consisting of all paths named as `global' within the " "man-db configuration file." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:73 msgid "" "If this system has access to other operating system's manual hierarchies, " "this option can be used to include them in the output of B<%manpath%>. To " "include NewOS's manual page hierarchies use the option B<-m> B." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:84 msgid "" "The I specified can be a combination of comma delimited operating " "system names. To include the native operating system's manual page " "hierarchies, the system name B must be included in the argument " "string. This option will override the $B environment variable." msgstr "" #. type: Plain text #: ../../man/man1/manpath.man1:116 msgid "" "If $B is set, B<%manpath%> displays its value rather than " "determining it on the fly. If $B is prefixed by a colon, then the " "value of the variable is appended to the list determined from the content of " "the configuration files. If the colon comes at the end of the value in the " "variable, then the determined list is appended to the content of the " "variable. If the value of the variable contains a double colon (B<::>), " "then the determined list is inserted in the middle of the value, between the " "two colons." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:15 msgid "%whatis% - display one-line manual page descriptions" msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:32 msgid "" "B<%whatis%> [\\|B<-dlv?V>\\|] [\\|B<-r>\\||\\|B<-w>\\|] [\\|B<-s> " "I\\|] [\\|B<-m> I\\|[\\|,.\\|.\\|.\\|]\\|] [\\|B<-M> " "I\\|] [\\|B<-L> I\\|] [\\|B<-C> I\\|] I " "\\&.\\|.\\|." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:39 msgid "" "Each manual page has a short description available within it. B<%whatis%> " "searches the manual page names and displays the manual page descriptions of " "any I matched." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:49 msgid "" "I may contain wildcards (B<-w>) or be a regular expression (B<-r>). " "Using these options, it may be necessary to quote the I or escape " "(\\e) the special characters to stop the shell from interpreting them." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:61 msgid "" "B databases are used during the search, and are 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. To produce an old style text B database from " "the relative B database, issue the command:" msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:66 msgid "B<%whatis% -M> I B<-w '*' | sort E> I" msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:71 msgid "where I is a manual page hierarchy such as I." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:89 msgid "" "Interpret each I as a regular expression. If a I matches any " "part of a page name, a match will be made. This option causes B<%whatis%> " "to be somewhat slower due to the nature of database searches." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:100 msgid "" "Interpret each I as a pattern containing shell style wildcards. For a " "match to be made, an expanded I must match the entire page name. This " "option causes B<%whatis%> to be somewhat slower due to the nature of " "database searches." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:140 msgid "" "If this system has access to other operating system's manual page names, " "they can be accessed using this option. To search NewOS's manual page " "names, use the option B<-m> B." msgstr "" #. type: Plain text #: ../../man/man1/whatis.man1:151 msgid "" "The I specified can be a combination of comma delimited operating " "system names. To include a search of the native operating system's manual " "page names, include the system name B in the argument string. This " "option will override the $B environment variable." msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:15 msgid "%zsoelim% - satisfy .so requests in roff input" msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:20 msgid "B<%zsoelim%> [\\|B<-CVh>\\|] [\\|I \\&.\\|.\\|.\\|]" msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:26 msgid "" "B<%zsoelim%> parses I arguments, or if none are specified, its " "standard input for lines of the form:" msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:29 msgid "B<.so> E\\|I\\|E" msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:48 msgid "" "These requests are replaced by the contents of the I specified. " "If the request cannot be met, B<%zsoelim%> looks for I where " "I<.ext> can be one of B<.gz>, B<.Z> or B<.z>. Other extension types may be " "supported depending upon compile time options. If the request can be met by " "a compressed file, this file is decompressed using an appropriate " "decompressor and its output is used to satisfy the request." msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:55 msgid "" "Traditionally, B programs were used to allow roff preprocessors to " "be able to preprocess the files referred to by the requests. This " "particular version was written to circumvent problems created by support for " "compressed manual pages." msgstr "" #. type: Plain text #: ../../man/man1/zsoelim.man1:64 msgid "" "This flag is available for compatibility with other B programs. Its " "use is to enable .so requests followed by something other than whitespace. " "As this is already the default behaviour, it is ignored." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:16 msgid "manpath - format of the %manpath_config_file% file" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:21 msgid "" "The manpath configuration file is used by the manual page utilities to " "assess users' manpaths at run time, to indicate which manual page " "hierarchies (manpaths) are to be treated as system hierarchies and to assign " "them directories to be used for storing cat files." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:26 msgid "" "If the environment variable $B is already set, the information " "contained within %manpath_config_file% will not override it." msgstr "" #. type: SH #: ../../man/man5/manpath.man5:26 #, no-wrap msgid "FORMAT" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:28 msgid "The following field types are currently recognised:" msgstr "" #. type: TP #: ../../man/man5/manpath.man5:28 #, no-wrap msgid "B<#>I<\\ comment>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:33 msgid "" "Blank lines or those beginning with a B<#> will be treated as comments and " "ignored." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:33 #, no-wrap msgid "BI<\\ manpath_element>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:40 msgid "" "Lines of this form indicate manpaths that every automatically generated " "$B should contain. This will typically include I." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:40 #, no-wrap msgid "BI<\\ path_element\\ manpath_element>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:54 msgid "" "Lines of this form set up $B to $B mappings. For each " "I found in the user's $B, I will be " "added to the $B." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:54 #, no-wrap msgid "BI\\|[\\| I \\|]" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:64 msgid "" "Lines of this form indicate which manpaths are to be treated as system " "manpaths, and optionally where their cat files should be stored. This field " "type is particularly important if B is a setuid program, as (when in " "the system configuration file %manpath_config_file% rather than the per-user " "configuration file .manpath) it indicates which manual page hierarchies to " "access as the setuid user and which as the invoking user." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:72 msgid "" "The system manual page hierarchies are usually those stored under I " "such as I, I and I." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:78 msgid "" "If cat pages from a particular I are not to be stored or " "are to be stored in the traditional location, I may be " "omitted." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:87 msgid "" "Traditional cat placement would be impossible for read only mounted manual " "page hierarchies and because of this it is possible to specify any valid " "directory hierarchy for their storage. To observe the B the " "keyword `B can be used in place of an actual directory." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:96 msgid "" "Unfortunately, it is necessary to specify B system man tree paths, " "including alternate operating system paths such as I and any " "B paths such as I." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:104 msgid "" "As the information is parsed line by line in the order written, it is " "necessary for any manpath that is a sub-hierarchy of another hierarchy to be " "listed first, otherwise an incorrect match will be made. An example is that " "I must come before I." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:104 #, no-wrap msgid "BI<\\ key\\ value>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:114 msgid "" "Lines of this form define miscellaneous configuration variables; see the " "default configuration file for those variables used by the manual pager " "utilities. They include default paths to various programs (such as I " "and I), and default sets of arguments to those programs." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:114 #, no-wrap msgid "B
I
.\\|.\\|." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:122 msgid "" "Lines of this form define the order in which manual sections should be " "searched. If there are no B
directives in the configuration file, " "the default is:" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:132 msgid "" "If multiple B
directives are given, their section lists will be " "concatenated." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:139 msgid "" "If a particular extension is not in this list (say, 1mh) it will be " "displayed with the rest of the section it belongs to. The effect of this is " "that you only need to explicitly list extensions if you want to force a " "particular order. Sections with extensions should usually be adjacent to " "their main section (e.g. \"1 1mh 8 ...\")." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:142 msgid "B is accepted as an alternative name for this directive." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:143 #, no-wrap msgid "BI<\\ width>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:149 msgid "" "If the terminal width is less than I, cat pages will not be created " "(if missing) or displayed. The default is 80." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:149 #, no-wrap msgid "BI<\\ width>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:155 msgid "" "If the terminal width is greater than I, cat pages will not be " "created (if missing) or displayed. The default is 80." msgstr "" #. type: TP #: ../../man/man5/manpath.man5:155 #, no-wrap msgid "BI<\\ width>" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:165 msgid "" "If I is non-zero, cat pages will always be formatted for a terminal " "of the given width, regardless of the width of the terminal actually being " "used. This should generally be within the range set by B and " "B." msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:170 msgid "This flag prevents B<%man%>(1) from creating cat pages automatically." msgstr "" #. type: SH #: ../../man/man5/manpath.man5:170 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: ../../man/man5/manpath.man5:173 msgid "" "Unless the rules above are followed and observed precisely, the manual pager " "utilities will not function as desired. The rules are overly complicated." msgstr "" #. type: Plain text #: ../../man/man8/accessdb.man8:16 msgid "accessdb - dumps the content of a man-db database in a human readable format" msgstr "" #. type: Plain text #: ../../man/man8/accessdb.man8:20 msgid "B [\\|B<-d?V>\\|] [Iindex-fileE>]" msgstr "" #. type: Plain text #: ../../man/man8/accessdb.man8:27 msgid "" "B will output the data contained within a man-db database in a " "human readable form. By default, it will dump the data from " "Bdb-typeE,> where Edb-typeE is " "dependent on the database library in use." msgstr "" #. type: Plain text #: ../../man/man8/accessdb.man8:29 msgid "Supplying an argument to accessdb will override this default." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:15 msgid "%catman% - create or update the pre-formatted manual pages" msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:24 msgid "" "B<%catman%> [\\|B<-d?V>\\|] [\\|B<-M> I\\|] [\\|B<-C> I\\|] " "[\\|I
\\|] \\&.\\|.\\|." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:32 msgid "" "B<%catman%> is used to create an up to date set of pre-formatted manual " "pages known as cat pages. Cat pages are generally much faster to display " "than the original manual pages, but require extra storage space. The " "decision to support cat pages is that of the local administrator, who must " "provide suitable directories to contain them." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:49 msgid "" "The options available to B<%catman%> are the manual page hierarchies and " "sections to pre-format. The default hierarchies are those specified as " "system hierarchies in the man-db configuration file, and the default " "sections are either the colon-delimited contents of the environment variable " "$B or the standard set compiled into B<%man%> if $B is " "undefined. Supplying B<%catman%> with a set of whitespace-delimited section " "names will override both of the above." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:55 msgid "" "B<%catman%> makes use of the B database cache associated with each " "hierarchy to determine which files need to be formatted." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:64 msgid "" "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." msgstr "" #. type: Plain text #: ../../man/man8/catman.man8:109 ../../man/man8/mandb.man8:213 msgid "An alternate or FSSTND compliant global I database cache." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:16 msgid "%mandb% - create or update the manual page index caches" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:22 msgid "B<%mandb%> [\\|B<-dqsucpt?V>\\|] [\\|B<-C> I\\|] [\\|I\\|]" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:29 msgid "" "B<%mandb%> [\\|B<-dqsut>\\|] [\\|B<-C> I\\|] B<-f> I\\ " ".\\|.\\|." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:38 msgid "" "B<%mandb%> is used to initialise or manually update B database caches " "that are usually maintained by B<%man%>. The caches contain information " "relevant to the current state of the manual page system and the information " "stored within them is used by the man-db utilities to enhance their speed " "and functionality." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:46 msgid "" "When creating or updating an B, B<%mandb%> will warn of bad ROFF .so " "requests, bogus manual page filenames and manual pages from which the " "B cannot be parsed." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:52 msgid "" "Supplying B<%mandb%> with an optional colon-delimited path will override the " "internal system manual page hierarchy search path, determined from " "information found within the man-db configuration file." msgstr "" #. type: SH #: ../../man/man8/mandb.man8:52 #, no-wrap msgid "DATABASE CACHES" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:55 msgid "" "B<%mandb%> can be compiled with support for any one of the following " "database types." msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:59 #, no-wrap msgid "Name" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:59 #, no-wrap msgid "Type" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:59 #, no-wrap msgid "Async" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:59 #, no-wrap msgid "Filename" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:61 #, no-wrap msgid "Berkeley db" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:63 #, no-wrap msgid "Binary tree" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:63 ../../man/man8/mandb.man8:66 #, no-wrap msgid "Yes" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:63 #, no-wrap msgid "I" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:64 #, no-wrap msgid "GNU gdbm" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:66 ../../man/man8/mandb.man8:69 #, no-wrap msgid "Hashed" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:66 #, no-wrap msgid "I" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:67 #, no-wrap msgid "UNIX ndbm" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:69 #, no-wrap msgid "No" msgstr "" #. type: tbl table #: ../../man/man8/mandb.man8:69 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:80 msgid "" "Those database types that support asynchronous updates provide enhanced " "speed at the cost of possible corruption in the event of unusual " "termination. In an unusual case where this has occurred, it may be " "necessary to rerun B<%mandb%> with the B<-c> option to re-create the " "databases from scratch." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:87 msgid "Produce no warnings." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:91 msgid "" "Do not spend time looking for or adding information to the databases " "regarding stray cats." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:95 msgid "" "Do not spend time checking for deleted manual pages and purging them from " "the databases." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:107 msgid "" "By default, B<%mandb%> will try to update any previously created databases. " "If a database does not exist, it will create it. This option forces " "B<%mandb%> to delete previous databases and re-create them from scratch, and " "implies B<--no-purge.> This may be necessary if a database becomes corrupt " "or if a new database storage scheme is introduced in the future." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:111 msgid "" "Create user databases only, even with write permissions necessary to create " "system databases." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:117 msgid "" "Perform correctness checks on manual pages in the hierarchy search path. " "With this option, B<%mandb%> will not alter existing databases." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:131 msgid "" "Update only the entries for the given filename. This option is not for " "general use; it is used internally by B<%man%> when it has been compiled " "with the B option and finds that a page is out of date. It " "implies B<-p> and disables B<-c> and B<-s>." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:138 msgid "Show the usage message, then exit." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:144 msgid "Show the version, then exit." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:151 msgid "Usage, syntax, or configuration file error." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:157 msgid "A child process failed." msgstr "" #. type: SH #: ../../man/man8/mandb.man8:157 #, no-wrap msgid "DIAGNOSTICS" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:159 msgid "The following warning messages can be emitted during database building." msgstr "" #. type: TP #: ../../man/man8/mandb.man8:159 #, no-wrap msgid "BfilenameE: whatis parse for page(sec) failed>" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:170 msgid "" "An attempt to extract whatis line(s) from the given EfilenameE " "failed. This is usually due to a poorly written manual page, but if many " "such messages are emitted it is likely that the system contains non-standard " "manual pages which are incompatible with the man-db whatis parser. See the " "B section in B(1) for more information." msgstr "" #. type: TP #: ../../man/man8/mandb.man8:170 #, no-wrap msgid "BfilenameE: is a dangling symlink>" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:175 msgid "" "EfilenameE does not exist but is referenced by a symbolic link. " "Further diagnostics are usually emitted to identify the EfilenameE " "of the offending link." msgstr "" #. type: TP #: ../../man/man8/mandb.man8:175 #, no-wrap msgid "BfilenameE: bad symlink or ROFF `.so' request>" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:179 msgid "" "EfilenameE is either a symbolic link to, or contains a ROFF include " "request to, a non existent file." msgstr "" #. type: TP #: ../../man/man8/mandb.man8:179 #, no-wrap msgid "BfilenameE: ignoring bogus filename>" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:185 msgid "" "The EfilenameE may or may not be a valid manual page but its name is " "invalid. This is usually due to a manual page with sectional extension " "ExE being put in manual page section EyE." msgstr "" #. type: TP #: ../../man/man8/mandb.man8:185 #, no-wrap msgid "Bfilename_maskE: competing extensions>" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:191 msgid "" "The wildcard Efilename_maskE is not unique. This is usually caused " "by the existence of both a compressed and uncompressed version of the same " "manual page. All but the most recent are ignored." msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:202 msgid "Older locations for the database cache included:" msgstr "" #. type: Plain text #: ../../man/man8/mandb.man8:223 msgid "" "The B section formerly in this manual page is now part of " "B(1)." msgstr ""