From a167e505d53ca8a971e38fd85f757ca2e2cebda8 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 18 Feb 2011 17:43:22 +0200 Subject: [PATCH] Document *SUBSTRING completion for Unicode character names. international/mule-cmds.el (read-char-by-name, ucs-insert): Document completion with asterisk and a substring. --- lisp/ChangeLog | 5 +++++ lisp/international/mule-cmds.el | 25 ++++++++++++++++++++----- 2 files changed, 25 insertions(+), 5 deletions(-) diff --git a/lisp/ChangeLog b/lisp/ChangeLog index cdf6dbf4944..da5b9ebbda2 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,3 +1,8 @@ +2011-02-18 Eli Zaretskii + + * international/mule-cmds.el (read-char-by-name, ucs-insert): + Document completion with asterisk and a substring. + 2011-02-18 Glenn Morris * files.el (find-file-literally): Doc fix. diff --git a/lisp/international/mule-cmds.el b/lisp/international/mule-cmds.el index fed7e6ec9b1..0ca4a740586 100644 --- a/lisp/international/mule-cmds.el +++ b/lisp/international/mule-cmds.el @@ -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." -- 2.39.2