head	1.1;
branch	1.1.1;
access;
symbols
	RELENG_8_4:1.1.1.4.0.30
	RELENG_9_1_0_RELEASE:1.1.1.4
	RELENG_9_1:1.1.1.4.0.28
	RELENG_9_1_BP:1.1.1.4
	RELENG_8_3_0_RELEASE:1.1.1.4
	RELENG_8_3:1.1.1.4.0.26
	RELENG_8_3_BP:1.1.1.4
	RELENG_9_0_0_RELEASE:1.1.1.4
	RELENG_9_0:1.1.1.4.0.24
	RELENG_9_0_BP:1.1.1.4
	RELENG_9:1.1.1.4.0.22
	RELENG_9_BP:1.1.1.4
	RELENG_7_4_0_RELEASE:1.1.1.4
	RELENG_8_2_0_RELEASE:1.1.1.4
	RELENG_7_4:1.1.1.4.0.20
	RELENG_7_4_BP:1.1.1.4
	RELENG_8_2:1.1.1.4.0.18
	RELENG_8_2_BP:1.1.1.4
	RELENG_8_1_0_RELEASE:1.1.1.4
	RELENG_8_1:1.1.1.4.0.16
	RELENG_8_1_BP:1.1.1.4
	RELENG_7_3_0_RELEASE:1.1.1.4
	RELENG_7_3:1.1.1.4.0.14
	RELENG_7_3_BP:1.1.1.4
	RELENG_8_0_0_RELEASE:1.1.1.4
	RELENG_8_0:1.1.1.4.0.12
	RELENG_8_0_BP:1.1.1.4
	RELENG_8:1.1.1.4.0.10
	RELENG_8_BP:1.1.1.4
	RELENG_7_2_0_RELEASE:1.1.1.4
	RELENG_7_2:1.1.1.4.0.8
	RELENG_7_2_BP:1.1.1.4
	RELENG_7_1_0_RELEASE:1.1.1.4
	RELENG_6_4_0_RELEASE:1.1.1.3.12.1
	RELENG_7_1:1.1.1.4.0.6
	RELENG_7_1_BP:1.1.1.4
	RELENG_6_4:1.1.1.3.12.1.0.8
	RELENG_6_4_BP:1.1.1.3.12.1
	RELENG_7_0_0_RELEASE:1.1.1.4
	RELENG_6_3_0_RELEASE:1.1.1.3.12.1
	RELENG_7_0:1.1.1.4.0.4
	RELENG_7_0_BP:1.1.1.4
	RELENG_6_3:1.1.1.3.12.1.0.6
	RELENG_6_3_BP:1.1.1.3.12.1
	RELENG_7:1.1.1.4.0.2
	RELENG_7_BP:1.1.1.4
	RELENG_6_2_0_RELEASE:1.1.1.3.12.1
	RELENG_6_2:1.1.1.3.12.1.0.4
	RELENG_6_2_BP:1.1.1.3.12.1
	RELENG_5_5_0_RELEASE:1.1.1.3
	RELENG_5_5:1.1.1.3.0.16
	RELENG_5_5_BP:1.1.1.3
	RELENG_6_1_0_RELEASE:1.1.1.3.12.1
	RELENG_6_1:1.1.1.3.12.1.0.2
	RELENG_6_1_BP:1.1.1.3.12.1
	RELENG_6_0_0_RELEASE:1.1.1.3
	v1_19_2:1.1.1.4
	RELENG_6_0:1.1.1.3.0.14
	RELENG_6_0_BP:1.1.1.3
	RELENG_6:1.1.1.3.0.12
	RELENG_6_BP:1.1.1.3
	RELENG_5_4_0_RELEASE:1.1.1.3
	RELENG_5_4:1.1.1.3.0.10
	RELENG_5_4_BP:1.1.1.3
	RELENG_4_11_0_RELEASE:1.1.1.1.2.3
	RELENG_4_11:1.1.1.1.2.3.0.6
	RELENG_4_11_BP:1.1.1.1.2.3
	RELENG_5_3_0_RELEASE:1.1.1.3
	RELENG_5_3:1.1.1.3.0.8
	RELENG_5_3_BP:1.1.1.3
	RELENG_5:1.1.1.3.0.6
	RELENG_5_BP:1.1.1.3
	RELENG_4_10_0_RELEASE:1.1.1.1.2.3
	RELENG_4_10:1.1.1.1.2.3.0.4
	RELENG_4_10_BP:1.1.1.1.2.3
	RELENG_5_2_1_RELEASE:1.1.1.3
	RELENG_5_2_0_RELEASE:1.1.1.3
	RELENG_5_2:1.1.1.3.0.4
	RELENG_5_2_BP:1.1.1.3
	RELENG_4_9_0_RELEASE:1.1.1.1.2.3
	RELENG_4_9:1.1.1.1.2.3.0.2
	RELENG_4_9_BP:1.1.1.1.2.3
	RELENG_5_1_0_RELEASE:1.1.1.3
	RELENG_5_1:1.1.1.3.0.2
	RELENG_5_1_BP:1.1.1.3
	v1_19:1.1.1.3
	RELENG_4_8_0_RELEASE:1.1.1.1.2.2
	RELENG_4_8:1.1.1.1.2.2.0.2
	RELENG_4_8_BP:1.1.1.1.2.2
	RELENG_5_0_0_RELEASE:1.1.1.2
	RELENG_5_0:1.1.1.2.0.2
	RELENG_5_0_BP:1.1.1.2
	v1_18_1:1.1.1.2
	RELENG_4_7_0_RELEASE:1.1.1.1.2.1
	RELENG_4_7:1.1.1.1.2.1.0.8
	RELENG_4_7_BP:1.1.1.1.2.1
	RELENG_4_6_2_RELEASE:1.1.1.1.2.1
	RELENG_4_6_1_RELEASE:1.1.1.1.2.1
	RELENG_4_6_0_RELEASE:1.1.1.1.2.1
	RELENG_4_6:1.1.1.1.2.1.0.6
	RELENG_4_6_BP:1.1.1.1.2.1
	RELENG_4_5_0_RELEASE:1.1.1.1.2.1
	RELENG_4_5:1.1.1.1.2.1.0.4
	RELENG_4_5_BP:1.1.1.1.2.1
	RELENG_4_4_0_RELEASE:1.1.1.1.2.1
	RELENG_4_4:1.1.1.1.2.1.0.2
	RELENG_4_4_BP:1.1.1.1.2.1
	v1_17_2:1.1.1.1
	RELENG_4:1.1.1.1.0.2
	v1_17:1.1.1.1
	FSF:1.1.1;
locks; strict;
comment	@# @;


1.1
date	2001.04.17.12.11.55;	author ru;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2001.04.17.12.11.55;	author ru;	state Exp;
branches
	1.1.1.1.2.1;
next	1.1.1.2;

1.1.1.2
date	2002.10.11.08.52.12;	author ru;	state Exp;
branches;
next	1.1.1.3;

1.1.1.3
date	2003.05.01.13.09.49;	author ru;	state Exp;
branches
	1.1.1.3.12.1;
next	1.1.1.4;

1.1.1.4
date	2005.10.20.10.45.18;	author ru;	state Exp;
branches
	1.1.1.4.30.1;
next	;

1.1.1.1.2.1
date	2001.04.26.17.34.01;	author ru;	state Exp;
branches;
next	1.1.1.1.2.2;

1.1.1.1.2.2
date	2003.02.14.15.22.01;	author ru;	state Exp;
branches;
next	1.1.1.1.2.3;

1.1.1.1.2.3
date	2003.06.26.13.13.32;	author ru;	state Exp;
branches;
next	;

1.1.1.3.12.1
date	2005.11.15.22.06.37;	author ru;	state Exp;
branches;
next	;

1.1.1.4.30.1
date	2005.10.20.10.45.18;	author svnexp;	state dead;
branches;
next	1.1.1.4.30.2;

1.1.1.4.30.2
date	2013.03.28.13.01.16;	author svnexp;	state Exp;
branches;
next	;


desc
@@


