# groff_rfc1345

## 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 largely a subset of RFC 1345 (being
           limited to two-character mnemonics), but, as a newer
           implementation, adds several mnemonics not specified in the RFC
           (Latin capital and small letters W and Y with grave accent,
           bullet, horizontal ellipsis, quadruple prime, “approaches the
           limit”, and two mappings each for the Euro and rouble signs).
           These have also been added to _rfc1345.tmac_.
    
           _rfc1345.tmac_ contains about 1,700 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/local/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)
    


* * *