2900 lines
105 KiB
Plaintext
2900 lines
105 KiB
Plaintext
# SOME DESCRIPTIVE TITLE
|
|
# Copyright (C) YEAR Free Software Foundation, Inc.
|
|
# This file is distributed under the same license as the PACKAGE package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\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{} #<buffer buffers.texi>\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{} #<buffer temp>\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{} #<killed buffer>\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{} #<buffer lewis>\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{} #<buffer lewis>\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{} #<buffer buffers.texi>\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{} (#<buffer buffers.texi>\n"
|
|
" #<buffer *Minibuf-1*> #<buffer buffer.c>\n"
|
|
" #<buffer *Help*> #<buffer TAGS>)\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{} #<buffer foo>\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{} #<buffer bar>\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{} #<buffer bar<2>>\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{} #<buffer bar<3>>\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 ""
|