[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100483: Document *SUBSTRING completion for Unicode character names.

[Eli Zaretskii]

------------------------------------------------------------
revno: 100483
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-23
timestamp: Fri 2011-02-18 17:43:22 +0200
message:
  Document *SUBSTRING completion for Unicode character names.
  
   international/mule-cmds.el (read-char-by-name, ucs-insert):
   Document completion with asterisk and a substring.
modified:
  lisp/ChangeLog
  lisp/international/mule-cmds.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-02-18 05:15:22 +0000
+++ b/lisp/ChangeLog    2011-02-18 15:43:22 +0000
@@ -1,3 +1,8 @@
+2011-02-18  Eli Zaretskii  <address@hidden>
+
+       * international/mule-cmds.el (read-char-by-name, ucs-insert):
+       Document completion with asterisk and a substring.
+
 2011-02-18  Glenn Morris  <address@hidden>
 
        * files.el (find-file-literally): Doc fix.

=== modified file 'lisp/international/mule-cmds.el'
--- a/lisp/international/mule-cmds.el   2011-01-02 23:50:46 +0000
+++ b/lisp/international/mule-cmds.el   2011-02-18 15:43:22 +0000
@@ -2934,11 +2934,19 @@
 (defun read-char-by-name (prompt)
   "Read a character by its Unicode name or hex number string.
 Display PROMPT and read a string that represents a character by its
-Unicode property `name' or `old-name'.  You can type a few of first
-letters of the Unicode name and use completion.  This function also
-accepts a hexadecimal number of Unicode code point or a number in
-hash notation, e.g. #o21430 for octal, #x2318 for hex, or #10r8984
-for decimal.  Returns a character as a number."
+Unicode property `name' or `old-name'.
+
+This function returns the character as a number.
+
+You can type a few of the first letters of the Unicode name and
+use completion.  If you type a substring of the Unicode name
+preceded by an asterisk `*' and use completion, it will show all
+the characters whose names include that substring, not necessarily
+at the beginning of the name.
+
+This function also accepts a hexadecimal number of Unicode code
+point or a number in hash notation, e.g. #o21430 for octal,
+#x2318 for hex, or #10r8984 for decimal."
   (let* ((completion-ignore-case t)
         (input (completing-read prompt ucs-completions)))
     (cond
@@ -2953,6 +2961,13 @@
   "Insert COUNT copies of CHARACTER of the given Unicode code point.
 Interactively, prompts for a Unicode character name or a hex number
 using `read-char-by-name'.
+
+You can type a few of the first letters of the Unicode name and
+use completion.  If you type a substring of the Unicode name
+preceded by an asterisk `*' and use completion, it will show all
+the characters whose names include that substring, not necessarily
+at the beginning of the name.
+
 The optional third arg INHERIT (non-nil when called interactively),
 says to inherit text properties from adjoining text, if those
 properties are sticky."