Name

       groff_rfc1345 - special character names from RFC 1345 and Vim digraphs

Description

       The file rfc1345.tmac defines special character escape sequences for groff(7) based on the
       glyph mnemonics specified in RFC 1345 and the digraph table of the text editor Vim.   Each
       escape  sequence  translates  to  a  Unicode  code point, and will render correctly if the
       underlying font is a Unicode font that covers the code point.

       For example, “\[Rx]” is the “recipe” or “prescription take” symbol, and maps to  the  code
       point U+211E.  groff lets you write it as “\[u211E]”, but “\[Rx]” is more mnemonic.

       For  a  list of the glyph names provided, please see the file rfc1345.tmac, which contains
       definitions of the form
              .char \[Rx] \[u211E]    \" PRESCRIPTION TAKE
       where .char's first argument defines a groff special  character  escape  sequence  with  a
       mnemonic  glyph  name, its second argument is a special character escape sequence based on
       the code point, and the comment describes the glyph defined.

       The RFC 1345 glyph names cover a wide range of Unicode code points, including supplemental
       Latin,  Greek,  Cyrillic,  Hebrew,  Arabic,  Hiragana,  Katakana,  and  Bopomofo  letters,
       punctuation, math notation, currency symbols, industrial and entertainment icons, and box-
       drawing symbols.

       The  Vim digraph table is practically a subset of RFC 1345 (being limited to two-character
       mnemonics), but, as a newer implementation, adds four mnemonics not specified in  the  RFC
       (the  horizontal  ellipsis,  the  Euro sign, and two mappings for the rouble sign).  These
       have also been added to rfc1345.tmac.

       rfc1345.tmac contains a total  of  1,696  glyph  names.   It  is  not  an  error  to  load
       rfc1345.tmac  if your font does not have all the glyphs, as long as it contains the glyphs
       that you actually use in your document.

       The RFC 1345 mnemonics are not identical  in  every  case  to  the  mappings  for  special
       character  glyph  names  that  are built in to groff; for example, “\[<<]” means the “much
       less than” sign (U+226A) when rfc1345.tmac is not loaded and this special character is not
       otherwise  defined  by a document or macro package.  rfc1345.tmac redefines “\[<<]” to the
       “left-pointing double angle quotation mark” (U+00AB).  See groff_char(7) for the full list
       of predefined special character escape sequences.

   Usage
       Load the rfc1345.tmac file.  This can be done by either adding “.mso rfc1345.tmac” to your
       document before the first use of any of the glyph names the  macro  file  defines,  or  by
       using the troff(1) option “-m rfc1345” from the shell.

   Bugs
       As  the  groff Texinfo manual notes, “[o]nly the current font is checked for ligatures and
       kerns; neither special fonts nor entities defined with the char request (and its siblings)
       are  taken  into  account.”   Many  of the characters defined in rfc1345.tmac are accented
       Latin letters, and will be  affected  by  this  deficiency,  producing  subpar  typography
       ⟨https://savannah.gnu.org/bugs/?59932⟩.

Files

       /usr/share/groff/1.23.0/tmac/rfc1345.tmac
              implements the character mappings.

Authors

       rfc1345.tmac was contributed by Dorai Sitaram ⟨ds26gte@yahoo.com⟩.

See also

       RFC 1345 ⟨https://tools.ietf.org/html/rfc1345⟩, by Keld Simonsen, June 1992.

       The Vim digraph table can be listed using the vim(1) command “:help digraph-table”.

       groff_char(7)