Go to main content

man pages section 7: Standards, Environments, Macros, Character Sets, and Miscellany

Exit Print View

Updated: Wednesday, July 27, 2022

groff_me (7)


groff_me - troff macros for formatting papers


groff -me [ options ] file ...
groff -m me [ options ] file ...


Miscellaneous Information Manual                                   GROFF_ME(7)

       groff_me - troff macros for formatting papers

       groff -me [ options ] file ...
       groff -m me [ options ] file ...

       This  manual page describes the GNU version of the -me macros, which is
       part of the groff document formatting system.  This version can be used
       with  both GNU troff and Unix troff.  This package of troff macro defi-
       nitions provides a canned formatting facility for technical  papers  in
       various formats.

       The  macro  requests are defined below.  Many troff requests are unsafe
       in conjunction with this package, however, these requests may  be  used
       with impunity after the first .pp:

       .bp     begin new page
       .br     break output line here
       .sp n   insert n spacing lines
       .ls n   (line spacing) n=1 single, n=2 double space
       .na     no alignment of right margin
       .ce n   center next n lines
       .ul n   underline next n lines

       Output  of  the pic, eqn, refer, and tbl preprocessors is acceptable as

       /usr/share/groff/1.21/tmac/me.tmac (a wrapper file for e.tmac)

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

       |Availability   | text/groff       |
       |Stability      | Uncommitted      |

       groff(1), troff(1)
       -me Reference Manual, Eric P. Allman
       Writing Papers with Groff Using -me

       This list is incomplete; see The -me Reference Manual  for  interesting

       Request       Initial   Causes   Explanation
                     Value     Break
       .(c           -         yes      Begin centered block
       .(d           -         no       Begin delayed text
       .(f           -         no       Begin footnote

       .(l           -         yes      Begin list
       .(q           -         yes      Begin major quote
       .(x x         -         no       Begin indexed item in index
       .(z           -         no       Begin floating keep
       .)c           -         yes      End centered block
       .)d           -         yes      End delayed text
       .)f           -         yes      End footnote
       .)l           -         yes      End list
       .)q           -         yes      End major quote
       .)x           -         yes      End index item
       .)z           -         yes      End floating keep
       .++ m H       -         no       Define paper section.  m defines the
                                        part of the paper, and can be C (chap-
                                        ter), A (appendix), P (preliminary,
                                        e.g., abstract, table of contents,
                                        etc.), B (bibliography), RC (chapters
                                        renumbered from page one each chap-
                                        ter), or RA (appendix renumbered from
                                        page one).
       .+c T         -         yes      Begin chapter (or appendix, etc., as
                                        set by .++).  T is the chapter title.
       .1c           1         yes      One column format on a new page.
       .2c           1         yes      Two column format.
       .EN           -         yes      Space after equation produced by eqn
                                        or neqn.
       .EQ x y       -         yes      Precede equation; break out and add
                                        space.  Equation number is y.  The
                                        optional argument x may be I to indent
                                        equation (default), L to left-adjust
                                        the equation, or C to center the equa-
       .GE           -         yes      End gremlin picture.
       .GS           -         yes      Begin gremlin picture.
       .PE           -         yes      End pic picture.
       .PS           -         yes      Begin pic picture.
       .TE           -         yes      End table.
       .TH           -         yes      End heading section of table.
       .TS x         -         yes      Begin table; if x is H table has
                                        repeated heading.
       .b x          no        no       Print x in boldface; if no argument
                                        switch to boldface.
       .ba +n        0         yes      Augments the base indent by n.  This
                                        indent is used to set the indent on
                                        regular text (like paragraphs).
       .bc           no        yes      Begin new column
       .bi x         no        no       Print x in bold italics (nofill only)
       .bu           -         yes      Begin bulleted paragraph
       .bx x         no        no       Print x in a box (nofill only).
       .ef 'x'y'z'   ''''      no       Set even footer to x  y  z
       .eh 'x'y'z'   ''''      no       Set even header to x  y  z
       .fo 'x'y'z'   ''''      no       Set footer to x  y  z
       .hx           -         no       Suppress headers and footers on next
       .he 'x'y'z'   ''''      no       Set header to x  y  z
       .hl           -         yes      Draw a horizontal line
       .i x          no        no       Italicize x; if x missing, italic text
       .ip x y       no        yes      Start indented paragraph, with hanging
                                        tag x.  Indentation is y ens (default
       .lp           yes       yes      Start left-blocked paragraph.
       .np           1         yes      Start numbered paragraph.
       .of 'x'y'z'   ''''      no       Set odd footer to x  y  z
       .oh 'x'y'z'   ''''      no       Set odd header to x  y  z
       .pd           -         yes      Print delayed text.

       .pp           no        yes      Begin paragraph.  First line indented.
       .r            yes       no       Roman text follows.
       .re           -         no       Reset tabs to default values.
       .sh n x       -         yes      Section head follows, font automati-
                                        cally bold.  n is level of section, x
                                        is title of section.
       .sk           no        no       Leave the next page blank.  Only one
                                        page is remembered ahead.
       .sm x         -         no       Set x in a smaller pointsize.
       .sz +n        10p       no       Augment the point size by n points.
       .tp           no        yes      Begin title page.
       .u x          -         no       Underline argument (even in troff).
                                        (Nofill only).
       .uh           -         yes      Like .sh but unnumbered.
       .xp x         -         no       Print index.

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

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

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

3rd Berkeley Distribution       4 November 2014                    GROFF_ME(7)