1.1
log
@Initial revision
@
text
@The following from the original troff manual (by Ossanna and Kernighan) is
unmapped:

                \(bs    shaded solid ball (Bell System logo, AT&T logo)

Character 0x002D has not been given a name because its Unicode name
"HYPHEN-MINUS" is so ambiguous that it's unusable for serious typographic use.

The following, mentioned in the original troff manual, are only approximate:

                \(lk    middle part of big left curly brace
                \(rk    middle part of big right curly brace

\(wp has been mapped to 0x2118, because according to unicode.org's
NamesList-3.0.0.txt, U+2118 "SCRIPT CAPITAL P" is really a Weierstrass p,
neither SCRIPT not CAPITAL.

The following lines could be added, to define names which are known to
"devps" but are not documented and not known to "devdvi".
space	24	0	0x0020
vS	24	0	0x0160
vs	24	0	0x0161
:Y	24	0	0x0178
vZ	24	0	0x017D
vz	24	0	0x017E
3d	24	0	0x2234
nb	24	0	0x2284
product	24	0	0x220F
sum	24	0	0x2211
SP	24	0	0x2660
CL	24	0	0x2663
HE	24	0	0x2665
DI	24	0	0x2666

The following lines could be added, to define names which are known to e.g.
"devdvi" but are not known to "devps".
<<	24	0	0x226A
>>	24	0	0x226B

"devps" maps \(a~ and ~ to asciitilde, which is equivalent to 0x02DC, but
this glyph is just too small. We map them to 0x007E instead.

"devps" maps \(a^ and ^ to circumflex, which is equivalent to 0x02C6, but
this glyph is just too small. We map them to 0x005E instead.

"devps" maps *m to mu, which is equivalent to either 0x00B5 or 0x03BC. We
map it to 0x03BC.

"devps" maps *U to Upsilon1, which is equivalent to 0x03D2. We map it to
0x03A5 instead.

"devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9. We
map it to 0x03A9.

"devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394. We
map it to 0x0394.

"devps" maps CR to carriagereturn, which is equivalent to 0x21B5. We map it
to 0x240D instead.

Using unnamed characters:

Assume you want to use a Unicode character not provided in the list, say
U+20AC. You need to do two things:

- Add a line

    ---	24	0	0x20AC

  (the second column is computed as 24 * wcwidth(0x20AC)) to the file
  R.proto, or, when groff is already installed, to the four fonts files in
  $(prefix)/share/groff/<version>/font/devutf8/.

- In your source file, use the notation \N'8364' where 8364 is the decimal
  representation of 0x20AC.
@


1.1.1.1
log
@Virgin import of FSF groff v1.17
@
text
@@


1.1.1.2
log
@Virgin import of FSF groff v1.18.1
@
text
@a0 3
Note that all `charXXX' entity names have been removed from the font files.
They don't make sense for Unicode.

d4 1
a4 1
  \(bs    shaded solid ball (Bell System logo, AT&T logo)
d11 2
a12 2
  \(lk    middle part of big left curly brace
  \(rk    middle part of big right curly brace
d18 2
a19 4
The following line could be added; "space" is known to "devps" but are not
documented and not known to "devdvi" (actually, there is no space glyph
within the TeX system).

d21 13
a36 1

d41 1
a41 1
this glyph is just too small.  We map them to 0x007E instead.
d44 1
a44 1
this glyph is just too small.  We map them to 0x005E instead.
d46 4
a49 1
"devps" maps *U to Upsilon1, which is equivalent to 0x03D2.  We map it to
d52 2
a53 5
"devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9.
We map it to 0x03A9.

"devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394.
We map it to 0x0394.
d55 2
a56 2
"devps" maps CR to carriagereturn, which is equivalent to 0x21B5.  We map
it to 0x240D instead.
d58 2
d61 1
a61 2
Using unnamed characters
------------------------
@


1.1.1.3
log
@Virgin import of FSF groff v1.19
@
text
@d12 5
d27 6
d47 3
@


1.1.1.3.12.1
log
@MFC: Groff 1.19.2.
@
text
@d1 1
a1 1
Note that all \[charXXX] entity names have been removed from the font files.
d4 2
a5 2
The following entity from the original troff manual (by Ossanna and
Kernighan) is unmapped:
d7 1
a7 1
  bs    shaded solid ball (Bell System logo, AT&T logo)
d10 1
a10 2
HYPHEN-MINUS is so ambiguous that it is unusable for serious typographic
use.
d12 2
a13 2
\[wp] has been mapped to 0x2118, because according to Unicode 4.1's
NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass `p',
d16 3
a18 3
The following line could be added; \[space] is known to devps but is not
documented and not known to devdvi (actually, there is no space glyph within
the TeX system).
d20 1
a20 1
  space   24   0   0x0020
d22 1
a22 1
devps maps \[a~] and `~' to `asciitilde', which is equivalent to 0x02DC, but
d25 1
a25 1
devps maps \[a^] and `^' to `circumflex', which is equivalent to 0x02C6, but
d28 1
a28 1
devps maps \[*U] to `Upsilon1', which is equivalent to 0x03D2.  We map it to
d31 1
a31 1
devps maps \[*W] to `Omega', which is equivalent to either 0x2126 or 0x03A9.
d34 1
a34 1
devps maps \[*D] to `Delta', which is equivalent to either 0x2206 or 0x0394.
d38 2
a39 2
Adding Unicode characters
-------------------------
d46 1
a46 1
    u20AC   24   0   0x20AC
d52 2
a53 1
- In your source file, use the notation \[u20AC] to access it.
@


1.1.1.4
log
@Virgin import of FSF groff v1.19.2
@
text
@d1 1
a1 1
Note that all \[charXXX] entity names have been removed from the font files.
d4 2
a5 2
The following entity from the original troff manual (by Ossanna and
Kernighan) is unmapped:
d7 1
a7 1
  bs    shaded solid ball (Bell System logo, AT&T logo)
d10 1
a10 2
HYPHEN-MINUS is so ambiguous that it is unusable for serious typographic
use.
d12 2
a13 2
\[wp] has been mapped to 0x2118, because according to Unicode 4.1's
NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass `p',
d16 3
a18 3
The following line could be added; \[space] is known to devps but is not
documented and not known to devdvi (actually, there is no space glyph within
the TeX system).
d20 1
a20 1
  space   24   0   0x0020
d22 1
a22 1
devps maps \[a~] and `~' to `asciitilde', which is equivalent to 0x02DC, but
d25 1
a25 1
devps maps \[a^] and `^' to `circumflex', which is equivalent to 0x02C6, but
d28 1
a28 1
devps maps \[*U] to `Upsilon1', which is equivalent to 0x03D2.  We map it to
d31 1
a31 1
devps maps \[*W] to `Omega', which is equivalent to either 0x2126 or 0x03A9.
d34 1
a34 1
devps maps \[*D] to `Delta', which is equivalent to either 0x2206 or 0x0394.
d38 2
a39 2
Adding Unicode characters
-------------------------
d46 1
a46 1
    u20AC   24   0   0x20AC
d52 2
a53 1
- In your source file, use the notation \[u20AC] to access it.
@


1.1.1.4.30.1
log
@file NOTES was added on branch RELENG_8_4 on 2013-03-28 13:01:16 +0000
@
text
@d1 53
@


1.1.1.4.30.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 53
Note that all \[charXXX] entity names have been removed from the font files.
They don't make sense for Unicode.

The following entity from the original troff manual (by Ossanna and
Kernighan) is unmapped:

  bs    shaded solid ball (Bell System logo, AT&T logo)

Character 0x002D has not been given a name because its Unicode name
HYPHEN-MINUS is so ambiguous that it is unusable for serious typographic
use.

\[wp] has been mapped to 0x2118, because according to Unicode 4.1's
NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass `p',
neither SCRIPT not CAPITAL.

The following line could be added; \[space] is known to devps but is not
documented and not known to devdvi (actually, there is no space glyph within
the TeX system).

  space   24   0   0x0020

devps maps \[a~] and `~' to `asciitilde', which is equivalent to 0x02DC, but
this glyph is just too small.  We map them to 0x007E instead.

devps maps \[a^] and `^' to `circumflex', which is equivalent to 0x02C6, but
this glyph is just too small.  We map them to 0x005E instead.

devps maps \[*U] to `Upsilon1', which is equivalent to 0x03D2.  We map it to
0x03A5 instead.

devps maps \[*W] to `Omega', which is equivalent to either 0x2126 or 0x03A9.
We map it to 0x03A9.

devps maps \[*D] to `Delta', which is equivalent to either 0x2206 or 0x0394.
We map it to 0x0394.


Adding Unicode characters
-------------------------

Assume you want to use a Unicode character not provided in the list, say
U+20AC. You need to do two things:

- Add a line

    u20AC   24   0   0x20AC

  (the second column is computed as 24 * wcwidth(0x20AC)) to the file
  R.proto, or, when groff is already installed, to the four fonts files in
  $(prefix)/share/groff/<version>/font/devutf8/.

- In your source file, use the notation \[u20AC] to access it.
@


1.1.1.1.2.1
log
@MFC: Upgrade to Groff 1.17.
@
text
@@


1.1.1.1.2.2
log
@MFC: Groff 1.18.1.
@
text
@a0 3
Note that all `charXXX' entity names have been removed from the font files.
They don't make sense for Unicode.

d4 1
a4 1
  \(bs    shaded solid ball (Bell System logo, AT&T logo)
d11 2
a12 2
  \(lk    middle part of big left curly brace
  \(rk    middle part of big right curly brace
d18 2
a19 4
The following line could be added; "space" is known to "devps" but are not
documented and not known to "devdvi" (actually, there is no space glyph
within the TeX system).

d21 13
a36 1

d41 1
a41 1
this glyph is just too small.  We map them to 0x007E instead.
d44 1
a44 1
this glyph is just too small.  We map them to 0x005E instead.
d46 4
a49 1
"devps" maps *U to Upsilon1, which is equivalent to 0x03D2.  We map it to
d52 2
a53 5
"devps" maps *W to Omega, which is equivalent to either 0x2126 or 0x03A9.
We map it to 0x03A9.

"devps" maps *D to Delta, which is equivalent to either 0x2206 or 0x0394.
We map it to 0x0394.
d55 2
a56 2
"devps" maps CR to carriagereturn, which is equivalent to 0x21B5.  We map
it to 0x240D instead.
d58 2
d61 1
a61 2
Using unnamed characters
------------------------
@


1.1.1.1.2.3
log
@MFC: GNU Groff 1.19.
@
text
@d12 5
d27 6
d47 3
@


