Mercurial > hg > xemacs-beta

comparison man/lispref/markers.texi @ 5791:9fae6227ede5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up pointers to all nodes. See xemacs-patches message with ID <5315f7bf.sHpFD7lXYR05GH6E%james@xemacs.org>.
author Jerry James <james@xemacs.org>
date Thu, 27 Mar 2014 08:59:03 -0600
parents f43f9ca6c7d9
children
comparison
equal deleted inserted replaced
5790:dcf9067f26bb 5791:9fae6227ede5
20 * Changing Markers:: Moving the marker to a new buffer or position. 20 * Changing Markers:: Moving the marker to a new buffer or position.
21 * The Mark:: How ``the mark'' is implemented with a marker. 21 * The Mark:: How ``the mark'' is implemented with a marker.
22 * The Region:: How to access ``the region''. 22 * The Region:: How to access ``the region''.
23 @end menu 23 @end menu
24 24
25 @node Overview of Markers 25 @node Overview of Markers, Predicates on Markers, Markers, Markers
26 @section Overview of Markers 26 @section Overview of Markers
27 27
28 A marker specifies a buffer and a position in that buffer. The marker 28 A marker specifies a buffer and a position in that buffer. The marker
29 can be used to represent a position in the functions that require one, 29 can be used to represent a position in the functions that require one,
30 just as an integer could be used. @xref{Positions}, for a complete 30 just as an integer could be used. @xref{Positions}, for a complete
148 (set-marker m1 nil) 148 (set-marker m1 nil)
149 @result{} #<marker in no buffer> 149 @result{} #<marker in no buffer>
150 @end group 150 @end group
151 @end example 151 @end example
152 152
153 @node Predicates on Markers 153 @node Predicates on Markers, Creating Markers, Overview of Markers, Markers
154 @section Predicates on Markers 154 @section Predicates on Markers
155 155
156 You can test an object to see whether it is a marker, or whether it is 156 You can test an object to see whether it is a marker, or whether it is
157 either an integer or a marker or either an integer, a character, or a 157 either an integer or a marker or either an integer, a character, or a
158 marker. The latter tests are useful in connection with the arithmetic 158 marker. The latter tests are useful in connection with the arithmetic
182 @defun number-char-or-marker-p object 182 @defun number-char-or-marker-p object
183 This function returns @code{t} if @var{object} is a number (either 183 This function returns @code{t} if @var{object} is a number (either
184 kind), a character, or a marker, @code{nil} otherwise. 184 kind), a character, or a marker, @code{nil} otherwise.
185 @end defun 185 @end defun
186 186
187 @node Creating Markers 187 @node Creating Markers, Information from Markers, Predicates on Markers, Markers
188 @section Functions That Create Markers 188 @section Functions That Create Markers
189 189
190 When you create a new marker, you can make it point nowhere, or point 190 When you create a new marker, you can make it point nowhere, or point
191 to the present position of point, or to the beginning or end of the 191 to the present position of point, or to the beginning or end of the
192 accessible portion of the buffer, or to the same place as another given 192 accessible portion of the buffer, or to the same place as another given
338 @result{} #<marker at 7572 in markers.texi> 338 @result{} #<marker at 7572 in markers.texi>
339 @end group 339 @end group
340 @end example 340 @end example
341 @end defun 341 @end defun
342 342
343 @node Information from Markers 343 @node Information from Markers, Changing Markers, Creating Markers, Markers
344 @section Information from Markers 344 @section Information from Markers
345 345
346 This section describes the functions for accessing the components of a 346 This section describes the functions for accessing the components of a
347 marker object. 347 marker object.
348 348
386 386
387 Two distinct markers are considered @code{equal} (even though not 387 Two distinct markers are considered @code{equal} (even though not
388 @code{eq}) to each other if they have the same position and buffer, or 388 @code{eq}) to each other if they have the same position and buffer, or
389 if they both point nowhere. 389 if they both point nowhere.
390 390
391 @node Changing Markers 391 @node Changing Markers, The Mark, Information from Markers, Markers
392 @section Changing Marker Positions 392 @section Changing Marker Positions
393 393
394 This section describes how to change the position of an existing 394 This section describes how to change the position of an existing
395 marker. When you do this, be sure you know whether the marker is used 395 marker. When you do this, be sure you know whether the marker is used
396 outside of your program, and, if so, what effects will result from 396 outside of your program, and, if so, what effects will result from
435 435
436 @defun move-marker marker position &optional buffer 436 @defun move-marker marker position &optional buffer
437 This is another name for @code{set-marker}. 437 This is another name for @code{set-marker}.
438 @end defun 438 @end defun
439 439
440 @node The Mark 440 @node The Mark, The Region, Changing Markers, Markers
441 @section The Mark 441 @section The Mark
442 @cindex mark, the 442 @cindex mark, the
443 @cindex mark ring 443 @cindex mark ring
444 @cindex global mark ring 444 @cindex global mark ring
445 445
659 @deffn Command pop-global-mark 659 @deffn Command pop-global-mark
660 This function pops a mark off the global mark ring and jumps to that 660 This function pops a mark off the global mark ring and jumps to that
661 location. 661 location.
662 @end deffn 662 @end deffn
663 663
664 @node The Region 664 @node The Region, , The Mark, Markers
665 @section The Region 665 @section The Region
666 @cindex region, the 666 @cindex region, the
667 667
668 The text between point and the mark is known as @dfn{the region}. 668 The text between point and the mark is known as @dfn{the region}.
669 Various functions operate on text delimited by point and the mark, but 669 Various functions operate on text delimited by point and the mark, but