groff_rfc1345
Section: Environments, Tables, and Troff Macros (7)
Updated: 2 July 2023
Index
Return to Main Contents
Name
groff_rfc1345 - special character names from RFC 1345 and Vim digraphs
.nr d-fallback 1
.nr d-fallback 1
Description
The file
rfc1345.tmac
defines special character escape sequences for
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,
[lq][rs][Rx][rq]
is the [lq]recipe[rq] or [lq]prescription take[rq] symbol,
and maps to the code point U+211E.
groff
lets you write it as
[lq][rs][u211E][rq],
but
[lq][rs][Rx][rq]
is more mnemonic.
For a list of the glyph names provided,
please see the file
rfc1345.tmac,
which contains definitions of the form
-
.char [rs][Rx] [rs][u211E] [rs]" 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 bo-drawing symbols.
The Vim digraph table is practically a subset of RFC 1345
(being limited to tw-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,
[lq][rs][<<][rq]
means the [lq]much less than[rq] 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
[lq][rs][<<][rq]
to the [lq]lef-pointing double angle quotation mark[rq] (U+00AB).
See
for the full list of predefined special character escape sequences.
Usage
Load the
rfc1345.tmac
file.
This can be done by either adding
[lq]
.mso rfc1345.tmac[rq]
to your document before the first use of any of the glyph names the
macro file defines,
or by using the
option
[lq]
-m rfc1345[rq]
from the shell.
Bugs
As the
groff
Texinfo manual notes,
[lq][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.[rq]
Many of the characters defined in
rfc1345.tmac
are accented Latin letters,
and will be affected by this deficiency,
producing subpar typography
Files
- /usr/:share/:groff/:1.23.0/:tmac/:rfc1345:.tmac
-
implements the character mappings.
Authors
rfc1345:.tmac
was contributed by
Dorai Sitaram
See also
RFC 1345
by Keld Simonsen,
June 1992.
The Vim digraph table can be listed using the
command
[lq]:help digraph-table[rq].
Index
- Name
-
- Description
-
- Usage
-
- Bugs
-
- Files
-
- Authors
-
- See also
-
|
|
- Running on 
-
:
