Provided by: manpages-ja_0.5.0.0.20110915-1_all bug

TROFF

     -mdoc -mdoc GNU troff(1)
     () '\&' '\&'  0

      GNU troff(1)  (9  troff ) (  ) (  )

     -mdoc  '.' () '.Op' 'Fl' 'Ar'  :

           [-s bytes]   '.Op Fl s Ar bytes'

      '\&'

           [Fl s Ar bytes]   '.Op \&Fl s \&Ar bytes'

      'Fl' 'Ar'   -mdoc

     1 -mdoc '.Fn'  1 ANSI C  2 int foo

      2 1 '\ ' '\' 1 troff  () '\~'  ( GNU troff(1) ) 2

     :

           fetch(char *str)   '.Fn fetch char\ *str'

           fetch(char *str)   '.Fn fetch "char *str"'

      '\' '.Fn'  3

           fetch(char, *str)
      '\n' '\' '\e' ( '\en' )

      () '.sp' ( -mdoc )

       2  2  1

      '"' '\*[q]' ( '\*q')

      troff(1)  2 ')' ''' '\&'

           The
           .Ql .
           character.
           .Pp
           The
           .Ql \&.
           character.
           .Pp
           .No test .
           test
           .Pp
           .No test.
           test

           The ''.  character.

           The '.' character.

           test.  test

           test. test

     1  3 -mdoc   0 'e.g.\&'

      '.\"' '\"' '\#' ( GNU troff(1) )

           .\"
           .Dd  ,
           .Os [] [/]
           .Dt  [] [/]
           .Sh NAME
           .Nm
           .Nd  1
           .\"  2, 3
           .\" .Sh LIBRARY
           .Sh SYNOPSIS
           .Sh DESCRIPTION
           .\"
           .\"
           .\" .Sh IMPLEMENTATION NOTES
           .\"  2, 3, 9
           .\"
           .\" .Sh RETURN VALUES
           .\"  1, 6, 7, 8, 9
           .\" .Sh ENVIRONMENT
           .\" .Sh FILES
           .\" .Sh EXAMPLES
           .\"  1, 6, 7, 8, 9
           .\"     (()
           .\"       fprintf/stderr )
           .\" .Sh DIAGNOSTICS
           .\" .Sh COMPATIBILITY
           .\"  2, 3, 9
           .\"
           .\" .Sh ERRORS
           .\" .Sh SEE ALSO
           .\" .Sh STANDARDS
           .\" .Sh HISTORY
           .\" .Sh AUTHORS
           .\" .Sh BUGS

      '.Dd', '.Os', '.Dt'  (  )

      (.Sh) NAME, SYNOPSIS, DESCRIPTION

       ([]) ('...')  0 '|' ( '|' )  ({})  (<>)

     :

           .Xx <foo> {bar1 | bar2} [-test1 [-test2 | -test3]] ...

      '.Bl' '.Bd' width (-width)  offset (-offset) -mdoc

      3

     .Dt [<>] [<>] [<>]
              troff  'UNTITLED' 1, ..., 9 'unass', 'draft', 'paper'

             BSD :

                   1        General Commands Manual
                   2        System Calls Manual
                   3        Library Functions Manual
                   4        Kernel Interfaces Manual
                   5        File Formats Manual
                   6        Games Manual
                   7        Miscellaneous Information Manual
                   8        System Manager's Manual
                   9        Kernel Developer's Manual

              :

                   USD      User's Supplementary Documents
                   PS1      Programmer's Supplementary Documents
                   AMD      Ancestral Manual Documents
                   SMM      System Manager's Manual
                   URM      User's Reference Manual
                   PRM      Programmer's Manual
                   KM       Kernel Manual
                   IND      Manual Master Index
                   LOCAL    Local Manual
                   CON      Contributed Software Manual

              'IND' 'MMI' 'LOCAL' 'LOC'  3  2 :

                   alpha, amiga, arc, arm26, arm32, atari, bebox, cobalt,
                   evbsh3, hp300, hpcmips, i386, luna68k, m68k, mac68k,
                   macppc, mips, mmeye, mvme68k, news68k, newsmips, next68k,
                   ofppc, pc532, pmax, powerpc, prep, sgimips, sh3, sparc,
                   sparc64, sun3, tahoe, vax, x68k

              ()

                   .Dt FOO 7         'FOO(7)' 'System Reference Manual'
                   .Dt FOO 2 mac68k  'FOO(2)' 'System Programmer's Manual
                                     (mac68k Architecture)'
                   .Dt FOO "" bar    'FOO' 'bar'

              OS mdoc.local 'volume-ds-XXX' () 'volume-as-XXX' () 'XXX' '.Dt'

     .Os [<>] [<>]
              1 'BSD' mdoc.local  () BSD ATT  2 '.Dt' mdoc.local
             'operating-system-XXX-YYY' 'XXX'  () 'YYY'  ID

                   ATT      7th, 7, III, 3, V, V.2, V.3, V.4

                   BSD      3, 4, 4.1, 4.2, 4.3, 4.3t, 4.3T, 4.3r, 4.3R, 4.4

                   NetBSD   0.8, 0.8a, 0.9, 0.9a, 1.0, 1.0a, 1.1, 1.2, 1.2a,
                            1.2b, 1.2c, 1.2d, 1.2e, 1.3, 1.3a, 1.4, 1.5

                   FreeBSD  1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5,
                            2.1.6, 2.1.7, 2.2, 2.2.1, 2.2.2, 2.2.5, 2.2.6,
                            2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0,
                            4.1, 4.2, 5.0

             ATT  2 UNIX  () :

                   .Os BSD 4.3

              '4.3 Berkeley Distribution'

                   .Os CS Department

              'CS Department'

             '.Os'

     .Dd [<> <>, <>]
             'Dd' ' ( 197011 00:00:00)'  3

                   .Dd January 25, 2001

   ...
      3 -mdoc 2 -mdoc  UNIX 3

      troff(1) troff

           .Xx argument1 argument2 ...

     '.Xx' 2 UNIX SYNOPSIS

           filter [-flag] <infile> <outfile>

      filter -flag  -mdoc <infile> <outfile>   (<>) -mdoc

           .Nm filter
           .Op Fl flag
           .Ao Ar infile Ac Ao Ar outfile Ac

     3 <infile> <outfile>

           make  [-eiknqrstv] [-D variable] [-d flags] [-f makefile] [-I
                 directory] [-j max_jobs] [variable=value] [target ...]

      make makefile -f target -mdoc  target 'Ar' variable  make

           .Nm make
           .Op Fl eiknqrstv
           .Op Fl D Ar variable
           .Op Fl d Ar flags
           .Op Fl f Ar makefile
           .Op Fl I Ar directory
           .Op Fl j Ar max_jobs
           .Op Ar variable Ns = Ns Ar value
           .Bk
           .Op Ar target ...
           .Ek

      '.Bk' '.Ek'

      '.Ar', '.Fl', '.Nm', '.Pa' '.Fn' '.Xr'

           .Ar sptr, ptr),

           sptr, ptr),

      '.Ar'

           .Ar sptr , ptr ) ,

           sptr, ptr),

      '\&'

     troff

                 {+,-,/,*,%,<,>,<=,>=,=,==,&,`,',"}

      troff '\&' '.Ad'

           : .Ad <> ...

                    .Ad addr1           addr1
                    .Ad addr1 .         addr1.
                    .Ad addr1 , file2   addr1, file2
                    .Ad f1 , f2 , f3 :  f1, f2, f3:
                    .Ad addr ) ) ,      addr)),

      12n

     '.An'

           : .An <> ...

                    .An "Joe Author"        Joe Author

                    .An "Joe Author" ,      Joe Author,

                    .An "Joe Author" Aq nobody@FreeBSD.org
                                            Joe Author <nobody@FreeBSD.org>

                    .An "Joe Author" ) ) ,  Joe Author)),

      12n

     AUTHORS '.An'

           .An -nosplit

           .An -split

      .Ar 'file ...'

           : .Ar [<>] ...

                    .Ar              file ...
                    .Ar file1        file1
                    .Ar file1 .      file1.
                    .Ar file1 file2  file1 file2
                    .Ar f1 f2 f3 :   f1 f2 f3:
                    .Ar file ) ) ,   file)),

      12n

    ( 4 )
     '.Cd'  4 config(8)

           : .Cd <> ...

                    .Cd "device le0 at scode?"  device le0 at scode?

     SYNOPSIS '.Cd'

      12n

      '.Cm' '.Fl' ()

      10n

      () '.Dv'

           : .Dv <> ...

                    .Dv MAXHOSTNAMELEN  MAXHOSTNAMELEN
                    .Dv TIOCGPGRP )     TIOCGPGRP)

      12n

   errno
     '.Er' errno  2, 3, 9  2 '.Er' '.Bq' ( 2 )

           : .Er <errno > ...

                    .Er ENOENT      ENOENT
                    .Er ENOENT ) ;  ENOENT);
                    .Bq Er ENOTDIR  [ENOTDIR]

      17n

     '.Ev'

           : .Ev <> ...

                    .Ev DISPLAY        DISPLAY
                    .Ev PATH .         PATH.
                    .Ev PRINTER ) ) ,  PRINTER)),

      15n

     '.Fl' '-' '.Cm' ()

           : .Fl <> ...

                    .Fl          -
                    .Fl cfv      -cfv
                    .Fl cfv .    -cfv.
                    .Cm cfv .    cfv.
                    .Fl s v t    -s -v -t
                    .Fl - ,      --,
                    .Fl xyz ) ,  -xyz),
                    .Fl |        - |

      '.Fl' / '.Fl'  1 2

      12n

     '.Fd' SYNOPSIS  2  3

           : .Fd <> ...

                    .Fd "#include <sys/types.h>"  #include <sys/types.h>

     SYNOPSIS '.Fd'

     '.In' (#include )  C C

           : .In <>

                    .In stdio.h  <stdio.h>

      SYNOPSIS  2  3 SYNOPSIS ()

           : .Ft <> ...

                    .Ft struct stat  struct stat

    ()
     '.Fn' ANSI C

           : .Fn <> [<>] ...

                    .Fn getchar              getchar()
                    .Fn strlen ) ,           strlen()),
                    .Fn align "char *ptr" ,  align(char *ptr),

      '.Fn' ()

      () '.Fo'  () '.Fc'  () '.Fa' ()

     :

           .Ft int
           .Fo res_mkquery
           .Fa "int op"
           .Fa "char *dname"
           .Fa "int class"
           .Fa "int type"
           .Fa "char *data"
           .Fa "int datalen"
           .Fa "struct rrec *newrr"
           .Fa "char *buf"
           .Fa "int buflen"
           .Fc

     :

           int res_mkquery(int op, char *dname, int class, int type,
           char *data, int datalen, struct rrec *newrr, char *buf, int buflen)

     SYNOPSIS SYNOPSIS

     '.Fn' '.Fo'  12n  16n

     '.Fa'  () SYNOPSIS '.Fn' '.Fo' '.Fc' SYNOPSIS '.Fa'

           : .Fa <> ...

                    .Fa d_namlen ) ) ,  d_namlen)),
                    .Fa iov_len         iov_len

      12n

     '.Rv' RETURN VALUES

           : .Rv [-std] [<> ...]

      '.Rv -std atexit'

            The atexit() function returns the value 0 if successful; otherwise
            the value -1 is returned and the global variable errno is set to
            indicate the error.

     -std  2  3 -std

     '.Ex' DIAGNOSTICS

           : .Ex [-std] [<> ...]

      '.Ex -std cat'

            The cat utility exits 0 on success, and >0 if an error occurs.

     -std  1  6  8 -std

     '.Ic'

           : .Ic <> ...

                    .Ic :wq                :wq
                    .Ic "do while {...}"   do while {...}
                    .Ic setenv , unsetenv  setenv, unsetenv

      12n

     '.Lb'

           : .Lb <> ...

     '.Lb' :

           libarm32     ARM32 Architecture Library (libarm32, -larm32)
           libc         Standard C Library (libc, -lc)
           libcompat    Compatibility Library (libcompat, -lcompat)
           libcrypt     Crypt Library (libcrypt, -lcrypt)
           libcurses    Curses Library (libcurses, -lcurses)
           libedit      Command Line Editor Library (libedit, -ledit)
           libi386      i386 Architecture Library (libi386, -li386)
           libipsec     IPsec Policy Control Library (libipsec, -lipsec)
           libkvm       Kernel Data Access Library (libkvm, -lkvm)
           libm         Math Library (libm, -lm)
           libmenu      Curses Menu Library (libmenu, -lmenu)
           libossaudio  OSS Audio Emulation Library (libossaudio, -lossaudio)
           libposix     POSIX Compatibility Library (libposix, -lposix)
           libresolv    DNS Resolver Library (libresolv, -lresolv)
           libtermcap   Termcap Access Library (libtermcap, -ltermcap)
           libutil      System Utilities Library (libutil, -lutil)
           libz         Compression Library (libz, -lz)

      OS mdoc.local 'str-Lb-XXX' 'XXX' '.Lb'

      '.Li'

           : .Li <> ...

                    .Li \en          \n
                    .Li M1 M2 M3 ;   M1 M2 M3;
                    .Li cntrl-D ) ,  cntrl-D),
                    .Li 1024 ...     1024 ...

      16n

     '.Nm'  1 '.Nm' :  2  3 NAME '.Nm' SYNOPSIS '.Fn' csh(1) 'while' '.Ic'
     '.Ic' '.Nm'  1

           : .Nm [<>] ...

                    .Nm groff_mdoc  groff_mdoc
                    .Nm \-mdoc      -mdoc
                    .Nm foo ) ) ,   foo)),
                    .Nm :           groff_mdoc:

      10n

     '.Op' '.Oo' '.Oc'  ()

           : .Op [<>] ...

                    .Op                                []
                    .Op Fl k                           [-k]
                    .Op Fl k ) .                       [-k]).
                    .Op Fl k Ar kookfile               [-k kookfile]
                    .Op Fl k Ar kookfile ,             [-k kookfile],
                    .Op Ar objfil Op Ar corfil         [objfil [corfil]]
                    .Op Fl c Ar objfil Op Ar corfil ,  [-c objfil [corfil]],
                    .Op word1 word2                    [word1 word2]
                    .Li .Op Oo Ao option Ac Oc ...     .Op [<options>] ...

      '.Oo' '.Oc' :

           .Oo
           .Op Fl k Ar kilobytes
           .Op Fl i Ar interval
           .Op Fl c Ar count
           .Oc

     :

           [[-k kilobytes] [-i interval] [-c count]]

     '.Op' '.Oo' 14n  10n

     '.Pa' '~'

           : .Pa [<>] ...

                    .Pa                    ~
                    .Pa /usr/share         /usr/share
                    .Pa /tmp/fooXXXXX ) .  /tmp/fooXXXXX).

      32n

     '.St'

           : .St <> ...

      ``/'' :
           -ansiC         ANSI X3.159-1989 (``ANSI C89'')
           -ansiC-89      ANSI X3.159-1989 (``ANSI C89'')
           -isoC          ISO/IEC 9899:1990 (``ISO C90'')
           -isoC-99       ISO/IEC 9899:1999 (``ISO C99'')
           -iso9945-1-90   ISO/IEC 9945-1:1990 (``POSIX.1'')
           -iso9945-1-96   ISO/IEC 9945-1:1996 (``POSIX.1'')
           -p1003.1        IEEE Std 1003.1 (``POSIX.1'')
           -p1003.1-88     IEEE Std 1003.1-1988 (``POSIX.1'')
           -p1003.1-90     ISO/IEC 9945-1:1990 (``POSIX.1'')
           -p1003.1-96     ISO/IEC 9945-1:1996 (``POSIX.1'')
           -p1003.1b-93    IEEE Std 1003.1b-1993 (``POSIX.1'')
           -p1003.1c-95    IEEE Std 1003.1c-1995 (``POSIX.1'')
           -p1003.1g-2000  IEEE Std 1003.1g-2000 (``POSIX.1'')
           -p1003.1i-95    IEEE Std 1003.1i-1995 (``POSIX.1'')
           -iso9945-2-93   ISO/IEC 9945-2:1993 (``POSIX.2'')
           -p1003.2        IEEE Std 1003.2 (``POSIX.2'')
           -p1003.2-92     IEEE Std 1003.2-1992 (``POSIX.2'')
           -p1003.2a-92    IEEE Std 1003.2a-1992 (``POSIX.2'')

     X/Open

           -susv2          Version 2 of the Single UNIX Specification
                           (``SUSv2'')
           -svid4          System V Interface Definition, Fourth Edition
                           (``SVID4'')
           -xbd5           X/Open System Interface Definitions Issue 5
                           (``XBD5'')
           -xcu5           X/Open Commands and Utilities Issue 5 (``XCU5'')
           -xcurses4.2     X/Open Curses Issue 4, Version 2 (``XCURSES4.2'')
           -xns5           X/Open Networking Services Issue 5 (``XNS5'')
           -xns5.2         X/Open Networking Services Issue 5.2 (``XNS5.2'')
           -xpg3           X/Open Portability Guide Issue 3 (``XPG3'')
           -xpg4           X/Open Portability Guide Issue 4 (``XPG4'')
           -xpg4.2         X/Open Portability Guide Issue 4, Version 2
                           (``XPG4.2'')
           -xsh5           X/Open System Interfaces and Headers Issue 5
                           (``XSH5'')

           -ieee754        IEEE Std 754-1985
           -iso8802-3      ISO/IEC 8802-3:1989

     '.Vt' SYNOPSIS ()

           : .Vt <> ...

                    .Vt extern char *optarg ;  extern char *optarg;
                    .Vt FILE *                 FILE *

           : .Va <> ...

                    .Va count             count
                    .Va settimer ,        settimer,
                    .Va "int *prt" ) :    int *prt):
                    .Va "char s" ] ) ) ,  char s])),

      12n

     '.Xr'  2 ()

           : .Xr <> [<>] ...

                    .Xr mdoc        mdoc
                    .Xr mdoc ,      mdoc,
                    .Xr mdoc 7      mdoc(7)
                    .Xr xinit 1x ;  xinit(1x);

      10n

   AT&T
           : .At [<>] ...

                    .At       AT&T UNIX
                    .At v6 .  Version 6 AT&T UNIX.

     <> :

           32v, v1, v2, v3, v4, v5, v6, v7, V, V.1, V.2, V.3, V.4

   BSD
           : .Bx {-alpha | -beta | -devel} ...
                  .Bx [<> [<>]] ...

                    .Bx         BSD
                    .Bx 4.3 .   4.3BSD.
                    .Bx -devel  BSD (currently under development)

     <> 'BSD' <> :

           Reno, reno, Tahoe, tahoe, Lite, lite, Lite2, lite2

   NetBSD
           : .Nx [<>] ...

                    .Nx        NetBSD
                    .Nx 1.4 .  NetBSD 1.4.

     <>  '.Os'

   FreeBSD
           : .Fx [<>] ...

                    .Fx        FreeBSD
                    .Fx 2.2 .  FreeBSD 2.2.

     <>  '.Os'

   OpenBSD
           : .Ox [<>] ...

                    .Ox 1.0  OpenBSD 1.0

   BSD/OS
           : .Bsx [<>] ...

                    .Bsx 1.0  BSD/OS 1.0

   UNIX
           : .Ux ...

                    .Ux  UNIX

      '.Em'

           : .Em <> ...

                    .Em does not          does not
                    .Em exceed 1024 .     exceed 1024.
                    .Em vide infra ) ) ,  vide infra)),

      10n

     '.Bf' '.Ef'  ()

     '.Bf' :

           .Bf <>

     <>  3

           Em | -emphasis  '.Em'
           Li | -literal   '.Li'
           Sy | -symbolic  '.Sy'

   /
      1  1 'q' 'o' 'c'

         .Aq   .Ao   .Ac                <string>
         .Bq   .Bo   .Bc                [string]
         .Brq  .Bro  .Brc               {string}
         .Dq   .Do   .Dc                2 ``string''
         .Eq   .Eo   .Ec                 (XX )XXstringXX
         .Pq   .Po   .Pc                (string)
         .Ql                            'string'  string
         .Qq   .Qo   .Qc                 2 "string"
         .Sq   .So   .Sc                1 'string'

     'q' 'o'  12n

     .Eo, .Ec   1

     .Es, .En   troff  9 (Eo, Ec )  2 '.Es'  1  2 '.En'  12n

     .Eq        1 2

     .Ql        troff  nroff nroff troff  3  ()

                16n

     .Pf        1  2 :

                     .Pf ( Fa name2  (name2

                12n

               '.Ns'  ()

     .Ap       '.Ap' '.No'

     :

           .Aq                      <>
           .Aq Pa ctype.h ) ,       <ctype.h>),
           .Bq                      []
           .Bq Em Greek , French .  [Greek, French].
           .Dq                      ``''
           .Dq string abc .         ``string abc''.
           .Dq '^[A-Z]'             ``'^[A-Z]'''
           .Ql man mdoc             'man mdoc'
           .Qq                      ""
           .Qq string ) ,           "string"),
           .Qq string Ns ),         "string),"
           .Sq                      ''
           .Sq string               'string'
           .Em or Ap ing            or'ing

      '.Op' '.Xo' '.Xc'

     '.No'   () 'No' '\&'

           : .No <> ...

                    .No test Ta with Ta tabs  test     with     tabs

      12n

     '.Ns'  1 :

           : ... <> Ns [<>] ...
                   .Ns <> ...

                    .Op Fl I Ns Ar directory  [-Idirectory]

     : '.Ns' '.No'  ( ''  2 ) '.Ns' '.No'

     '.Sx'

           : .Sx <> ...

                    .Sx FILES  FILES

      16n

           : .Sy <> ...

                    .Sy Important Notice  Important Notice

      6n

           : .Ms <> ...

                    .Ms sigma  sigma

      6n

      refer(1)

           .Rs      () SEE ALSO
           .Re      ()
           .%A     1
           .%B
           .%C      /  ()
           .%D
           .%I     /
           .%J
           .%N
           .%O
           .%P
           .%Q
           .%R
           .%T
           .%V

     '%' '.Tn' '.%B' '.%T' '.Rs/.Re'

     :

           .Rs
           .%A "Matthew Bar"
           .%A "John Foo"
           .%T "Implementation Notes on foobar(1)"
           .%R "Technical Report ABC-DE-12-345"
           .%Q "Drofnats College, Nowhere"
           .%D "April 1991"
           .Re

           Matthew Bar and John Foo, Implementation Notes on foobar(1),
           Technical Report ABC-DE-12-345, Drofnats College, Nowhere, April
           1991.

    ()

           : .Tn <> ...

                    .Tn DEC    DEC
                    .Tn ASCII  ASCII

      10n

     .Xo .Xc '.It'  () .Xo .Xc  ()

      '.Xo'

           .Sm off
           .It Xo Sy I Ar operation
           .No \en Ar count No \en
           .Xc
           .Sm on

           Ioperation\ncount\n

     :

           .Sm off
           .It Cm S No / Ar old_pattern Xo
           .No / Ar new_pattern
           .No / Op Cm g
           .Xc
           .Sm on

           S/old_pattern/new_pattern/[g]

      '.Xo' :

           .It Xo
           .Ic .ifndef
           .Oo \&! Oc Ns Ar variable Oo
           .Ar operator variable ...
           .Oc Xc

           .ifndef [!]variable [operator variable ...]

      '.Sh' '.Sh' '.Sh' '.Sh'

      8n

     .Sh NAME           '.Sh NAME' NAME  3 '.Nm' 2 '.Nd'  3

                        '.Nd' '-',

     .Sh LIBRARY         2  3 '.Lb'  1

     .Sh SYNOPSIS       SYNOPSIS '.Nm', '.Cd', '.Fn' ( '.Fo', '.Fc', '.Fd',
                        '.Ft' ) '.Fn'  2  3 '.Nm'  1, 5, 6, 7, 8  4 '.Nm'
                        '.Fd' '.Cd' :

                              cat [-benstuv] [-] file ...

                        :

                              .Nm cat
                              .Op Fl benstuv
                              .Op Fl
                              .Ar

     .Sh DESCRIPTION     DESCRIPTION '.Bl' () '.It' () '.El' ()  (  )

     .Sh IMPLEMENTATION NOTES

     .Sh RETURN VALUES   2, 3, 9 '.Rv'  2  3 RETURN VALUES

      '.Sh'

     .Sh ENVIRONMENT    ENVIRONMENT

     .Sh FILES           FILES '.Pa'

     .Sh EXAMPLES

     .Sh DIAGNOSTICS

     .Sh COMPATIBILITY   ( )

     .Sh ERRORS          ( 2, 3, 9) '.Er'  (errno)

     .Sh SEE ALSO       SEE ALSO '.Xr' refer(1)

                         :

                        ls(1), ps(1), group(5), passwd(5)

     .Sh STANDARDS       IEEE Std 1003.2 (``POSIX.2'') ANSI X3.159-1989
                        (``ANSI C89'') HISTORY

     .Sh HISTORY

     .Sh AUTHORS         '.An'

     .Sh BUGS

      '.Sh'

                    .Sh ""

      '.Ss' '.Ss' '.Ss'

      8n

     .Pp  '.Pp' '.Sh' '.Ss' '.Bl' '.Bd' ( -compact )

           '.Lp'

      '.Bk' () '.Ek' () '.Bk' -words  () make  (  ) nroff

      -line

      7

     .D1  (D-)  1

                -ldghfstru

          : .D1 Fl ldghfstru

     .Dl  (D-)   1 '.Dl'  1  ()  () '.Dl'

                % ls -ldg /usr/local/bin

          : .Dl % ls -ldg /usr/local/bin

     .Bd   '.Bd' '.Ed' :

                .Bd {-literal | -filled | -unfilled | -ragged | -centered}
                     [-offset <>] [-file <>] [-compact]

          -ragged    ()
          -centered

          -unfilled

          -filled     ( )
          -literal   ()
          -file <>  -file '.Bd' '.Ed' troff/-mdoc
          -offset <>
                    -offset

                    left         '.Bd'
                    center
                    indent       '.D1' '.Dl'  2  6n  2/3  ( 6 )
                    indent-two   2
                    right        2  troff

                    <> ('u' ) 'm' 'n' Em En square 'm' 'n'  ( nroff  ) <>
                    -mdoc the width of <> ()
          -compact

     .Ed   ()

      '.Bl' '.It' '.El'

      () (-tag)

     :

           .Bl {-hang | -ohang | -tag | -diag | -inset} [-width <>] [-offset
                <>] [-compact]
           .Bl -column [-offset <>] <1> <2> ...
           .Bl {-item | -enum [-nested] | -bullet | -hyphen | -dash} [-offset
                <>] [-compact]

     -bullet

                    .Bl -bullet -offset indent -compact
                    .It
                    1
                    .It
                    2
                    .El

              :

                    +o   1
                    +o   2

     -dash ( -hyphen)

                    .Bl -dash -offset indent -compact
                    .It
                    1
                    .It
                    2
                    .El

              :

                    -   1
                    -   2

     -enum

                    .Bl -enum -offset indent -compact
                    .It
                    1
                    .It
                    2
                    .El

              :

                    1.   1
                    2.   2

               -nested ( 2 ):

                    .Bl -enum -offset indent -compact
                    .It
                    1
                    .Bl -enum -nested -compact
                    .It
                    2
                    .It
                    3
                    .It
                    .El
                    .It
                    4
                    .El

              :

                    1.   1
                         1.1.   2
                         1.2.   3
                    2.   4

     -item     -item

                    .Bl -item -offset indent
                    .It
                    1
                    1
                    1
                    .It
                    2
                    2
                    2
                    .El

              :

                    1 1 1

                    2 2 2

     -tag      -width

                    SL     sleep  ()
                    PAGEIN
                           I/O
                    UID    ID
                    PPID   ID ()

              :

                    .Bl -tag -width "PPID" -compact -offset indent
                    .It SL
                     sleep  ()
                    .It PAGEIN

                    .Tn I/O

                    .It UID
                     ID
                    .It PPID
                     ID
                    ()
                    .El

     -diag     4 inset -width

              :

                    .Bl -diag
                    .It  Sy

                    .El

               Sy

     -hang

                    Hanged

                    Longer hanged list labels

               :

                    .Bl -hang -offset indent
                    .It Em Hanged

                    .It Em Longer Hanged list labels

                    .El

     -ohang    (overhanging tags)

                    SL
                     sleep  ()

                    PAGEIN
                     I/O

                    UID
                     ID

                    PPID
                     ID ()

              :

                    .Bl -ohang -offset indent
                    .It Sy SL
                     sleep  ()
                    .It Sy PAGEIN

                    .Tn I/O

                    .It Sy UID
                     ID
                    .It Sy PPID
                     ID
                    ()
                    .El

     -inset   inset :

                    tag  () -width

                    diag  4 inset

                    hang

                    ohang

                    inset inset -mdoc

              :

                    .Bl -inset -offset indent
                    .It Em tag
                     ()

                    .Fl width

                    .It Em diag
                     4

                    inset
                    .It Em hang

                    .It Em ohang

                    .It Em inset
                    inset
                    .Nm -mdoc

                    .El

     -column   -column <string1>, <string2> <stringN> '.' () -mdoc <stringN>
              <stringN> () N

              '.It' '.Ta'

                        nroff    troff
                    <=  <=       <=
                    >=  >=       >=

              :

                    .Bl -column -offset indent ".Sy " ".Sy nroff" ".Sy troff"
                    .It Sy  Ta Sy nroff Ta Sy troff
                    .It Li <= Ta <= Ta \*(<=
                    .It Li >= Ta >= Ta \*(>=
                    .El

     :

     -width <>   <> '.' () -mdoc <>

                 :

                       .Bl -tag -width ".Fl test Ao Ar  Ac"
                       .It Fl test Ao Ar  Ac

                       .Fl width

                       .El

                 :

                 -test <>   -width

                 <> -mdoc  () GNU troff(1)  '.Ao Ar ' '.Ao Ar  Xc'

                  <> ('u' ) 'm' 'n' Em En square 'm' 'n'  (nroff ) <> -mdoc <>
                 ()

                  '.It' '.It'  1 '.No'

     -offset <>  <> indent  ( 6n '.Dl' '.Bd' ) <> ('u'  ) 'm' 'n' Em En square
                 'm' 'n'  (nroff ) <> -mdoc <>  ()

     -compact

      '.Me' '.Ot'  2  2 bug-groff@gnu.org  ()

     .Bt

                is currently in beta test.

     .Fr

                : .Fr <> ...

            ( 1 ) '\~'

     .Hf  () 'File:' <>

                : .Hf <>

     .Lk

     .Me   -mdoc ``''

           6n

     .Mt

     .Ot   -mdoc `` (fortran)''

     .Sm   ()

                : .Sm [on | off] ...

           off  ( 'on' 'off' ) '.Sm'

     .Ud

                currently under development.

     :

               nroff       troff
           <=  <=          <=
           >=  >=          >=
           Rq  ''          ''
           Lq  ``          ``
           ua  ^           ^
           aa  '           '
           ga  `           `
           q   "           "
           Pi  pi          pi
           Ne  !=          !=
           Le  <=          <=
           Ge  >=          >=
           Lt  <           <
           Gt  >           >
           Pm  +-          +-
           If  infinity    infinity
           Na  NaN         NaN
           Ba  |           |

      nroff troff nroff ASCII troff Unicode TTY  Latin1 TTY

      2 '\*(xx'  1 '\*x' '\*[xxx]'  ( GNU troff(1) )

      -mdoc '.Db' GNU troff(1)

      '.Rd'

GROFF, TROFF, NROFF

      'latin1' 'unicode' TTY groff  0 ( TTY )

           groff -Tlatin1 -rcR=0 -mdoc foo.man > foo.txt

      'D'  1 :

           groff -Tps -rD1 -mdoc foo.man > foo.ps

      11pt  12pt 'S' :

           groff -Tdvi -rS11 -mdoc foo.man > foo.dvi

      'S' TTY

     doc.tmac
     mdoc.tmac         doc.tmac
     mdoc/doc-common
     mdoc/doc-nroff    TTY
     mdoc/doc-ditroff
     mdoc.local
     andoc.tmac         -mdoc -man
      3f

     '.Nm' NAME

      '.Fn'