[Groff-commit] groff ChangeLog man/groff.man man/groff_char.ma...

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     08/01/15 06:24:41

Modified files:
        .              : ChangeLog 
        man            : groff.man groff_char.man groff_diff.man 

Log message:
        * man/groff.man: Mention glyph and characters.
        Minor other updates.
        * man/groff_char.man: Minor updates.
        * man/groff_diff.man: Better clarification between characters and
        glyphs.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1122&r2=1.1123
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff.man?cvsroot=groff&r1=1.98&r2=1.99
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff_char.man?cvsroot=groff&r1=1.29&r2=1.30
http://cvs.savannah.gnu.org/viewcvs/groff/man/groff_diff.man?cvsroot=groff&r1=1.66&r2=1.67

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1122
retrieving revision 1.1123
diff -u -b -r1.1122 -r1.1123
--- ChangeLog   12 Jan 2008 22:31:33 -0000      1.1122
+++ ChangeLog   15 Jan 2008 06:24:40 -0000      1.1123
@@ -1,3 +1,11 @@
+2008-01-14  Werner LEMBERG  <address@hidden>
+
+       * man/groff.man: Mention glyph and characters.
+       Minor other updates.
+       * man/groff_char.man: Minor updates.
+       * man/groff_diff.man: Better clarification between characters and
+       glyphs.
+
 2008-01-12  Werner LEMBERG  <address@hidden>
 
        * doc/groff.texinfo: Fix top-level structure to make it compilable

Index: man/groff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff.man,v
retrieving revision 1.98
retrieving revision 1.99
diff -u -b -r1.98 -r1.99
--- man/groff.man       4 Jan 2008 23:29:19 -0000       1.98
+++ man/groff.man       15 Jan 2008 06:24:41 -0000      1.99
@@ -486,6 +486,23 @@
 On text devices, all glyphs have a constant width anyway.
 .
 .P
+.B Glyphs
+are visual representation forms of
+.BR characters .
+In groff, the distinction between those two elements is not always
+obvious (and a full discussion is beyond the scope of this man page).
+.
+A first approximation is that glyphs have a specific size and
+colour and are taken from a specific font; they can't be modified any
+more \[en] characters are the input, and glyphs are the output.
+.
+As soon as an output line has been generated, it no longer contains
+characters but glyphs.
+.
+In this man page, we use either `glyph' or `character', whatever is
+more appropriate.
+.
+.P
 Moreover, there are some advanced roff elements.
 .
 A
@@ -1257,7 +1274,7 @@
 .
 .TPx
 .REQ .cflags "mode c1 c2 .\|.\|.\&"
-Treat glyphs
+Treat characters
 .IR c1 ,
 .IR c2 ,
 .I .\|.\|.\&
@@ -1558,7 +1575,7 @@
 .
 .TPx
 .REQ .fchar "c anything"
-Define fallback glyph
+Define fallback character (or glyph)
 .I c
 as string
 .IR anything .
@@ -1598,7 +1615,7 @@
 .
 .TPx
 .REQ .fschar "f c anything"
-Define fallback glyph
+Define fallback character (or glyph)
 .I c
 for font
 .I f
@@ -2181,7 +2198,7 @@
 .
 .TPx
 .REQ .schar "c anything"
-Define global fallback glyph\~\c
+Define global fallback character (or glyph)\~\c
 .I c
 as string
 .IR anything .

Index: man/groff_char.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff_char.man,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- man/groff_char.man  5 Jan 2008 20:59:06 -0000       1.29
+++ man/groff_char.man  15 Jan 2008 06:24:41 -0000      1.30
@@ -411,7 +411,7 @@
 .
 .P
 Some of the predefined groff escape sequences (with names of length\ 1)
-also produce single characters; these exist for historical reasons or
+also produce single glyphs; these exist for historical reasons or
 are printable versions of syntactical characters.
 .
 They include `\f(CW\e\e\fP', `\f(CW\e\'\fP', `\f(CW\e`\fP', `\f(CW\e-\fP',
@@ -1258,7 +1258,7 @@
 .2e hbar uni210F u210F
 .
 .Pa
-.I Greek characters
+.I Greek glyphs
 .P
 These glyphs are intended for technical use, not for real Greek; normally,
 the uppercase letters have upright shape, and the lowercase ones are

Index: man/groff_diff.man
===================================================================
RCS file: /cvsroot/groff/groff/man/groff_diff.man,v
retrieving revision 1.66
retrieving revision 1.67
diff -u -b -r1.66 -r1.67
--- man/groff_diff.man  5 Jan 2008 20:59:06 -0000       1.66
+++ man/groff_diff.man  15 Jan 2008 06:24:41 -0000      1.67
@@ -98,7 +98,7 @@
 special characters (glyphs), and colors can be of any length.
 .
 In escape sequences, additionally to the classical `\fB(\fP\fIxx\fP'
-construction for a two-character name, you can use
+construction for a two-character glyph name, you can use
 `\fB[\fP\fIxxx\fP\fB]\fP' for a name of arbitrary length.
 .
 .TP
@@ -743,7 +743,7 @@
 .B \[rs])
 Like
 .B \[rs]&
