summaryrefslogtreecommitdiff
path: root/devdocs/elisp/describing-characters.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/elisp/describing-characters.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/elisp/describing-characters.html')
-rw-r--r--devdocs/elisp/describing-characters.html45
1 files changed, 0 insertions, 45 deletions
diff --git a/devdocs/elisp/describing-characters.html b/devdocs/elisp/describing-characters.html
deleted file mode 100644
index 0c584729..00000000
--- a/devdocs/elisp/describing-characters.html
+++ /dev/null
@@ -1,45 +0,0 @@
- <h3 class="section">Describing Characters for Help Messages</h3> <p>These functions convert events, key sequences, or characters to textual descriptions. These descriptions are useful for including arbitrary text characters or key sequences in messages, because they convert non-printing and whitespace characters to sequences of printing characters. The description of a non-whitespace printing character is the character itself. </p> <dl> <dt id="key-description">Function: <strong>key-description</strong> <em>sequence &amp;optional prefix</em>
-</dt> <dd>
- <p>This function returns a string containing the Emacs standard notation for the input events in <var>sequence</var>. If <var>prefix</var> is non-<code>nil</code>, it is a sequence of input events leading up to <var>sequence</var> and is included in the return value. Both arguments may be strings, vectors or lists. See <a href="input-events">Input Events</a>, for more information about valid events. </p> <div class="example"> <pre class="example">(key-description [?\M-3 delete])
- ⇒ "M-3 &lt;delete&gt;"
-</pre>
-<pre class="example">(key-description [delete] "\M-3")
- ⇒ "M-3 &lt;delete&gt;"
-</pre>
-</div> <p>See also the examples for <code>single-key-description</code>, below. </p>
-</dd>
-</dl> <dl> <dt id="single-key-description">Function: <strong>single-key-description</strong> <em>event &amp;optional no-angles</em>
-</dt> <dd>
- <p>This function returns a string describing <var>event</var> in the standard Emacs notation for keyboard input. A normal printing character appears as itself, but a control character turns into a string starting with ‘<samp>C-</samp>’, a meta character turns into a string starting with ‘<samp>M-</samp>’, and space, tab, etc., appear as ‘<samp>SPC</samp>’, ‘<samp>TAB</samp>’, etc. A function key symbol appears inside angle brackets ‘<samp>&lt;…&gt;</samp>’. An event that is a list appears as the name of the symbol in the <small>CAR</small> of the list, inside angle brackets. </p> <p>If the optional argument <var>no-angles</var> is non-<code>nil</code>, the angle brackets around function keys and event symbols are omitted; this is for compatibility with old versions of Emacs which didn’t use the brackets. </p> <div class="example"> <pre class="example">(single-key-description ?\C-x)
- ⇒ "C-x"
-</pre>
-<pre class="example">(key-description "\C-x \M-y \n \t \r \f123")
- ⇒ "C-x SPC M-y SPC C-j SPC TAB SPC RET SPC C-l 1 2 3"
-</pre>
-<pre class="example">(single-key-description 'delete)
- ⇒ "&lt;delete&gt;"
-</pre>
-<pre class="example">(single-key-description 'C-mouse-1)
- ⇒ "C-&lt;mouse-1&gt;"
-</pre>
-<pre class="example">(single-key-description 'C-mouse-1 t)
- ⇒ "C-mouse-1"
-</pre>
-</div> </dd>
-</dl> <dl> <dt id="text-char-description">Function: <strong>text-char-description</strong> <em>character</em>
-</dt> <dd>
-<p>This function returns a string describing <var>character</var> in the standard Emacs notation for characters that can appear in text—similar to <code>single-key-description</code>, except that the argument must be a valid character code that passes a <code>characterp</code> test (see <a href="character-codes">Character Codes</a>). The function produces descriptions of control characters with a leading caret (which is how Emacs usually displays control characters in buffers). Characters with modifier bits will cause this function to signal an error (<acronym>ASCII</acronym> characters with the Control modifier are an exception, they are represented as control characters). </p> <div class="example"> <pre class="example">(text-char-description ?\C-c)
- ⇒ "^C"
-</pre>
-<pre class="example">(text-char-description ?\M-m)
- error→ Wrong type argument: characterp, 134217837
-</pre>
-</div> </dd>
-</dl> <dl> <dt id="read-kbd-macro">Command: <strong>read-kbd-macro</strong> <em>string &amp;optional need-vector</em>
-</dt> <dd><p>This function is used mainly for operating on keyboard macros, but it can also be used as a rough inverse for <code>key-description</code>. You call it with a string containing key descriptions, separated by spaces; it returns a string or vector containing the corresponding events. (This may or may not be a single valid key sequence, depending on what events you use; see <a href="key-sequences">Key Sequences</a>.) If <var>need-vector</var> is non-<code>nil</code>, the return value is always a vector. </p></dd>
-</dl><div class="_attribution">
- <p class="_attribution-p">
- Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
- <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Describing-Characters.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Describing-Characters.html</a>
- </p>
-</div>