# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2021-11-07 12:11+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: chapter #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:6 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:7 #, no-wrap msgid "Buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:8 #, no-wrap msgid "buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:17 msgid "" "A @dfn{buffer} is a Lisp object containing text to be edited. Buffers are " "used to hold the contents of files that are being visited; there may also be " "buffers that are not visiting files. While several buffers may exist at one " "time, only one buffer is designated the @dfn{current buffer} at any time. " "Most editing commands act on the contents of the current buffer. Each " "buffer, including the current buffer, may or may not be displayed in any " "windows." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:36 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:37 #, no-wrap msgid "Buffer Basics" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "What is a buffer?" msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:80 #, no-wrap msgid "Current Buffer" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Designating a buffer as current so that primitives will access its contents." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:257 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:258 #, no-wrap msgid "Buffer Names" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Accessing and changing buffer names." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:374 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:375 #, no-wrap msgid "Buffer File Name" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "The buffer file name indicates which file is visited." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:522 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:523 #, no-wrap msgid "Buffer Modification" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "A buffer is @dfn{modified} if it needs to be saved." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:611 #, no-wrap msgid "Modification Time" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Determining whether the visited file was changed behind Emacs's back." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:708 #, no-wrap msgid "Read Only Buffers" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Modifying text is not allowed in a read-only buffer." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:788 #, no-wrap msgid "Buffer List" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "How to look at all the existing buffers." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:956 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:957 #, no-wrap msgid "Creating Buffers" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Functions that create buffers." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1034 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1035 #, no-wrap msgid "Killing Buffers" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Buffers exist until explicitly killed." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1158 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1159 #, no-wrap msgid "Indirect Buffers" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "An indirect buffer shares text with some other buffer." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1227 #, no-wrap msgid "Swapping Text" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "Swapping text between two buffers." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1278 #, no-wrap msgid "Buffer Gap" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:34 msgid "The gap in the buffer." msgstr "" #. type: ifnottex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:47 msgid "" "A @dfn{buffer} is a Lisp object containing text to be edited. Buffers are " "used to hold the contents of files that are being visited; there may also be " "buffers that are not visiting files. Although several buffers normally " "exist, only one buffer is designated the @dfn{current buffer} at any time. " "Most editing commands act on the contents of the current buffer. Each " "buffer, including the current buffer, may or may not be displayed in any " "windows." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:54 msgid "" "Buffers in Emacs editing are objects that have distinct names and hold text " "that can be edited. Buffers appear to Lisp programs as a special data " "type. You can think of the contents of a buffer as a string that you can " "extend; insertions and deletions may occur in any part of the buffer. " "@xref{Text}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:61 msgid "" "A Lisp buffer object contains numerous pieces of information. Some of this " "information is directly accessible to the programmer through variables, " "while other information is accessible only through special-purpose " "functions. For example, the visited file name is directly accessible " "through a variable, while the value of point is accessible only through a " "primitive function." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:69 msgid "" "Buffer-specific information that is directly accessible is stored in " "@dfn{buffer-local} variable bindings, which are variable values that are " "effective only in a particular buffer. This feature allows each buffer to " "override the values of certain variables. Most major modes override " "variables such as @code{fill-column} or @code{comment-column} in this way. " "For more information about buffer-local variables and functions related to " "them, see @ref{Buffer-Local Variables}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:74 msgid "" "For functions and variables related to visiting files in buffers, see " "@ref{Visiting Files} and @ref{Saving Buffers}. For functions and variables " "related to the display of buffers in windows, see @ref{Buffers and Windows}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:75 #, no-wrap msgid "bufferp object" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:78 msgid "" "This function returns @code{t} if @var{object} is a buffer, @code{nil} " "otherwise." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:81 #, no-wrap msgid "The Current Buffer" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:82 #, no-wrap msgid "selecting a buffer" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:83 #, no-wrap msgid "changing to another buffer" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:84 #, no-wrap msgid "current buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:91 msgid "" "There are, in general, many buffers in an Emacs session. At any time, one " "of them is designated the @dfn{current buffer}---the buffer in which most " "editing takes place. Most of the primitives for examining or changing text " "operate implicitly on the current buffer (@pxref{Text})." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:98 msgid "" "Normally, the buffer displayed in the selected window (@pxref{Selecting " "Windows}) is the current buffer, but this is not always so: a Lisp program " "can temporarily designate any buffer as current in order to operate on its " "contents, without changing what is displayed on the screen. The most basic " "function for designating a current buffer is @code{set-buffer}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:99 #, no-wrap msgid "current-buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:101 msgid "This function returns the current buffer." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:106 #, no-wrap msgid "" "(current-buffer)\n" " @result{} #\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:110 #, no-wrap msgid "set-buffer buffer-or-name" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:114 msgid "" "This function makes @var{buffer-or-name} the current buffer. " "@var{buffer-or-name} must be an existing buffer or the name of an existing " "buffer. The return value is the buffer made current." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:118 msgid "" "This function does not display the buffer in any window, so the user cannot " "necessarily see the buffer. But Lisp programs will now operate on it." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:128 msgid "" "When an editing command returns to the editor command loop, Emacs " "automatically calls @code{set-buffer} on the buffer shown in the selected " "window (@pxref{Selecting Windows}). This is to prevent confusion: it " "ensures that the buffer that the cursor is in, when Emacs reads a command, " "is the buffer to which that command applies (@pxref{Command Loop}). Thus, " "you should not use @code{set-buffer} to switch visibly to a different " "buffer; for that, use the functions described in @ref{Switching Buffers}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:135 msgid "" "When writing a Lisp function, do @emph{not} rely on this behavior of the " "command loop to restore the current buffer after an operation. Editing " "commands can also be called as Lisp functions by other programs, not just " "from the command loop; it is convenient for the caller if the subroutine " "does not change which buffer is current (unless, of course, that is the " "subroutine's purpose)." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:139 msgid "" "To operate temporarily on another buffer, put the @code{set-buffer} within a " "@code{save-current-buffer} form. Here, as an example, is a simplified " "version of the command @code{append-to-buffer}:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:149 #, no-wrap msgid "" "(defun append-to-buffer (buffer start end)\n" " \"Append the text of the region to BUFFER.\"\n" " (interactive \"BAppend to buffer: \\nr\")\n" " (let ((oldbuf (current-buffer)))\n" " (save-current-buffer\n" " (set-buffer (get-buffer-create buffer))\n" " (insert-buffer-substring oldbuf start end))))\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:158 msgid "" "Here, we bind a local variable to record the current buffer, and then " "@code{save-current-buffer} arranges to make it current again later. Next, " "@code{set-buffer} makes the specified buffer current, and " "@code{insert-buffer-substring} copies the string from the original buffer to " "the specified (and now current) buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:160 msgid "Alternatively, we can use the @code{with-current-buffer} macro:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:169 #, no-wrap msgid "" "(defun append-to-buffer (buffer start end)\n" " \"Append the text of the region to BUFFER.\"\n" " (interactive \"BAppend to buffer: \\nr\")\n" " (let ((oldbuf (current-buffer)))\n" " (with-current-buffer (get-buffer-create buffer)\n" " (insert-buffer-substring oldbuf start end))))\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:177 msgid "" "In either case, if the buffer appended to happens to be displayed in some " "window, the next redisplay will show how its text has changed. If it is not " "displayed in any window, you will not see the change immediately on the " "screen. The command causes the buffer to become current temporarily, but " "does not cause it to be displayed." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:183 msgid "" "If you make local bindings (with @code{let} or function arguments) for a " "variable that may also have buffer-local bindings, make sure that the same " "buffer is current at the beginning and at the end of the local binding's " "scope. Otherwise you might bind it in one buffer and unbind it in another!" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:188 msgid "" "Do not rely on using @code{set-buffer} to change the current buffer back, " "because that won't do the job if a quit happens while the wrong buffer is " "current. For instance, in the previous example, it would have been wrong to " "do this:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:195 #, no-wrap msgid "" " (let ((oldbuf (current-buffer)))\n" " (set-buffer (get-buffer-create buffer))\n" " (insert-buffer-substring oldbuf start end)\n" " (set-buffer oldbuf))\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:202 msgid "" "Using @code{save-current-buffer} or @code{with-current-buffer}, as we did, " "correctly handles quitting, errors, and @code{throw}, as well as ordinary " "evaluation." msgstr "" #. type: defspec #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:203 #, no-wrap msgid "save-current-buffer body@dots{}" msgstr "" #. type: defspec #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:209 msgid "" "The @code{save-current-buffer} special form saves the identity of the " "current buffer, evaluates the @var{body} forms, and finally restores that " "buffer as current. The return value is the value of the last form in " "@var{body}. The current buffer is restored even in case of an abnormal exit " "via @code{throw} or error (@pxref{Nonlocal Exits})." msgstr "" #. type: defspec #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:214 msgid "" "If the buffer that used to be current has been killed by the time of exit " "from @code{save-current-buffer}, then it is not made current again, of " "course. Instead, whichever buffer was current just before exit remains " "current." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:216 #, no-wrap msgid "with-current-buffer buffer-or-name body@dots{}" msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:221 msgid "" "The @code{with-current-buffer} macro saves the identity of the current " "buffer, makes @var{buffer-or-name} current, evaluates the @var{body} forms, " "and finally restores the current buffer. @var{buffer-or-name} must specify " "an existing buffer or the name of an existing buffer." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:225 msgid "" "The return value is the value of the last form in @var{body}. The current " "buffer is restored even in case of an abnormal exit via @code{throw} or " "error (@pxref{Nonlocal Exits})." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:227 #, no-wrap msgid "with-temp-buffer body@dots{}" msgstr "" #. type: anchor{#1} #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:234 msgid "Definition of with-temp-buffer" msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:234 msgid "" "The @code{with-temp-buffer} macro evaluates the @var{body} forms with a " "temporary buffer as the current buffer. It saves the identity of the " "current buffer, creates a temporary buffer and makes it current, evaluates " "the @var{body} forms, and finally restores the previous current buffer while " "killing the temporary buffer." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:235 #, no-wrap msgid "undo in temporary buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:236 #, no-wrap msgid "@code{kill-buffer-hook} in temporary buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:237 #, no-wrap msgid "@code{kill-buffer-query-functions} in temporary buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:238 #, no-wrap msgid "@code{buffer-list-update-hook} in temporary buffers" msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:245 msgid "" "By default, undo information (@pxref{Undo}) is not recorded in the buffer " "created by this macro (but @var{body} can enable that, if needed). The " "temporary buffer also does not run the hooks @code{kill-buffer-hook}, " "@code{kill-buffer-query-functions} (@pxref{Killing Buffers}), and " "@code{buffer-list-update-hook} (@pxref{Buffer List})." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:249 msgid "" "The return value is the value of the last form in @var{body}. You can " "return the contents of the temporary buffer by using @code{(buffer-string)} " "as the last form." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:252 msgid "" "The current buffer is restored even in case of an abnormal exit via " "@code{throw} or error (@pxref{Nonlocal Exits})." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:255 msgid "" "See also @code{with-temp-file} in @ref{Definition of with-temp-file,, " "Writing to Files}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:259 #, no-wrap msgid "buffer names" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:267 msgid "" "Each buffer has a unique name, which is a string. Many of the functions " "that work on buffers accept either a buffer or a buffer name as an " "argument. Any argument called @var{buffer-or-name} is of this sort, and an " "error is signaled if it is neither a string nor a buffer. Any argument " "called @var{buffer} must be an actual buffer object, not a name." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:268 #, no-wrap msgid "hidden buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:269 #, no-wrap msgid "buffers without undo information" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:276 msgid "" "Buffers that are ephemeral and generally uninteresting to the user have " "names starting with a space, so that the @code{list-buffers} and " "@code{buffer-menu} commands don't mention them (but if such a buffer visits " "a file, it @strong{is} mentioned). A name starting with space also " "initially disables recording undo information; see @ref{Undo}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:277 #, no-wrap msgid "buffer-name &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:280 msgid "" "This function returns the name of @var{buffer} as a string. @var{buffer} " "defaults to the current buffer." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:283 msgid "" "If @code{buffer-name} returns @code{nil}, it means that @var{buffer} has " "been killed. @xref{Killing Buffers}." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:288 #, no-wrap msgid "" "(buffer-name)\n" " @result{} \"buffers.texi\"\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:293 #, no-wrap msgid "" "(setq foo (get-buffer \"temp\"))\n" " @result{} #\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:297 #, no-wrap msgid "" "(kill-buffer foo)\n" " @result{} nil\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:301 #, no-wrap msgid "" "(buffer-name foo)\n" " @result{} nil\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:305 #, no-wrap msgid "" "foo\n" " @result{} #\n" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:309 #, no-wrap msgid "Command rename-buffer newname &optional unique" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:312 msgid "" "This function renames the current buffer to @var{newname}. An error is " "signaled if @var{newname} is not a string." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:318 msgid "" "Ordinarily, @code{rename-buffer} signals an error if @var{newname} is " "already in use. However, if @var{unique} is non-@code{nil}, it modifies " "@var{newname} to make a name that is not in use. Interactively, you can " "make @var{unique} non-@code{nil} with a numeric prefix argument. (This is " "how the command @code{rename-uniquely} is implemented.)" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:320 msgid "This function returns the name actually given to the buffer." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:322 #, no-wrap msgid "get-buffer buffer-or-name" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:328 msgid "" "This function returns the buffer specified by @var{buffer-or-name}. If " "@var{buffer-or-name} is a string and there is no buffer with that name, the " "value is @code{nil}. If @var{buffer-or-name} is a buffer, it is returned as " "given; that is not very useful, so the argument is usually a name. For " "example:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:333 #, no-wrap msgid "" "(setq b (get-buffer \"lewis\"))\n" " @result{} #\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:337 #, no-wrap msgid "" "(get-buffer b)\n" " @result{} #\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:341 #, no-wrap msgid "" "(get-buffer \"Frazzle-nots\")\n" " @result{} nil\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:345 msgid "See also the function @code{get-buffer-create} in @ref{Creating Buffers}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:347 #, no-wrap msgid "generate-new-buffer-name starting-name &optional ignore" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:353 msgid "" "This function returns a name that would be unique for a new buffer---but " "does not create the buffer. It starts with @var{starting-name}, and " "produces a name not currently in use for any buffer by appending a number " "inside of @samp{<@dots{}>}. It starts at 2 and keeps incrementing the " "number until it is not the name of an existing buffer." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:360 msgid "" "If the optional second argument @var{ignore} is non-@code{nil}, it should be " "a string, a potential buffer name. It means to consider that potential " "buffer acceptable, if it is tried, even if it is the name of an existing " "buffer (which would normally be rejected). Thus, if buffers named " "@samp{foo}, @samp{foo<2>}, @samp{foo<3>} and @samp{foo<4>} exist," msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:368 #, no-wrap msgid "" "(generate-new-buffer-name \"foo\")\n" " @result{} \"foo<5>\"\n" "(generate-new-buffer-name \"foo\" \"foo<3>\")\n" " @result{} \"foo<3>\"\n" "(generate-new-buffer-name \"foo\" \"foo<6>\")\n" " @result{} \"foo<5>\"\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:372 msgid "" "See the related function @code{generate-new-buffer} in @ref{Creating " "Buffers}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:376 #, no-wrap msgid "visited file" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:377 #, no-wrap msgid "buffer file name" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:378 #, no-wrap msgid "file name of buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:386 msgid "" "The @dfn{buffer file name} is the name of the file that is visited in that " "buffer. When a buffer is not visiting a file, its buffer file name is " "@code{nil}. Most of the time, the buffer name is the same as the " "nondirectory part of the buffer file name, but the buffer file name and the " "buffer name are distinct and can be set independently. @xref{Visiting " "Files}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:387 #, no-wrap msgid "buffer-file-name &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:392 msgid "" "This function returns the absolute file name of the file that @var{buffer} " "is visiting. If @var{buffer} is not visiting any file, " "@code{buffer-file-name} returns @code{nil}. If @var{buffer} is not " "supplied, it defaults to the current buffer." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:397 #, no-wrap msgid "" "(buffer-file-name (other-buffer))\n" " @result{} \"/usr/user/lewis/manual/files.texi\"\n" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:401 #, no-wrap msgid "buffer-file-name" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:406 msgid "" "This buffer-local variable contains the name of the file being visited in " "the current buffer, or @code{nil} if it is not visiting a file. It is a " "permanent local variable, unaffected by @code{kill-all-local-variables}." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:411 #, no-wrap msgid "" "buffer-file-name\n" " @result{} \"/usr/user/lewis/manual/buffers.texi\"\n" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:419 msgid "" "It is risky to change this variable's value without doing various other " "things. Normally it is better to use @code{set-visited-file-name} (see " "below); some of the things done there, such as changing the buffer name, are " "not strictly necessary, but others are essential to avoid confusing Emacs." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:421 #, no-wrap msgid "buffer-file-truename" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:427 msgid "" "This buffer-local variable holds the abbreviated truename of the file " "visited in the current buffer, or @code{nil} if no file is visited. It is a " "permanent local, unaffected by @code{kill-all-local-variables}. " "@xref{Truenames}, and @ref{abbreviate-file-name}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:429 #, no-wrap msgid "buffer-file-number" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:434 msgid "" "This buffer-local variable holds the file number and directory device number " "of the file visited in the current buffer, or @code{nil} if no file or a " "nonexistent file is visited. It is a permanent local, unaffected by " "@code{kill-all-local-variables}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:440 msgid "" "The value is normally a list of the form @code{(@var{filenum} " "@var{devnum})}. This pair of numbers uniquely identifies the file among all " "files accessible on the system. See the function @code{file-attributes}, in " "@ref{File Attributes}, for more information about them." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:443 msgid "" "If @code{buffer-file-name} is the name of a symbolic link, then both numbers " "refer to the recursive target." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:445 #, no-wrap msgid "get-file-buffer filename" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:453 msgid "" "This function returns the buffer visiting file @var{filename}. If there is " "no such buffer, it returns @code{nil}. The argument @var{filename}, which " "must be a string, is expanded (@pxref{File Name Expansion}), then compared " "against the visited file names of all live buffers. Note that the buffer's " "@code{buffer-file-name} must match the expansion of @var{filename} exactly. " "This function will not recognize other names for the same file." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:458 #, no-wrap msgid "" "(get-file-buffer \"buffers.texi\")\n" " @result{} #\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:464 msgid "" "In unusual circumstances, there can be more than one buffer visiting the " "same file name. In such cases, this function returns the first such buffer " "in the buffer list." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:466 #, no-wrap msgid "find-buffer-visiting filename &optional predicate" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:476 msgid "" "This is like @code{get-file-buffer}, except that it can return any buffer " "visiting the file @emph{possibly under a different name}. That is, the " "buffer's @code{buffer-file-name} does not need to match the expansion of " "@var{filename} exactly, it only needs to refer to the same file. If " "@var{predicate} is non-@code{nil}, it should be a function of one argument, " "a buffer visiting @var{filename}. The buffer is only considered a suitable " "return value if @var{predicate} returns non-@code{nil}. If it can not find " "a suitable buffer to return, @code{find-buffer-visiting} returns @code{nil}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:478 #, no-wrap msgid "Command set-visited-file-name filename &optional no-query along-with-file" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:483 msgid "" "If @var{filename} is a non-empty string, this function changes the name of " "the file visited in the current buffer to @var{filename}. (If the buffer " "had no visited file, this gives it one.) The @emph{next time} the buffer is " "saved it will go in the newly-specified file." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:489 msgid "" "This command marks the buffer as modified, since it does not (as far as " "Emacs knows) match the contents of @var{filename}, even if it matched the " "former visited file. It also renames the buffer to correspond to the new " "file name, unless the new name is already in use." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:494 msgid "" "If @var{filename} is @code{nil} or the empty string, that stands for ``no " "visited file''. In this case, @code{set-visited-file-name} marks the buffer " "as having no visited file, without changing the buffer's modified flag." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:502 msgid "" "Normally, this function asks the user for confirmation if there already is a " "buffer visiting @var{filename}. If @var{no-query} is non-@code{nil}, that " "prevents asking this question. If there already is a buffer visiting " "@var{filename}, and the user confirms or @var{no-query} is non-@code{nil}, " "this function makes the new buffer name unique by appending a number inside " "of @samp{<@dots{}>} to @var{filename}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:511 msgid "" "If @var{along-with-file} is non-@code{nil}, that means to assume that the " "former visited file has been renamed to @var{filename}. In this case, the " "command does not change the buffer's modified flag, nor the buffer's " "recorded last file modification time as reported by " "@code{visited-file-modtime} (@pxref{Modification Time}). If " "@var{along-with-file} is @code{nil}, this function clears the recorded last " "file modification time, after which @code{visited-file-modtime} returns " "zero." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:514 msgid "" "When the function @code{set-visited-file-name} is called interactively, it " "prompts for @var{filename} in the minibuffer." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:516 #, no-wrap msgid "list-buffers-directory" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:520 msgid "" "This buffer-local variable specifies a string to display in a buffer listing " "where the visited file name would go, for buffers that don't have a visited " "file name. Dired buffers use this variable." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:524 #, no-wrap msgid "buffer modification" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:525 #, no-wrap msgid "modification flag (of buffer)" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:534 msgid "" "Emacs keeps a flag called the @dfn{modified flag} for each buffer, to record " "whether you have changed the text of the buffer. This flag is set to " "@code{t} whenever you alter the contents of the buffer, and cleared to " "@code{nil} when you save it. Thus, the flag shows whether there are unsaved " "changes. The flag value is normally shown in the mode line (@pxref{Mode " "Line Variables}), and controls saving (@pxref{Saving Buffers}) and " "auto-saving (@pxref{Auto-Saving})." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:539 msgid "" "Some Lisp programs set the flag explicitly. For example, the function " "@code{set-visited-file-name} sets the flag to @code{t}, because the text " "does not match the newly-visited file, even if it is unchanged from the file " "formerly visited." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:542 msgid "" "The functions that modify the contents of buffers are described in " "@ref{Text}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:543 #, no-wrap msgid "buffer-modified-p &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:548 msgid "" "This function returns @code{t} if the buffer @var{buffer} has been modified " "since it was last read in from a file or saved, or @code{nil} otherwise. If " "@var{buffer} is not supplied, the current buffer is tested." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:550 #, no-wrap msgid "set-buffer-modified-p flag" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:553 msgid "" "This function marks the current buffer as modified if @var{flag} is " "non-@code{nil}, or as unmodified if the flag is @code{nil}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:557 msgid "" "Another effect of calling this function is to cause unconditional redisplay " "of the mode line for the current buffer. In fact, the function " "@code{force-mode-line-update} works by doing this:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:561 #, no-wrap msgid "(set-buffer-modified-p (buffer-modified-p))\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:565 #, no-wrap msgid "restore-buffer-modified-p flag" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:568 msgid "" "Like @code{set-buffer-modified-p}, but does not force redisplay of mode " "lines." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:570 #, no-wrap msgid "Command not-modified &optional arg" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:575 msgid "" "This command marks the current buffer as unmodified, and not needing to be " "saved. If @var{arg} is non-@code{nil}, it marks the buffer as modified, so " "that it will be saved at the next suitable occasion. Interactively, " "@var{arg} is the prefix argument." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:578 msgid "" "Don't use this function in programs, since it prints a message in the echo " "area; use @code{set-buffer-modified-p} (above) instead." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:580 #, no-wrap msgid "buffer-modified-tick &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:584 msgid "" "This function returns @var{buffer}'s modification-count. This is a counter " "that increments every time the buffer is modified. If @var{buffer} is " "@code{nil} (or omitted), the current buffer is used." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:586 #, no-wrap msgid "buffer-chars-modified-tick &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:595 msgid "" "This function returns @var{buffer}'s character-change modification-count. " "Changes to text properties leave this counter unchanged; however, each time " "text is inserted or removed from the buffer, the counter is reset to the " "value that would be returned by @code{buffer-modified-tick}. By comparing " "the values returned by two @code{buffer-chars-modified-tick} calls, you can " "tell whether a character change occurred in that buffer in between the " "calls. If @var{buffer} is @code{nil} (or omitted), the current buffer is " "used." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:602 msgid "" "Sometimes there's a need for modifying buffer in a way that doesn't really " "change its text, like if only its text properties are changed. If your " "program needs to modify a buffer without triggering any hooks and features " "that react to buffer modifications, use the @code{with-silent-modifications} " "macro." msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:603 #, no-wrap msgid "with-silent-modifications body@dots{}" msgstr "" #. type: defmac #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:609 msgid "" "Execute @var{body} pretending it does not modify the buffer. This includes " "checking whether the buffer's file is locked (@pxref{File Locks}), running " "buffer modification hooks (@pxref{Change Hooks}), etc. Note that if " "@var{body} actually modifies the buffer text (as opposed to its text " "properties), its undo data may become corrupted." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:612 #, no-wrap msgid "Buffer Modification Time" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:613 #, no-wrap msgid "comparing file modification time" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:614 #, no-wrap msgid "modification time of buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:623 msgid "" "Suppose that you visit a file and make changes in its buffer, and meanwhile " "the file itself is changed on disk. At this point, saving the buffer would " "overwrite the changes in the file. Occasionally this may be what you want, " "but usually it would lose valuable information. Emacs therefore checks the " "file's modification time using the functions described below before saving " "the file. (@xref{File Attributes}, for how to examine a file's modification " "time.)" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:624 #, no-wrap msgid "verify-visited-file-modtime &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:630 msgid "" "This function compares what @var{buffer} (by default, the current-buffer) " "has recorded for the modification time of its visited file against the " "actual modification time of the file as recorded by the operating system. " "The two should be the same unless some other process has written the file " "since Emacs visited or saved it." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:636 msgid "" "The function returns @code{t} if the last actual modification time and " "Emacs's recorded modification time are the same, @code{nil} otherwise. It " "also returns @code{t} if the buffer has no recorded last modification time, " "that is if @code{visited-file-modtime} would return zero." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:643 msgid "" "It always returns @code{t} for buffers that are not visiting a file, even if " "@code{visited-file-modtime} returns a non-zero value. For instance, it " "always returns @code{t} for dired buffers. It returns @code{t} for buffers " "that are visiting a file that does not exist and never existed, but " "@code{nil} for file-visiting buffers whose file has been deleted." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:645 #, no-wrap msgid "clear-visited-file-modtime" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:650 msgid "" "This function clears out the record of the last modification time of the " "file being visited by the current buffer. As a result, the next attempt to " "save this buffer will not complain of a discrepancy in file modification " "times." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:654 msgid "" "This function is called in @code{set-visited-file-name} and other " "exceptional places where the usual test to avoid overwriting a changed file " "should not be done." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:656 #, no-wrap msgid "visited-file-modtime" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:659 msgid "" "This function returns the current buffer's recorded last file modification " "time, as a Lisp timestamp (@pxref{Time of Day})." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:667 msgid "" "If the buffer has no recorded last modification time, this function returns " "zero. This case occurs, for instance, if the buffer is not visiting a file " "or if the time has been explicitly cleared by " "@code{clear-visited-file-modtime}. Note, however, that " "@code{visited-file-modtime} returns a timestamp for some non-file buffers " "too. For instance, in a Dired buffer listing a directory, it returns the " "last modification time of that directory, as recorded by Dired." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:670 msgid "" "If the buffer is visiting a file that doesn't exist, this function returns " "@minus{}1." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:672 #, no-wrap msgid "set-visited-file-modtime &optional time" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:677 msgid "" "This function updates the buffer's record of the last modification time of " "the visited file, to the value specified by @var{time} if @var{time} is not " "@code{nil}, and otherwise to the last modification time of the visited file." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:681 msgid "" "If @var{time} is neither @code{nil} nor an integer flag returned by " "@code{visited-file-modtime}, it should be a Lisp time value (@pxref{Time of " "Day})." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:685 msgid "" "This function is useful if the buffer was not read from the file normally, " "or if the file itself has been changed for some known benign reason." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:687 #, no-wrap msgid "ask-user-about-supersession-threat filename" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:694 msgid "" "This function is used to ask a user how to proceed after an attempt to " "modify a buffer visiting file @var{filename} when the file is newer than the " "buffer text. Emacs detects this because the modification time of the file " "on disk is newer than the last save-time and its contents have changed. " "This means some other program has probably altered the file." msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:695 #, no-wrap msgid "file-supersession" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:700 msgid "" "Depending on the user's answer, the function may return normally, in which " "case the modification of the buffer proceeds, or it may signal a " "@code{file-supersession} error with data @code{(@var{filename})}, in which " "case the proposed buffer modification is not allowed." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:704 msgid "" "This function is called automatically by Emacs on the proper occasions. It " "exists so you can customize Emacs by redefining it. See the file " "@file{userlock.el} for the standard definition." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:706 msgid "See also the file locking mechanism in @ref{File Locks}." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:709 #, no-wrap msgid "Read-Only Buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:710 #, no-wrap msgid "read-only buffer" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:711 #, no-wrap msgid "buffer, read-only" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:716 msgid "" "If a buffer is @dfn{read-only}, then you cannot change its contents, " "although you may change your view of the contents by scrolling and " "narrowing." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:718 msgid "Read-only buffers are used in two kinds of situations:" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:722 msgid "A buffer visiting a write-protected file is normally read-only." msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:727 msgid "" "Here, the purpose is to inform the user that editing the buffer with the aim " "of saving it in the file may be futile or undesirable. The user who wants " "to change the buffer text despite this can do so after clearing the " "read-only flag with @kbd{C-x C-q}." msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:731 msgid "" "Modes such as Dired and Rmail make buffers read-only when altering the " "contents with the usual editing commands would probably be a mistake." msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:735 msgid "" "The special commands of these modes bind @code{buffer-read-only} to " "@code{nil} (with @code{let}) or bind @code{inhibit-read-only} to @code{t} " "around the places where they themselves change the text." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:737 #, no-wrap msgid "buffer-read-only" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:742 msgid "" "This buffer-local variable specifies whether the buffer is read-only. The " "buffer is read-only if this variable is non-@code{nil}. However, characters " "that have the @code{inhibit-read-only} text property can still be modified. " "@xref{Special Properties, inhibit-read-only}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:744 #, no-wrap msgid "inhibit-read-only" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:750 msgid "" "If this variable is non-@code{nil}, then read-only buffers and, depending on " "the actual value, some or all read-only characters may be modified. " "Read-only characters in a buffer are those that have a non-@code{nil} " "@code{read-only} text property. @xref{Special Properties}, for more " "information about text properties." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:755 msgid "" "If @code{inhibit-read-only} is @code{t}, all @code{read-only} character " "properties have no effect. If @code{inhibit-read-only} is a list, then " "@code{read-only} character properties have no effect if they are members of " "the list (comparison is done with @code{eq})." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:757 #, no-wrap msgid "Command read-only-mode &optional arg" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:763 msgid "" "This is the mode command for Read Only minor mode, a buffer-local minor " "mode. When the mode is enabled, @code{buffer-read-only} is non-@code{nil} " "in the buffer; when disabled, @code{buffer-read-only} is @code{nil} in the " "buffer. The calling convention is the same as for other minor mode commands " "(@pxref{Minor Mode Conventions})." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:770 msgid "" "This minor mode mainly serves as a wrapper for @code{buffer-read-only}; " "unlike most minor modes, there is no separate @code{read-only-mode} " "variable. Even when Read Only mode is disabled, characters with " "non-@code{nil} @code{read-only} text properties remain read-only. To " "temporarily ignore all read-only states, bind @code{inhibit-read-only}, as " "described above." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:776 msgid "" "When enabling Read Only mode, this mode command also enables View mode if " "the option @code{view-read-only} is non-@code{nil}. @xref{Misc " "Buffer,,Miscellaneous Buffer Operations, emacs, The GNU Emacs Manual}. When " "disabling Read Only mode, it disables View mode if View mode was enabled." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:778 #, no-wrap msgid "barf-if-buffer-read-only &optional position" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:783 msgid "" "This function signals a @code{buffer-read-only} error if the current buffer " "is read-only. If the text at @var{position} (which defaults to point) has " "the @code{inhibit-read-only} text property set, the error will not be " "raised." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:786 msgid "" "@xref{Using Interactive}, for another way to signal an error if the current " "buffer is read-only." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:789 #, no-wrap msgid "The Buffer List" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:790 #, no-wrap msgid "buffer list" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:791 #, no-wrap msgid "listing all buffers" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:798 msgid "" "The @dfn{buffer list} is a list of all live buffers. The order of the " "buffers in this list is based primarily on how recently each buffer has been " "displayed in a window. Several functions, notably @code{other-buffer}, use " "this ordering. A buffer list displayed for the user also follows this " "order." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:807 msgid "" "Creating a buffer adds it to the end of the buffer list, and killing a " "buffer removes it from that list. A buffer moves to the front of this list " "whenever it is chosen for display in a window (@pxref{Switching Buffers}) or " "a window displaying it is selected (@pxref{Selecting Windows}). A buffer " "moves to the end of the list when it is buried (see @code{bury-buffer}, " "below). There are no functions available to the Lisp programmer which " "directly manipulate the buffer list." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:815 msgid "" "In addition to the fundamental buffer list just described, Emacs maintains a " "local buffer list for each frame, in which the buffers that have been " "displayed (or had their windows selected) in that frame come first. (This " "order is recorded in the frame's @code{buffer-list} frame parameter; see " "@ref{Buffer Parameters}.) Buffers never displayed in that frame come " "afterward, ordered according to the fundamental buffer list." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:816 #, no-wrap msgid "buffer-list &optional frame" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:820 msgid "" "This function returns the buffer list, including all buffers, even those " "whose names begin with a space. The elements are actual buffers, not their " "names." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:825 msgid "" "If @var{frame} is a frame, this returns @var{frame}'s local buffer list. If " "@var{frame} is @code{nil} or omitted, the fundamental buffer list is used: " "the buffers appear in order of most recent display or selection, regardless " "of which frames they were displayed on." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:832 #, no-wrap msgid "" "(buffer-list)\n" " @result{} (#\n" " # #\n" " # #)\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:840 #, no-wrap msgid "" ";; @r{Note that the name of the minibuffer}\n" ";; @r{begins with a space!}\n" "(mapcar #'buffer-name (buffer-list))\n" " @result{} (\"buffers.texi\" \" *Minibuf-1*\"\n" " \"buffer.c\" \"*Help*\" \"TAGS\")\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:848 msgid "" "The list returned by @code{buffer-list} is constructed specifically; it is " "not an internal Emacs data structure, and modifying it has no effect on the " "order of buffers. If you want to change the order of buffers in the " "fundamental buffer list, here is an easy way:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:854 #, no-wrap msgid "" "(defun reorder-buffer-list (new-list)\n" " (while new-list\n" " (bury-buffer (car new-list))\n" " (setq new-list (cdr new-list))))\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:859 msgid "" "With this method, you can specify any order for the list, but there is no " "danger of losing a buffer or adding something that is not a valid live " "buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:863 msgid "" "To change the order or value of a specific frame's buffer list, set that " "frame's @code{buffer-list} parameter with @code{modify-frame-parameters} " "(@pxref{Parameter Access})." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:864 #, no-wrap msgid "other-buffer &optional buffer visible-ok frame" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:870 msgid "" "This function returns the first buffer in the buffer list other than " "@var{buffer}. Usually, this is the buffer appearing in the most recently " "selected window (in frame @var{frame} or else the selected frame, " "@pxref{Input Focus}), aside from @var{buffer}. Buffers whose names start " "with a space are not considered at all." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:875 msgid "" "If @var{buffer} is not supplied (or if it is not a live buffer), then " "@code{other-buffer} returns the first buffer in the selected frame's local " "buffer list. (If @var{frame} is non-@code{nil}, it returns the first buffer " "in @var{frame}'s local buffer list instead.)" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:880 msgid "" "If @var{frame} has a non-@code{nil} @code{buffer-predicate} parameter, then " "@code{other-buffer} uses that predicate to decide which buffers to " "consider. It calls the predicate once for each buffer, and if the value is " "@code{nil}, that buffer is ignored. @xref{Buffer Parameters}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:885 msgid "" "If @var{visible-ok} is @code{nil}, @code{other-buffer} avoids returning a " "buffer visible in any window on any visible frame, except as a last resort. " "If @var{visible-ok} is non-@code{nil}, then it does not matter whether a " "buffer is displayed somewhere or not." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:888 msgid "" "If no suitable buffer exists, the buffer @file{*scratch*} is returned (and " "created, if necessary)." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:890 #, no-wrap msgid "last-buffer &optional buffer visible-ok frame" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:894 msgid "" "This function returns the last buffer in @var{frame}'s buffer list other " "than @var{buffer}. If @var{frame} is omitted or @code{nil}, it uses the " "selected frame's buffer list." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:898 msgid "" "The argument @var{visible-ok} is handled as with @code{other-buffer}, see " "above. If no suitable buffer can be found, the buffer @file{*scratch*} is " "returned." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:900 #, no-wrap msgid "Command bury-buffer &optional buffer-or-name" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:906 msgid "" "This command puts @var{buffer-or-name} at the end of the buffer list, " "without changing the order of any of the other buffers on the list. This " "buffer therefore becomes the least desirable candidate for " "@code{other-buffer} to return. The argument can be either a buffer itself " "or the name of one." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:913 msgid "" "This function operates on each frame's @code{buffer-list} parameter as well " "as the fundamental buffer list; therefore, the buffer that you bury will " "come last in the value of @code{(buffer-list @var{frame})} and in the value " "of @code{(buffer-list)}. In addition, it also puts the buffer at the end of " "the list of buffers of the selected window (@pxref{Window History}) provided " "it is shown in that window." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:927 msgid "" "If @var{buffer-or-name} is @code{nil} or omitted, this means to bury the " "current buffer. In addition, if the current buffer is displayed in the " "selected window (@pxref{Selecting Windows}), this makes sure that the window " "is either deleted or another buffer is shown in it. More precisely, if the " "selected window is dedicated (@pxref{Dedicated Windows}) and there are other " "windows on its frame, the window is deleted. If it is the only window on " "its frame and that frame is not the only frame on its terminal, the frame is " "dismissed by calling the function specified by " "@code{frame-auto-hide-function} (@pxref{Quitting Windows}). Otherwise, it " "calls @code{switch-to-prev-buffer} (@pxref{Window History}) to show another " "buffer in that window. If @var{buffer-or-name} is displayed in some other " "window, it remains displayed there." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:930 msgid "" "To replace a buffer in all the windows that display it, use " "@code{replace-buffer-in-windows}, @xref{Buffers and Windows}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:932 #, no-wrap msgid "Command unbury-buffer" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:938 msgid "" "This command switches to the last buffer in the local buffer list of the " "selected frame. More precisely, it calls the function " "@code{switch-to-buffer} (@pxref{Switching Buffers}), to display the buffer " "returned by @code{last-buffer} (see above), in the selected window." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:940 #, no-wrap msgid "buffer-list-update-hook" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:950 msgid "" "This is a normal hook run whenever the buffer list changes. Functions " "(implicitly) running this hook are @code{get-buffer-create} (@pxref{Creating " "Buffers}), @code{rename-buffer} (@pxref{Buffer Names}), @code{kill-buffer} " "(@pxref{Killing Buffers}), @code{bury-buffer} (see above), and " "@code{select-window} (@pxref{Selecting Windows}). This hook is not run for " "internal or temporary buffers created by @code{get-buffer-create} or " "@code{generate-new-buffer} with a non-@code{nil} argument " "@var{inhibit-buffer-hooks}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:954 msgid "" "Functions run by this hook should avoid calling @code{select-window} with a " "@code{nil} @var{norecord} argument since this may lead to infinite " "recursion." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:958 #, no-wrap msgid "creating buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:959 #, no-wrap msgid "buffers, creating" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:965 msgid "" "This section describes the two primitives for creating buffers. " "@code{get-buffer-create} creates a buffer if it finds no existing buffer " "with the specified name; @code{generate-new-buffer} always creates a new " "buffer and gives it a unique name." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:973 msgid "" "Both functions accept an optional argument @var{inhibit-buffer-hooks}. If " "it is non-@code{nil}, the buffer they create does not run the hooks " "@code{kill-buffer-hook}, @code{kill-buffer-query-functions} (@pxref{Killing " "Buffers}), and @code{buffer-list-update-hook} (@pxref{Buffer List}). This " "avoids slowing down internal or temporary buffers that are never presented " "to users or passed on to other applications." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:978 msgid "" "Other functions you can use to create buffers include " "@code{with-output-to-temp-buffer} (@pxref{Temporary Displays}) and " "@code{create-file-buffer} (@pxref{Visiting Files}). Starting a subprocess " "can also create a buffer (@pxref{Processes})." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:979 #, no-wrap msgid "get-buffer-create buffer-or-name &optional inhibit-buffer-hooks" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:983 msgid "" "This function returns a buffer named @var{buffer-or-name}. The buffer " "returned does not become the current buffer---this function does not change " "which buffer is current." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:989 msgid "" "@var{buffer-or-name} must be either a string or an existing buffer. If it " "is a string and a live buffer with that name already exists, " "@code{get-buffer-create} returns that buffer. If no such buffer exists, it " "creates a new buffer. If @var{buffer-or-name} is a buffer instead of a " "string, it is returned as given, even if it is dead." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:994 #, no-wrap msgid "" "(get-buffer-create \"foo\")\n" " @result{} #\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1001 msgid "" "The major mode for a newly created buffer is set to Fundamental mode. (The " "default value of the variable @code{major-mode} is handled at a higher " "level; see @ref{Auto Major Mode}.) If the name begins with a space, the " "buffer initially disables undo information recording (@pxref{Undo})." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1003 #, no-wrap msgid "generate-new-buffer name &optional inhibit-buffer-hooks" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1011 msgid "" "This function returns a newly created, empty buffer, but does not make it " "current. The name of the buffer is generated by passing @var{name} to the " "function @code{generate-new-buffer-name} (@pxref{Buffer Names}). Thus, if " "there is no buffer named @var{name}, then that is the name of the new " "buffer; if that name is in use, a suffix of the form @samp{<@var{n}>}, where " "@var{n} is an integer, is appended to @var{name}." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1013 msgid "An error is signaled if @var{name} is not a string." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1018 #, no-wrap msgid "" "(generate-new-buffer \"bar\")\n" " @result{} #\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1022 #, no-wrap msgid "" "(generate-new-buffer \"bar\")\n" " @result{} #>\n" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1026 #, no-wrap msgid "" "(generate-new-buffer \"bar\")\n" " @result{} #>\n" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1032 msgid "" "The major mode for the new buffer is set to Fundamental mode. The default " "value of the variable @code{major-mode} is handled at a higher level. " "@xref{Auto Major Mode}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1036 #, no-wrap msgid "killing buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1037 #, no-wrap msgid "buffers, killing" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1041 msgid "" "@dfn{Killing a buffer} makes its name unknown to Emacs and makes the memory " "space it occupied available for other use." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1047 msgid "" "The buffer object for the buffer that has been killed remains in existence " "as long as anything refers to it, but it is specially marked so that you " "cannot make it current or display it. Killed buffers retain their identity, " "however; if you kill two distinct buffers, they remain distinct according to " "@code{eq} although both are dead." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1054 msgid "" "If you kill a buffer that is current or displayed in a window, Emacs " "automatically selects or displays some other buffer instead. This means " "that killing a buffer can change the current buffer. Therefore, when you " "kill a buffer, you should also take the precautions associated with changing " "the current buffer (unless you happen to know that the buffer being killed " "isn't current). @xref{Current Buffer}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1056 msgid "If you kill a buffer that is the base buffer of one or more indirect" msgstr "" #. type: iftex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1058 msgid "buffers," msgstr "" #. type: ifnottex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1061 msgid "buffers (@pxref{Indirect Buffers})," msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1063 msgid "the indirect buffers are automatically killed as well." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1064 #, no-wrap msgid "live buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1069 msgid "" "The @code{buffer-name} of a buffer is @code{nil} if, and only if, the buffer " "is killed. A buffer that has not been killed is called a @dfn{live} " "buffer. To test whether a buffer is live or killed, use the function " "@code{buffer-live-p} (see below)." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1070 #, no-wrap msgid "Command kill-buffer &optional buffer-or-name" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1075 msgid "" "This function kills the buffer @var{buffer-or-name}, freeing all its memory " "for other uses or to be returned to the operating system. If " "@var{buffer-or-name} is @code{nil} or omitted, it kills the current buffer." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1079 msgid "" "Any processes that have this buffer as the @code{process-buffer} are sent " "the @code{SIGHUP} (hangup) signal, which normally causes them to terminate. " "@xref{Signals to Processes}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1085 msgid "" "If the buffer is visiting a file and contains unsaved changes, " "@code{kill-buffer} asks the user to confirm before the buffer is killed. It " "does this even if not called interactively. To prevent the request for " "confirmation, clear the modified flag before calling @code{kill-buffer}. " "@xref{Buffer Modification}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1088 msgid "" "This function calls @code{replace-buffer-in-windows} for cleaning up all " "windows currently displaying the buffer to be killed." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1090 msgid "Killing a buffer that is already dead has no effect." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1094 msgid "" "This function returns @code{t} if it actually killed the buffer. It returns " "@code{nil} if the user refuses to confirm or if @var{buffer-or-name} was " "already dead." msgstr "" #. type: smallexample #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1099 #, no-wrap msgid "" "(kill-buffer \"foo.unchanged\")\n" " @result{} t\n" "(kill-buffer \"foo.changed\")\n" "\n" msgstr "" #. type: smallexample #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1103 #, no-wrap msgid "" "---------- Buffer: Minibuffer ----------\n" "Buffer foo.changed modified; kill anyway? (yes or no) @kbd{yes}\n" "---------- Buffer: Minibuffer ----------\n" "\n" msgstr "" #. type: smallexample #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1105 #, no-wrap msgid " @result{} t\n" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1108 #, no-wrap msgid "kill-buffer-query-functions" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1115 msgid "" "Before confirming unsaved changes, @code{kill-buffer} calls the functions in " "the list @code{kill-buffer-query-functions}, in order of appearance, with no " "arguments. The buffer being killed is the current buffer when they are " "called. The idea of this feature is that these functions will ask for " "confirmation from the user. If any of them returns @code{nil}, " "@code{kill-buffer} spares the buffer's life." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1119 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1131 msgid "" "This hook is not run for internal or temporary buffers created by " "@code{get-buffer-create} or @code{generate-new-buffer} with a non-@code{nil} " "argument @var{inhibit-buffer-hooks}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1121 #, no-wrap msgid "kill-buffer-hook" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1127 msgid "" "This is a normal hook run by @code{kill-buffer} after asking all the " "questions it is going to ask, just before actually killing the buffer. The " "buffer to be killed is current when the hook functions run. @xref{Hooks}. " "This variable is a permanent local, so its local binding is not cleared by " "changing major modes." msgstr "" #. type: defopt #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1133 #, no-wrap msgid "buffer-offer-save" msgstr "" #. type: defopt #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1144 msgid "" "This variable, if non-@code{nil} in a particular buffer, tells " "@code{save-buffers-kill-emacs} to offer to save that buffer, just as it " "offers to save file-visiting buffers. If @code{save-some-buffers} is called " "with the second optional argument set to @code{t}, it will also offer to " "save the buffer. Lastly, if this variable is set to the symbol " "@code{always}, both @code{save-buffers-kill-emacs} and " "@code{save-some-buffers} will always offer to save. @xref{Definition of " "save-some-buffers}. The variable @code{buffer-offer-save} automatically " "becomes buffer-local when set for any reason. @xref{Buffer-Local " "Variables}." msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1146 #, no-wrap msgid "buffer-save-without-query" msgstr "" #. type: defvar #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1151 msgid "" "This variable, if non-@code{nil} in a particular buffer, tells " "@code{save-buffers-kill-emacs} and @code{save-some-buffers} to save this " "buffer (if it's modified) without asking the user. The variable " "automatically becomes buffer-local when set for any reason." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1153 #, no-wrap msgid "buffer-live-p object" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1156 msgid "" "This function returns @code{t} if @var{object} is a live buffer (a buffer " "which has not been killed), @code{nil} otherwise." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1160 #, no-wrap msgid "indirect buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1161 #, no-wrap msgid "base buffer" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1167 msgid "" "An @dfn{indirect buffer} shares the text of some other buffer, which is " "called the @dfn{base buffer} of the indirect buffer. In some ways it is the " "analogue, for buffers, of a symbolic link among files. The base buffer may " "not itself be an indirect buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1172 msgid "" "The text of the indirect buffer is always identical to the text of its base " "buffer; changes made by editing either one are visible immediately in the " "other. This includes the text properties as well as the characters " "themselves." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1179 msgid "" "In all other respects, the indirect buffer and its base buffer are " "completely separate. They have different names, independent values of " "point, independent narrowing, independent markers and overlays (though " "inserting or deleting text in either buffer relocates the markers and " "overlays for both), independent major modes, and independent buffer-local " "variable bindings." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1183 msgid "" "An indirect buffer cannot visit a file, but its base buffer can. If you try " "to save the indirect buffer, that actually saves the base buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1187 msgid "" "Killing an indirect buffer has no effect on its base buffer. Killing the " "base buffer effectively kills the indirect buffer in that it cannot ever " "again be the current buffer." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1188 #, no-wrap msgid "" "Command make-indirect-buffer base-buffer name &optional clone " "inhibit-buffer-hooks" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1193 msgid "" "This creates and returns an indirect buffer named @var{name} whose base " "buffer is @var{base-buffer}. The argument @var{base-buffer} may be a live " "buffer or the name (a string) of an existing buffer. If @var{name} is the " "name of an existing buffer, an error is signaled." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1199 msgid "" "If @var{clone} is non-@code{nil}, then the indirect buffer originally shares " "the state of @var{base-buffer} such as major mode, minor modes, buffer local " "variables and so on. If @var{clone} is omitted or @code{nil} the indirect " "buffer's state is set to the default state for new buffers." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1204 msgid "" "If @var{base-buffer} is an indirect buffer, its base buffer is used as the " "base for the new buffer. If, in addition, @var{clone} is non-@code{nil}, " "the initial state is copied from the actual base buffer, not from " "@var{base-buffer}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1206 msgid "@xref{Creating Buffers}, for the meaning of @var{inhibit-buffer-hooks}." msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1208 #, no-wrap msgid "Command clone-indirect-buffer newname display-flag &optional norecord" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1213 msgid "" "This function creates and returns a new indirect buffer that shares the " "current buffer's base buffer and copies the rest of the current buffer's " "attributes. (If the current buffer is not indirect, it is used as the base " "buffer.)" msgstr "" #. type: deffn #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1218 msgid "" "If @var{display-flag} is non-@code{nil}, as it always is in interactive " "calls, that means to display the new buffer by calling " "@code{pop-to-buffer}. If @var{norecord} is non-@code{nil}, that means not " "to put the new buffer to the front of the buffer list." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1220 #, no-wrap msgid "buffer-base-buffer &optional buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1225 msgid "" "This function returns the base buffer of @var{buffer}, which defaults to the " "current buffer. If @var{buffer} is not indirect, the value is @code{nil}. " "Otherwise, the value is another buffer, which is never an indirect buffer." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1228 #, no-wrap msgid "Swapping Text Between Two Buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1229 #, no-wrap msgid "swap text between buffers" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1230 #, no-wrap msgid "virtual buffers" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1236 msgid "" "Specialized modes sometimes need to let the user access from the same buffer " "several vastly different types of text. For example, you may need to " "display a summary of the buffer text, in addition to letting the user access " "the text itself." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1243 msgid "" "This could be implemented with multiple buffers (kept in sync when the user " "edits the text), or with narrowing (@pxref{Narrowing}). But these " "alternatives might sometimes become tedious or prohibitively expensive, " "especially if each type of text requires expensive buffer-global operations " "in order to provide correct display and editing commands." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1251 msgid "" "Emacs provides another facility for such modes: you can quickly swap buffer " "text between two buffers with @code{buffer-swap-text}. This function is " "very fast because it doesn't move any text, it only changes the internal " "data structures of the buffer object to point to a different chunk of text. " "Using it, you can pretend that a group of two or more buffers are actually a " "single virtual buffer that holds the contents of all the individual buffers " "together." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1252 #, no-wrap msgid "buffer-swap-text buffer" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1257 msgid "" "This function swaps the text of the current buffer and that of its argument " "@var{buffer}. It signals an error if one of the two buffers is an indirect " "buffer (@pxref{Indirect Buffers}) or is a base buffer of an indirect buffer." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1263 msgid "" "All the buffer properties that are related to the buffer text are swapped as " "well: the positions of point and mark, all the markers, the overlays, the " "text properties, the undo list, the value of the " "@code{enable-multibyte-characters} flag (@pxref{Text Representations, " "enable-multibyte-characters}), etc." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1269 msgid "" "@strong{Warning:} If this function is called from within a " "@code{save-excursion} form, the current buffer will be set to @var{buffer} " "upon leaving the form, since the marker used by @code{save-excursion} to " "save the position and buffer will be swapped as well." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1277 msgid "" "If you use @code{buffer-swap-text} on a file-visiting buffer, you should set " "up a hook to save the buffer's original text rather than what it was swapped " "with. @code{write-region-annotate-functions} works for this purpose. You " "should probably set @code{buffer-saved-size} to @minus{}2 in the buffer, so " "that changes in the text it is swapped with will not interfere with " "auto-saving." msgstr "" #. type: section #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1279 #, no-wrap msgid "The Buffer Gap" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1280 #, no-wrap msgid "buffer gap" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1290 msgid "" "Emacs buffers are implemented using an invisible @dfn{gap} to make insertion " "and deletion faster. Insertion works by filling in part of the gap, and " "deletion adds to the gap. Of course, this means that the gap must first be " "moved to the locus of the insertion or deletion. Emacs moves the gap only " "when you try to insert or delete. This is why your first editing command in " "one part of a large buffer, after previously editing in another far-away " "part, sometimes involves a noticeable delay." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1294 msgid "" "This mechanism works invisibly, and Lisp code should never be affected by " "the gap's current location, but these functions are available for getting " "information about the gap status." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1295 #, no-wrap msgid "gap-position" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1297 msgid "This function returns the current gap position in the current buffer." msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1299 #, no-wrap msgid "gap-size" msgstr "" #. type: defun #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/lispref/buffers.texi:1301 msgid "This function returns the current gap size of the current buffer." msgstr ""