Mercurial > hg > xemacs-beta

comparison man/lispref/buffers.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 6772ce4d982b
children
comparison
equal deleted inserted replaced
5790:dcf9067f26bb 5791:9fae6227ede5
29 * Creating Buffers:: Functions that create buffers. 29 * Creating Buffers:: Functions that create buffers.
30 * Killing Buffers:: Buffers exist until explicitly killed. 30 * Killing Buffers:: Buffers exist until explicitly killed.
31 * Indirect Buffers:: An indirect buffer shares text with some other buffer. 31 * Indirect Buffers:: An indirect buffer shares text with some other buffer.
32 @end menu 32 @end menu
33 33
34 @node Buffer Basics 34 @node Buffer Basics, Current Buffer, Buffers, Buffers
35 @section Buffer Basics 35 @section Buffer Basics
36 36
37 @ifinfo 37 @ifinfo
38 A @dfn{buffer} is a Lisp object containing text to be edited. Buffers 38 A @dfn{buffer} is a Lisp object containing text to be edited. Buffers
39 are used to hold the contents of files that are being visited; there may 39 are used to hold the contents of files that are being visited; there may
73 @defun bufferp object 73 @defun bufferp object
74 This function returns @code{t} if @var{object} is a buffer, 74 This function returns @code{t} if @var{object} is a buffer,
75 @code{nil} otherwise. 75 @code{nil} otherwise.
76 @end defun 76 @end defun
77 77
78 @node Current Buffer 78 @node Current Buffer, Buffer Names, Buffer Basics, Buffers
79 @section The Current Buffer 79 @section The Current Buffer
80 @cindex selecting a buffer 80 @cindex selecting a buffer
81 @cindex changing to another buffer 81 @cindex changing to another buffer
82 @cindex current buffer 82 @cindex current buffer
83 83
197 @var{buffer-or-name} must be a buffer or the name of an existing 197 @var{buffer-or-name} must be a buffer or the name of an existing
198 buffer--else an error is signaled. This function returns the buffer 198 buffer--else an error is signaled. This function returns the buffer
199 identified by @var{buffer-or-name}. 199 identified by @var{buffer-or-name}.
200 @end defun 200 @end defun
201 201
202 @node Buffer Names 202 @node Buffer Names, Buffer File Name, Current Buffer, Buffers
203 @section Buffer Names 203 @section Buffer Names
204 @cindex buffer names 204 @cindex buffer names
205 205
206 Each buffer has a unique name, which is a string. Many of the 206 Each buffer has a unique name, which is a string. Many of the
207 functions that work on buffers accept either a buffer or a buffer name 207 functions that work on buffers accept either a buffer or a buffer name
300 300
301 See the related function @code{generate-new-buffer} in @ref{Creating 301 See the related function @code{generate-new-buffer} in @ref{Creating
302 Buffers}. 302 Buffers}.
303 @end defun 303 @end defun
304 304
305 @node Buffer File Name 305 @node Buffer File Name, Buffer Modification, Buffer Names, Buffers
306 @section Buffer File Name 306 @section Buffer File Name
307 @cindex visited file 307 @cindex visited file
308 @cindex buffer file name 308 @cindex buffer file name
309 @cindex file name of buffer 309 @cindex file name of buffer
310 310
411 This buffer-local variable records a string to display in a buffer 411 This buffer-local variable records a string to display in a buffer
412 listing in place of the visited file name, for buffers that don't have a 412 listing in place of the visited file name, for buffers that don't have a
413 visited file name. Dired buffers use this variable. 413 visited file name. Dired buffers use this variable.
414 @end defvar 414 @end defvar
415 415
416 @node Buffer Modification 416 @node Buffer Modification, Modification Time, Buffer File Name, Buffers
417 @section Buffer Modification 417 @section Buffer Modification
418 @cindex buffer modification 418 @cindex buffer modification
419 @cindex modification flag (of buffer) 419 @cindex modification flag (of buffer)
420 420
421 XEmacs keeps a flag called the @dfn{modified flag} for each buffer, to 421 XEmacs keeps a flag called the @dfn{modified flag} for each buffer, to
471 This function returns @var{buffer}`s modification-count. This is a 471 This function returns @var{buffer}`s modification-count. This is a
472 counter that increments every time the buffer is modified. If 472 counter that increments every time the buffer is modified. If
473 @var{buffer} is @code{nil} (or omitted), the current buffer is used. 473 @var{buffer} is @code{nil} (or omitted), the current buffer is used.
474 @end defun 474 @end defun
475 475
476 @node Modification Time 476 @node Modification Time, Read Only Buffers, Buffer Modification, Buffers
477 @section Comparison of Modification Time 477 @section Comparison of Modification Time
478 @cindex comparison of modification time 478 @cindex comparison of modification time
479 @cindex modification time, comparison of 479 @cindex modification time, comparison of
480 480
481 Suppose that you visit a file and make changes in its buffer, and 481 Suppose that you visit a file and make changes in its buffer, and
551 See the file @file{userlock.el} for the standard definition. 551 See the file @file{userlock.el} for the standard definition.
552 552
553 See also the file locking mechanism in @ref{File Locks}. 553 See also the file locking mechanism in @ref{File Locks}.
554 @end defun 554 @end defun
555 555
556 @node Read Only Buffers 556 @node Read Only Buffers, The Buffer List, Modification Time, Buffers
557 @section Read-Only Buffers 557 @section Read-Only Buffers
558 @cindex read-only buffer 558 @cindex read-only buffer
559 @cindex buffer, read-only 559 @cindex buffer, read-only
560 560
561 If a buffer is @dfn{read-only}, then you cannot change its contents, 561 If a buffer is @dfn{read-only}, then you cannot change its contents,
629 range checked is (@var{start}, @var{end}) \(open on both ends), except 629 range checked is (@var{start}, @var{end}) \(open on both ends), except
630 that extents that lie completely within [@var{start}, @var{end}] are not 630 that extents that lie completely within [@var{start}, @var{end}] are not
631 checked. See @code{extent-in-region-p} for a fuller discussion. 631 checked. See @code{extent-in-region-p} for a fuller discussion.
632 @end defun 632 @end defun
633 633
634 @node The Buffer List 634 @node The Buffer List, Creating Buffers, Read Only Buffers, Buffers
635 @section The Buffer List 635 @section The Buffer List
636 @cindex buffer list 636 @cindex buffer list
637 637
638 The @dfn{buffer list} is a list of all live buffers. Creating a 638 The @dfn{buffer list} is a list of all live buffers. Creating a
639 buffer adds it to this list, and killing a buffer deletes it. The order 639 buffer adds it to this list, and killing a buffer deletes it. The order
738 738
739 If you wish to replace a buffer in all the windows that display it, use 739 If you wish to replace a buffer in all the windows that display it, use
740 @code{replace-buffer-in-windows}. @xref{Buffers and Windows}. 740 @code{replace-buffer-in-windows}. @xref{Buffers and Windows}.
741 @end deffn 741 @end deffn
742 742
743 @node Creating Buffers 743 @node Creating Buffers, Killing Buffers, The Buffer List, Buffers
744 @section Creating Buffers 744 @section Creating Buffers
745 @cindex creating buffers 745 @cindex creating buffers
746 @cindex buffers, creating 746 @cindex buffers, creating
747 747
748 This section describes the two primitives for creating buffers. 748 This section describes the two primitives for creating buffers.
806 806
807 See the related function @code{generate-new-buffer-name} in @ref{Buffer 807 See the related function @code{generate-new-buffer-name} in @ref{Buffer
808 Names}. 808 Names}.
809 @end defun 809 @end defun
810 810
811 @node Killing Buffers 811 @node Killing Buffers, Indirect Buffers, Creating Buffers, Buffers
812 @section Killing Buffers 812 @section Killing Buffers
813 @cindex killing buffers 813 @cindex killing buffers
814 @cindex buffers, killing 814 @cindex buffers, killing
815 815
816 @dfn{Killing a buffer} makes its name unknown to XEmacs and makes its 816 @dfn{Killing a buffer} makes its name unknown to XEmacs and makes its
896 save that buffer, just as they offer to save file-visiting buffers. The 896 save that buffer, just as they offer to save file-visiting buffers. The
897 variable @code{buffer-offer-save} automatically becomes buffer-local 897 variable @code{buffer-offer-save} automatically becomes buffer-local
898 when set for any reason. @xref{Buffer-Local Variables}. 898 when set for any reason. @xref{Buffer-Local Variables}.
899 @end defvar 899 @end defvar
900 900
901 @node Indirect Buffers 901 @node Indirect Buffers, , Killing Buffers, Buffers
902 @section Indirect Buffers 902 @section Indirect Buffers
903 @cindex indirect buffers 903 @cindex indirect buffers
904 @cindex base buffer 904 @cindex base buffer
905 905
906 An @dfn{indirect buffer} shares the text of some other buffer, which 906 An @dfn{indirect buffer} shares the text of some other buffer, which