groff_rfc1345(7)

1groff_rfc1345(7)       Miscellaneous Information Manual       groff_rfc1345(7)
2
3
4

Name

6       groff_rfc1345 - special character names from RFC 1345 and Vim digraphs
7

Description

9       The  file  rfc1345.tmac  defines special character escape sequences for
10       groff(7) based on the glyph mnemonics specified in RFC 1345 and the di‐
11       graph table of the text editor Vim.  Each escape sequence translates to
12       a Unicode code point, and will render correctly if the underlying  font
13       is a Unicode font that covers the code point.
14
15       For example, “\[Rx]” is the “recipe” or “prescription take” symbol, and
16       maps to the code point U+211E.  groff lets you write it as  “\[u211E]”,
17       but “\[Rx]” is more mnemonic.
18
19       For   a  list  of  the  glyph  names  provided,  please  see  the  file
20       rfc1345.tmac, which contains definitions of the form
21              .char \[Rx] \[u211E]    \" PRESCRIPTION TAKE
22       where .char's first argument defines a groff special  character  escape
23       sequence  with  a mnemonic glyph name, its second argument is a special
24       character escape sequence based on the code point, and the comment  de‐
25       scribes the glyph defined.
26
27       The RFC 1345 glyph names cover a wide range of Unicode code points, in‐
28       cluding supplemental Latin, Greek, Cyrillic, Hebrew, Arabic,  Hiragana,
29       Katakana,  and  Bopomofo  letters, punctuation, math notation, currency
30       symbols, industrial and entertainment icons, and box-drawing symbols.
31
32       The Vim digraph table is practically a subset of RFC 1345  (being  lim‐
33       ited  to two-character mnemonics), but, as a newer implementation, adds
34       four mnemonics not specified in the RFC (the horizontal  ellipsis,  the
35       Euro sign, and two mappings for the rouble sign).  These have also been
36       added to rfc1345.tmac.
37
38       rfc1345.tmac contains a total of 1,696 glyph names.  It is not an error
39       to load rfc1345.tmac if your font does not have all the glyphs, as long
40       as it contains the glyphs that you actually use in your document.
41
42       The RFC 1345 mnemonics are not identical in every case to the  mappings
43       for special character glyph names that are built in to groff; for exam‐
44       ple, “\[<<]” means the “much less than” sign (U+226A) when rfc1345.tmac
45       is  not loaded and this special character is not otherwise defined by a
46       document or macro  package.   rfc1345.tmac  redefines  “\[<<]”  to  the
47       “left-pointing    double   angle   quotation   mark”   (U+00AB).    See
48       groff_char(7) for the full list of predefined special character  escape
49       sequences.
50
51   Usage
52       Load  the  rfc1345.tmac  file.  This can be done by either adding “.mso
53       rfc1345.tmac” to your document before the first use of any of the glyph
54       names  the  macro  file  defines,  or  by using the troff(1) option “-m
55       rfc1345” from the shell.
56
57   Bugs
58       As the groff Texinfo manual notes, “[o]nly the current font is  checked
59       for  ligatures  and  kerns;  neither special fonts nor entities defined
60       with the char request (and its siblings) are taken into account.”  Many
61       of  the  characters defined in rfc1345.tmac are accented Latin letters,
62       and will be affected by this deficiency,  producing  subpar  typography
63       ⟨https://savannah.gnu.org/bugs/?59932⟩.
64

Files

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

Authors

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

Name

Description

Files

Authors

See also