X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/41306318777a942420bc4feadbfacf662ea179dc..0e963201d03d9229bb8ac4323291d2b0119526ed:/doc/lispref/markers.texi diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi index d94908994e..d44085527a 100644 --- a/doc/lispref/markers.texi +++ b/doc/lispref/markers.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@c Copyright (C) 1990-1995, 1998-1999, 2001-2016 Free Software @c Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Markers @@ -20,8 +20,8 @@ deleted, so that it stays with the two characters on either side of it. * Marker Insertion Types:: Two ways a marker can relocate when you insert where it points. * Moving Markers:: Moving the marker to a new buffer or position. -* The Mark:: How "the mark" is implemented with a marker. -* The Region:: How to access "the region". +* The Mark:: How the mark is implemented with a marker. +* The Region:: How to access the region. @end menu @node Overview of Markers @@ -118,6 +118,8 @@ m1 @node Predicates on Markers @section Predicates on Markers +@cindex predicates for markers +@cindex markers, predicates for You can test an object to see whether it is a marker, or whether it is either an integer or a marker. The latter test is useful in connection @@ -141,6 +143,8 @@ integer or floating point) or a marker, @code{nil} otherwise. @node Creating Markers @section Functions that Create Markers +@cindex creating markers +@cindex marker creation When you create a new marker, you can make it point nowhere, or point to the present position of point, or to the beginning or end of the @@ -269,6 +273,7 @@ if they both point nowhere. @node Information from Markers @section Information from Markers +@cindex marker information This section describes the functions for accessing the components of a marker object. @@ -282,8 +287,8 @@ This function returns the position that @var{marker} points to, or This function returns the buffer that @var{marker} points into, or @code{nil} if it points nowhere. -@c FIXME: The `buffer' argument of `set-marker' already defaults to -@c the current buffer, why use `(current-buffer)' explicitly here? +@c FIXME: The 'buffer' argument of 'set-marker' already defaults to +@c the current buffer, why use '(current-buffer)' explicitly here? @example @group (setq m (make-marker)) @@ -342,6 +347,8 @@ specify the insertion type, create them with insertion type @node Moving Markers @section Moving Marker Positions +@cindex moving markers +@cindex marker, how to move position This section describes how to change the position of an existing marker. When you do this, be sure you know whether the marker is used @@ -397,7 +404,7 @@ This is another name for @code{set-marker}. Each buffer has a special marker, which is designated @dfn{the mark}. When a buffer is newly created, this marker exists but does -not point anywhere; this means that the mark ``doesn't exist'' in that +not point anywhere; this means that the mark doesn't exist in that buffer yet. Subsequent commands can set the mark. The mark specifies a position to bound a range of text for many @@ -417,7 +424,7 @@ sets the mark to the value of point before doing any replacements, because this enables the user to move back there conveniently after the replace is finished. - Once the mark ``exists'' in a buffer, it normally never ceases to + Once the mark exists in a buffer, it normally never ceases to exist. However, it may become @dfn{inactive}, if Transient Mark mode is enabled. The buffer-local variable @code{mark-active}, if non-@code{nil}, means that the mark is active. A command can call the @@ -613,7 +620,7 @@ This piece of command_loop_1, run unless deactivating the mark: @end defvar @defun handle-shift-selection -This function implements the ``shift-selection'' behavior of +This function implements the shift-selection behavior of point-motion commands. @xref{Shift Selection,,, emacs, The GNU Emacs Manual}. It is called automatically by the Emacs command loop whenever a command with a @samp{^} character in its @code{interactive} @@ -654,8 +661,8 @@ more marks than this are pushed onto the @code{mark-ring}, @node The Region @section The Region -@c The index entry must be just ``region'' to make it the first hit -@c when the user types ``i region RET'', because otherwise the Info +@c The index entry must be just "region" to make it the first hit +@c when the user types "i region RET", because otherwise the Info @c reader will present substring matches in alphabetical order, @c putting this one near the end, with something utterly unrelated as @c the first hit. @@ -705,4 +712,3 @@ A region is valid if it has a non-zero size, or if the user option cases, you should not use @code{region-active-p}, since if the region is empty it is often more appropriate to operate on point. @end defun -