documentation_emacs/source/lispref/variables.texi.fr.po
2022-03-08 11:11:57 +01:00

5980 lines
211 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/variables.texi:5
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:6
#, no-wrap
msgid "Variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:7
#, no-wrap
msgid "variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:18
msgid ""
"A @dfn{variable} is a name used in a program to stand for a value. In Lisp, "
"each variable is represented by a Lisp symbol (@pxref{Symbols}). The "
"variable name is simply the symbol's name, and the variable's value is "
"stored in the symbol's value cell@footnote{To be precise, under the default "
"@dfn{dynamic scoping} rule, the value cell always holds the variable's "
"current value, but this is not the case under the @dfn{lexical scoping} "
"rule. @xref{Variable Scoping}, for details.}. @xref{Symbol Components}. "
"In Emacs Lisp, the use of a symbol as a variable is independent of its use "
"as a function name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:25
msgid ""
"As previously noted in this manual, a Lisp program is represented primarily "
"by Lisp objects, and only secondarily as text. The textual form of a Lisp "
"program is given by the read syntax of the Lisp objects that constitute the "
"program. Hence, the textual form of a variable in a Lisp program is written "
"using the read syntax for the symbol representing the variable."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:49
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:50
#, no-wrap
msgid "Global Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Variable values that exist permanently, everywhere."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:101
#, no-wrap
msgid "Constant Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Variables that never change."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:149
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:150
#, no-wrap
msgid "Local Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Variable values that exist only temporarily."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:381
#, no-wrap
msgid "Void Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Symbols that lack values."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:477
#, no-wrap
msgid "Defining Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "A definition says a symbol is used as a variable."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:624
#, no-wrap
msgid "Tips for Defining"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Things you should think about when you define a variable."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:724
#, no-wrap
msgid "Accessing Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Examining values of variables whose names are known only at run time."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:780
#, no-wrap
msgid "Setting Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Storing new values in variables."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:882
#, no-wrap
msgid "Watching Variables"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:883
#, no-wrap
msgid "Running a function when a variable is changed."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:944
#, no-wrap
msgid "Variable Scoping"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "How Lisp chooses among local and global values."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1381
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1382
#, no-wrap
msgid "Buffer-Local Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Variable values in effect only in one buffer."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1900
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1901
#, no-wrap
msgid "File Local Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Handling local variable lists in files."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2130
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2131
#, no-wrap
msgid "Directory Local Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Local variables common to all files in a directory."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2241
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2242
#, no-wrap
msgid "Connection Local Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Local variables common for remote connections."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2410
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2411
#, no-wrap
msgid "Variable Aliases"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Variables that are aliases for other variables."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2511
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2512
#, no-wrap
msgid "Variables with Restricted Values"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid ""
"Non-constant variables whose value can @emph{not} be an arbitrary Lisp "
"object."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2547
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2548
#, no-wrap
msgid "Generalized Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:47
msgid "Extending the concept of variables."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:51
#, no-wrap
msgid "global variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:58
msgid ""
"The simplest way to use a variable is @dfn{globally}. This means that the "
"variable has just one value at a time, and this value is in effect (at least "
"for the moment) throughout the Lisp system. The value remains in effect "
"until you specify a new one. When a new value replaces the old one, no "
"trace of the old value remains in the variable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:60
msgid "You specify a value for a symbol with @code{setq}. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:63
#, no-wrap
msgid "(setq x '(a b))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:70
msgid ""
"gives the variable @code{x} the value @code{(a b)}. Note that @code{setq} "
"is a special form (@pxref{Special Forms}); it does not evaluate its first "
"argument, the name of the variable, but it does evaluate the second "
"argument, the new value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:73
msgid ""
"Once the variable has a value, you can refer to it by using the symbol "
"itself as an expression. Thus,"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:77
#, no-wrap
msgid "x @result{} (a b)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:82
msgid "assuming the @code{setq} form shown above has already been executed."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:85
msgid "If you do set the same variable again, the new value replaces the old one:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:90
#, no-wrap
msgid ""
"x\n"
" @result{} (a b)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:94
#, no-wrap
msgid ""
"(setq x 4)\n"
" @result{} 4\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:98
#, no-wrap
msgid ""
"x\n"
" @result{} 4\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:102
#, no-wrap
msgid "Variables that Never Change"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:103
#, no-wrap
msgid "@code{setting-constant} error"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:104
#, no-wrap
msgid "keyword symbol"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:105
#, no-wrap
msgid "variable with constant value"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:106
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:574
#, no-wrap
msgid "constant variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:107
#, no-wrap
msgid "symbol that evaluates to itself"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:108
#, no-wrap
msgid "symbol with constant value"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:118
msgid ""
"In Emacs Lisp, certain symbols normally evaluate to themselves. These "
"include @code{nil} and @code{t}, as well as any symbol whose name starts "
"with @samp{:} (these are called @dfn{keywords}). These symbols cannot be "
"rebound, nor can their values be changed. Any attempt to set or bind "
"@code{nil} or @code{t} signals a @code{setting-constant} error. The same is "
"true for a keyword (a symbol whose name starts with @samp{:}), if it is "
"interned in the standard obarray, except that setting such a symbol to "
"itself is not an error."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:123
#, no-wrap
msgid ""
"nil @equiv{} 'nil\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:127
#, no-wrap
msgid ""
"(setq nil 500)\n"
"@error{} Attempt to set constant symbol: nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:130
#, no-wrap
msgid "keywordp object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:134
msgid ""
"function returns @code{t} if @var{object} is a symbol whose name starts with "
"@samp{:}, interned in the standard obarray, and returns @code{nil} "
"otherwise."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:141
msgid ""
"These constants are fundamentally different from the constants defined using "
"the @code{defconst} special form (@pxref{Defining Variables}). A "
"@code{defconst} form serves to inform human readers that you do not intend "
"to change the value of a variable, but Emacs does not raise an error if you "
"actually change it."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:142
#, no-wrap
msgid "read-only variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:148
msgid ""
"A small number of additional symbols are made read-only for various "
"practical reasons. These include @code{enable-multibyte-characters}, "
"@code{most-positive-fixnum}, @code{most-negative-fixnum}, and a few others. "
"Any attempt to set or bind these also signals a @code{setting-constant} "
"error."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:151
#, no-wrap
msgid "binding local variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:152
#, no-wrap
msgid "local variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:153
#, no-wrap
msgid "local binding"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:154
#, no-wrap
msgid "global binding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:162
msgid ""
"Global variables have values that last until explicitly superseded with new "
"values. Sometimes it is useful to give a variable a @dfn{local value}---a "
"value that takes effect only within a certain part of a Lisp program. When "
"a variable has a local value, we say that it is @dfn{locally bound} to that "
"value, and that it is a @dfn{local variable}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:169
msgid ""
"For example, when a function is called, its argument variables receive local "
"values, which are the actual arguments supplied to the function call; these "
"local bindings take effect within the body of the function. To take another "
"example, the @code{let} special form explicitly establishes local bindings "
"for specific variables, which take effect only within the body of the "
"@code{let} form."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:172
msgid ""
"We also speak of the @dfn{global binding}, which is where (conceptually) the "
"global value is kept."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:173
#, no-wrap
msgid "shadowing of variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:181
msgid ""
"Establishing a local binding saves away the variable's previous value (or "
"lack of one). We say that the previous value is @dfn{shadowed}. Both "
"global and local values may be shadowed. If a local binding is in effect, "
"using @code{setq} on the local variable stores the specified value in the "
"local binding. When that local binding is no longer in effect, the "
"previously shadowed value (or lack of one) comes back."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:182
#, no-wrap
msgid "current binding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:188
msgid ""
"A variable can have more than one local binding at a time (e.g., if there "
"are nested @code{let} forms that bind the variable). The @dfn{current "
"binding} is the local binding that is actually in effect. It determines the "
"value returned by evaluating the variable symbol, and it is the binding "
"acted on by @code{setq}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:199
msgid ""
"For most purposes, you can think of the current binding as the innermost "
"local binding, or the global binding if there is no local binding. To be "
"more precise, a rule called the @dfn{scoping rule} determines where in a "
"program a local binding takes effect. The default scoping rule in Emacs "
"Lisp is called @dfn{dynamic scoping}, which simply states that the current "
"binding at any given point in the execution of a program is the most "
"recently-created binding for that variable that still exists. For details "
"about dynamic scoping, and an alternative scoping rule called @dfn{lexical "
"scoping}, @pxref{Variable Scoping}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:202
msgid "The special forms @code{let} and @code{let*} exist to create local bindings:"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:203
#, no-wrap
msgid "let (bindings@dots{}) forms@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:209
msgid ""
"This special form sets up local bindings for a certain set of variables, as "
"specified by @var{bindings}, and then evaluates all of the @var{forms} in "
"textual order. Its return value is the value of the last form in "
"@var{forms}. The local bindings set up by @code{let} will be in effect only "
"within the body of @var{forms}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:215
msgid ""
"Each of the @var{bindings} is either @w{(i) a} symbol, in which case that "
"symbol is locally bound to @code{nil}; or @w{(ii) a} list of the form "
"@code{(@var{symbol} @var{value-form})}, in which case @var{symbol} is "
"locally bound to the result of evaluating @var{value-form}. If "
"@var{value-form} is omitted, @code{nil} is used."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:220
msgid ""
"All of the @var{value-form}s in @var{bindings} are evaluated in the order "
"they appear and @emph{before} binding any of the symbols to them. Here is "
"an example of this: @code{z} is bound to the old value of @code{y}, which is "
"2, not the new value of @code{y}, which is 1."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:225
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:259
#, no-wrap
msgid ""
"(setq y 2)\n"
" @result{} 2\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:232
#, no-wrap
msgid ""
"(let ((y 1)\n"
" (z y))\n"
" (list y z))\n"
" @result{} (1 2)\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:237
msgid ""
"On the other hand, the order of @emph{bindings} is unspecified: in the "
"following example, either 1 or 2 might be printed."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:242
#, no-wrap
msgid ""
"(let ((x 1)\n"
" (x 2))\n"
" (print x))\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:246
msgid ""
"Therefore, avoid binding a variable more than once in a single @code{let} "
"form."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:248
#, no-wrap
msgid "let* (bindings@dots{}) forms@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:254
msgid ""
"This special form is like @code{let}, but it binds each variable right after "
"computing its local value, before computing the local value for the next "
"variable. Therefore, an expression in @var{bindings} can refer to the "
"preceding symbols bound in this @code{let*} form. Compare the following "
"example with the example above for @code{let}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:266
#, no-wrap
msgid ""
"(let* ((y 1)\n"
" (z y)) ; @r{Use the just-established value of @code{y}.}\n"
" (list y z))\n"
" @result{} (1 1)\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:270
#, no-wrap
msgid "letrec (bindings@dots{}) forms@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:277
msgid ""
"This special form is like @code{let*}, but all the variables are bound "
"before any of the local values are computed. The values are then assigned "
"to the locally bound variables. This is only useful when lexical binding is "
"in effect, and you want to create closures that refer to bindings that would "
"otherwise not yet be in effect when using @code{let*}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:280
msgid ""
"For instance, here's a closure that removes itself from a hook after being "
"run once:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:286
#, no-wrap
msgid ""
"(letrec ((hookfun (lambda ()\n"
" (message \"Run once\")\n"
" (remove-hook 'post-command-hook hookfun))))\n"
" (add-hook 'post-command-hook hookfun))\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:289
#, no-wrap
msgid "dynamic binding, temporarily"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:290
#, no-wrap
msgid "dynamic let-binding"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:291
#, no-wrap
msgid "dlet (bindings@dots{}) forms@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:297
msgid ""
"This special form is like @code{let}, but it binds all variables "
"dynamically. This is rarely useful---you usually want to bind normal "
"variables lexically, and special variables (i.e., variables that are defined "
"with @code{defvar}) dynamically, and this is what @code{let} does."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:303
msgid ""
"@code{dlet} can be useful when interfacing with old code that assumes that "
"certain variables are dynamically bound (@pxref{Dynamic Binding}), but it's "
"impractical to @code{defvar} these variables. @code{dlet} will temporarily "
"make the bound variables special, execute the forms, and then make the "
"variables non-special again."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:305
#, no-wrap
msgid "named-let name bindings &rest body"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:315
msgid ""
"This special form is a looping construct inspired from the Scheme language. "
"It is similar to @code{let}: It binds the variables in @var{bindings}, and "
"then evaluates @var{body}. However, @code{named-let} also binds @var{name} "
"to a local function whose formal arguments are the variables in "
"@var{bindings} and whose body is @var{body}. This allows @var{body} to call "
"itself recursively by calling @var{name}, where the arguments passed to "
"@var{name} are used as the new values of the bound variables in the "
"recursive invocation."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:317
msgid "Example of a loop summing a list of numbers:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:325
#, no-wrap
msgid ""
"(named-let sum ((numbers '(1 2 3 4))\n"
" (running-sum 0))\n"
" (if numbers\n"
" (sum (cdr numbers) (+ running-sum (car numbers)))\n"
" running-sum))\n"
"@result{} 10\n"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:334
msgid "Tail recursion"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:334
msgid ""
"Recursive calls to @var{name} that occur in @emph{tail positions} in "
"@var{body} are guaranteed to be optimised as @emph{tail calls}, which means "
"that they will not consume any additional stack space no matter how deeply "
"the recursion runs. Such recursive calls will effectively jump to the top "
"of the loop with new values for the variables."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:338
msgid ""
"A function call is in the tail position if it's the very last thing done so "
"that the value returned by the call is the value of @var{body} itself, as is "
"the case in the recursive call to @code{sum} above."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:342
msgid "Here is a complete list of the other facilities that create local bindings:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:346
msgid "Function calls (@pxref{Functions})."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:349
msgid "Macro calls (@pxref{Macros})."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:352
msgid "@code{condition-case} (@pxref{Errors})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:359
msgid ""
"Variables can also have buffer-local bindings (@pxref{Buffer-Local "
"Variables}); a few variables have terminal-local bindings (@pxref{Multiple "
"Terminals}). These kinds of bindings work somewhat like ordinary local "
"bindings, but they are localized depending on where you are in Emacs."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:360
#, no-wrap
msgid "max-specpdl-size"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:362
msgid "Definition of max-specpdl-size"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:362
#, no-wrap
msgid "variable limit error"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:363
#, no-wrap
msgid "evaluation error"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:364
#, no-wrap
msgid "infinite recursion"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:370
msgid ""
"This variable defines the limit on the total number of local variable "
"bindings and @code{unwind-protect} cleanups (see @ref{Cleanups,, Cleaning Up "
"from Nonlocal Exits}) that are allowed before Emacs signals an error (with "
"data @code{\"Variable binding depth exceeds max-specpdl-size\"})."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:375
msgid ""
"This limit, with the associated error when it is exceeded, is one way that "
"Lisp avoids infinite recursion on an ill-defined function. "
"@code{max-lisp-eval-depth} provides another limit on depth of nesting. "
"@xref{Definition of max-lisp-eval-depth,, Eval}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:379
msgid ""
"The default value is 1600. Entry to the Lisp debugger increases the value, "
"if there is little room left, to make sure the debugger itself has room to "
"execute."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:382
#, no-wrap
msgid "When a Variable is Void"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:383
#, no-wrap
msgid "@code{void-variable} error"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:384
#, no-wrap
msgid "void variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:388
msgid ""
"We say that a variable is void if its symbol has an unassigned value cell "
"(@pxref{Symbol Components})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:397
msgid ""
"Under Emacs Lisp's default dynamic scoping rule (@pxref{Variable Scoping}), "
"the value cell stores the variable's current (local or global) value. Note "
"that an unassigned value cell is @emph{not} the same as having @code{nil} in "
"the value cell. The symbol @code{nil} is a Lisp object and can be the value "
"of a variable, just as any other object can be; but it is still a value. If "
"a variable is void, trying to evaluate the variable signals a "
"@code{void-variable} error, instead of returning a value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:403
msgid ""
"Under the optional lexical scoping rule, the value cell only holds the "
"variable's global value---the value outside of any lexical binding "
"construct. When a variable is lexically bound, the local value is "
"determined by the lexical environment; hence, variables can have local "
"values even if their symbols' value cells are unassigned."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:404
#, no-wrap
msgid "makunbound symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:407
msgid ""
"This function empties out the value cell of @var{symbol}, making the "
"variable void. It returns @var{symbol}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:413
msgid ""
"If @var{symbol} has a dynamic local binding, @code{makunbound} voids the "
"current binding, and this voidness lasts only as long as the local binding "
"is in effect. Afterwards, the previously shadowed local or global binding "
"is reexposed; then the variable will no longer be void, unless the reexposed "
"binding is void too."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:415
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:451
msgid "Here are some examples (assuming dynamic binding is in effect):"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:424
#, no-wrap
msgid ""
"(setq x 1) ; @r{Put a value in the global binding.}\n"
" @result{} 1\n"
"(let ((x 2)) ; @r{Locally bind it.}\n"
" (makunbound 'x) ; @r{Void the local binding.}\n"
" x)\n"
"@error{} Symbol's value as variable is void: x\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:428
#, no-wrap
msgid ""
"x ; @r{The global binding is unchanged.}\n"
" @result{} 1\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:434
#, no-wrap
msgid ""
"(let ((x 2)) ; @r{Locally bind it.}\n"
" (let ((x 3)) ; @r{And again.}\n"
" (makunbound 'x) ; @r{Void the innermost-local binding.}\n"
" x)) ; @r{And refer: it's void.}\n"
"@error{} Symbol's value as variable is void: x\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:442
#, no-wrap
msgid ""
"(let ((x 2))\n"
" (let ((x 3))\n"
" (makunbound 'x)) ; @r{Void inner binding, then remove it.}\n"
" x) ; @r{Now outer @code{let} binding is visible.}\n"
" @result{} 2\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:446
#, no-wrap
msgid "boundp variable"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:449
msgid ""
"This function returns @code{t} if @var{variable} (a symbol) is not void, and "
"@code{nil} if it is void."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:456
#, no-wrap
msgid ""
"(boundp 'abracadabra) ; @r{Starts out void.}\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:461
#, no-wrap
msgid ""
"(let ((abracadabra 5)) ; @r{Locally bind it.}\n"
" (boundp 'abracadabra))\n"
" @result{} t\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:465
#, no-wrap
msgid ""
"(boundp 'abracadabra) ; @r{Still globally void.}\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:469
#, no-wrap
msgid ""
"(setq abracadabra 5) ; @r{Make it globally nonvoid.}\n"
" @result{} 5\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:473
#, no-wrap
msgid ""
"(boundp 'abracadabra)\n"
" @result{} t\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:478
#, no-wrap
msgid "Defining Global Variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:479
#, no-wrap
msgid "variable definition"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:484
msgid ""
"A @dfn{variable definition} is a construct that announces your intention to "
"use a symbol as a global variable. It uses the special forms @code{defvar} "
"or @code{defconst}, which are documented below."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:491
msgid ""
"A variable definition serves three purposes. First, it informs people who "
"read the code that the symbol is @emph{intended} to be used a certain way "
"(as a variable). Second, it informs the Lisp system of this, optionally "
"supplying an initial value and a documentation string. Third, it provides "
"information to programming tools such as @command{etags}, allowing them to "
"find where the variable was defined."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:499
msgid ""
"The difference between @code{defconst} and @code{defvar} is mainly a matter "
"of intent, serving to inform human readers of whether the value should ever "
"change. Emacs Lisp does not actually prevent you from changing the value of "
"a variable defined with @code{defconst}. One notable difference between the "
"two forms is that @code{defconst} unconditionally initializes the variable, "
"whereas @code{defvar} initializes it only if it is originally void."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:503
msgid ""
"To define a customizable variable, you should use @code{defcustom} (which "
"calls @code{defvar} as a subroutine). @xref{Variable Definitions}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:504
#, no-wrap
msgid "defvar symbol [value [doc-string]]"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:510
msgid ""
"This special form defines @var{symbol} as a variable. Note that "
"@var{symbol} is not evaluated; the symbol to be defined should appear "
"explicitly in the @code{defvar} form. The variable is marked as "
"@dfn{special}, meaning that it should always be dynamically bound "
"(@pxref{Variable Scoping})."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:517
msgid ""
"If @var{value} is specified, and @var{symbol} is void (i.e., it has no "
"dynamically bound value; @pxref{Void Variables}), then @var{value} is "
"evaluated and @var{symbol} is set to the result. But if @var{symbol} is not "
"void, @var{value} is not evaluated, and @var{symbol}'s value is left "
"unchanged. If @var{value} is omitted, the value of @var{symbol} is not "
"changed in any case."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:523
msgid ""
"Note that specifying a value, even @code{nil}, marks the variable as special "
"permanently. Whereas if @var{value} is omitted then the variable is only "
"marked special locally (i.e.@: within the current lexical scope, or file if "
"at the top-level). This can be useful for suppressing byte compilation "
"warnings, see @ref{Compiler Errors}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:528
msgid ""
"If @var{symbol} has a buffer-local binding in the current buffer, "
"@code{defvar} acts on the default value, which is buffer-independent, rather "
"than the buffer-local binding. It sets the default value if the default "
"value is void. @xref{Buffer-Local Variables}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:533
msgid ""
"If @var{symbol} is already lexically bound (e.g., if the @code{defvar} form "
"occurs in a @code{let} form with lexical binding enabled), then "
"@code{defvar} sets the dynamic value. The lexical binding remains in effect "
"until its binding construct exits. @xref{Variable Scoping}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:534
#, no-wrap
msgid "@code{eval-defun}, and @code{defvar} forms"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:535
#, no-wrap
msgid "@code{eval-last-sexp}, and @code{defvar} forms"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:541
msgid ""
"When you evaluate a top-level @code{defvar} form with @kbd{C-M-x} "
"(@code{eval-defun}) or with @kbd{C-x C-e} (@code{eval-last-sexp}) in Emacs "
"Lisp mode, a special feature of these two commands arranges to set the "
"variable unconditionally, without testing whether its value is void."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:545
msgid ""
"If the @var{doc-string} argument is supplied, it specifies the documentation "
"string for the variable (stored in the symbol's "
"@code{variable-documentation} property). @xref{Documentation}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:548
msgid ""
"Here are some examples. This form defines @code{foo} but does not "
"initialize it:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:553
#, no-wrap
msgid ""
"(defvar foo)\n"
" @result{} foo\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:558
msgid ""
"This example initializes the value of @code{bar} to @code{23}, and gives it "
"a documentation string:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:564
#, no-wrap
msgid ""
"(defvar bar 23\n"
" \"The normal weight of a bar.\")\n"
" @result{} bar\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:569
msgid ""
"The @code{defvar} form returns @var{symbol}, but it is normally used at top "
"level in a file where its value does not matter."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:572
msgid ""
"For a more elaborate example of using @code{defvar} without a value, see "
"@ref{Local defvar example}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:575
#, no-wrap
msgid "defconst symbol value [doc-string]"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:581
msgid ""
"This special form defines @var{symbol} as a value and initializes it. It "
"informs a person reading your code that @var{symbol} has a standard global "
"value, established here, that should not be changed by the user or by other "
"programs. Note that @var{symbol} is not evaluated; the symbol to be defined "
"must appear explicitly in the @code{defconst}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:586
msgid ""
"The @code{defconst} form, like @code{defvar}, marks the variable as "
"@dfn{special}, meaning that it should always be dynamically bound "
"(@pxref{Variable Scoping}). In addition, it marks the variable as risky "
"(@pxref{File Local Variables})."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:593
msgid ""
"@code{defconst} always evaluates @var{value}, and sets the value of "
"@var{symbol} to the result. If @var{symbol} does have a buffer-local "
"binding in the current buffer, @code{defconst} sets the default value, not "
"the buffer-local value. (But you should not be making buffer-local bindings "
"for a symbol that is defined with @code{defconst}.)"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:599
msgid ""
"An example of the use of @code{defconst} is Emacs's definition of "
"@code{float-pi}---the mathematical constant @math{pi}, which ought not to be "
"changed by anyone (attempts by the Indiana State Legislature "
"notwithstanding). As the second form illustrates, however, @code{defconst} "
"is only advisory."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:604
#, no-wrap
msgid ""
"(defconst float-pi 3.141592653589793 \"The value of Pi.\")\n"
" @result{} float-pi\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:608
#, no-wrap
msgid ""
"(setq float-pi 3)\n"
" @result{} float-pi\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:612
#, no-wrap
msgid ""
"float-pi\n"
" @result{} 3\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:623
msgid ""
"@strong{Warning:} If you use a @code{defconst} or @code{defvar} special form "
"while the variable has a local binding (made with @code{let}, or a function "
"argument), it sets the local binding rather than the global binding. This "
"is not what you usually want. To prevent this, use these special forms at "
"top level in a file, where normally no local binding is in effect, and make "
"sure to load the file before making a local binding for the variable."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:625
#, no-wrap
msgid "Tips for Defining Variables Robustly"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:630
msgid ""
"When you define a variable whose value is a function, or a list of "
"functions, use a name that ends in @samp{-function} or @samp{-functions}, "
"respectively."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:633
msgid "There are several other variable name conventions; here is a complete list:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:635
#, no-wrap
msgid "@dots{}-hook"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:637
msgid "The variable is a normal hook (@pxref{Hooks})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:638
#, no-wrap
msgid "@dots{}-function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:640
msgid "The value is a function."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:641
#, no-wrap
msgid "@dots{}-functions"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:643
msgid "The value is a list of functions."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:644
#, no-wrap
msgid "@dots{}-form"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:646
msgid "The value is a form (an expression)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:647
#, no-wrap
msgid "@dots{}-forms"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:649
msgid "The value is a list of forms (expressions)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:650
#, no-wrap
msgid "@dots{}-predicate"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:653
msgid ""
"The value is a predicate---a function of one argument that returns "
"non-@code{nil} for success and @code{nil} for failure."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:654
#, no-wrap
msgid "@dots{}-flag"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:658
msgid ""
"The value is significant only as to whether it is @code{nil} or not. Since "
"such variables often end up acquiring more values over time, this convention "
"is not strongly recommended."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:659
#, no-wrap
msgid "@dots{}-program"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:661
msgid "The value is a program name."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:662
#, no-wrap
msgid "@dots{}-command"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:664
msgid "The value is a whole shell command."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:665
#, no-wrap
msgid "@dots{}-switches"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:667
msgid "The value specifies options for a command."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:668
#, no-wrap
msgid "@var{prefix}--@dots{}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:672
msgid ""
"The variable is intended for internal use and is defined in the file "
"@file{@var{prefix}.el}. (Emacs code contributed before 2018 may follow "
"other conventions, which are being phased out.)"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:673
#, no-wrap
msgid "@dots{}-internal"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:677
msgid ""
"The variable is intended for internal use and is defined in C code. (Emacs "
"code contributed before 2018 may follow other conventions, which are being "
"phased out.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:681
msgid ""
"When you define a variable, always consider whether you should mark it as "
"safe or risky; see @ref{File Local Variables}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:685
msgid ""
"When defining and initializing a variable that holds a complicated value "
"(such as a keymap with bindings in it), it's best to put the entire "
"computation of the value into the @code{defvar}, like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:693
#, no-wrap
msgid ""
"(defvar my-mode-map\n"
" (let ((map (make-sparse-keymap)))\n"
" (define-key map \"\\C-c\\C-a\" 'my-command)\n"
" @dots{}\n"
" map)\n"
" @var{docstring})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:704
msgid ""
"This method has several benefits. First, if the user quits while loading "
"the file, the variable is either still uninitialized or initialized "
"properly, never in-between. If it is still uninitialized, reloading the "
"file will initialize it properly. Second, reloading the file once the "
"variable is initialized will not alter it; that is important if the user has "
"run hooks to alter part of the contents (such as, to rebind keys). Third, "
"evaluating the @code{defvar} form with @kbd{C-M-x} will reinitialize the map "
"completely."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:708
msgid ""
"Putting so much code in the @code{defvar} form has one disadvantage: it puts "
"the documentation string far away from the line which names the variable. "
"Here's a safe way to avoid that:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:717
#, no-wrap
msgid ""
"(defvar my-mode-map nil\n"
" @var{docstring})\n"
"(unless my-mode-map\n"
" (let ((map (make-sparse-keymap)))\n"
" (define-key map \"\\C-c\\C-a\" 'my-command)\n"
" @dots{}\n"
" (setq my-mode-map map)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:723
msgid ""
"This has all the same advantages as putting the initialization inside the "
"@code{defvar}, except that you must type @kbd{C-M-x} twice, once on each "
"form, if you do want to reinitialize the variable."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:725
#, no-wrap
msgid "Accessing Variable Values"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:729
msgid ""
"The usual way to reference a variable is to write the symbol which names "
"it. @xref{Symbol Forms}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:734
msgid ""
"Occasionally, you may want to reference a variable which is only determined "
"at run time. In that case, you cannot specify the variable name in the text "
"of the program. You can use the @code{symbol-value} function to extract the "
"value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:735
#, no-wrap
msgid "symbol-value symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:740
msgid ""
"This function returns the value stored in @var{symbol}'s value cell. This "
"is where the variable's current (dynamic) value is stored. If the variable "
"has no local binding, this is simply its global value. If the variable is "
"void, a @code{void-variable} error is signaled."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:745
msgid ""
"If the variable is lexically bound, the value reported by "
"@code{symbol-value} is not necessarily the same as the variable's lexical "
"value, which is determined by the lexical environment rather than the "
"symbol's value cell. @xref{Variable Scoping}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:750
#, no-wrap
msgid ""
"(setq abracadabra 5)\n"
" @result{} 5\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:754
#, no-wrap
msgid ""
"(setq foo 9)\n"
" @result{} 9\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:762
#, no-wrap
msgid ""
";; @r{Here the symbol @code{abracadabra}}\n"
";; @r{is the symbol whose value is examined.}\n"
"(let ((abracadabra 'foo))\n"
" (symbol-value 'abracadabra))\n"
" @result{} foo\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:771
#, no-wrap
msgid ""
";; @r{Here, the value of @code{abracadabra},}\n"
";; @r{which is @code{foo},}\n"
";; @r{is the symbol whose value is examined.}\n"
"(let ((abracadabra 'foo))\n"
" (symbol-value abracadabra))\n"
" @result{} 9\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:776
#, no-wrap
msgid ""
"(symbol-value 'abracadabra)\n"
" @result{} 5\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:781
#, no-wrap
msgid "Setting Variable Values"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:786
msgid ""
"The usual way to change the value of a variable is with the special form "
"@code{setq}. When you need to compute the choice of variable at run time, "
"use the function @code{set}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:787
#, no-wrap
msgid "setq [symbol form]@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:792
msgid ""
"This special form is the most common method of changing a variable's value. "
"Each @var{symbol} is given a new value, which is the result of evaluating "
"the corresponding @var{form}. The current binding of the symbol is changed."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:796
msgid ""
"@code{setq} does not evaluate @var{symbol}; it sets the symbol that you "
"write. We say that this argument is @dfn{automatically quoted}. The "
"@samp{q} in @code{setq} stands for ``quoted''."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:798
msgid "The value of the @code{setq} form is the value of the last @var{form}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:803
#, no-wrap
msgid ""
"(setq x (1+ 2))\n"
" @result{} 3\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:806
#, no-wrap
msgid ""
"x ; @r{@code{x} now has a global value.}\n"
" @result{} 3\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:811
#, no-wrap
msgid ""
"(let ((x 5))\n"
" (setq x 6) ; @r{The local binding of @code{x} is set.}\n"
" x)\n"
" @result{} 6\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:814
#, no-wrap
msgid ""
"x ; @r{The global value is unchanged.}\n"
" @result{} 3\n"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:819
msgid ""
"Note that the first @var{form} is evaluated, then the first @var{symbol} is "
"set, then the second @var{form} is evaluated, then the second @var{symbol} "
"is set, and so on:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:825
#, no-wrap
msgid ""
"(setq x 10 ; @r{Notice that @code{x} is set before}\n"
" y (1+ x)) ; @r{the value of @code{y} is computed.}\n"
" @result{} 11\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:829
#, no-wrap
msgid "set symbol value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:834
msgid ""
"This function puts @var{value} in the value cell of @var{symbol}. Since it "
"is a function rather than a special form, the expression written for "
"@var{symbol} is evaluated to obtain the symbol to set. The return value is "
"@var{value}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:841
msgid ""
"When dynamic variable binding is in effect (the default), @code{set} has the "
"same effect as @code{setq}, apart from the fact that @code{set} evaluates "
"its @var{symbol} argument whereas @code{setq} does not. But when a variable "
"is lexically bound, @code{set} affects its @emph{dynamic} value, whereas "
"@code{setq} affects its current (lexical) value. @xref{Variable Scoping}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:846
#, no-wrap
msgid ""
"(set one 1)\n"
"@error{} Symbol's value as variable is void: one\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:850
#, no-wrap
msgid ""
"(set 'one 1)\n"
" @result{} 1\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:854
#, no-wrap
msgid ""
"(set 'two 'one)\n"
" @result{} one\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:858
#, no-wrap
msgid ""
"(set two 2) ; @r{@code{two} evaluates to symbol @code{one}.}\n"
" @result{} 2\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:866
#, no-wrap
msgid ""
"one ; @r{So it is @code{one} that was set.}\n"
" @result{} 2\n"
"(let ((one 1)) ; @r{This binding of @code{one} is set,}\n"
" (set 'one 3) ; @r{not the global value.}\n"
" one)\n"
" @result{} 3\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:870
#, no-wrap
msgid ""
"one\n"
" @result{} 2\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:875
msgid ""
"If @var{symbol} is not actually a symbol, a @code{wrong-type-argument} error "
"is signaled."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:879
#, no-wrap
msgid ""
"(set '(x y) 'z)\n"
"@error{} Wrong type argument: symbolp, (x y)\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:884
#, no-wrap
msgid "variable watchpoints"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:885
#, no-wrap
msgid "watchpoints for Lisp variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:892
msgid ""
"It is sometimes useful to take some action when a variable changes its "
"value. The @dfn{variable watchpoint} facility provides the means to do so. "
"Some possible uses for this feature include keeping display in sync with "
"variable settings, and invoking the debugger to track down unexpected "
"changes to variables (@pxref{Variable Debugging})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:895
msgid ""
"The following functions may be used to manipulate and query the watch "
"functions for a variable."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:896
#, no-wrap
msgid "add-variable-watcher symbol watch-function"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:900
msgid ""
"This function arranges for @var{watch-function} to be called whenever "
"@var{symbol} is modified. Modifications through aliases (@pxref{Variable "
"Aliases}) will have the same effect."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:912
msgid ""
"@var{watch-function} will be called, just before changing the value of "
"@var{symbol}, with 4 arguments: @var{symbol}, @var{newval}, @var{operation}, "
"and @var{where}. @var{symbol} is the variable being changed. @var{newval} "
"is the value it will be changed to. (The old value is available to "
"@var{watch-function} as the value of @var{symbol}, since it was not yet "
"changed to @var{newval}.) @var{operation} is a symbol representing the kind "
"of change, one of: @code{set}, @code{let}, @code{unlet}, @code{makunbound}, "
"or @code{defvaralias}. @var{where} is a buffer if the buffer-local value of "
"the variable is being changed, @code{nil} otherwise."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:914
#, no-wrap
msgid "remove-variable-watcher symbol watch-function"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:917
msgid ""
"This function removes @var{watch-function} from @var{symbol}'s list of "
"watchers."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:919
#, no-wrap
msgid "get-variable-watchers symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:922
msgid "This function returns the list of @var{symbol}'s active watcher functions."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:924
#, no-wrap
msgid "Limitations"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:928
msgid ""
"There are a couple of ways in which a variable could be modified (or at "
"least appear to be modified) without triggering a watchpoint."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:932
msgid ""
"Since watchpoints are attached to symbols, modification to the objects "
"contained within variables (e.g., by a list modification function "
"@pxref{Modifying Lists}) is not caught by this mechanism."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:935
msgid ""
"Additionally, C code can modify the value of variables directly, bypassing "
"the watchpoint mechanism."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:942
msgid ""
"A minor limitation of this feature, again because it targets symbols, is "
"that only variables of dynamic scope may be watched. This poses little "
"difficulty, since modifications to lexical variables can be discovered "
"easily by inspecting the code within the scope of the variable (unlike "
"dynamic variables, which can be modified by any code at all, @pxref{Variable "
"Scoping})."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:945
#, no-wrap
msgid "Scoping Rules for Variable Bindings"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:946
#, no-wrap
msgid "scoping rule"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:951
msgid ""
"When you create a local binding for a variable, that binding takes effect "
"only within a limited portion of the program (@pxref{Local Variables}). "
"This section describes exactly what this means."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:952
#, no-wrap
msgid "scope"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:953
#, no-wrap
msgid "extent"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:958
msgid ""
"Each local binding has a certain @dfn{scope} and @dfn{extent}. @dfn{Scope} "
"refers to @emph{where} in the textual source code the binding can be "
"accessed. @dfn{Extent} refers to @emph{when}, as the program is executing, "
"the binding exists."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:959
#, no-wrap
msgid "dynamic binding"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:960
#, no-wrap
msgid "dynamic scope"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:961
#, no-wrap
msgid "dynamic extent"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:968
msgid ""
"By default, the local bindings that Emacs creates are @dfn{dynamic "
"bindings}. Such a binding has @dfn{dynamic scope}, meaning that any part of "
"the program can potentially access the variable binding. It also has "
"@dfn{dynamic extent}, meaning that the binding lasts only while the binding "
"construct (such as the body of a @code{let} form) is being executed."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:969
#, no-wrap
msgid "lexical binding"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:970
#, no-wrap
msgid "lexical scope"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:971
#, no-wrap
msgid "indefinite extent"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:980
msgid ""
"Emacs can optionally create @dfn{lexical bindings}. A lexical binding has "
"@dfn{lexical scope}, meaning that any reference to the variable must be "
"located textually within the binding construct@footnote{With some "
"exceptions; for instance, a lexical binding can also be accessed from the "
"Lisp debugger.}. It also has @dfn{indefinite extent}, meaning that under "
"some circumstances the binding can live on even after the binding construct "
"has finished executing, by means of special objects called @dfn{closures}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:984
msgid ""
"The following subsections describe dynamic binding and lexical binding in "
"greater detail, and how to enable lexical binding in Emacs Lisp programs."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:993
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:994
#, no-wrap
msgid "Dynamic Binding"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
msgid "The default for binding local variables in Emacs."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1067
#, no-wrap
msgid "Dynamic Binding Tips"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
msgid "Avoiding problems with dynamic binding."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1113
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1114
#, no-wrap
msgid "Lexical Binding"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
msgid "A different type of local variable binding."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1224
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1225
#, no-wrap
msgid "Using Lexical Binding"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
msgid "How to enable lexical binding."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1304
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1305
#, no-wrap
msgid "Converting to Lexical Binding"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:991
msgid "Convert existing code to lexical binding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1001
msgid ""
"By default, the local variable bindings made by Emacs are dynamic bindings. "
"When a variable is dynamically bound, its current binding at any point in "
"the execution of the Lisp program is simply the most recently-created "
"dynamic local binding for that symbol, or the global binding if there is no "
"such local binding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1004
msgid ""
"Dynamic bindings have dynamic scope and extent, as shown by the following "
"example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1008
#, no-wrap
msgid ""
"(defvar x -99) ; @r{@code{x} receives an initial value of @minus{}99.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1011
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1141
#, no-wrap
msgid ""
"(defun getx ()\n"
" x) ; @r{@code{x} is used free in this function.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1015
#, no-wrap
msgid ""
"(let ((x 1)) ; @r{@code{x} is dynamically bound.}\n"
" (getx))\n"
" @result{} 1\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1018
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1050
#, no-wrap
msgid ""
";; @r{After the @code{let} form finishes, @code{x} reverts to its}\n"
";; @r{previous value, which is @minus{}99.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1021
#, no-wrap
msgid ""
"(getx)\n"
" @result{} -99\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1032
msgid ""
"The function @code{getx} refers to @code{x}. This is a @dfn{free} "
"reference, in the sense that there is no binding for @code{x} within that "
"@code{defun} construct itself. When we call @code{getx} from within a "
"@code{let} form in which @code{x} is (dynamically) bound, it retrieves the "
"local value (i.e., 1). But when we call @code{getx} outside the @code{let} "
"form, it retrieves the global value (i.e., @minus{}99)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1035
msgid ""
"Here is another example, which illustrates setting a dynamically bound "
"variable using @code{setq}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1039
#, no-wrap
msgid ""
"(defvar x -99) ; @r{@code{x} receives an initial value of "
"@minus{}99.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1042
#, no-wrap
msgid ""
"(defun addx ()\n"
" (setq x (1+ x))) ; @r{Add 1 to @code{x} and return its new value.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1047
#, no-wrap
msgid ""
"(let ((x 1))\n"
" (addx)\n"
" (addx))\n"
" @result{} 3 ; @r{The two @code{addx} calls add to @code{x} "
"twice.}\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1053
#, no-wrap
msgid ""
"(addx)\n"
" @result{} -98\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1063
msgid ""
"Dynamic binding is implemented in Emacs Lisp in a simple way. Each symbol "
"has a value cell, which specifies its current dynamic value (or absence of "
"value). @xref{Symbol Components}. When a symbol is given a dynamic local "
"binding, Emacs records the contents of the value cell (or absence thereof) "
"in a stack, and stores the new local value in the value cell. When the "
"binding construct finishes executing, Emacs pops the old value off the "
"stack, and puts it in the value cell."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1066
msgid ""
"Note that when code using Dynamic Binding is native compiled the native "
"compiler will not perform any Lisp specific optimization."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1068
#, no-wrap
msgid "Proper Use of Dynamic Binding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1075
msgid ""
"Dynamic binding is a powerful feature, as it allows programs to refer to "
"variables that are not defined within their local textual scope. However, "
"if used without restraint, this can also make programs hard to understand. "
"There are two clean ways to use this technique:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1084
msgid ""
"If a variable has no global definition, use it as a local variable only "
"within a binding construct, such as the body of the @code{let} form where "
"the variable was bound. If this convention is followed consistently "
"throughout a program, the value of the variable will not affect, nor be "
"affected by, any uses of the same variable symbol elsewhere in the program."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1093
msgid ""
"Otherwise, define the variable with @code{defvar}, @code{defconst} "
"(@pxref{Defining Variables}), or @code{defcustom} (@pxref{Variable "
"Definitions}). Usually, the definition should be at top-level in an Emacs "
"Lisp file. As far as possible, it should include a documentation string "
"which explains the meaning and purpose of the variable. You should also "
"choose the variable's name to avoid name conflicts (@pxref{Coding "
"Conventions})."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1099
msgid ""
"Then you can bind the variable anywhere in a program, knowing reliably what "
"the effect will be. Wherever you encounter the variable, it will be easy to "
"refer back to the definition, e.g., via the @kbd{C-h v} command (provided "
"the variable definition has been loaded into Emacs). @xref{Name Help,,, "
"emacs, The GNU Emacs Manual}."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1102
msgid ""
"For example, it is common to use local bindings for customizable variables "
"like @code{case-fold-search}:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1109
#, no-wrap
msgid ""
"(defun search-for-abc ()\n"
" \"Search for the string \\\"abc\\\", ignoring case differences.\"\n"
" (let ((case-fold-search t))\n"
" (re-search-forward \"abc\")))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1122
msgid ""
"Lexical binding was introduced to Emacs, as an optional feature, in version "
"24.1. We expect its importance to increase with time. Lexical binding "
"opens up many more opportunities for optimization, so programs using it are "
"likely to run faster in future Emacs versions. Lexical binding is also more "
"compatible with concurrency, which was added to Emacs in version 26.1."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1126
msgid ""
"A lexically-bound variable has @dfn{lexical scope}, meaning that any "
"reference to the variable must be located textually within the binding "
"construct. Here is an example"
msgstr ""
#. type: iftex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1128
msgid "(see the next subsection, for how to actually enable lexical binding):"
msgstr ""
#. type: ifnottex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1131
msgid "(@pxref{Using Lexical Binding}, for how to actually enable lexical binding):"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1138
#, no-wrap
msgid ""
"(let ((x 1)) ; @r{@code{x} is lexically bound.}\n"
" (+ x 3))\n"
" @result{} 4\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1145
#, no-wrap
msgid ""
"(let ((x 1)) ; @r{@code{x} is lexically bound.}\n"
" (getx))\n"
"@error{} Symbol's value as variable is void: x\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1155
msgid ""
"Here, the variable @code{x} has no global value. When it is lexically bound "
"within a @code{let} form, it can be used in the textual confines of that "
"@code{let} form. But it can @emph{not} be used from within a @code{getx} "
"function called from the @code{let} form, since the function definition of "
"@code{getx} occurs outside the @code{let} form itself."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1156
#, no-wrap
msgid "lexical environment"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1163
msgid ""
"Here is how lexical binding works. Each binding construct defines a "
"@dfn{lexical environment}, specifying the variables that are bound within "
"the construct and their local values. When the Lisp evaluator wants the "
"current value of a variable, it looks first in the lexical environment; if "
"the variable is not specified in there, it looks in the symbol's value cell, "
"where the dynamic value is stored."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1171
msgid ""
"(Internally, the lexical environment is an alist of symbol-value pairs, with "
"the final element in the alist being the symbol @code{t} rather than a cons "
"cell. Such an alist can be passed as the second argument to the @code{eval} "
"function, in order to specify a lexical environment in which to evaluate a "
"form. @xref{Eval}. Most Emacs Lisp programs, however, should not interact "
"directly with lexical environments in this way; only specialized programs "
"like debuggers.)"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1172
#, no-wrap
msgid "closures, example of using"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1178
msgid ""
"Lexical bindings have indefinite extent. Even after a binding construct has "
"finished executing, its lexical environment can be ``kept around'' in Lisp "
"objects called @dfn{closures}. A closure is created when you define a named "
"or anonymous function with lexical binding enabled. @xref{Closures}, for "
"details."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1182
msgid ""
"When a closure is called as a function, any lexical variable references "
"within its definition use the retained lexical environment. Here is an "
"example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1186
#, no-wrap
msgid ""
"(defvar my-ticker nil) ; @r{We will use this dynamically bound}\n"
" ; @r{variable to store a closure.}\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1192
#, no-wrap
msgid ""
"(let ((x 0)) ; @r{@code{x} is lexically bound.}\n"
" (setq my-ticker (lambda ()\n"
" (setq x (1+ x)))))\n"
" @result{} (closure ((x . 0) t) ()\n"
" (setq x (1+ x)))\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1195
#, no-wrap
msgid ""
"(funcall my-ticker)\n"
" @result{} 1\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1198
#, no-wrap
msgid ""
"(funcall my-ticker)\n"
" @result{} 2\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1201
#, no-wrap
msgid ""
"(funcall my-ticker)\n"
" @result{} 3\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1204
#, no-wrap
msgid ""
"x ; @r{Note that @code{x} has no global value.}\n"
"@error{} Symbol's value as variable is void: x\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1215
msgid ""
"The @code{let} binding defines a lexical environment in which the variable "
"@code{x} is locally bound to 0. Within this binding construct, we define a "
"lambda expression which increments @code{x} by one and returns the "
"incremented value. This lambda expression is automatically turned into a "
"closure, in which the lexical environment lives on even after the @code{let} "
"binding construct has exited. Each time we evaluate the closure, it "
"increments @code{x}, using the binding of @code{x} in that lexical "
"environment."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1223
msgid ""
"Note that unlike dynamic variables which are tied to the symbol object "
"itself, the relationship between lexical variables and symbols is only "
"present in the interpreter (or compiler). Therefore, functions which take a "
"symbol argument (like @code{symbol-value}, @code{boundp}, and @code{set}) "
"can only retrieve or modify a variable's dynamic binding (i.e., the contents "
"of its symbol's value cell)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1230
msgid ""
"When loading an Emacs Lisp file or evaluating a Lisp buffer, lexical binding "
"is enabled if the buffer-local variable @code{lexical-binding} is "
"non-@code{nil}:"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1231
#, no-wrap
msgid "lexical-binding"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1240
msgid ""
"If this buffer-local variable is non-@code{nil}, Emacs Lisp files and "
"buffers are evaluated using lexical binding instead of dynamic binding. "
"(However, special variables are still dynamically bound; see below.) If "
"@code{nil}, dynamic binding is used for all local variables. This variable "
"is typically set for a whole Emacs Lisp file, as a file local variable "
"(@pxref{File Local Variables}). Note that unlike other such variables, this "
"one must be set in the first line of a file."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1246
msgid ""
"When evaluating Emacs Lisp code directly using an @code{eval} call, lexical "
"binding is enabled if the @var{lexical} argument to @code{eval} is "
"non-@code{nil}. @xref{Eval}."
msgstr ""
#. type: findex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1247
#, no-wrap
msgid "eval-expression@r{, and }lexical-binding"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1255
msgid ""
"Lexical binding is also enabled in Lisp Interaction and IELM mode, used in "
"the @file{*scratch*} and @file{*ielm*} buffers, and also when evaluating "
"expressions via @kbd{M-:} (@code{eval-expression}) and when processing the "
"@option{--eval} command-line options of Emacs (@pxref{Action Arguments,,, "
"emacs, The GNU Emacs Manual}) and @command{emacsclient} (@pxref{emacsclient "
"Options,,, emacs, The GNU Emacs Manual})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1256
#, no-wrap
msgid "special variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1263
msgid ""
"Even when lexical binding is enabled, certain variables will continue to be "
"dynamically bound. These are called @dfn{special variables}. Every "
"variable that has been defined with @code{defvar}, @code{defcustom} or "
"@code{defconst} is a special variable (@pxref{Defining Variables}). All "
"other variables are subject to lexical binding."
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1268
msgid "Local defvar example"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1268
msgid ""
"Using @code{defvar} without a value, it is possible to bind a variable "
"dynamically just in one file, or in just one part of a file while still "
"binding it lexically elsewhere. For example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1276
#, no-wrap
msgid ""
"(let (_)\n"
" (defvar x) ; @r{Let-bindings of @code{x} will be dynamic within this "
"let.}\n"
" (let ((x -99)) ; @r{This is a dynamic binding of @code{x}.}\n"
" (defun get-dynamic-x ()\n"
" x)))\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1280
#, no-wrap
msgid ""
"(let ((x 'lexical)) ; @r{This is a lexical binding of @code{x}.}\n"
" (defun get-lexical-x ()\n"
" x))\n"
"\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1287
#, no-wrap
msgid ""
"(let (_)\n"
" (defvar x)\n"
" (let ((x 'dynamic))\n"
" (list (get-lexical-x)\n"
" (get-dynamic-x))))\n"
" @result{} (lexical dynamic)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1290
#, no-wrap
msgid "special-variable-p symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1295
msgid ""
"This function returns non-@code{nil} if @var{symbol} is a special variable "
"(i.e., it has a @code{defvar}, @code{defcustom}, or @code{defconst} variable "
"definition). Otherwise, the return value is @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1299
msgid ""
"Note that since this is a function, it can only return non-@code{nil} for "
"variables which are permanently special, but not for those that are only "
"special in the current lexical scope."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1303
msgid ""
"The use of a special variable as a formal argument in a function is not "
"supported."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1313
msgid ""
"Converting an Emacs Lisp program to lexical binding is easy. First, add a "
"file-local variable setting of @code{lexical-binding} to @code{t} in the "
"header line of the Emacs Lisp source file (@pxref{File Local Variables}). "
"Second, check that every variable in the program which needs to be "
"dynamically bound has a variable definition, so that it is not inadvertently "
"bound lexically."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1314
#, no-wrap
msgid "free variable"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1315
#, no-wrap
msgid "unused lexical variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1324
msgid ""
"A simple way to find out which variables need a variable definition is to "
"byte-compile the source file. @xref{Byte Compilation}. If a non-special "
"variable is used outside of a @code{let} form, the byte-compiler will warn "
"about reference or assignment to a free variable. If a non-special variable "
"is bound but not used within a @code{let} form, the byte-compiler will warn "
"about an unused lexical variable. The byte-compiler will also issue a "
"warning if you use a special variable as a function argument."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1329
msgid ""
"A warning about a reference or an assignment to a free variable is usually a "
"clear sign that that variable should be marked as dynamically scoped, so you "
"need to add an appropriate @code{defvar} before the first use of that "
"variable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1341
msgid ""
"A warning about an unused variable may be a good hint that the variable was "
"intended to be dynamically scoped (because it is actually used, but in "
"another function), but it may also be an indication that the variable is "
"simply really not used and could simply be removed. So you need to find out "
"which case it is, and based on that, either add a @code{defvar} or remove "
"the variable altogether. If removal is not possible or not desirable "
"(typically because it is a formal argument and that we cannot or don't want "
"to change all the callers), you can also add a leading underscore to the "
"variable's name to indicate to the compiler that this is a variable known "
"not to be used.)"
msgstr ""
#. type: subsubheading
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1342
#, no-wrap
msgid "Cross-file variable checking"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1346
msgid ""
"@strong{Caution:} This is an experimental feature that may change or "
"disappear without prior notice."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1351
msgid ""
"The byte-compiler can also warn about lexical variables that are special in "
"other Emacs Lisp files, often indicating a missing @code{defvar} "
"declaration. This useful but somewhat specialised check requires three "
"steps:"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1360
msgid ""
"Byte-compile all files whose special variable declarations may be of "
"interest, with the environment variable @env{EMACS_GENERATE_DYNVARS} set to "
"a nonempty string. These are typically all the files in the same package or "
"related packages or Emacs subsystems. The process will generate a file "
"whose name ends in @file{.dynvars} for each compiled Emacs Lisp file."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1363
msgid "Concatenate the @file{.dynvars} files into a single file."
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1368
msgid ""
"Byte-compile the files that need to be checked, this time with the "
"environment variable @env{EMACS_DYNVARS_FILE} set to the name of the "
"aggregated file created in step 2."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1372
msgid ""
"Here is an example illustrating how this could be done, assuming that a Unix "
"shell and @command{make} are used for byte-compilation:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1379
#, no-wrap
msgid ""
"$ rm *.elc # force recompilation\n"
"$ EMACS_GENERATE_DYNVARS=1 make # generate .dynvars\n"
"$ cat *.dynvars > ~/my-dynvars # combine .dynvars\n"
"$ rm *.elc # force recompilation\n"
"$ EMACS_DYNVARS_FILE=~/my-dynvars make # perform checks\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1383
#, no-wrap
msgid "variable, buffer-local"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1384
#, no-wrap
msgid "buffer-local variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1393
msgid ""
"Global and local variable bindings are found in most programming languages "
"in one form or another. Emacs, however, also supports additional, unusual "
"kinds of variable binding, such as @dfn{buffer-local} bindings, which apply "
"only in one buffer. Having different values for a variable in different "
"buffers is an important customization method. (Variables can also have "
"bindings that are local to each terminal. @xref{Multiple Terminals}.)"
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1401
#, no-wrap
msgid "Intro to Buffer-Local"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
msgid "Introduction and concepts."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1495
#, no-wrap
msgid "Creating Buffer-Local"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
msgid "Creating and destroying buffer-local bindings."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1744
#, no-wrap
msgid "Default Value"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1399
msgid ""
"The default value is seen in buffers that don't have their own buffer-local "
"values."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1402
#, no-wrap
msgid "Introduction to Buffer-Local Variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1410
msgid ""
"A buffer-local variable has a buffer-local binding associated with a "
"particular buffer. The binding is in effect when that buffer is current; "
"otherwise, it is not in effect. If you set the variable while a "
"buffer-local binding is in effect, the new value goes in that binding, so "
"its other bindings are unchanged. This means that the change is visible "
"only in the buffer where you made it."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1414
msgid ""
"The variable's ordinary binding, which is not associated with any specific "
"buffer, is called the @dfn{default binding}. In most cases, this is the "
"global binding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1422
msgid ""
"A variable can have buffer-local bindings in some buffers but not in other "
"buffers. The default binding is shared by all the buffers that don't have "
"their own bindings for the variable. (This includes all newly-created "
"buffers.) If you set the variable in a buffer that does not have a "
"buffer-local binding for it, this sets the default binding, so the new value "
"is visible in all the buffers that see the default binding."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1429
msgid ""
"The most common use of buffer-local bindings is for major modes to change "
"variables that control the behavior of commands. For example, C mode and "
"Lisp mode both set the variable @code{paragraph-start} to specify that only "
"blank lines separate paragraphs. They do this by making the variable "
"buffer-local in the buffer that is being put into C mode or Lisp mode, and "
"then setting it to the new value for that mode. @xref{Major Modes}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1435
msgid ""
"The usual way to make a buffer-local binding is with "
"@code{make-local-variable}, which is what major mode commands typically "
"use. This affects just the current buffer; all other buffers (including "
"those yet to be created) will continue to share the default value unless "
"they are explicitly given their own buffer-local bindings."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1436
#, no-wrap
msgid "automatically buffer-local"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1449
msgid ""
"A more powerful operation is to mark the variable as @dfn{automatically "
"buffer-local} by calling @code{make-variable-buffer-local}. You can think "
"of this as making the variable local in all buffers, even those yet to be "
"created. More precisely, the effect is that setting the variable "
"automatically makes the variable local to the current buffer if it is not "
"already so. All buffers start out by sharing the default value of the "
"variable as usual, but setting the variable creates a buffer-local binding "
"for the current buffer. The new value is stored in the buffer-local "
"binding, leaving the default binding untouched. This means that the default "
"value cannot be changed with @code{setq} in any buffer; the only way to "
"change it is with @code{setq-default}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1461
msgid ""
"@strong{Warning:} When a variable has buffer-local bindings in one or more "
"buffers, @code{let} rebinds the binding that's currently in effect. For "
"instance, if the current buffer has a buffer-local value, @code{let} "
"temporarily rebinds that. If no buffer-local bindings are in effect, "
"@code{let} rebinds the default value. If inside the @code{let} you then "
"change to a different current buffer in which a different binding is in "
"effect, you won't see the @code{let} binding any more. And if you exit the "
"@code{let} while still in the other buffer, you won't see the unbinding "
"occur (though it will occur properly). Here is an example to illustrate:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1467
#, no-wrap
msgid ""
"(setq foo 'g)\n"
"(set-buffer \"a\")\n"
"(make-local-variable 'foo)\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1474
#, no-wrap
msgid ""
"(setq foo 'a)\n"
"(let ((foo 'temp))\n"
" ;; foo @result{} 'temp ; @r{let binding in buffer @samp{a}}\n"
" (set-buffer \"b\")\n"
" ;; foo @result{} 'g ; @r{the global value since foo is not local in "
"@samp{b}}\n"
" @var{body}@dots{})\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1477
#, no-wrap
msgid ""
"foo @result{} 'g ; @r{exiting restored the local value in buffer "
"@samp{a},}\n"
" ; @r{but we don't see that in buffer @samp{b}}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1481
#, no-wrap
msgid ""
"(set-buffer \"a\") ; @r{verify the local value was restored}\n"
"foo @result{} 'a\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1487
msgid ""
"Note that references to @code{foo} in @var{body} access the buffer-local "
"binding of buffer @samp{b}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1491
msgid ""
"When a file specifies local variable values, these become buffer-local "
"values when you visit the file. @xref{File Variables,,, emacs, The GNU "
"Emacs Manual}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1494
msgid ""
"A buffer-local variable cannot be made terminal-local (@pxref{Multiple "
"Terminals})."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1496
#, no-wrap
msgid "Creating and Deleting Buffer-Local Bindings"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1498
#, no-wrap
msgid "Command make-local-variable variable"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1502
msgid ""
"This function creates a buffer-local binding in the current buffer for "
"@var{variable} (a symbol). Other buffers are not affected. The value "
"returned is @var{variable}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1506
msgid ""
"The buffer-local value of @var{variable} starts out as the same value "
"@var{variable} previously had. If @var{variable} was void, it remains void."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1512
#, no-wrap
msgid ""
";; @r{In buffer @samp{b1}:}\n"
"(setq foo 5) ; @r{Affects all buffers.}\n"
" @result{} 5\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1516
#, no-wrap
msgid ""
"(make-local-variable 'foo) ; @r{Now it is local in @samp{b1}.}\n"
" @result{} foo\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1520
#, no-wrap
msgid ""
"foo ; @r{That did not change}\n"
" @result{} 5 ; @r{the value.}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1524
#, no-wrap
msgid ""
"(setq foo 6) ; @r{Change the value}\n"
" @result{} 6 ; @r{in @samp{b1}.}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1528
#, no-wrap
msgid ""
"foo\n"
" @result{} 6\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1535
#, no-wrap
msgid ""
";; @r{In buffer @samp{b2}, the value hasn't changed.}\n"
"(with-current-buffer \"b2\"\n"
" foo)\n"
" @result{} 5\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1543
msgid ""
"Making a variable buffer-local within a @code{let}-binding for that variable "
"does not work reliably, unless the buffer in which you do this is not "
"current either on entry to or exit from the @code{let}. This is because "
"@code{let} does not distinguish between different kinds of bindings; it "
"knows only which variable the binding was made for."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1546
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1594
msgid ""
"It is an error to make a constant or a read-only variable buffer-local. "
"@xref{Constant Variables}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1550
msgid ""
"If the variable is terminal-local (@pxref{Multiple Terminals}), this "
"function signals an error. Such variables cannot have buffer-local bindings "
"as well."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1555
msgid ""
"@strong{Warning:} do not use @code{make-local-variable} for a hook "
"variable. The hook variables are automatically made buffer-local as needed "
"if you use the @var{local} argument to @code{add-hook} or "
"@code{remove-hook}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1557
#, no-wrap
msgid "setq-local &rest pairs"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1563
msgid ""
"@var{pairs} is a list of variable and value pairs. This macro creates a "
"buffer-local binding in the current buffer for each of the variables, and "
"gives them a buffer-local value. It is equivalent to calling "
"@code{make-local-variable} followed by @code{setq} for each of the "
"variables. The variables should be unquoted symbols."
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1567
#, no-wrap
msgid ""
"(setq-local var1 \"value1\"\n"
" var2 \"value2\")\n"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1570
#, no-wrap
msgid "Command make-variable-buffer-local variable"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1577
msgid ""
"This function marks @var{variable} (a symbol) automatically buffer-local, so "
"that any subsequent attempt to set it will make it local to the current "
"buffer at the time. Unlike @code{make-local-variable}, with which it is "
"often confused, this cannot be undone, and affects the behavior of the "
"variable in all buffers."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1583
msgid ""
"A peculiar wrinkle of this feature is that binding the variable (with "
"@code{let} or other binding constructs) does not create a buffer-local "
"binding for it. Only setting the variable (with @code{set} or @code{setq}), "
"while the variable does not have a @code{let}-style binding that was made in "
"the current buffer, does so."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1589
msgid ""
"If @var{variable} does not have a default value, then calling this command "
"will give it a default value of @code{nil}. If @var{variable} already has a "
"default value, that value remains unchanged. Subsequently calling "
"@code{makunbound} on @var{variable} will result in a void buffer-local value "
"and leave the default value unaffected."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1591
msgid "The value returned is @var{variable}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1600
msgid ""
"@strong{Warning:} Don't assume that you should use "
"@code{make-variable-buffer-local} for user-option variables, simply because "
"users @emph{might} want to customize them differently in different buffers. "
"Users can make any variable local, when they wish to. It is better to leave "
"the choice to them."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1606
msgid ""
"The time to use @code{make-variable-buffer-local} is when it is crucial that "
"no two buffers ever share the same binding. For example, when a variable is "
"used for internal purposes in a Lisp program which depends on having "
"separate values in separate buffers, then using "
"@code{make-variable-buffer-local} can be the best solution."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1608
#, no-wrap
msgid "defvar-local variable value &optional docstring"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1614
msgid ""
"This macro defines @var{variable} as a variable with initial value "
"@var{value} and @var{docstring}, and marks it as automatically "
"buffer-local. It is equivalent to calling @code{defvar} followed by "
"@code{make-variable-buffer-local}. @var{variable} should be an unquoted "
"symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1616
#, no-wrap
msgid "local-variable-p variable &optional buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1620
msgid ""
"This returns @code{t} if @var{variable} is buffer-local in buffer "
"@var{buffer} (which defaults to the current buffer); otherwise, @code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1622
#, no-wrap
msgid "local-variable-if-set-p variable &optional buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1627
msgid ""
"This returns @code{t} if @var{variable} either has a buffer-local value in "
"buffer @var{buffer}, or is automatically buffer-local. Otherwise, it "
"returns @code{nil}. If omitted or @code{nil}, @var{buffer} defaults to the "
"current buffer."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1629
#, no-wrap
msgid "buffer-local-value variable buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1634
msgid ""
"This function returns the buffer-local binding of @var{variable} (a symbol) "
"in buffer @var{buffer}. If @var{variable} does not have a buffer-local "
"binding in buffer @var{buffer}, it returns the default value (@pxref{Default "
"Value}) of @var{variable} instead."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1636
#, no-wrap
msgid "buffer-local-boundp variable buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1640
msgid ""
"This returns non-@code{nil} if there's either a buffer-local binding of "
"@var{variable} (a symbol) in buffer @var{buffer}, or @var{variable} has a "
"global binding."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1642
#, no-wrap
msgid "buffer-local-variables &optional buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1650
msgid ""
"This function returns a list describing the buffer-local variables in buffer "
"@var{buffer}. (If @var{buffer} is omitted, the current buffer is used.) "
"Normally, each list element has the form @w{@code{(@var{sym} . @var{val})}}, "
"where @var{sym} is a buffer-local variable (a symbol) and @var{val} is its "
"buffer-local value. But when a variable's buffer-local binding in "
"@var{buffer} is void, its list element is just @var{sym}."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1657
#, no-wrap
msgid ""
"(make-local-variable 'foobar)\n"
"(makunbound 'foobar)\n"
"(make-local-variable 'bind-me)\n"
"(setq bind-me 69)\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1664
#, no-wrap
msgid ""
"(setq lcl (buffer-local-variables))\n"
" ;; @r{First, built-in variables local in all buffers:}\n"
"@result{} ((mark-active . nil)\n"
" (buffer-undo-list . nil)\n"
" (mode-name . \"Fundamental\")\n"
" @dots{}\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1670
#, no-wrap
msgid ""
" ;; @r{Next, non-built-in buffer-local variables.}\n"
" ;; @r{This one is buffer-local and void:}\n"
" foobar\n"
" ;; @r{This one is buffer-local and nonvoid:}\n"
" (bind-me . 69))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1675
msgid ""
"Note that storing new values into the @sc{cdr}s of cons cells in this list "
"does @emph{not} change the buffer-local values of the variables."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1677
#, no-wrap
msgid "Command kill-local-variable variable"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1684
msgid ""
"This function deletes the buffer-local binding (if any) for @var{variable} "
"(a symbol) in the current buffer. As a result, the default binding of "
"@var{variable} becomes visible in this buffer. This typically results in a "
"change in the value of @var{variable}, since the default value is usually "
"different from the buffer-local value just eliminated."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1689
msgid ""
"If you kill the buffer-local binding of a variable that automatically "
"becomes buffer-local when set, this makes the default value visible in the "
"current buffer. However, if you set the variable again, that will once "
"again create a buffer-local binding for it."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1691
msgid "@code{kill-local-variable} returns @var{variable}."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1695
msgid ""
"This function is a command because it is sometimes useful to kill one "
"buffer-local variable interactively, just as it is useful to create "
"buffer-local variables interactively."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1697
#, no-wrap
msgid "local variables, killed by major mode"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1698
#, no-wrap
msgid "kill-all-local-variables &optional kill-permanent"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1706
msgid ""
"This function eliminates all the buffer-local variable bindings of the "
"current buffer. As a result, the buffer will see the default values of most "
"variables. By default, for variables marked as permanent and local hook "
"functions that have a non-@code{nil} @code{permanent-local-hook} property "
"(@pxref{Setting Hooks}) won't be killed, but if the optional "
"@var{kill-permanent} argument is non-@code{nil}, even these variables will "
"be killed."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1712
msgid ""
"This function also resets certain other information pertaining to the "
"buffer: it sets the local keymap to @code{nil}, the syntax table to the "
"value of @code{(standard-syntax-table)}, the case table to "
"@code{(standard-case-table)}, and the abbrev table to the value of "
"@code{fundamental-mode-abbrev-table}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1715
msgid ""
"The very first thing this function does is run the normal hook "
"@code{change-major-mode-hook} (see below)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1720
msgid ""
"Every major mode command begins by calling this function, which has the "
"effect of switching to Fundamental mode and erasing most of the effects of "
"the previous major mode. To ensure that this does its job, the variables "
"that major modes set should not be marked permanent."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1722
msgid "@code{kill-all-local-variables} returns @code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1724
#, no-wrap
msgid "change-major-mode-hook"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1730
msgid ""
"The function @code{kill-all-local-variables} runs this normal hook before it "
"does anything else. This gives major modes a way to arrange for something "
"special to be done if the user switches to a different major mode. It is "
"also useful for buffer-specific minor modes that should be forgotten if the "
"user changes the major mode."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1734
msgid ""
"For best results, make this variable buffer-local, so that it will disappear "
"after doing its job and will not interfere with the subsequent major mode. "
"@xref{Hooks}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1736
#, no-wrap
msgid "permanent local variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1743
msgid ""
"A buffer-local variable is @dfn{permanent} if the variable name (a symbol) "
"has a @code{permanent-local} property that is non-@code{nil}. Such "
"variables are unaffected by @code{kill-all-local-variables}, and their local "
"bindings are therefore not cleared by changing major modes. Permanent "
"locals are appropriate for data pertaining to where the file came from or "
"how to save it, rather than with how to edit the contents."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1745
#, no-wrap
msgid "The Default Value of a Buffer-Local Variable"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1746
#, no-wrap
msgid "default value"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1752
msgid ""
"The global value of a variable with buffer-local bindings is also called the "
"@dfn{default} value, because it is the value that is in effect whenever "
"neither the current buffer nor the selected frame has its own binding for "
"the variable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1760
msgid ""
"The functions @code{default-value} and @code{setq-default} access and change "
"a variable's default value regardless of whether the current buffer has a "
"buffer-local binding. For example, you could use @code{setq-default} to "
"change the default setting of @code{paragraph-start} for most buffers; and "
"this would work even when you are in a C or Lisp mode buffer that has a "
"buffer-local value for this variable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1764
msgid ""
"The special forms @code{defvar} and @code{defconst} also set the default "
"value (if they set the variable at all), rather than any buffer-local value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1765
#, no-wrap
msgid "default-value symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1770
msgid ""
"This function returns @var{symbol}'s default value. This is the value that "
"is seen in buffers and frames that do not have their own values for this "
"variable. If @var{symbol} is not buffer-local, this is equivalent to "
"@code{symbol-value} (@pxref{Accessing Variables})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1772
#, no-wrap
msgid "default-boundp symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1776
msgid ""
"The function @code{default-boundp} tells you whether @var{symbol}'s default "
"value is nonvoid. If @code{(default-boundp 'foo)} returns @code{nil}, then "
"@code{(default-value 'foo)} would get an error."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1779
msgid ""
"@code{default-boundp} is to @code{default-value} as @code{boundp} is to "
"@code{symbol-value}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1781
#, no-wrap
msgid "setq-default [symbol form]@dots{}"
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1786
msgid ""
"This special form gives each @var{symbol} a new default value, which is the "
"result of evaluating the corresponding @var{form}. It does not evaluate "
"@var{symbol}, but does evaluate @var{form}. The value of the "
"@code{setq-default} form is the value of the last @var{form}."
msgstr ""
#. type: defspec
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1793
msgid ""
"If a @var{symbol} is not buffer-local for the current buffer, and is not "
"marked automatically buffer-local, @code{setq-default} has the same effect "
"as @code{setq}. If @var{symbol} is buffer-local for the current buffer, "
"then this changes the value that other buffers will see (as long as they "
"don't have a buffer-local value), but not the value that the current buffer "
"sees."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1799
#, no-wrap
msgid ""
";; @r{In buffer @samp{foo}:}\n"
"(make-local-variable 'buffer-local)\n"
" @result{} buffer-local\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1803
#, no-wrap
msgid ""
"(setq buffer-local 'value-in-foo)\n"
" @result{} value-in-foo\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1807
#, no-wrap
msgid ""
"(setq-default buffer-local 'new-default)\n"
" @result{} new-default\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1811
#, no-wrap
msgid ""
"buffer-local\n"
" @result{} value-in-foo\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1815
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1825
#, no-wrap
msgid ""
"(default-value 'buffer-local)\n"
" @result{} new-default\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1821
#, no-wrap
msgid ""
";; @r{In (the new) buffer @samp{bar}:}\n"
"buffer-local\n"
" @result{} new-default\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1829
#, no-wrap
msgid ""
"(setq buffer-local 'another-default)\n"
" @result{} another-default\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1833
#, no-wrap
msgid ""
"(default-value 'buffer-local)\n"
" @result{} another-default\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1841
#, no-wrap
msgid ""
";; @r{Back in buffer @samp{foo}:}\n"
"buffer-local\n"
" @result{} value-in-foo\n"
"(default-value 'buffer-local)\n"
" @result{} another-default\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1845
#, no-wrap
msgid "set-default symbol value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1848
msgid ""
"This function is like @code{setq-default}, except that @var{symbol} is an "
"ordinary evaluated argument."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1853
#, no-wrap
msgid ""
"(set-default (car '(a b c)) 23)\n"
" @result{} 23\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1857
#, no-wrap
msgid ""
"(default-value 'a)\n"
" @result{} 23\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1868
msgid ""
"A variable can be let-bound (@pxref{Local Variables}) to a value. This "
"makes its global value shadowed by the binding; @code{default-value} will "
"then return the value from that binding, not the global value, and "
"@code{set-default} will be prevented from setting the global value (it will "
"change the let-bound value instead). The following two functions allow to "
"reference the global value even if it's shadowed by a let-binding."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1869
#, no-wrap
msgid "top-level default value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1870
#, no-wrap
msgid "default-toplevel-value symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1873
msgid ""
"This function returns the @dfn{top-level} default value of @var{symbol}, "
"which is its value outside of any let-binding."
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1879
#, no-wrap
msgid ""
"(defvar variable 'global-value)\n"
" @result{} variable\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1884
#, no-wrap
msgid ""
"(let ((variable 'let-binding))\n"
" (default-value 'variable))\n"
" @result{} let-binding\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1889
#, no-wrap
msgid ""
"(let ((variable 'let-binding))\n"
" (default-toplevel-value 'variable))\n"
" @result{} global-value\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1892
#, no-wrap
msgid "set-default-toplevel-value symbol value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1897
msgid ""
"This function sets the top-level default value of @var{symbol} to the "
"specified @var{value}. This comes in handy when you want to set the global "
"value of @var{symbol} regardless of whether your code runs in the context of "
"@var{symbol}'s let-binding."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1902
#, no-wrap
msgid "file local variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1910
msgid ""
"A file can specify local variable values; Emacs uses these to create "
"buffer-local bindings for those variables in the buffer visiting that file. "
"@xref{File Variables, , Local Variables in Files, emacs, The GNU Emacs "
"Manual}, for basic information about file-local variables. This section "
"describes the functions and variables that affect how file-local variables "
"are processed."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1916
msgid ""
"If a file-local variable could specify an arbitrary function or Lisp "
"expression that would be called later, visiting a file could take over your "
"Emacs. Emacs protects against this by automatically setting only those "
"file-local variables whose specified values are known to be safe. Other "
"file-local variables are set only if the user agrees."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1921
msgid ""
"For additional safety, @code{read-circle} is temporarily bound to @code{nil} "
"when Emacs reads file-local variables (@pxref{Input Functions}). This "
"prevents the Lisp reader from recognizing circular and shared Lisp "
"structures (@pxref{Circular Objects})."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1922
#, no-wrap
msgid "enable-local-variables"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1925
msgid ""
"This variable controls whether to process file-local variables. The "
"possible values are:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1927
#, no-wrap
msgid "@code{t} (the default)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1929
msgid "Set the safe variables, and query (once) about any unsafe variables."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1929
#, no-wrap
msgid ":safe"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1931
msgid "Set only the safe variables and do not query."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1931
#, no-wrap
msgid ":all"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1933
msgid "Set all the variables and do not query."
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1933
#, no-wrap
msgid "nil"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1935
msgid "Don't set any variables."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1935
#, no-wrap
msgid "anything else"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1937
msgid "Query (once) about all the variables."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1940
#, no-wrap
msgid "inhibit-local-variables-regexps"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1945
msgid ""
"This is a list of regular expressions. If a file has a name matching an "
"element of this list, then it is not scanned for any form of file-local "
"variable. For examples of why you might want to use this, @pxref{Auto Major "
"Mode}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1947
#, no-wrap
msgid "permanently-enabled-local-variables"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1953
msgid ""
"Some local variable settings will, by default, be heeded even if "
"@code{enable-local-variables} is @code{nil}. By default, this is only the "
"case for the @code{lexical-binding} local variable setting, but this can be "
"controlled by using this variable, which is a list of symbols."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1955
#, no-wrap
msgid "hack-local-variables &optional handle-mode"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1962
msgid ""
"This function parses, and binds or evaluates as appropriate, any local "
"variables specified by the contents of the current buffer. The variable "
"@code{enable-local-variables} has its effect here. However, this function "
"does not look for the @samp{mode:} local variable in the @w{@samp{-*-}} "
"line. @code{set-auto-mode} does that, also taking "
"@code{enable-local-variables} into account (@pxref{Auto Major Mode})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1971
msgid ""
"This function works by walking the alist stored in "
"@code{file-local-variables-alist} and applying each local variable in turn. "
"It calls @code{before-hack-local-variables-hook} and "
"@code{hack-local-variables-hook} before and after applying the variables, "
"respectively. It only calls the before-hook if the alist is non-@code{nil}; "
"it always calls the other hook. This function ignores a @samp{mode} element "
"if it specifies the same major mode as the buffer already has."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1981
msgid ""
"If the optional argument @var{handle-mode} is @code{t}, then all this "
"function does is return a symbol specifying the major mode, if the "
"@w{@samp{-*-}} line or the local variables list specifies one, and "
"@code{nil} otherwise. It does not set the mode or any other file-local "
"variable. If @var{handle-mode} has any value other than @code{nil} or "
"@code{t}, any settings of @samp{mode} in the @w{@samp{-*-}} line or the "
"local variables list are ignored, and the other settings are applied. If "
"@var{handle-mode} is @code{nil}, all the file local variables are set."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1983
#, no-wrap
msgid "file-local-variables-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1991
msgid ""
"This buffer-local variable holds the alist of file-local variable settings. "
"Each element of the alist is of the form @w{@code{(@var{var} "
". @var{value})}}, where @var{var} is a symbol of the local variable and "
"@var{value} is its value. When Emacs visits a file, it first collects all "
"the file-local variables into this alist, and then the "
"@code{hack-local-variables} function applies them one by one."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1993
#, no-wrap
msgid "before-hack-local-variables-hook"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1996
msgid ""
"Emacs calls this hook immediately before applying file-local variables "
"stored in @code{file-local-variables-alist}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:1998
#, no-wrap
msgid "hack-local-variables-hook"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2001
msgid ""
"Emacs calls this hook immediately after it finishes applying file-local "
"variables stored in @code{file-local-variables-alist}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2003
#, no-wrap
msgid "safe local variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2012
msgid ""
"You can specify safe values for a variable with a @code{safe-local-variable} "
"property. The property has to be a function of one argument; any value is "
"safe if the function returns non-@code{nil} given that value. Many "
"commonly-encountered file variables have @code{safe-local-variable} "
"properties; these include @code{fill-column}, @code{fill-prefix}, and "
"@code{indent-tabs-mode}. For boolean-valued variables that are safe, use "
"@code{booleanp} as the property value."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2017
msgid ""
"If you want to define @code{safe-local-variable} properties for variables "
"defined in C source code, add the names and the properties of those "
"variables to the list in the ``Safe local variables'' section of "
"@file{files.el}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2018
#, no-wrap
msgid "autoload cookie, and safe values of variable"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2027
msgid ""
"When defining a user option using @code{defcustom}, you can set its "
"@code{safe-local-variable} property by adding the arguments @code{:safe "
"@var{function}} to @code{defcustom} (@pxref{Variable Definitions}). "
"However, a safety predicate defined using @code{:safe} will only be known "
"once the package that contains the @code{defcustom} is loaded, which is "
"often too late. As an alternative, you can use the autoload cookie "
"(@pxref{Autoload}) to assign the option its safety predicate, like this:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2030
#, no-wrap
msgid ";;;###autoload (put '@var{var} 'safe-local-variable '@var{pred})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2037
msgid ""
"The safe value definitions specified with @code{autoload} are copied into "
"the package's autoloads file (@file{loaddefs.el} for most packages bundled "
"with Emacs), and are known to Emacs since the beginning of a session."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2038
#, no-wrap
msgid "safe-local-variable-values"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2043
msgid ""
"This variable provides another way to mark some variable values as safe. It "
"is a list of cons cells @code{(@var{var} . @var{val})}, where @var{var} is a "
"variable name and @var{val} is a value which is safe for that variable."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2049
msgid ""
"When Emacs asks the user whether or not to obey a set of file-local variable "
"specifications, the user can choose to mark them as safe. Doing so adds "
"those variable/value pairs to @code{safe-local-variable-values}, and saves "
"it to the user's custom file."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2051
#, no-wrap
msgid "ignored-local-variable-values"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2063
msgid ""
"If there are some values of particular local variables that you always want "
"to ignore completely, you can use this variable. Its value has the same "
"form as @code{safe-local-variable-values}; a file-local variable setting to "
"the value that appears in the list will always be ignored when processing "
"the local variables specified by the file. As with that variable, when "
"Emacs queries the user about whether to obey file-local variables, the user "
"can choose to ignore their particular values permanently, and that will "
"alter this variable and save it to the user's custom file. Variable-value "
"pairs that appear in this variable take precedence over the same pairs in "
"@code{safe-local-variable-values}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2065
#, no-wrap
msgid "safe-local-variable-p sym val"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2068
msgid ""
"This function returns non-@code{nil} if it is safe to give @var{sym} the "
"value @var{val}, based on the above criteria."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2076
msgid ""
"Some variables are considered @dfn{risky}. If a variable is risky, it is "
"never entered automatically into @code{safe-local-variable-values}; Emacs "
"always queries before setting a risky variable, unless the user explicitly "
"allows a value by customizing @code{safe-local-variable-values} directly."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2090
msgid ""
"Any variable whose name has a non-@code{nil} @code{risky-local-variable} "
"property is considered risky. When you define a user option using "
"@code{defcustom}, you can set its @code{risky-local-variable} property by "
"adding the arguments @code{:risky @var{value}} to @code{defcustom} "
"(@pxref{Variable Definitions}). In addition, any variable whose name ends "
"in any of @samp{-command}, @samp{-frame-alist}, @samp{-function}, "
"@samp{-functions}, @samp{-hook}, @samp{-hooks}, @samp{-form}, @samp{-forms}, "
"@samp{-map}, @samp{-map-alist}, @samp{-mode-alist}, @samp{-program}, or "
"@samp{-predicate} is automatically considered risky. The variables "
"@samp{font-lock-keywords}, @samp{font-lock-keywords} followed by a digit, "
"and @samp{font-lock-syntactic-keywords} are also considered risky."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2091
#, no-wrap
msgid "risky-local-variable-p sym"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2094
msgid ""
"This function returns non-@code{nil} if @var{sym} is a risky variable, based "
"on the above criteria."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2096
#, no-wrap
msgid "ignored-local-variables"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2100
msgid ""
"This variable holds a list of variables that should not be given local "
"values by files. Any value specified for one of these variables is "
"completely ignored."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2104
msgid ""
"The @samp{Eval:} ``variable'' is also a potential loophole, so Emacs "
"normally asks for confirmation before handling it."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2105
#, no-wrap
msgid "enable-local-eval"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2111
msgid ""
"This variable controls processing of @samp{Eval:} in @samp{-*-} lines or "
"local variables lists in files being visited. A value of @code{t} means "
"process them unconditionally; @code{nil} means ignore them; anything else "
"means ask the user what to do for each file. The default value is "
"@code{maybe}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2113
#, no-wrap
msgid "safe-local-eval-forms"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2117
msgid ""
"This variable holds a list of expressions that are safe to evaluate when "
"found in the @samp{Eval:} ``variable'' in a file local variables list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2125
msgid ""
"If the expression is a function call and the function has a "
"@code{safe-local-eval-function} property, the property value determines "
"whether the expression is safe to evaluate. The property value can be a "
"predicate to call to test the expression, a list of such predicates (it's "
"safe if any predicate succeeds), or @code{t} (always safe provided the "
"arguments are constant)."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2129
msgid ""
"Text properties are also potential loopholes, since their values could "
"include functions to call. So Emacs discards all text properties from "
"string values specified for file-local variables."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2132
#, no-wrap
msgid "directory local variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2139
msgid ""
"A directory can specify local variable values common to all files in that "
"directory; Emacs uses these to create buffer-local bindings for those "
"variables in buffers visiting any file in that directory. This is useful "
"when the files in the directory belong to some @dfn{project} and therefore "
"share the same local variables."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2143
msgid ""
"There are two different methods for specifying directory local variables: by "
"putting them in a special file, or by defining a @dfn{project class} for "
"that directory."
msgstr ""
#. type: defvr
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2144
#, no-wrap
msgid "Constant dir-locals-file"
msgstr ""
#. type: defvr
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2164
msgid ""
"This constant is the name of the file where Emacs expects to find the "
"directory-local variables. The name of the file is "
"@file{.dir-locals.el}@footnote{ The MS-DOS version of Emacs uses "
"@file{_dir-locals.el} instead, due to limitations of the DOS filesystems. "
"}. A file by that name in a directory causes Emacs to apply its settings to "
"any file in that directory or any of its subdirectories (optionally, you can "
"exclude subdirectories; see below). If some of the subdirectories have "
"their own @file{.dir-locals.el} files, Emacs uses the settings from the "
"deepest file it finds starting from the file's directory and moving up the "
"directory tree. This constant is also used to derive the name of a second "
"dir-locals file @file{.dir-locals-2.el}. If this second dir-locals file is "
"present, then that is loaded in addition to @file{.dir-locals.el}. This is "
"useful when @file{.dir-locals.el} is under version control in a shared "
"repository and cannot be used for personal customizations. The file "
"specifies local variables as a specially formatted list; see @ref{Directory "
"Variables, , Per-directory Local Variables, emacs, The GNU Emacs Manual}, "
"for more details."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2166
#, no-wrap
msgid "hack-dir-local-variables"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2175
msgid ""
"This function reads the @code{.dir-locals.el} file and stores the "
"directory-local variables in @code{file-local-variables-alist} that is local "
"to the buffer visiting any file in the directory, without applying them. It "
"also stores the directory-local settings in @code{dir-locals-class-alist}, "
"where it defines a special class for the directory in which "
"@file{.dir-locals.el} file was found. This function works by calling "
"@code{dir-locals-set-class-variables} and "
"@code{dir-locals-set-directory-class}, described below."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2177
#, no-wrap
msgid "hack-dir-local-variables-non-file-buffer"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2184
msgid ""
"This function looks for directory-local variables, and immediately applies "
"them in the current buffer. It is intended to be called in the mode "
"commands for non-file buffers, such as Dired buffers, to let them obey "
"directory-local variable settings. For non-file buffers, Emacs looks for "
"directory-local variables in @code{default-directory} and its parent "
"directories."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2186
#, no-wrap
msgid "dir-locals-set-class-variables class variables"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2201
msgid ""
"This function defines a set of variable settings for the named @var{class}, "
"which is a symbol. You can later assign the class to one or more "
"directories, and Emacs will apply those variable settings to all files in "
"those directories. The list in @var{variables} can be of one of the two "
"forms: @code{(@var{major-mode} . @var{alist})} or @code{(@var{directory} "
". @var{list})}. With the first form, if the file's buffer turns on a mode "
"that is derived from @var{major-mode}, then all the variables in the "
"associated @var{alist} are applied; @var{alist} should be of the form "
"@code{(@var{name} . @var{value})}. A special value @code{nil} for "
"@var{major-mode} means the settings are applicable to any mode. In "
"@var{alist}, you can use a special @var{name}: @code{subdirs}. If the "
"associated value is @code{nil}, the alist is only applied to files in the "
"relevant directory, not to those in any subdirectories."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2206
msgid ""
"With the second form of @var{variables}, if @var{directory} is the initial "
"substring of the file's directory, then @var{list} is applied recursively by "
"following the above rules; @var{list} should be of one of the two forms "
"accepted by this function in @var{variables}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2208
#, no-wrap
msgid "dir-locals-set-directory-class directory class &optional mtime"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2214
msgid ""
"This function assigns @var{class} to all the files in @code{directory} and "
"its subdirectories. Thereafter, all the variable settings specified for "
"@var{class} will be applied to any visited file in @var{directory} and its "
"children. @var{class} must have been already defined by "
"@code{dir-locals-set-class-variables}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2221
msgid ""
"Emacs uses this function internally when it loads directory variables from a "
"@code{.dir-locals.el} file. In that case, the optional argument @var{mtime} "
"holds the file modification time (as returned by @code{file-attributes}). "
"Emacs uses this time to check stored local variables are still valid. If "
"you are assigning a class directly, not via a file, this argument should be "
"@code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2223
#, no-wrap
msgid "dir-locals-class-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2226
msgid ""
"This alist holds the class symbols and the associated variable settings. It "
"is updated by @code{dir-locals-set-class-variables}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2228
#, no-wrap
msgid "dir-locals-directory-cache"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2233
msgid ""
"This alist holds directory names, their assigned class names, and "
"modification times of the associated directory local variables file (if "
"there is one). The function @code{dir-locals-set-directory-class} updates "
"this list."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2235
#, no-wrap
msgid "enable-dir-local-variables"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2239
msgid ""
"If @code{nil}, directory-local variables are ignored. This variable may be "
"useful for modes that want to ignore directory-locals while still respecting "
"file-local variables (@pxref{File Local Variables})."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2243
#, no-wrap
msgid "connection local variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2248
msgid ""
"Connection-local variables provide a general mechanism for different "
"variable settings in buffers with a remote connection. They are bound and "
"set depending on the remote connection a buffer is dedicated to."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2249
#, no-wrap
msgid "connection-local-set-profile-variables profile variables"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2256
msgid ""
"This function defines a set of variable settings for the connection "
"@var{profile}, which is a symbol. You can later assign the connection "
"profile to one or more remote connections, and Emacs will apply those "
"variable settings to all process buffers for those connections. The list in "
"@var{variables} is an alist of the form "
"@code{(@var{name}@tie{}.@tie{}@var{value})}. Example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2265
#, no-wrap
msgid ""
"(connection-local-set-profile-variables\n"
" 'remote-bash\n"
" '((shell-file-name . \"/bin/bash\")\n"
" (shell-command-switch . \"-c\")\n"
" (shell-interactive-switch . \"-i\")\n"
" (shell-login-switch . \"-l\")))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2274
#, no-wrap
msgid ""
"(connection-local-set-profile-variables\n"
" 'remote-ksh\n"
" '((shell-file-name . \"/bin/ksh\")\n"
" (shell-command-switch . \"-c\")\n"
" (shell-interactive-switch . \"-i\")\n"
" (shell-login-switch . \"-l\")))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2280
#, no-wrap
msgid ""
"(connection-local-set-profile-variables\n"
" 'remote-null-device\n"
" '((null-device . \"/dev/null\")))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2284
#, no-wrap
msgid "connection-local-profile-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2288
msgid ""
"This alist holds the connection profile symbols and the associated variable "
"settings. It is updated by @code{connection-local-set-profile-variables}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2290
#, no-wrap
msgid "connection-local-set-profiles criteria &rest profiles"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2299
msgid ""
"This function assigns @var{profiles}, which are symbols, to all remote "
"connections identified by @var{criteria}. @var{criteria} is a plist "
"identifying a connection and the application using this connection. "
"Property names might be @code{:application}, @code{:protocol}, @code{:user} "
"and @code{:machine}. The property value of @code{:application} is a symbol, "
"all other property values are strings. All properties are optional; if "
"@var{criteria} is @code{nil}, it always applies. Example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2305
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" '(:application 'tramp :protocol \"ssh\" :machine \"localhost\")\n"
" 'remote-bash 'remote-null-device)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2312
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" '(:application 'tramp :protocol \"sudo\"\n"
" :user \"root\" :machine \"localhost\")\n"
" 'remote-ksh 'remote-null-device)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2317
msgid ""
"If @var{criteria} is @code{nil}, it applies for all remote connections. "
"Therefore, the example above would be equivalent to"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2323
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" '(:application 'tramp :protocol \"ssh\" :machine \"localhost\")\n"
" 'remote-bash)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2330
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" '(:application 'tramp :protocol \"sudo\"\n"
" :user \"root\" :machine \"localhost\")\n"
" 'remote-ksh)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2335
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" nil 'remote-null-device)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2340
msgid ""
"Any connection profile of @var{profiles} must have been already defined by "
"@code{connection-local-set-profile-variables}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2342
#, no-wrap
msgid "connection-local-criteria-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2346
msgid ""
"This alist contains connection criteria and their assigned profile names. "
"The function @code{connection-local-set-profiles} updates this list."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2348
#, no-wrap
msgid "hack-connection-local-variables criteria"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2353
msgid ""
"This function collects applicable connection-local variables associated with "
"@var{criteria} in @code{connection-local-variables-alist}, without applying "
"them. Example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2358
#, no-wrap
msgid ""
"(hack-connection-local-variables\n"
" '(:application 'tramp :protocol \"ssh\" :machine \"localhost\"))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2367
#, no-wrap
msgid ""
"connection-local-variables-alist\n"
" @result{} ((null-device . \"/dev/null\")\n"
" (shell-login-switch . \"-l\")\n"
" (shell-interactive-switch . \"-i\")\n"
" (shell-command-switch . \"-c\")\n"
" (shell-file-name . \"/bin/bash\"))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2371
#, no-wrap
msgid "hack-connection-local-variables-apply criteria"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2374
msgid ""
"This function looks for connection-local variables according to "
"@var{criteria}, and immediately applies them in the current buffer."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2376
#, no-wrap
msgid "with-connection-local-variables &rest body"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2379
msgid ""
"All connection-local variables, which are specified by "
"@code{default-directory}, are applied."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2382
msgid ""
"After that, @var{body} is executed, and the connection-local variables are "
"unwound. Example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2389
#, no-wrap
msgid ""
"(connection-local-set-profile-variables\n"
" 'remote-perl\n"
" '((perl-command-name . \"/usr/local/bin/perl\")\n"
" (perl-command-switch . \"-e %s\")))\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2395
#, no-wrap
msgid ""
"(connection-local-set-profiles\n"
" '(:application 'tramp :protocol \"ssh\" :machine \"remotehost\")\n"
" 'remote-perl)\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2401
#, no-wrap
msgid ""
"(let ((default-directory \"/ssh:remotehost:/working/dir/\"))\n"
" (with-connection-local-variables\n"
" do something useful))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2405
#, no-wrap
msgid "enable-connection-local-variables"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2408
msgid ""
"If @code{nil}, connection-local variables are ignored. This variable shall "
"be changed temporarily only in special modes."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2412
#, no-wrap
msgid "variable aliases"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2413
#, no-wrap
msgid "alias, for variables"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2422
msgid ""
"It is sometimes useful to make two variables synonyms, so that both "
"variables always have the same value, and changing either one also changes "
"the other. Whenever you change the name of a variable---either because you "
"realize its old name was not well chosen, or because its meaning has partly "
"changed---it can be useful to keep the old name as an @emph{alias} of the "
"new one for compatibility. You can do this with @code{defvaralias}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2423
#, no-wrap
msgid "defvaralias new-alias base-variable &optional docstring"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2430
msgid ""
"This function defines the symbol @var{new-alias} as a variable alias for "
"symbol @var{base-variable}. This means that retrieving the value of "
"@var{new-alias} returns the value of @var{base-variable}, and changing the "
"value of @var{new-alias} changes the value of @var{base-variable}. The two "
"aliased variable names always share the same value and the same bindings."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2436
msgid ""
"If the @var{docstring} argument is non-@code{nil}, it specifies the "
"documentation for @var{new-alias}; otherwise, the alias gets the same "
"documentation as @var{base-variable} has, if any, unless @var{base-variable} "
"is itself an alias, in which case @var{new-alias} gets the documentation of "
"the variable at the end of the chain of aliases."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2438
msgid "This function returns @var{base-variable}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2444
msgid ""
"Variable aliases are convenient for replacing an old name for a variable "
"with a new name. @code{make-obsolete-variable} declares that the old name "
"is obsolete and therefore that it may be removed at some stage in the "
"future."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2445
#, no-wrap
msgid "make-obsolete-variable obsolete-name current-name when &optional access-type"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2454
msgid ""
"This function makes the byte compiler warn that the variable "
"@var{obsolete-name} is obsolete. If @var{current-name} is a symbol, it is "
"the variable's new name; then the warning message says to use "
"@var{current-name} instead of @var{obsolete-name}. If @var{current-name} is "
"a string, this is the message and there is no replacement variable. "
"@var{when} should be a string indicating when the variable was first made "
"obsolete (usually a version number string)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2458
msgid ""
"The optional argument @var{access-type}, if non-@code{nil}, should specify "
"the kind of access that will trigger obsolescence warnings; it can be either "
"@code{get} or @code{set}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2462
msgid ""
"You can make two variables synonyms and declare one obsolete at the same "
"time using the macro @code{define-obsolete-variable-alias}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2463
#, no-wrap
msgid ""
"define-obsolete-variable-alias obsolete-name current-name &optional when "
"docstring"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2467
msgid ""
"This macro marks the variable @var{obsolete-name} as obsolete and also makes "
"it an alias for the variable @var{current-name}. It is equivalent to the "
"following:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2471
#, no-wrap
msgid ""
"(defvaralias @var{obsolete-name} @var{current-name} @var{docstring})\n"
"(make-obsolete-variable @var{obsolete-name} @var{current-name} @var{when})\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2476
msgid ""
"This macro evaluates all its parameters, and both @var{obsolete-name} and "
"@var{current-name} should be symbols, so a typical usage would look like:"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2479
#, no-wrap
msgid "(define-obsolete-variable-alias 'foo-thing 'bar-thing \"27.1\")\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2482
#, no-wrap
msgid "indirect-variable variable"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2486
msgid ""
"This function returns the variable at the end of the chain of aliases of "
"@var{variable}. If @var{variable} is not a symbol, or if @var{variable} is "
"not defined as an alias, the function returns @var{variable}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2489
msgid ""
"This function signals a @code{cyclic-variable-indirection} error if there is "
"a loop in the chain of symbols."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2500
#, no-wrap
msgid ""
"(defvaralias 'foo 'bar)\n"
"(indirect-variable 'foo)\n"
" @result{} bar\n"
"(indirect-variable 'bar)\n"
" @result{} bar\n"
"(setq bar 2)\n"
"bar\n"
" @result{} 2\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2503
#, no-wrap
msgid ""
"foo\n"
" @result{} 2\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2509
#, no-wrap
msgid ""
"(setq foo 0)\n"
"bar\n"
" @result{} 0\n"
"foo\n"
" @result{} 0\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2513
#, no-wrap
msgid "lisp variables defined in C, restrictions"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2524
msgid ""
"Ordinary Lisp variables can be assigned any value that is a valid Lisp "
"object. However, certain Lisp variables are not defined in Lisp, but in "
"C@. Most of these variables are defined in the C code using "
"@code{DEFVAR_LISP}. Like variables defined in Lisp, these can take on any "
"value. However, some variables are defined using @code{DEFVAR_INT} or "
"@code{DEFVAR_BOOL}. @xref{Defining Lisp variables in C,, Writing Emacs "
"Primitives}, in particular the description of functions of the type "
"@code{syms_of_@var{filename}}, for a brief discussion of the C "
"implementation."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2528
msgid ""
"Variables of type @code{DEFVAR_BOOL} can only take on the values @code{nil} "
"or @code{t}. Attempting to assign them any other value will set them to "
"@code{t}:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2533
#, no-wrap
msgid ""
"(let ((display-hourglass 5))\n"
" display-hourglass)\n"
" @result{} t\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2535
#, no-wrap
msgid "byte-boolean-vars"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2537
msgid "This variable holds a list of all variables of type @code{DEFVAR_BOOL}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2541
msgid ""
"Variables of type @code{DEFVAR_INT} can take on only integer values. "
"Attempting to assign them any other value will result in an error:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2545
#, no-wrap
msgid ""
"(setq undo-limit 1000.0)\n"
"@error{} Wrong type argument: integerp, 1000.0\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2550
#, no-wrap
msgid "generalized variable"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2551
#, no-wrap
msgid "place form"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2558
msgid ""
"A @dfn{generalized variable} or @dfn{place form} is one of the many places "
"in Lisp memory where values can be stored using the @code{setf} macro "
"(@pxref{Setting Generalized Variables}). The simplest place form is a "
"regular Lisp variable. But the @sc{car}s and @sc{cdr}s of lists, elements "
"of arrays, properties of symbols, and many other locations are also places "
"where Lisp values get stored."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2564
msgid ""
"Generalized variables are analogous to lvalues in the C language, where "
"@samp{x = a[i]} gets an element from an array and @samp{a[i] = x} stores an "
"element using the same notation. Just as certain forms like @code{a[i]} can "
"be lvalues in C, there is a set of forms that can be generalized variables "
"in Lisp."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2568
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2570
#, no-wrap
msgid "Setting Generalized Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2568
msgid "The @code{setf} macro."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2568
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2662
#, no-wrap
msgid "Adding Generalized Variables"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2568
msgid "Defining new @code{setf} forms."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2571
#, no-wrap
msgid "The @code{setf} Macro"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2580
msgid ""
"The @code{setf} macro is the most basic way to operate on generalized "
"variables. The @code{setf} form is like @code{setq}, except that it accepts "
"arbitrary place forms on the left side rather than just symbols. For "
"example, @code{(setf (car a) b)} sets the car of @code{a} to @code{b}, doing "
"the same operation as @code{(setcar a b)}, but without you having to use two "
"separate functions for setting and accessing this type of place."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2581
#, no-wrap
msgid "setf [place form]@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2587
msgid ""
"This macro evaluates @var{form} and stores it in @var{place}, which must be "
"a valid generalized variable form. If there are several @var{place} and "
"@var{form} pairs, the assignments are done sequentially just as with "
"@code{setq}. @code{setf} returns the value of the last @var{form}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2592
msgid ""
"The following Lisp forms are the forms in Emacs that will work as "
"generalized variables, and so may appear in the @var{place} argument of "
"@code{setf}:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2602
msgid ""
"A symbol. In other words, @code{(setf x y)} is exactly equivalent to "
"@code{(setq x y)}, and @code{setq} itself is strictly speaking redundant "
"given that @code{setf} exists. Most programmers will continue to prefer "
"@code{setq} for setting simple variables, though, for stylistic and "
"historical reasons. The macro @code{(setf x y)} actually expands to "
"@code{(setq x y)}, so there is no performance penalty for using it in "
"compiled code."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2605
msgid "A call to any of the following standard Lisp functions:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2613
#, no-wrap
msgid ""
"aref cddr symbol-function\n"
"car elt symbol-plist\n"
"caar get symbol-value\n"
"cadr gethash\n"
"cdr nth\n"
"cdar nthcdr\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2617
msgid "A call to any of the following Emacs-specific functions:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2629
#, no-wrap
msgid ""
"alist-get process-get\n"
"frame-parameter process-sentinel\n"
"terminal-parameter window-buffer\n"
"keymap-parent window-display-table\n"
"match-data window-dedicated-p\n"
"overlay-get window-hscroll\n"
"overlay-start window-parameter\n"
"overlay-end window-point\n"
"process-buffer window-start\n"
"process-filter default-value\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2635
msgid ""
"@code{setf} signals an error if you pass a @var{place} form that it does not "
"know how to handle."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2642
msgid ""
"Note that for @code{nthcdr}, the list argument of the function must itself "
"be a valid @var{place} form. For example, @code{(setf (nthcdr 0 foo) 7)} "
"will set @code{foo} itself to 7."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2656
msgid ""
"The macros @code{push} (@pxref{List Variables}) and @code{pop} (@pxref{List "
"Elements}) can manipulate generalized variables, not just lists. @code{(pop "
"@var{place})} removes and returns the first element of the list stored in "
"@var{place}. It is analogous to @code{(prog1 (car @var{place}) (setf "
"@var{place} (cdr @var{place})))}, except that it takes care to evaluate all "
"subforms only once. @code{(push @var{x} @var{place})} inserts @var{x} at "
"the front of the list stored in @var{place}. It is analogous to @code{(setf "
"@var{place} (cons @var{x} @var{place}))}, except for evaluation of the "
"subforms. Note that @code{push} and @code{pop} on an @code{nthcdr} place "
"can be used to insert or delete at any position in a list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2660
msgid ""
"The @file{cl-lib} library defines various extensions for generalized "
"variables, including additional @code{setf} places. @xref{Generalized "
"Variables,,, cl, Common Lisp Extensions}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2663
#, no-wrap
msgid "Defining new @code{setf} forms"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2667
msgid ""
"This section describes how to define new forms that @code{setf} can operate "
"on."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2668
#, no-wrap
msgid "gv-define-simple-setter name setter &optional fix-return"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2674
msgid ""
"This macro enables you to easily define @code{setf} methods for simple "
"cases. @var{name} is the name of a function, macro, or special form. You "
"can use this macro whenever @var{name} has a directly corresponding "
"@var{setter} function that updates it, e.g., @code{(gv-define-simple-setter "
"car setcar)}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2676
msgid "This macro translates a call of the form"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2679
#, no-wrap
msgid "(setf (@var{name} @var{args}@dots{}) @var{value})\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2682
msgid "into"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2684
#, no-wrap
msgid "(@var{setter} @var{args}@dots{} @var{value})\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2693
msgid ""
"Such a @code{setf} call is documented to return @var{value}. This is no "
"problem with, e.g., @code{car} and @code{setcar}, because @code{setcar} "
"returns the value that it set. If your @var{setter} function does not "
"return @var{value}, use a non-@code{nil} value for the @var{fix-return} "
"argument of @code{gv-define-simple-setter}. This expands into something "
"equivalent to"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2697
#, no-wrap
msgid ""
"(let ((temp @var{value}))\n"
" (@var{setter} @var{args}@dots{} temp)\n"
" temp)\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2699
msgid "so ensuring that it returns the correct result."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2702
#, no-wrap
msgid "gv-define-setter name arglist &rest body"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2707
msgid ""
"This macro allows for more complex @code{setf} expansions than the previous "
"form. You may need to use this form, for example, if there is no simple "
"setter function to call, or if there is one but it requires different "
"arguments to the place form."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2715
msgid ""
"This macro expands the form @code{(setf (@var{name} @var{args}@dots{}) "
"@var{value})} by first binding the @code{setf} argument forms "
"@code{(@var{value} @var{args}@dots{})} according to @var{arglist}, and then "
"executing @var{body}. @var{body} should return a Lisp form that does the "
"assignment, and finally returns the value that was set. An example of using "
"this macro is:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2718
#, no-wrap
msgid "(gv-define-setter caar (val x) `(setcar (car ,x) ,val))\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2721
#, no-wrap
msgid "gv-define-expander name handler"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2725
msgid ""
"For more control over the expansion, the @code{gv-define-expander} macro can "
"be used. For instance, a settable @code{substring} could be implemented "
"this way:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2738
#, no-wrap
msgid ""
"(gv-define-expander substring\n"
" (lambda (do place from &optional to)\n"
" (gv-letplace (getter setter) place\n"
" (macroexp-let2* nil ((start from) (end to))\n"
" (funcall do `(substring ,getter ,start ,end)\n"
" (lambda (v)\n"
" (macroexp-let2 nil v v\n"
" `(progn\n"
" ,(funcall setter `(cl--set-substring\n"
" ,getter ,start ,end ,v))\n"
" ,v))))))))\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2741
#, no-wrap
msgid "gv-letplace (getter setter) place &rest body"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2745
msgid ""
"The macro @code{gv-letplace} can be useful in defining macros that perform "
"similarly to @code{setf}; for example, the @code{incf} macro of Common Lisp "
"could be implemented this way:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2751
#, no-wrap
msgid ""
"(defmacro incf (place &optional n)\n"
" (gv-letplace (getter setter) place\n"
" (macroexp-let2 nil v (or n 1)\n"
" (funcall setter `(+ ,v ,getter)))))\n"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2758
msgid ""
"@var{getter} will be bound to a copyable expression that returns the value "
"of @var{place}. @var{setter} will be bound to a function that takes an "
"expression @var{v} and returns a new expression that sets @var{place} to "
"@var{v}. @var{body} should return a Emacs Lisp expression manipulating "
"@var{place} via @var{getter} and @var{setter}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2761
msgid "Consult the source file @file{gv.el} for more details."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2762
#, no-wrap
msgid "CL note---no @code{setf} functions"
msgstr ""
#. type: quotation
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/variables.texi:2773
msgid ""
"@b{Common Lisp note:} Common Lisp defines another way to specify the "
"@code{setf} behavior of a function, namely @code{setf} functions, whose "
"names are lists @code{(setf @var{name})} rather than symbols. For example, "
"@code{(defun (setf foo) @dots{})} defines the function that is used when "
"@code{setf} is applied to @code{foo}. Emacs does not support this. It is a "
"compile-time error to use @code{setf} on a form that has not already had an "
"appropriate expansion defined. In Common Lisp, this is not an error since "
"the function @code{(setf @var{func})} might be defined later."
msgstr ""