# 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: 2024-06-12 10:57+0200\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=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: SY #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "groff" msgstr "" #. type: TH #: archlinux #, no-wrap msgid "13 September 2023" msgstr "" #. type: TH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff 1.23.0" msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Name" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "groff - front end to the GNU I document formatting system" msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Synopsis" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "[B<-abcCeEgGijklNpRsStUVXzZ>] [B<-d\\ >I] [B<-d\\ " ">IB<=>I] [B<-D\\ >I] [B<-f\\ >I] [B<-F\\ >I] [B<-I\\ >I] [B<-" "K\\ >I] [B<-L\\ >I] [B<-m\\ >I] [B<-M\\ >I] [B<-n\\ >I] [B<-o\\ " ">I] [B<-P\\ >I] [B<-r\\ >I] [B<-r\\ >IB<=>I] [B<-T\\ " ">I] [B<-w\\ >I] [B<-W\\ >I] [I.\\|.\\|.]" msgstr "" #. #-#-#-#-# archlinux: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# debian-bookworm: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# debian-unstable: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# fedora-40: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# fedora-rawhide: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# mageia-cauldron: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-leap-15-6: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-tumbleweed: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-h>" msgstr "" #. #-#-#-#-# archlinux: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# debian-bookworm: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# debian-unstable: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# fedora-40: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# fedora-rawhide: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #. #-#-#-#-# mageia-cauldron: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# opensuse-leap-15-6: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# opensuse-tumbleweed: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<--help>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "B<-v> [I.\\|.\\|.\\&] [I.\\|.\\|.]" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "B<--version> [I.\\|.\\|.\\&] [I.\\|.\\|.]" msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Description" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I is the primary front end to the GNU I document formatting " "system." msgstr "" #. BEGIN Keep parallel with groff.texi node "What Is groff?". #. This language is slightly expanded from that in the "ANNOUNCE" file #. and on the groff home page. #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I is a typesetting system that reads plain text input files that " "include formatting commands to produce output in PostScript, PDF, HTML, DVI, " "or other formats, or for display to a terminal." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Formatting commands can be low-level typesetting primitives, macros from a " "supplied package, or user-defined macros." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "All three approaches can be combined." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If no I operands are specified, or if I is \\[lq]B<->\\[rq], " "I reads the standard input stream." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A reimplementation and extension of the typesetter from AT&T Unix, I " "is present on most POSIX systems owing to its long association with Unix " "manuals (including man pages)." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It and its predecessor are notable for their production of several best-" "selling software engineering texts." msgstr "" #. END Keep parallel with groff.texi node "What Is groff?". #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I is capable of producing typographically sophisticated documents " "while consuming minimal system resources." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The I command orchestrates the execution of preprocessors, the " "transformation of input documents into a device-independent page description " "language, and the production of output from that language." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Options" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "B<-h> and B<--help> display a usage message and exit." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Because I is intended to subsume most users' direct invocations of " "the E<.MR \\%troff 1> formatter, the two programs share a set of options." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "However, I has some options that I<\\%troff> does not share, and " "others which I interprets differently." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "At the same time, not all valid I<\\%troff> options can be given to I." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\f[I]groff\\fB-specific options" msgstr "" #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The following options either do not exist in GNU I or are interpreted " "differently by I." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-D\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Set fallback input encoding used by E<.MR preconv 1> to I; implies B<-" "k>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-e>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%eqn 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-g>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%grn 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-G>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR grap 1> preprocessor; implies B<-p>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-I\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Works as I<\\%troff>'s option (see below), but also implies B<-g> and B<-s>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It is passed to E<.MR \\%soelim 1> and the output driver, and I<\\%grn> is " "passed an B<-M> option with I as its argument." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-j>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%chem 1> preprocessor; implies B<-p>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-k>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR preconv 1> preprocessor." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Refer to its man page for its behavior if neither of I's B<-K> or B<-" "D> options is also specified." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-K\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Set input encoding used by E<.MR preconv 1> to I; implies B<-k>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-l>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Send the output to a spooler program for printing." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The \\[lq]B\\[rq] directive in the device description file specifies " "the default command to be used; see E<.MR groff_font 5 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "If no such directive is present for the output device," msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "See options B<-L> and B<-X>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-L\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Pass I to the print spooler program." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If multiple Is are required, pass each with a separate B<-L> option." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I does not prefix an option dash to I before passing it to the " "spooler program." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-M>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Works as I<\\%troff>'s option (see below), but is also passed to E<.MR \\" "%eqn 1 ,> E<.MR grap 1 ,> and E<.MR \\%grn 1 .>" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-N>" msgstr "" #. language #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Prohibit newlines between I delimiters: pass B<-N> to E<.MR \\%eqn 1 .>" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-p>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%pic 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-P\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Pass I to the postprocessor." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If multiple Is are required, pass each with a separate B<-P> option." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I does not prefix an option dash to I before passing it to the " "postprocessor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-R>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%refer 1> preprocessor." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "No mechanism is provided for passing arguments to I<\\%refer> because most " "I<\\%refer> options have equivalent language elements that can be specified " "within the document." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-s>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%soelim 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-S>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Operate in \\[lq]safer\\[rq] mode; see B<-U> below for its opposite." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "For security reasons, safer mode is enabled by default." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-t>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Run E<.MR \\%tbl 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-T\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Direct I<\\%troff> to format the input for the output device I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I then calls an output driver to convert I<\\%troff>'s output to a " "form appropriate for I; see subsection \\[lq]Output devices\\[rq] below." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-U>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Operate in unsafe mode: pass the B<-U> option to I<\\%pic> and I<\\%troff>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-v>" msgstr "" #. type: TQ #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<--version>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Write version information for I and all programs run by it to the " "standard output stream; that is, the given command line is processed in the " "usual way, passing B<-v> to the formatter and any pre- or postprocessors " "invoked." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-V>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Output the pipeline that I would run to the standard output stream, " "but do not execute it." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "If given more than once, I both writes and runs the pipeline." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-X>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Use E<.MR gxditview 1> instead of the usual postprocessor to (pre)view a " "document on an X11 display." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Combining this option with B<-Tps> uses the font metrics of the PostScript " "device, whereas the B<-TX75> and B<-TX100> options use the metrics of X11 " "fonts." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-Z>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Disable postprocessing." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I<\\%troff> output will appear on the standard output stream (unless " "suppressed with B<-z>); see E<.MR groff_out 5> for a description of this " "format." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Transparent options" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The following options are passed as-is to the formatter program E<.MR \\" "%troff 1> and described in more detail in its man page." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-a>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Generate a plain text approximation of the typeset output." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-b>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Write a backtrace to the standard error stream on each error or warning." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-c>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Start with color output disabled." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-C>" msgstr "" #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Enable AT&T I compatibility mode; implies B<-c>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-d\\ >I" msgstr "" #. type: TQ #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-d\\ >IB<=>I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Define string." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-E>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Inhibit I<\\%troff> error messages; implies B<-Ww>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-f\\ >I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Set default font family." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-F\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Search in directory I for the selected output device's directory of " "device and font description files." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-i>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Process standard input after the specified input files." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Search I for input files." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-m\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Process nameI<.tmac> before input files." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-M\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Search directory I for macro files." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-n\\ >I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Number the first page I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-o\\ >I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Output only pages in I." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-r\\ >I" msgstr "" #. type: TQ #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B<-r\\ >IB<=>I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Define register." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-w\\ >I" msgstr "" #. #-#-#-#-# archlinux: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# debian-bookworm: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# debian-unstable: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# fedora-40: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# fedora-rawhide: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# mageia-cauldron: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-leap-15-6: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-tumbleweed: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-W\\ >I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Enable (B<-w>) or inhibit (B<-W>) emission of warnings in category I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<-z>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Suppress formatted device-independent output of I<\\%troff>." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Usage" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The architecture of the GNU I system follows that of other device-" "independent I implementations, comprising preprocessors, macro " "packages, output drivers (or \\[lq]postprocessors\\[rq]), a suite of " "utilities, and the formatter I<\\%troff> at its heart." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "See E<.MR roff 7> for a survey of how a I system works." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The front end programs available in the GNU I system make it easier to " "use than traditional Is that required the construction of pipelines or " "use of temporary files to carry a source document from maintainable form to " "device-ready output." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The discussion below summarizes the constituent parts of the GNU I " "system." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It complements E<.MR roff 7> with I-specific information." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Getting started" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Those who prefer to learn by experimenting or are desirous of rapid feedback " "from the system may wish to start with a \\[lq]Hello, world!\\&\\[rq] " "document." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "$ B\n" "Hello, world!\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "We used a I command only to eliminate the 65 blank lines that would " "otherwise flood the terminal screen." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "(I systems were developed in the days of paper-based terminals with 66 " "lines to a page.)" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Today's users may prefer output to a UTF-8-capable terminal." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "$ B\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Producing PDF, HTML, or \\*[TeX]'s DVI is also straightforward." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "The hard part may be selecting a viewer program for the output." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "$ B hello.pdf>\n" "$ B\n" "$ B hello.html>\n" "$ B\n" "$ B hello.dvi>\n" "$ B\n" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Using \\f[I]groff\\fB as a REPL" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Those with a programmer's bent may be pleased to know that they can use " "I in a read-evaluate-print loop (REPL)." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Doing so can be handy to verify one's understanding of the formatter's " "behavior and/or the syntax it accepts." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Turning on all warnings with B<-ww> can aid this goal." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "$ B\n" "B<\\[rs]# This is a comment. Let\\[aq]s define a register.>\n" "B<.nr a 1>\n" "B<\\[rs]# Do integer arithmetic with operators evaluated left-to-right.>\n" "B<.nr b \\[rs]n[a]+5/2>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "B<\\[rs]# Let\\[aq]s get the result on the standard error stream.>\n" "B<.tm \\[rs]n[b]>\n" "3\n" "B<\\[rs]# Now we\\[aq]ll define a string.>\n" "B<.ds name Leslie\\[rs]\" This is another form of comment.>\n" "B<.nr b (\\[rs]n[a] + (7/2))>\n" "B<\\[rs]# Center the next two text input lines.>\n" "B<.ce 2>\n" "B\n" "B\n" "B<\\[rs]# We will see that the division rounded toward zero.>\n" "B\n" "B<\\[rs]# Here\\[aq]s an if-else control structure.>\n" "B<.ie (\\[rs]n[b] % 2) odd.>\n" "B<.el even.>\n" "B<\\[rs]# This trick sets the page length to the current vertical>\n" "B<\\[rs]# position, so that blank lines don\\[aq]t spew when we\\[aq]re done.>\n" "B<.pl \\[rs]n[nl]u>\n" "IControl-DE>\n" " Hi, Leslie.\n" " Your secret number is 4.\n" "It is even.\n" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Paper format" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "In GNU I, the page dimensions for the formatter I<\\%troff> and for " "output devices are handled separately." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "In the formatter, requests are used to set the page length (B<.pl>), page " "offset (or left margin, B<.po>), and line length (B<.ll>)." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The right margin is not explicitly configured; the combination of page " "offset and line length provides the information necessary to derive it." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The I macro package, automatically loaded by I<\\%troff>, " "provides an interface for configuring page dimensions by convenient names, " "like \\[lq]letter\\[rq] or \\[lq]A4\\[rq]; see E<.MR groff_tmac 5 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable msgid "The formatter's default in this installation is \\[lq]B<\\%A4>\\[rq]." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It is up to each macro package to respect the page dimensions configured in " "this way." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Some offer alternative mechanisms." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "For each output device, the size of the output medium can be set in its " "I file." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Most output drivers also recognize a command-line option B<-p> to override " "the default dimensions and an option B<-l> to use landscape orientation." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "See E<.MR groff_font 5> for a description of the B directive, " "which takes an argument of the same form as B<-p>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The output driver's man page, such as E<.MR grops 1 ,> may also be helpful." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I uses the command-line option B<-P> to pass options to output " "devices; for example, use the following for PostScript output on A4 paper in " "landscape orientation." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms E foo.ps\n" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Front end" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "The I program is a wrapper around the E<.MR \\%troff 1> program." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It allows one to specify preprocessors via command-line options and " "automatically runs the appropriate postprocessor for the selected output " "device." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Doing so, the manual construction of pipelines or management of temporary " "files required of users of traditional E<.MR roff 7> systems can be avoided." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Use the E<.MR grog 1> program to infer an appropriate I command line " "to format a document." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Language" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Input to a I system is in plain text interleaved with control lines " "and escape sequences." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The combination constitutes a document in one of a family of languages we " "also call I; see E<.MR roff 7> for background." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "An overview of GNU I language syntax and features, including lists of " "all supported escape sequences, requests, and predefined registers, can be " "found in E<.MR groff 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I extensions to the AT&T I language, a common subset of " "I dialects extant today, are detailed in E<.MR groff_diff 7 .>" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Preprocessors" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A preprocessor interprets a domain-specific language that produces I " "language output." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Frequently, such input is confined to sections or regions of a I input " "file (bracketed with macro calls specific to each preprocessor), which it " "replaces." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Preprocessors therefore often interpret a subset of I syntax along " "with their own language." msgstr "" #. AT&T #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I provides reimplementations of most preprocessors familiar to " "users of AT&T I; these routinely have extended features and/or " "require GNU I to format their output." msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%tbl" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "lays out tables;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%eqn" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "typesets mathematics;" msgstr "" #. Keep the .PF line below the \%pic line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%pic" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "draws diagrams;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%refer" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "processes bibliographic references;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%soelim" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "preprocesses \\[lq]sourced\\[rq] input files;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%grn" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "renders\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".MR gremlin 1\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "diagrams;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%chem" msgstr "" #. generic #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "draws chemical structural formul\\[ae]\n" "using\n" "I;" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "gperl" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "populates\n" "I\n" "registers and strings using\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".MR perl 1 ;\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "glilypond" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" "embeds\n" "I\n" "sheet music;\n" "and" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "gpinyin" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "eases Mandarin Chinese input using Hanyu Pinyin." msgstr "" #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A preprocessor unique to GNU I is E<.MR preconv 1 ,> which converts " "various input encodings to something GNU I can understand." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "When used, it is run before any other preprocessors." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Most preprocessors enclose content between a pair of characteristic tokens." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Such a token must occur at the beginning of an input line and use the dot " "control character." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Spaces and tabs must not follow the control character or precede the end of " "the input line." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Deviating from these rules defeats a token's recognition by the preprocessor." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Tokens are generally preserved in preprocessor output and interpreted as " "macro calls subsequently by I<\\%troff>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "The I<\\%ideal> preprocessor is not yet available in I." msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "preprocessor" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "starting token" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "ending token" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "=" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".cstart" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".cend" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".EQ" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".EN" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grap" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".G1" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".G2" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".GS" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".GE" msgstr "" #. Keep the .IF line below the \%ideal line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%ideal" msgstr "" #. Keep the .IF line below the \%ideal line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".IS" msgstr "" #. Keep the .IF line below the \%ideal line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".IE" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".IF" msgstr "" #. Keep the .PF line below the \%pic line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".PS" msgstr "" #. Keep the .PF line below the \%pic line. #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".PE" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".PF" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".PY" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".R1" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".R2" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".TS" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".TE" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "_" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".lilypond start" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".lilypond stop" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".Perl start" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".Perl stop" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".pinyin start" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid ".pinyin stop" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Macro packages" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Macro files are I input files designed to produce no output themselves " "but instead ease the preparation of other I documents." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "When a macro file is installed at a standard location and suitable for use " "by a general audience, it is termed a I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Macro packages can be loaded prior to any I input documents with the " "B<-m>\\ option." msgstr "" #. AT&T #. exceptions: mpm, mv #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The GNU I system implements most well-known macro packages for AT&T " "I in a compatible way and extends them." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "These have one- or two-letter names arising from intense practices of naming " "economy in early Unix culture, a laconic approach that led to many of the " "packages being identified in general usage with the I and I " "option letter used to invoke them, sometimes to punning effect, as with " "\\[lq]man\\[rq] (short for \\[lq]manual\\[rq]), and even with the option " "dash, as in the case of the I package, much better known as I or even " "I<-ms>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Macro packages serve a variety of purposes." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Some are \\[lq]full-service\\[rq] packages, adopting responsibility for page " "layout among other fundamental tasks, and defining their own lexicon of " "macros for document composition; each such package stands alone and a given " "document can use at most one." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "is used to compose man pages in the format originating in Version\\ 7 Unix " "(1979); see E<.MR groff_man 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<-man>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "is used to compose man pages in the format originating in 4.3BSD-Reno " "(1990); see E<.MR groff_mdoc 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<-mdoc>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "is the Berkeley general-purpose macro suite, developed as an alternative to " "AT&T's I; see E<.MR groff_me 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<-me>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "implements the format used by the second-generation AT&T macro suite for " "general documents, a successor to I; see E<.MR groff_mm 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<-mm>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "(invariably called \\[lq]mom\\[rq]) is a modern package written by Peter " "Schaffter specifically for GNU I." msgstr "" #. type: Plain text #: archlinux msgid "" "Consult the E<.UR file://\\:/usr/\\:\\%share/\\:\\%doc/\\:\\%groff-1.23.0/\\:" "\\%html/\\:mom/\\:toc\\:.html> I HTML manual E<.UE> for extensive " "documentation." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "She\\[em]for I takes the female pronoun\\[em]can be specified on the " "command line as B<-mom>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "is the original AT&T general-purpose document format; see E<.MR groff_ms 7 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<-ms>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Others are supplemental." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "For instance," msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I<\\%andoc> is a wrapper package specific to GNU I that recognizes " "whether a document uses I or I format and loads the corresponding " "macro package." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "It can be specified on the command line as B<\\%-mandoc>." msgstr "" #. such as man-db, since 2001 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A E<.MR man 1> librarian program may use this macro file to delegate loading " "of the correct macro package; it is thus unnecessary for I itself to " "scan the contents of a document to decide the issue." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Many macro files augment the function of the full-service packages, or of " "I documents that do not employ such a package\\[em]the latter are " "sometimes characterized as \\[lq]raw\\[rq]." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "These auxiliary packages are described, along with details of macro file " "naming and placement, in E<.MR groff_tmac 5 .>" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Formatters" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The formatter, the program that interprets I language input, is E<.MR " "\\%troff 1 .>" msgstr "" #. AT&T #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It provides the features of the AT&T I and I programs as well " "as many extensions." msgstr "" #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The command-line option B<-C> switches I<\\%troff> into I, which tries to emulate AT&T I as closely as is practical to " "enable the formatting of documents written for the older system." msgstr "" #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A shell script, E<.MR \\%nroff 1 ,> emulates the behavior of AT&T I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "It attempts to correctly encode the output based on the locale, relieving " "the user of the need to specify an output device with the B<-T> option and " "is therefore convenient for use with terminal output devices, described in " "the next subsection." msgstr "" #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I generates output in a device-independent, but not device-" "agnostic, page description language detailed in E<.MR groff_out 5 .>" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Output devices" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I<\\%troff> output is formatted for a particular I, typically " "specified by the B<-T> option to the formatter or a front end." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If neither this option nor the I<\\%GROFF_TYPESETTER> environment variable " "is used, the default output device is B<\\%ps>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "An output device may be any of the following." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for terminals using the ISO 646 1991:IRV character set and encoding, also " "known as US-ASCII." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for terminals using the IBM code page 1047 character set and encoding." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for TeX DVI format." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. #-#-#-#-# archlinux: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# debian-bookworm: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# debian-unstable: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# fedora-40: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# fedora-rawhide: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #. #-#-#-#-# mageia-cauldron: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-leap-15-6: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TP #. #-#-#-#-# opensuse-tumbleweed: groff.1.pot (PACKAGE VERSION) #-#-#-#-# #. type: TQ #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for HTML and XHTML output, respectively." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for terminals using the ISO Latin-1 (ISO 8859-1) character set and encoding." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for Canon CaPSL printers (LBP-4 and LBP-8 series laser printers)." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for HP LaserJet4-compatible (or other PCL5-compatible) printers." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for PDF output." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "for PostScript output." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for terminals using the ISO 10646 (\\[lq]Unicode\\[rq]) character set in " "UTF-8 encoding." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for previewing with I<\\%gxditview> using 75 dpi resolution and a 10-point " "base type size." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for previewing with I<\\%gxditview> using 75 dpi resolution and a 12-point " "base type size." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for previewing with I<\\%gxditview> using 100 dpi resolution and a 10-point " "base type size." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "for previewing with I<\\%gxditview> using 100 dpi resolution and a 12-point " "base type size." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Postprocessors" msgstr "" #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Any program that interprets the output of GNU I is a postprocessor." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The postprocessors provided by GNU I are I, which " "prepare a document for viewing or printing." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Postprocessors for other purposes, such as page resequencing or statistical " "measurement of a document, are conceivable." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "An output driver supports one or more output devices, each with its own " "device description file." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A device determines its postprocessor with the B directive in its " "device description file; see E<.MR groff_font 5 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The B<-X> option overrides this selection, causing I<\\%gxditview> to serve " "as the output driver." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grodvi 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grohtml 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B and B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grolbp 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grolj4 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "gropdf 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grops 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grotty 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "provides B, B, B, and B." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "gxditview 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "provides B, B, B, and B, and additionally can " "preview B." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Utilities" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "GNU I includes a suite of utilities." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "gdiffmk 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "marks differences between a pair of I input files." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grog 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "infers the I command a document requires." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Several utilities prepare descriptions of fonts, enabling the formatter to " "use them when producing output for a given device." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "addftinfo 1" msgstr "" #. AT&T #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "adds information to AT&T I font description files to enable their use " "with GNU I." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "afmtodit 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "creates font description files for PostScript Type\\ 1 fonts." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "pfbtops 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "translates a PostScript Type\\ 1 font in PFB (Printer Font Binary) format " "to PFA (Printer Font ASCII), which can then be interpreted by I<\\%afmtodit>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "hpftodit 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "creates font description files for the HP LaserJet\\ 4 family of printers." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "tfmtodit 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "creates font description files for the TeX DVI device." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "xtotroff 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "creates font description files for X Window System core fonts." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A trio of tools transform material constructed using I preprocessor " "languages into graphical image files." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "eqn2graph 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "converts an I equation into a cropped image." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "grap2graph 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "converts a I diagram into a cropped image." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "pic2graph 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "converts a I diagram into a cropped image." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Another set of programs works with the bibliographic data files used by the " "E<.MR refer 1> preprocessor." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%indxbib 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "makes inverted indices for bibliographic databases, speeding lookup " "operations on them." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "lkbib 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "searches the databases." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%lookbib 1" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "interactively searches the databases." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Exit status" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I exits with a failure status if there was a problem parsing its " "arguments and a successful status if either of the options B<-h> or B<--" "help> was specified." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Otherwise, I runs a pipeline to process its input; if all commands " "within the pipeline exit successfully, I does likewise." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If not, I's exit status encodes a summary of problems encountered, " "setting bit\\ 0 if a command exited with a failure status, bit\\ 1 if a " "command was terminated with a signal, and bit\\ 2 if a command could not be " "executed." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "(Thus, if all three misfortunes befell one's pipeline, I would exit " "with status 2\\[ha]0 + 2\\[ha]1 + 2\\[ha]2 = 1+2+4 = 7.)" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "To troubleshoot pipeline problems, you may wish to re-run the I " "command with the B<-V> option and break the reported pipeline down into " "separate stages, inspecting the exit status of and diagnostic messages " "emitted by each command." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Environment" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Normally, the path separator in environment variables ending with I is " "the colon; this may vary depending on the operating system." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "For example, Windows uses a semicolon instead." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "This search path, followed by I, is used to locate commands executed " "by I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If it is not set, the installation directory of the GNU I executables, " "I, is searched before I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I can be configured at compile time to apply a prefix to the names " "of the programs it provides that had a counterpart in AT&T I, so that " "name collisions are avoided at run time." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "The default prefix is empty." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "When used, this prefix is conventionally the letter \\[lq]g\\[rq]." msgstr "" #. GNU #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "For example, GNU I would be installed as I." msgstr "" #. GNU #. GNU #. generic #. generic #. generic #. generic #. generic #. generic #. generic #. generic #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Besides I, the prefix applies to the formatter I; the " "preprocessors I, I, I, I<\\%refer>, I, and I<\\%soelim>; " "and the utilities I<\\%indxbib> and I<\\%lookbib>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The value of this variable is passed to the I(1) preprocessor's B<-" "e> option to select the character encoding of input files." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "This variable's existence implies the I option B<-k>." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "If set but empty, I calls I without an B<-e> option." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "I's B<-K> option overrides I<\\%GROFF_ENCODING>." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Seek the selected output device's directory of device and font description " "files in this list of directories." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "See E<.MR \\%troff 1> and E<.MR groff_font 5 .>" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Seek macro files in this list of directories." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "See E<.MR \\%troff 1> and E<.MR groff_tmac 5 .>" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Create temporary files in this directory." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "If not set, but the environment variable I<\\%TMPDIR> is set, temporary " "files are created there instead." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "On Windows systems, if neither of the foregoing are set, the environment " "variables I and I (in that order) are checked also." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Otherwise, temporary files are created in I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The E<.MR \\%refer 1 ,> E<.MR grohtml 1 ,> and E<.MR grops 1> commands use " "temporary files." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Set the default output device." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "If empty or not set, B<\\%ps> is used." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "The B<-T> option overrides I<\\%GROFF_TYPESETTER>." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A time stamp (expressed as seconds since the Unix epoch) to use as the " "output creation time stamp in place of the current time." msgstr "" #. type: Plain text #: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The time is converted to human-readable form using E<.MR localtime 3> when " "the formatter starts up and stored in registers usable by documents and " "macro packages." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The time zone to use when converting the current time (or value of " "I) to human-readable form; see E<.MR tzset 3 .>" msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Examples" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "I systems are best known for formatting man pages." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Once a E<.MR man 1> librarian program has located a man page, it may execute " "a I command much like the following." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff -t -man -Tutf8 /usr/share/man/man1/groff.1\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The librarian will also pipe the output through a pager, which might not " "interpret the SGR terminal escape sequences I emits for boldface, " "underlining, or italics; see section \\[lq]Limitations\\[rq] below." msgstr "" #. AT&T #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "To process a I input file using the preprocessors I<\\%tbl> and I<\\" "%pic> and the I macro package in the way to which AT&T I users " "were accustomed, one would type (or script) a pipeline." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\%pic foo.me | \\%tbl | \\%troff -me -Tutf8 | grotty\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Using I, this pipe can be shortened to an equivalent command." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff -p -t -me -T utf8 foo.me\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "An even easier way to do this is to use E<.MR grog 1> to guess the " "preprocessor and macro options and execute the result by using the command " "substitution feature of the shell." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "$(grog -Tutf8 foo.me)\n" msgstr "" #. No GNU roff postprocessor uses long options for anything except #. --help or --version. #. or #. .RB \[lq] \-\- \[rq] #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Each command-line option to a postprocessor must be specified with any " "required leading dashes \\[lq]B<->\\[rq] because I passes the " "arguments as-is to the postprocessor; this permits arbitrary arguments to be " "transmitted." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "For example, to pass a title to the I postprocessor, the shell " "commands" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff -X -P -title -P \\[aq]trial run\\[aq] mydoc.t\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "and" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "groff -X -Z mydoc.t | gxditview -title \\[aq]trial run\\[aq] -\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "are equivalent." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Limitations" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "When paging output for the B, B, B, and B " "devices, programs like E<.MR more 1> and E<.MR less 1> may require command-" "line options to correctly handle some terminal escape sequences; see E<.MR " "grotty 1 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "On EBCDIC hosts such as OS/390 Unix, the output devices B and " "B aren't available." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Conversely, the output device B is not available on systems based on " "the ISO\\ 646 or ISO\\ 8859 character encoding standards." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Installation directories" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "GNU I installs files in varying locations depending on its compile-" "time configuration." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "On this installation, the following locations are used." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Directory containing I's executable commands." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "List of common words for E<.MR indxbib 1 .>" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Directory for data files." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "Default index for E<.MR lkbib 1> and E<.MR refer 1 .>" msgstr "" #. type: TP #: archlinux #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Documentation directory." msgstr "" #. type: TP #: archlinux #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Example directory." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Font directory." msgstr "" #. type: TP #: archlinux #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "HTML documentation directory." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Legacy font directory." msgstr "" #. type: TP #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Local font directory." msgstr "" #. type: TP #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Local macro package (I file) directory." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Macro package (I file) directory." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Font directory for compatibility with old versions of I; see E<.MR " "grops 1 .>" msgstr "" #. type: TP #: archlinux #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "PDF documentation directory." msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\f[I]groff\\fB macro directory" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Most macro files supplied with GNU I are stored in I for the installation corresponding to " "this document." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "As a rule, multiple directories are searched for macro files; see E<.MR \\" "%troff 1 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "For a catalog of macro files GNU I provides, see E<.MR groff_tmac 5 .>" msgstr "" #. ==================================================================== #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\f[I]groff\\fB device and font description directory" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Device and font description files supplied with GNU I are stored in I for the installation " "corresponding to this document." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "As a rule, multiple directories are searched for device and font description " "files; see E<.MR \\%troff 1 .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "For the formats of these files, see E<.MR groff_font 5 .>" msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Availability" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Obtain links to I releases for download, its source repository, " "discussion mailing lists, a support ticket tracker, and further information " "from the E<.UR http://\\:www\\:.gnu\\:.org/\\:software/\\:groff> I " "page of the GNU website E<.UE .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "A free implementation of the I preprocessor, written by E<.MT faber@\\:" "lunabase\\:.org> Ted Faber E<.ME ,> can be found at the E<.UR http://\\:" "www\\:.lunabase\\:.org/\\:\\[ti]faber/\\:Vault/\\:software/\\:grap/> I " "website E<.UE .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "I supports only this I." msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Authors" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "I (both the front-end command and the overall system) was primarily " "written by E<.MT jjc@\\:jclark\\:.com> James Clark E<.ME .>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "Contributors to this document include Clark, Trent A.\\& Fisher, E<.MT " "wl@gnu.org> Werner Lemberg E<.ME ,> E<.MT groff-bernd.warken-72@\\:web\\:." "de> Bernd Warken E<.ME ,> and E<.MT g.branden\\:.robinson@\\:gmail\\:.com> G." "\\& Branden Robinson E<.ME .>" msgstr "" #. ==================================================================== #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "See also" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "I, by Trent A.\\& Fisher and Werner " "Lemberg, is the primary I manual." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "You can browse it interactively with \\[lq]info groff\\[rq]." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Introduction, history, and further reading:" msgstr "" #. #23 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR roff 7 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Viewer for\\ I\\ (and AT&T device-independent\\ I)\\ documents:" msgstr "" #. #33 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR gxditview 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Preprocessors:" msgstr "" #. #1 #. #34 #. #35 #. #4 #. #36 #. #38 #. #5 #. #37 #. #6 #. #39 #. #40 #. #41 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "E<.MR \\%chem 1 , > E<.MR \\%eqn 1 , > E<.MR \\%neqn 1 , > E<.MR glilypond " "1 , > E<.MR \\%grn 1 , > E<.MR preconv 1 , > E<.MR gperl 1 , > E<.MR \\%pic " "1 , > E<.MR gpinyin 1 , > E<.MR \\%refer 1 , > E<.MR \\%soelim 1 , > E<.MR \\" "%tbl 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Macro packages and package-specific utilities:" msgstr "" #. #9 #. #55a #. #55b #. #56 #. #57 #. # 10 #. # 11 #. #12 #. #13 #. #30 #. #58 #. 16 #. #59 #. #60 #. type: Plain text #: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "E<.MR groff_hdtbl 7 , > E<.MR groff_man 7 , > E<.MR groff_man_style 7 , > E<." "MR groff_mdoc 7 , > E<.MR groff_me 7 , > E<.MR groff_mm 7 , > E<.MR " "groff_mmse 7 , > E<.MR mmroff 1 , > E<.MR groff_mom 7 , > E<.MR pdfmom 1 , > " "E<.MR groff_ms 7 , > E<.MR groff_rfc1345 7 , > E<.MR groff_trace 7 , > E<.MR " "groff_www 7 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Bibliographic database management tools:" msgstr "" #. #49 #. #50 #. #51 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR \\%indxbib 1 , > E<.MR lkbib 1 , > E<.MR \\%lookbib 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Language, conventions, and GNU extensions:" msgstr "" #. #17 #. #18 #. #19 #. #20 #. #22 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "E<.MR groff 7 , > E<.MR groff_char 7 , > E<.MR groff_diff 7 , > E<.MR " "groff_font 5 , > E<.MR groff_tmac 5 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Intermediate output language:" msgstr "" #. #21 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR groff_out 5 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Formatter program:" msgstr "" #. #45 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR \\%troff 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Formatter wrappers:" msgstr "" #. #44 #. #14 #. .MR groff 1 , \" 42 -- this page #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR \\%nroff 1 , > E<.MR pdfroff 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Postprocessors for output devices:" msgstr "" #. #24 #. #25 #. #26 #. #27 #. #29 #. #31 #. #32 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "E<.MR grodvi 1 , > E<.MR grohtml 1 , > E<.MR grolbp 1 , > E<.MR grolj4 1 , > " "E<.MR gropdf 1 , > E<.MR grops 1 , > E<.MR grotty 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Font support utilities:" msgstr "" #. #46 #. #47 #. #48 #. #52 #. #53 #. #54 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "E<.MR addftinfo 1 , > E<.MR afmtodit 1 , > E<.MR hpftodit 1 , > E<.MR " "pfbtops 1 , > E<.MR tfmtodit 1 , > E<.MR xtotroff 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Graphics conversion utilities:" msgstr "" #. #2 #. #7 #. #15 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR eqn2graph 1 , > E<.MR grap2graph 1 , > E<.MR pic2graph 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "Difference-marking utility:" msgstr "" #. #3 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR gdiffmk 1 >" msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "\\[lq]groff guess\\[rq] utility:" msgstr "" #. #43 #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed msgid "E<.MR grog 1 >" msgstr "" #. type: TH #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "GROFF" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "7 March 2023" msgstr "" #. type: TH #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "groff 1.22.4" msgstr "" #. type: SH #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: debian-bookworm mageia-cauldron opensuse-leap-15-6 msgid "groff - front-end for the groff document formatting system" msgstr "" #. ==================================================================== #. type: SH #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-abcegijklpstzCEGNRSUVXZ" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-d" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "cs" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-D" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "arg" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-f" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "fam" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-F" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "dir" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-I" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-K" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-L" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-m" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "name" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-M" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-n" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "num" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-o" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "list" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-P" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-r" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "cn" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-T" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "dev" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-w" msgstr "" #. type: OP #: debian-bookworm mageia-cauldron opensuse-leap-15-6 #, no-wrap msgid "-W" msgstr "" #. type: Plain text #: debian-bookworm mageia-cauldron opensuse-leap-15-6 msgid "[I \\&.\\|.\\|.\\&]" msgstr "" #. type: Plain text #: debian-bookworm mageia-cauldron opensuse-leap-15-6 msgid "B<-v> [I