gnroff(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

gnroff(1)

gnroff(1)                   General Commands Manual                  gnroff(1)

Name
       gnroff - format documents with groff for TTY (terminal) devices

Synopsis
       gnroff [-bcCEhikpRStUVz] [-d ctext] [-d string=text] [-K fallback-
              encoding] [-m macro-package] [-M macro-directory] [-n page-
              number] [-o page-list] [-P postprocessor-argument] [-r cnumeric-
              expression] [-r register=numeric-expression] [-T output-device]
              [-w warning-category] [-W warning-category] [file ...]

       gnroff --help

       gnroff -v
       gnroff --version

Description
       gnroff  formats  documents  written  in the groff(7) language for type‐
       writer-like devices such as terminal emulators.  GNU nroff emulates the
       AT&T  nroff  command  using  groff(1).   gnroff  generates  output  via
       grotty(1),  groff's  terminal  output  driver,  which needs to know the
       character encoding scheme used by the device.  Consequently, acceptable
       arguments to the -T option are ascii, latin1,  utf8,  and  cp1047;  any
       others  are ignored.  If neither the GROFF_TYPESETTER environment vari‐
       able nor the -T command-line option (which  overrides  the  environment
       variable) specifies a (valid) device, gnroff consults the locale to se‐
       lect  an  appropriate output device.  It first tries the locale(1) pro‐
       gram, then checks several  locale-related  environment  variables;  see
       section  “Environment” below.  If all of the foregoing fail, -Tascii is
       implied.

       The -b, -c, -C, -d, -E, -i, -m, -M, -n, -o, -r, -U, -w, -W, and -z  op‐
       tions  have  the effects described in troff(1).  -c and -h imply “-P-c”
       and “-P-h”, respectively; -c is also interpreted directly by troff.  In
       addition, this implementation ignores the AT&T nroff  options  -e,  -q,
       and  -s  (which are not implemented in groff).  The options -k, -K, -p,
       -P, -R, -t, and -S are documented in groff(1).   -V  causes  gnroff  to
       display  the  constructed  groff command on the standard output stream,
       but does not execute it.  -v and  --version  show  version  information
       about  gnroff  and  the programs it runs, while --help displays a usage
       message; all exit afterward.

Exit status
       gnroff exits with error status 2 if there was a problem parsing its ar‐
       guments, with status 0 if any of the  options  -V,  -v,  --version,  or
       --help were specified, and with the status of groff otherwise.

Environment
       Normally,  the path separator in environment variables ending with PATH
       is the colon; this may vary depending on the operating system.  For ex‐
       ample, Windows uses a semicolon instead.

       GROFF_BIN_PATH
              is a colon-separated list of directories in which to search  for
              the  groff  executable  before  searching  in  PATH.   If unset,
              /usr/bin is used.

       GROFF_TYPESETTER
              specifies the default output device for groff.

       LC_ALL
       LC_CTYPE
       LANG
       LESSCHARSET
              are pattern-matched in this order for contents matching standard
              character encodings supported by groff in the event no -T option
              is given and GROFF_TYPESETTER is unset, or the values  specified
              are invalid.

Files
       /usr/share/groff/1.23.0/tmac/tty-char.tmac
              defines  fallback definitions of roff special characters.  These
              definitions more poorly  optically  approximate  typeset  output
              than those of tty.tmac in favor of communicating semantic infor‐
              mation.  nroff loads it automatically.

Notes
       Pager  programs  like  more(1) and less(1) may require command-line op‐
       tions to correctly handle some output sequences; see grotty(1).

See also
       groff(1), troff(1), grotty(1), locale(1), roff(7)



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   text/groff/groff-core = Stability Uncommitted

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://ftp.gnu.org/gnu/groff/groff-1.23.0.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/groff.

groff 1.23.0                    1 December 2025                      gnroff(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3