1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-30 12:21:25 -08:00

Document *SUBSTRING completion for Unicode character names.

international/mule-cmds.el (read-char-by-name, ucs-insert):
 Document completion with asterisk and a substring.
This commit is contained in:
Eli Zaretskii 2011-02-18 17:43:22 +02:00
parent 0c973505c8
commit a167e505d5
2 changed files with 25 additions and 5 deletions

View file

@ -1,3 +1,8 @@
2011-02-18 Eli Zaretskii <eliz@gnu.org>
* international/mule-cmds.el (read-char-by-name, ucs-insert):
Document completion with asterisk and a substring.
2011-02-18 Glenn Morris <rgm@gnu.org>
* files.el (find-file-literally): Doc fix.

View file

@ -2934,11 +2934,19 @@ on encoding."
(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 @@ for decimal. Returns a character as a number."
"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."