path: root/templates/man7/man.7.pot

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-05-01 15:44+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "man"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "2023-02-05"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "Linux man-pages 6.03"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "man - macros to format man pages"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<groff -Tascii -man> I<file> \\&..."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<groff -Tps -man> I<file> \\&..."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<man> [I<section>] I<title>"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"This manual page explains the B<groff an.tmac> macro package (often called "
"the B<man> macro package).  This macro package should be used by developers "
"when writing or porting man pages for Linux.  It is fairly compatible with "
"other versions of this macro package, so porting man pages should not be a "
"major problem (exceptions include the NET-2 BSD release, which uses a "
"totally different macro package called mdoc; see B<mdoc>(7))."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Note that NET-2 BSD mdoc man pages can be used with B<groff> simply by "
"specifying the B<-mdoc> option instead of the B<-man> option.  Using the B<-"
"mandoc> option is, however, recommended, since this will automatically "
"detect which macro package is in use."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"For conventions that should be employed when writing man pages for the Linux "
"I<man-pages> package, see B<man-pages>(7)."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Title line"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The first command in a man page (after comment lines, that is, lines that "
"start with B<.\\e\">) should be"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<\\&.TH> I<title section date source manual>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"For details of the arguments that should be supplied to the B<TH> command, "
"see B<man-pages>(7)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Note that BSD mdoc-formatted pages begin with the B<Dd> command, not the "
"B<TH> command."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Sections"
msgstr ""

#.  The following doesn't seem to be required (see Debian bug 411303),
#.  If the name contains spaces and appears
#.  on the same line as
#.  .BR \&.SH ,
#.  then place the heading in double quotes.
#. type: Plain text
#: debian-bookworm
msgid "Sections are started with B<\\&.SH> followed by the heading name."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The only mandatory heading is NAME, which should be the first section and be "
"followed on the next line by a one-line description of the program:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "\\&.SH NAME"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "item \\e- description"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"It is extremely important that this format is followed, and that there is a "
"backslash before the single dash which follows the item name.  This syntax "
"is used by the B<mandb>(8)  program to create a database of short "
"descriptions for the B<whatis>(1)  and B<apropos>(1)  commands.  (See "
"B<lexgrog>(1)  for further details on the syntax of the NAME section.)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"For a list of other sections that might appear in a manual page, see B<man-"
"pages>(7)."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Fonts"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "The commands to select the type face are:"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.B>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Bold"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.BI>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Bold alternating with italics (especially useful for function specifications)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.BR>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Bold alternating with Roman (especially useful for referring to other manual "
"pages)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.I>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Italics"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.IB>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Italics alternating with bold"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.IR>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Italics alternating with Roman"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.RB>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Roman alternating with bold"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.RI>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Roman alternating with italics"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.SB>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Small alternating with bold"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.SM>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Small (useful for acronyms)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Traditionally, each command can have up to six arguments, but the GNU "
"implementation removes this limitation (you might still want to limit "
"yourself to 6 arguments for portability's sake).  Arguments are delimited by "
"spaces.  Double quotes can be used to specify an argument which contains "
"spaces.  For the macros that produce alternating type faces, the arguments "
"will be printed next to each other without intervening spaces, so that the "
"B<\\&.BR> command can be used to specify a word in bold followed by a mark "
"of punctuation in Roman.  If no arguments are given, the command is applied "
"to the following line of text."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Other macros and strings"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Below are other relevant macros and predefined strings.  Unless noted "
"otherwise, all macros cause a break (end the current line of text).  Many of "
"these macros set or use the \"prevailing indent\".  The \"prevailing "
"indent\" value is set by any macro with the parameter I<i> below; macros may "
"omit I<i> in which case the current prevailing indent will be used.  As a "
"result, successive indented paragraphs can use the same indent without "
"respecifying the indent value.  A normal (nonindented) paragraph resets the "
"prevailing indent value to its default value (0.5 inches).  By default, a "
"given indent is measured in ens; try to use ens or ems as units for indents, "
"since these will automatically adjust to font size changes.  The other key "
"macro definitions are:"
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Normal paragraphs"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.LP>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Same as B<\\&.PP> (begin a new paragraph)."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.P>"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.PP>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Begin a new paragraph and reset prevailing indent."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Relative margin indent"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.RS>I< i>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Start relative margin indent: moves the left margin I<i> to the right (if "
"I<i> is omitted, the prevailing indent value is used).  A new prevailing "
"indent is set to 0.5 inches.  As a result, all following paragraph(s) will "
"be indented until the corresponding B<\\&.RE>."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.RE>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"End relative margin indent and restores the previous value of the prevailing "
"indent."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Indented paragraph macros"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.HP>I< i>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Begin paragraph with a hanging indent (the first line of the paragraph is at "
"the left margin of normal paragraphs, and the rest of the paragraph's lines "
"are indented)."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.IP>I< x i>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Indented paragraph with optional hanging tag.  If the tag I<x> is omitted, "
"the entire following paragraph is indented by I<i>.  If the tag I<x> is "
"provided, it is hung at the left margin before the following indented "
"paragraph (this is just like B<\\&.TP> except the tag is included with the "
"command instead of being on the following line).  If the tag is too long, "
"the text after the tag will be moved down to the next line (text will not be "
"lost or garbled).  For bulleted lists, use this macro with \\e(bu (bullet) "
"or \\e(em (em dash)  as the tag, and for numbered lists, use the number or "
"letter followed by a period as the tag; this simplifies translation to other "
"formats."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.TP>I< i>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Begin paragraph with hanging tag.  The tag is given on the next line, but "
"its results are like those of the B<\\&.IP> command."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Hypertext link macros"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.UR>I< url>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Insert a hypertext link to the URI (URL)  I<url>, with all text up to the "
"following B<\\&.UE> macro as the link text."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.UE>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"[I<trailer>] Terminate the link text of the preceding B<\\&.UR> macro, with "
"the optional I<trailer> (if present, usually a closing parenthesis and/or "
"end-of-sentence punctuation) immediately following.  For non-HTML output "
"devices (e.g., B<man -Tutf8>), the link text is followed by the URL in angle "
"brackets; if there is no link text, the URL is printed as its own link text, "
"surrounded by angle brackets.  (Angle brackets may not be available on all "
"output devices.)  For the HTML output device, the link text is hyperlinked "
"to the URL; if there is no link text, the URL is printed as its own link "
"text."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"These macros have been supported since GNU Troff 1.20 (2009-01-05) and "
"Heirloom Doctools Troff since 160217 (2016-02-17)."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Miscellaneous macros"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.DT>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Reset tabs to default tab values (every 0.5 inches); does not cause a break."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.PD>I< d>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Set inter-paragraph vertical distance to d (if omitted, d=0.4v); does not "
"cause a break."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<\\&.SS>I< t>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Subheading I<t> (like B<\\&.SH>, but used for a subsection inside a section)."
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Predefined strings"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "The B<man> package has the following predefined strings:"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "\\e*R"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Registration Symbol: \\*R"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "\\e*S"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Change to default font size"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "\\e*(Tm"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Trademark Symbol: \\*(Tm"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "\\e*(lq"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Left angled double quote: ``"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "\\e*(rq"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Right angled double quote: ''"
msgstr ""

#. type: SS
#: debian-bookworm
#, no-wrap
msgid "Safe subset"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Although technically B<man> is a troff macro package, in reality a large "
"number of other tools process man page files that don't implement all of "
"troff's abilities.  Thus, it's best to avoid some of troff's more exotic "
"abilities where possible to permit these other tools to work correctly.  "
"Avoid using the various troff preprocessors (if you must, go ahead and use "
"B<tbl>(1), but try to use the B<IP> and B<TP> commands instead for two-"
"column tables).  Avoid using computations; most other tools can't process "
"them.  Use simple commands that are easy to translate to other formats.  The "
"following troff macros are believed to be safe (though in many cases they "
"will be ignored by translators): B<\\e\">, B<.>, B<ad>, B<bp>, B<br>, B<ce>, "
"B<de>, B<ds>, B<el>, B<ie>, B<if>, B<fi>, B<ft>, B<hy>, B<ig>, B<in>, B<na>, "
"B<ne>, B<nf>, B<nh>, B<ps>, B<so>, B<sp>, B<ti>, B<tr>."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"You may also use many troff escape sequences (those sequences beginning with "
"\\e).  When you need to include the backslash character as normal text, use "
"\\ee.  Other sequences you may use, where x or xx are any characters and N "
"is any digit, include: B<\\e\\[aq]>, B<\\e\\[ga]>, B<\\e->, B<\\e.>, "
"B<\\e\">, B<\\e%>, B<\\e*x>, B<\\e*(xx>, B<\\e(xx>, B<\\e$N>, B<\\enx>, "
"B<\\en(xx>, B<\\efx>, and B<\\ef(xx>.  Avoid using the escape sequences for "
"drawing graphics."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Do not use the optional parameter for B<bp> (break page).  Use only positive "
"values for B<sp> (vertical space).  Don't define a macro (B<de>)  with the "
"same name as a macro in this or the mdoc macro package with a different "
"meaning; it's likely that such redefinitions will be ignored.  Every "
"positive indent (B<in>)  should be paired with a matching negative indent "
"(although you should be using the B<RS> and B<RE> macros instead).  The "
"condition test (B<if,ie>)  should only have \\[aq]t\\[aq] or \\[aq]n\\[aq] "
"as the condition.  Only translations (B<tr>)  that can be ignored should be "
"used.  Font changes (B<ft> and the B<\\ef> escape sequence)  should only "
"have the values 1, 2, 3, 4, R, I, B, P, or CW (the ft command may also have "
"no parameters)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"If you use capabilities beyond these, check the results carefully on several "
"tools.  Once you've confirmed that the additional capability is safe, let "
"the maintainer of this document know about the safe command or sequence that "
"should be added to this list."
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "FILES"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "I</usr/share/groff/>[*/]I<tmac/an.tmac>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "I</usr/man/whatis>"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"By all means include full URLs (or URIs) in the text itself; some tools such "
"as B<man2html>(1)  can automatically turn them into hypertext links.  You "
"can also use the B<UR> and B<UE> macros to identify links to related "
"information.  If you include URLs, use the full URL (e.g., E<.UR http://www."
"kernel.org> E<.UE )> to ensure that tools can automatically find the URLs."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Tools processing these files should open the file and examine the first "
"nonwhitespace character.  A period (.) or single quote (\\[aq]) at the "
"beginning of a line indicates a troff-based file (such as man or mdoc).  A "
"left angle bracket (E<lt>) indicates an SGML/XML-based file (such as HTML or "
"Docbook).  Anything else suggests simple ASCII text (e.g., a \"catman\" "
"result)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Many man pages begin with B<\\[aq]\\e\"> followed by a space and a list of "
"characters, indicating how the page is to be preprocessed.  For "
"portability's sake to non-troff translators we recommend that you avoid "
"using anything other than B<tbl>(1), and Linux can detect that "
"automatically.  However, you might want to include this information so your "
"man page can be handled by other (less capable) systems.  Here are the "
"definitions of the preprocessors invoked by these characters:"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<e>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "eqn(1)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<g>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "grap(1)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<p>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "pic(1)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<r>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "refer(1)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<t>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "tbl(1)"
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<v>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "vgrind(1)"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Most of the macros describe formatting (e.g., font type and spacing) instead "
"of marking semantic content (e.g., this text is a reference to another "
"page), compared to formats like mdoc and DocBook (even HTML has more "
"semantic markings).  This situation makes it harder to vary the B<man> "
"format for different media, to make the formatting consistent for a given "
"media, and to automatically insert cross-references.  By sticking to the "
"safe subset described above, it should be easier to automate transitioning "
"to a different reference page format in the future."
msgstr ""

#.  .SH AUTHORS
#.  .IP \[em] 3m
#.  James Clark (jjc@jclark.com) wrote the implementation of the macro package.
#.  .IP \[em]
#.  Rickard E. Faith (faith@cs.unc.edu) wrote the initial version of
#.  this manual page.
#.  .IP \[em]
#.  Jens Schweikhardt (schweikh@noc.fdn.de) wrote the Linux Man-Page Mini-HOWTO
#.  (which influenced this manual page).
#.  .IP \[em]
#.  David A. Wheeler (dwheeler@ida.org) heavily modified this
#.  manual page, such as adding detailed information on sections and macros.
#. type: Plain text
#: debian-bookworm
msgid "The Sun macro B<TX> is not implemented."
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"B<apropos>(1), B<groff>(1), B<lexgrog>(1), B<man>(1), B<man2html>(1), "
"B<groff_mdoc>(7), B<whatis>(1), B<groff_man>(7), B<groff_www>(7), B<man-"
"pages>(7), B<mdoc>(7)"
msgstr ""