[groff] 01/01: groff.7: add documentation for the Unicode escapes \[u....] and \[u.....].

[Bernd Warken]

bwarken pushed a commit to branch master
in repository groff.

commit 6054a4ec485f633c587f36054cb3686b337829f3
Author: Bernd Warken <address@hidden>
Date:   Tue Aug 5 23:59:38 2014 +0200

    groff.7: add documentation for the Unicode escapes \[u....] and \[u.....].
---
 ChangeLog     |    5 ++++
 man/groff.man |   61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 65 insertions(+), 1 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 3f27c49..396bb48 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2014-08-05  Bernd Warken  <address@hidden>
+
+       * man/groff.man (groff.7): Add documentation for the Unicode
+       escapes \[u....] and \[u.....].
+
 2014-08-02  Bernd Warken  <address@hidden>
 
        * src/roff/groff/groff.man: Improve documentation for `utf8'.
diff --git a/man/groff.man b/man/groff.man
index c7120d4..061d608 100644
--- a/man/groff.man
+++ b/man/groff.man
@@ -3,7 +3,7 @@
 before installation: <top-groff-source>/man/groff.man
 after installation:  </usr or /usr/local>/share/man/man7/groff.7
 
-Latest update: 12 Jul 2014
+Latest update: 5 Aug 2014
 
 This file is part of groff, the GNU roff type-setting system.
 
@@ -3459,6 +3459,65 @@ Plus-minus sign
 .
 .
 .\" --------------------------------------------------------------------
+.SS "Unicode Characters"
+.\" --------------------------------------------------------------------
+.
+There is the extended escape
+.B u
+that allows to include all available Unicode characters into some
+.I roff
+file.
+.
+.
+.TP
+.BI \(rs[u xxxx ]
+.B u
+is the escape name.
+.
+.I xxxx
+is a hexadecimal number of 4 hex digits, such as
+.B 0041
+for the letter
+.BR A ,
+see
+.BR \(rs[0041] .
+. 
+.
+.TP
+.BI \(rs[u yyyyy ]
+.B u
+is the escape name.
+.
+.I yyyyy
+is a hexadecimal number of 5 hex digits, such as
+.B 2FA1A
+for a Chinese looking character for
+.IR "CJK Compatibility Ideographs Supplement" ,
+see
+.BR \(rs[2FA1A] .
+.
+.
+.RS
+.P
+Both hexadecimal collections mean the corresponding Unicode code for a
+character.
+.
+.
+.P
+The availability depends on the used font.
+.
+For text mode, the device
+.B -Tutf8
+is most complete, for
+.I troff
+modes it might happen that some or many characters will not be
+displayed.
+.
+Please check your fonts.
+.RE
+.
+.
+.\" --------------------------------------------------------------------
 .SS "Strings"
 .\" --------------------------------------------------------------------
 .