-except that it behaves like a glyph declared with the
+except that it behaves like a character declared with the
 .B cflags
 request to be transparent for the purposes of end-of-sentence
 recognition.
@@ -965,7 +965,7 @@
 .
 .TP
 .BI .cflags\  n\ c1\ c2\|.\|.\|.\&
-Glyphs
+Characters
 .IR c1 ,
 .IR c2 ,\|.\|.\|.\&
 have properties determined by
@@ -974,57 +974,59 @@
 .
 .RS
 .IP 1
-The glyph ends sentences (initially glyphs
+The character ends sentences (initially characters
 .B .?!\&
 have this property).
 .
 .IP 2
-Lines can be broken before the glyph (initially no glyphs have
-this property); a line is not broken at a glyph with this
-property unless the input characters associated with those glyphs
-on each side both have non-zero hyphenation codes.
+Lines can be broken before the character (initially no characters have
+this property); a line is not broken at a character with this property
+unless the characters on each side both have non-zero hyphenation
+codes.
 This can be overridden with value 64.
 .
 .IP 4
-Lines can be broken after the glyph (initially glyphs
+Lines can be broken after the character (initially characters
 .B \-\[rs][hy]\[rs][em]
-have this property); a line is not broken at a glyph with
-this property unless the input characters associated with those
-glyphs on each side both have non-zero hyphenation codes.
+have this property); a line is not broken at a character with this
+property unless the characters on each side both have non-zero
+hyphenation codes.
+
 This can be overridden with value 64.
 .
 .IP 8
-The glyph overlaps horizontally (initially glyphs
+The glyph associated with this character overlaps horizontally
+(initially characters
 .B \[rs][ul]\[rs][rn]\[rs][ru]\[rs][radicalex]\[rs][sqrtex]
 have this property).
 .
 .IP 16
-The glyph overlaps vertically (initially glyph
+The glyph associated with this character overlaps vertically
+(initially glyph
 .B \[rs][br]
 has this property).
 .
 .IP 32
-An end-of-sentence glyph followed by any number of glyphs with
-this property is treated as the end of a sentence if followed by
-a newline or two spaces; in other words the glyph is transparent
-for the purposes of end-of-sentence recognition; this is the same as
-having a zero space factor in \*[tx] (initially glyphs
+An end-of-sentence character followed by any number of characters with
+this property is treated as the end of a sentence if followed by a
+newline or two spaces; in other words the character is transparent for
+the purposes of end-of-sentence recognition; this is the same as having
+a zero space factor in \*[tx] (initially characters
 .B \[dq]')]*\[rs][dg]\[rs][rq]
 have this property).
 .
 .IP 64
 Ignore hyphenation code values of the surrounding characters.
-Use this in combination with values 2 and\~4 (initially no glyphs have
-this property).
+Use this in combination with values 2 and\~4 (initially no characters
+have this property).
 .RE
 .
 .TP
 .BI .char\  c\ string
-[This request's name is a misnomer since it constructs output objects
-(glyphs) not input objects (characters).]
+[This request can both define characters and glyphs.]
 .
 .IP
-Define glyph\~\c
+Define entity\~\c
 .I c
 to be
 .IR string .
@@ -1346,7 +1348,7 @@
 .
 .TP
 .BI .fchar\  c\ string
-Define fallback glyph\~\c
+Define fallback character (or glyph)\~\c
 .I c
 to be
 .IR string .
@@ -1373,7 +1375,7 @@
 .
 .TP
 .BI .fschar\  f\ c\ string
-Define fallback glyph\~\c
+Define fallback character (or glyph)\~\c
 .I c
 for font\~\c
 .I f
@@ -1960,7 +1962,7 @@
 .
 .TP
 .BI .schar\  c\ string
-Define global fallback glyph\~\c
+Define global fallback character (or glyph)\~\c
 .I c
 to be
 .IR string .
@@ -3115,7 +3117,7 @@
 .
 .TP
 .BI .if\ c ch
-True if there is a glyph
+True if there is a character (or glyph)
 .IR ch
 available;
 .I ch