(Character Properties): Improve wording.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index bf6d58f15dbaf24e46cb0eb55c6cd74407724496..8d55c3958bee0e7ed51431995de32beba4116a99 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -2,6 +2,7 @@
 
        * nonascii.texi (Lisp and Coding Systems): Document
        inhibit-null-byte-detection and inhibit-iso-escape-detection.
+       (Character Properties): Improve wording.
 
 2009-01-09  Chong Yidong  <cyd@stupidchicken.com>
 

diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index fceabcc3fc166ff539f468a71e1e7267c0099eb3..f454835585d4d1ae30e49c6b9a548a52d56ac523 100644 (file)
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -370,9 +370,16 @@ retrieving properties of characters.
 
   In Emacs, each property has a name, which is a symbol, and a set of
 possible values, whose types depend on the property; if a character
-does not have a certain property, the value is @code{nil}.  Here's the
-full list of value types for all the character properties that Emacs
-knows about:
+does not have a certain property, the value is @code{nil}.  As a
+general rule, the names of character properties in Emacs are produced
+from the corresponding Unicode properties by downcasing them and
+replacing each @samp{_} character with a dash @samp{-}.  For example,
+@code{Canonical_Combining_Class} becomes
+@code{canonical-combining-class}.  However, sometimes we shorten the
+names to make their use easier.
+
+  Here's the full list of value types for all the character properties
+that Emacs knows about:
 
 @table @code
 @item name
@@ -399,8 +406,9 @@ Corresponds to the Unicode @code{Decomposition_Type} and
 @code{Decomposition_Value} properties.  The value is a list, whose
 first element may be a symbol representing a compatibility formatting
 tag, such as @code{small}@footnote{
-Note that Emacs strips the @samp{<..>} brackets from the corresponding
-Unicode tags; e.g., Unicode specifies @samp{<small>} where Emacs uses
+Note that the Unicode spec writes these tag names inside
+@samp{<..>} brackets.  The tag names in Emacs do not include the
+brackets; e.g., Unicode specifies @samp{<small>} where Emacs uses
 @samp{small}.
 }; the other elements are characters that give the compatibility
 decomposition sequence of this character.
@@ -428,7 +436,7 @@ numbers.  For example, the value of this property for the character
 
 @item mirrored
 Corresponds to the Unicode @code{Bidi_Mirrored} property.  The value
-of this property is a symbol, either @samp{Y} or @samp{N}.
+of this property is a symbol, either @code{Y} or @code{N}.
 
 @item old-name
 Corresponds to the Unicode @code{Unicode_1_Name} property.  The value