[Emacs-diffs] master a58d4e3 2/5: Add documentation for character name escapes

[Paul Eggert]

branch: master
commit a58d4e3c0f513294b9aebacb539542ad1b87be19
Author: Philipp Stephani <address@hidden>
Commit: Paul Eggert <address@hidden>

    Add documentation for character name escapes
---
 doc/lispref/nonascii.texi |    2 +-
 doc/lispref/objects.texi  |   10 ++++++++++
 etc/NEWS                  |    5 +++++
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 9cf3b57..66ad9ac 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -633,7 +633,7 @@ This function returns the value of @var{char}'s 
@var{propname} property.
 @end group
 @group
 ;; U+2163 ROMAN NUMERAL FOUR
-(get-char-code-property ?\u2163 'numeric-value)
+(get-char-code-property address@hidden NUMERAL address@hidden 'numeric-value)
      @result{} 4
 @end group
 @group
diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index 3245930..96b334d 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -387,6 +387,16 @@ up to three octal digits; thus, @samp{?\101} for the 
character
 for the character @kbd{C-b}.  Only characters up to octal code 777 can
 be specified this way.
 
+  Fourthly, you can specify characters by their name.  A character
+name escape sequence consists of a backslash, @address@hidden, the Unicode
+character name, and @address@hidden  Alternatively, you can also put the
+numeric code point value between the braces, using the syntax
address@hidden@address@hidden, where @samp{nnnn} denotes between one and eight
+hexadecimal digits.  Thus, @address@hidden CAPITAL LETTER address@hidden and
address@hidden@address@hidden both denote the character @kbd{A}.  To simplify
+entering multi-line strings, you can replace spaces in the character
+names by arbitrary non-empty sequence of whitespace (e.g., newlines).
+
   These escape sequences may also be used in strings.  @xref{Non-ASCII
 in Strings}.
 
diff --git a/etc/NEWS b/etc/NEWS
index 0411f19..a9b3922 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -166,6 +166,11 @@ different group ID.
 *** Support for completing attribute values and bang-rules using the
 'completion-at-point' command.
 
++++
+** Emacs now supports character name escape sequences in character and
+string literals.  The syntax variants \N{character name} and
+\N{U+code} are supported.
+
 
 * New Modes and Packages in Emacs 25.2