diff options
Diffstat (limited to 'devdocs/elisp/positions.html')
| -rw-r--r-- | devdocs/elisp/positions.html | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/devdocs/elisp/positions.html b/devdocs/elisp/positions.html new file mode 100644 index 00000000..cb1c4e7a --- /dev/null +++ b/devdocs/elisp/positions.html @@ -0,0 +1,26 @@ + <h2 class="chapter">Positions</h2> <p>A <em>position</em> is the index of a character in the text of a buffer. More precisely, a position identifies the place between two characters (or before the first character, or after the last character), so we can speak of the character before or after a given position. However, we often speak of the character “at” a position, meaning the character after that position. </p> <p>Positions are usually represented as integers starting from 1, but can also be represented as <em>markers</em>—special objects that relocate automatically when text is inserted or deleted so they stay with the surrounding characters. Functions that expect an argument to be a position (an integer), but accept a marker as a substitute, normally ignore which buffer the marker points into; they convert the marker to an integer, and use that integer, exactly as if you had passed the integer as the argument, even if the marker points to the wrong buffer. A marker that points nowhere cannot convert to an integer; using it instead of an integer causes an error. See <a href="markers">Markers</a>. </p> <p>See also the field feature (see <a href="fields">Fields</a>), which provides functions that are used by many cursor-motion commands. </p> <table class="menu" border="0" cellspacing="0"> <tr> +<td align="left" valign="top">• <a href="point" accesskey="1">Point</a> +</td> +<td> </td> +<td align="left" valign="top">The special position where editing takes place. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="motion" accesskey="2">Motion</a> +</td> +<td> </td> +<td align="left" valign="top">Changing point. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="excursions" accesskey="3">Excursions</a> +</td> +<td> </td> +<td align="left" valign="top">Temporary motion and buffer changes. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="narrowing" accesskey="4">Narrowing</a> +</td> +<td> </td> +<td align="left" valign="top">Restricting editing to a portion of the buffer. </td> +</tr> </table><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 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/Positions.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Positions.html</a> + </p> +</div> |