GROFF_ME(7)            (9 September 2021)             GROFF_ME(7)

     NAME
          groff_me - lqmerq macro package for formatting documents with
          GNU roff

     SYNOPSIS
          [option ...] [input-file ...] [option ...] [input-file ...]

     DESCRIPTION
          The me package of macro definitions for the roff language
          provides a convenient facility for preparing technical
          papers in various formats.  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.

          Many roff requests are unsafe in conjunction with this pack-
          age; however, the following requests may be used with
          impunity after the first .pp: l l.

     Page 1                    groff 1.22.4          (printed 5/21/22)

     GROFF_ME(7)            (9 September 2021)             GROFF_ME(7)

                                   Note:
          In contrast to its behavior with other macro packages and
          lqrawrq roff, when using the me package, the .sp request will
          not put space at the top of a page.

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

        Macro Reference
          Numeric arguments to macros are denoted with lowercase let-
          ters and string arguments with uppercase.  An optional macro
          argument such as x appears in brackets, [x/].  Note that
          arguments to macros generally must be quoted if they contain
          whitespace.  An exception is the argument to header and
          footer macros, which require some explanation.  They take
          the form lqc left c middle c right crq, with spaces added here
          for clarity.  The strings left, middle, and right correspond
          to their page placement and can contain unprotected whites-
          pace, but must not contain the (non-space) character c,
          which delimits them.  For brevity, the table presents header
          and footer arguments as clcmcrc. Popular choices for c are
          the ASCII apostrophe lqaqrq and the ASCII double quote lqdqrq.

          This list is incomplete; some requests are too complex to
          summarize in a table, and some that are listed below accept
          additional arguments not shown.  See the -me Reference
          Manual for interesting details.

          l l l lx.  Request   Initial   Causes    Explanation
               Value     Break _ .(c  -    yes  T{ Begin centered
          block.  T} .(d  -    no   T{ Begin delayed text.  T}
          .(f  -    no   T{ Begin footnote.  T} .(l  -    yes  Begin
          list.  .(q  -    yes  T{ Begin major quote.  T} .(x
          [X]   -    no   T{ Begin item in index (named X). T}
          .(z  -    no   T{ Begin floating keep.  T} .)c  -    yes  T{
          End centered block.  T} .)d  -    yes  T{ End delayed text.
          T} .)f  -    yes  T{ End footnote.  T} .)l  -    yes  End
          list.  .)q  -    yes  T{ End major quote.  T}
          .)x  -    yes  T{ End index item.  T} .)z  -    yes  T{ End
          floating keep.  T} .++ M [clcmcrc]     -    no   T{ Define
          paper section as M, which must be one of C (chapter), A
          (appendix), P (preliminary, i.e., front matter or table of
          contents), AB (abstract), B (bibliography), RC (chapters
          renumbered from page one each chapter), or RA (appendix
          renumbered from page one) (and set page header to clcmcrc).
          T} .+c [T]   -    yes  T{ Begin chapter (or appendix, etc.,
          as set by .++) (with title T). T} .1c  1    yes  T{ One-
          column format on a new page.  T} .2c  1    yes  T{ Two-
          column format.  T} .EN  -    yes  T{ Space after equation
          produced by eqn or neqn. T} .EQ [M [T]]    -    yes  T{
          Begin displayed equation (with indentation M, which must be
          one of C (centered, default), I (indented), or L (justified

     Page 2                    groff 1.22.4          (printed 5/21/22)

     GROFF_ME(7)            (9 September 2021)             GROFF_ME(7)

          left) (and title T in right margin)).  T} .GE  -    yes  T{
          End gremlin picture.  T} .GS  -    yes  T{ Begin gremlin
          picture.  T} .PE  -    yes  T{ End pic picture.  T}
          .PS  -    yes  T{ Begin pic picture.  T} .TE  -    yes  T{
          End tbl table.  T} .TH  -    yes  T{ End heading of tbl
          table.  T} .TS [H]   -    yes  T{ Begin tbl table; if H,
          table repeats heading on each page.  T} .b [X
          [Y]]     -    no   T{ Print X in bold (appending Y in the
          previous font); if no arguments, switch to bold.  T} .ba
          n     0    yes  T{ Augment the base indent (for regular
          text, like paragraphs) by n. T} .bc  -    yes  T{ Begin new
          column.  T} .bi [X [Y]]    -    no   T{ Print X in bold
          italics (appending Y in the previous font); if no arguments,
          switch to bold italics.  T} .bu  -    yes  T{ Begin bulleted
          paragraph.  T} .bx [X [Y]]    -    no   T{ Print X in a box
          (with Y appended).  Renders reliably only in no-fill mode.
          T} .ef clcmcrc    """" no   T{ Set even-numbered page
          footer.  T} .eh clcmcrc    """" no   T{ Set even-numbered
          page header.  T} .fo clcmcrc    """" no   T{ Set page
          footer.  T} .hx  -    no   T{ Suppress headers and footers
          on next page.  T} .he clcmcrc    """" no   T{ Set page
          header.  T} .hl  -    yes  T{ Draw a horizontal line.  T} .i
          [X [Y]]     -    no   T{ Print X in italics (appending Y in
          the previous font); if no arguments, switch to italics.  T}
          .ip [X [n]]    n=5n yes  T{ Start indented paragraph (with
          hanging tag X (and indentation n)). T} .lp  -    yes  T{
          Begin paragraph with first line flush left.  T}
          .np  1    yes  T{ Start numbered paragraph.  T} .of
          clcmcrc    """" no   T{ Set odd-numbered page footer.  T}
          .oh clcmcrc    """" no   T{ Set odd-numbered page header.
          T} .pd  -    yes  T{ Print delayed text.  T}
          .pp  -    yes  T{ Begin paragraph with indented first line.
          T} .r [X [Y]]     -    no   T{ Print X in roman (appending Y
          in the previous font); if no arguments, switch to roman.  T}
          .re  0.5i no   T{ Reset tabs to default values.  T} .sh [n
          [T]]    n=1  yes  T{ Start numbered section; print section
          number (set to n (and title T)) in bold.  T}
          .sk  -    no   T{ Leave the next page blank.  Only one page
          is remembered ahead.  T} .sm X [Y] -    no   T{ Print X in a
          smaller point size (appending Y at the previous size).  T}
          .sz n     10p  no   T{ Augment the point size by n points.
          T} .tp  -    yes  T{ Begin title page.  T} .u X
          [Y]  -    no   T{ Underline X (appending Y without underlin-
          ing).  Renders reliably only in no-fill mode.  T} .uh
          [T]   -    yes  T{ Start unnumbered section (and print title
          T in bold).  T} .xp [X]   -    no   T{ Print index (named
          X). T}

     FILES
          /usr/:share/:groff/:1.22.4/:tmac/me.tmac (a wrapper file for
          e.tmac)
          /usr/:share/:groff/:1.22.4/:tmac/e.tmac

     Page 3                    groff 1.22.4          (printed 5/21/22)

     GROFF_ME(7)            (9 September 2021)             GROFF_ME(7)

     NOTES
          Early roff macro packages limited themselves to a single-
          letter namespace (mm, ms, mv, mn, etc.).  The lqerq in lqmerq
          stands for lqEric P. Allmanrq, who wrote the macro package and
          the original technical papers documenting it while an under-
          graduate at the University of California.

     SEE ALSO
          groff(1), troff(1)

          Two manuals are available in source and rendered form.  On
          your system, they may be compressed and/or available in
          additional formats.

          /usr/:share/:doc/:groff-base/meintro.me
               /usr/:share/:doc/:groff-base/meintro.ps is Writing
               Papers with Groff Using -me, by Eric P. Allman and
               James Clark.

          /usr/:share/:doc/:groff-base/meref.me
               /usr/:share/:doc/:groff-base/meref.ps is the -me
               Reference Manual, by Eric P. Allman and James Clark.

          For preprocessors supported by me, see eqn(1), grn(1),
          pic(1), refer(1), and tbl(1).

     Page 4                    groff 1.22.4          (printed 5/21/22)