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

1829 lines
63 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/symbols.texi:6
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:7
#, no-wrap
msgid "Symbols"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:8
#, no-wrap
msgid "symbol"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:16
msgid ""
"A @dfn{symbol} is an object with a unique name. This chapter describes "
"symbols, their components, their property lists, and how they are created "
"and interned. Separate chapters describe the use of symbols as variables "
"and as function names; see @ref{Variables}, and @ref{Functions}. For the "
"precise read syntax for symbols, see @ref{Symbol Type}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:19
msgid ""
"You can test whether an arbitrary Lisp object is a symbol with "
"@code{symbolp}:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:20
#, no-wrap
msgid "symbolp object"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:23
msgid ""
"This function returns @code{t} if @var{object} is a symbol, @code{nil} "
"otherwise."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:37
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:38
#, no-wrap
msgid "Symbol Components"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
msgid "Symbols have names, values, function definitions and property lists."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:122
#, no-wrap
msgid "Definitions"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
msgid "A definition says how a symbol will be used."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:171
#, no-wrap
msgid "Creating Symbols"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
msgid "How symbols are kept unique."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:420
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:421
#, no-wrap
msgid "Symbol Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
msgid "Each symbol has a property list for recording miscellaneous information."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:638
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:639
#, no-wrap
msgid "Shorthands"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:34
msgid "Properly organize your symbol names but type less of them."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:39
#, no-wrap
msgid "symbol components"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:43
msgid ""
"Each symbol has four components (or ``cells''), each of which references "
"another object:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:45
#, no-wrap
msgid "Print name"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:46
#, no-wrap
msgid "print name cell"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:48
msgid "The symbol's name."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:49
#, no-wrap
msgid "Value"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:50
#, no-wrap
msgid "value cell"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:52
msgid "The symbol's current value as a variable."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:53
#, no-wrap
msgid "Function"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:54
#, no-wrap
msgid "function cell"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:57
msgid ""
"The symbol's function definition. It can also hold a symbol, a keymap, or a "
"keyboard macro."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:58
#, no-wrap
msgid "Property list"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:59
#, no-wrap
msgid "property list cell"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:61
msgid "The symbol's property list."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:66
msgid ""
"The print name cell always holds a string, and cannot be changed. Each of "
"the other three cells can be set to any Lisp object."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:77
msgid ""
"The print name cell holds the string that is the name of a symbol. Since "
"symbols are represented textually by their names, it is important not to "
"have two symbols with the same name. The Lisp reader ensures this: every "
"time it reads a symbol, it looks for an existing symbol with the specified "
"name before it creates a new one. To get a symbol's name, use the function "
"@code{symbol-name} (@pxref{Creating Symbols}). However, although each "
"symbol has only one unique @emph{print name}, it is nevertheless possible to "
"refer to that same symbol via different alias names called ``shorthands'' "
"(@pxref{Shorthands})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:87
msgid ""
"The value cell holds a symbol's value as a variable, which is what you get "
"if the symbol itself is evaluated as a Lisp expression. @xref{Variables}, "
"for details about how values are set and retrieved, including complications "
"such as @dfn{local bindings} and @dfn{scoping rules}. Most symbols can have "
"any Lisp object as a value, but certain special symbols have values that "
"cannot be changed; these include @code{nil} and @code{t}, and any symbol "
"whose name starts with @samp{:} (those are called @dfn{keywords}). "
"@xref{Constant Variables}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:98
msgid ""
"The function cell holds a symbol's function definition. Often, we refer to "
"``the function @code{foo}'' when we really mean the function stored in the "
"function cell of @code{foo}; we make the distinction explicit only when "
"necessary. Typically, the function cell is used to hold a function "
"(@pxref{Functions}) or a macro (@pxref{Macros}). However, it can also be "
"used to hold a symbol (@pxref{Function Indirection}), keyboard macro "
"(@pxref{Keyboard Macros}), keymap (@pxref{Keymaps}), or autoload object "
"(@pxref{Autoloading}). To get the contents of a symbol's function cell, use "
"the function @code{symbol-function} (@pxref{Function Cells})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:102
msgid ""
"The property list cell normally should hold a correctly formatted property "
"list. To get a symbol's property list, use the function "
"@code{symbol-plist}. @xref{Symbol Properties}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:108
msgid ""
"The function cell or the value cell may be @dfn{void}, which means that the "
"cell does not reference any object. (This is not the same thing as holding "
"the symbol @code{void}, nor the same as holding the symbol @code{nil}.) "
"Examining a function or value cell that is void results in an error, such as "
"@samp{Symbol's value as variable is void}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:114
msgid ""
"Because each symbol has separate value and function cells, variables names "
"and function names do not conflict. For example, the symbol "
"@code{buffer-file-name} has a value (the name of the file being visited in "
"the current buffer) as well as a function definition (a primitive function "
"that returns the name of the file):"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:120
#, no-wrap
msgid ""
"buffer-file-name\n"
" @result{} \"/gnu/elisp/symbols.texi\"\n"
"(symbol-function 'buffer-file-name)\n"
" @result{} #<subr buffer-file-name>\n"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:123
#, no-wrap
msgid "Defining Symbols"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:124
#, no-wrap
msgid "definitions of symbols"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:132
msgid ""
"A @dfn{definition} is a special kind of Lisp expression that announces your "
"intention to use a symbol in a particular way. It typically specifies a "
"value or meaning for the symbol for one kind of use, plus documentation for "
"its meaning when used in this way. Thus, when you define a symbol as a "
"variable, you can supply an initial value for the variable, plus "
"documentation for the variable."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:139
msgid ""
"@code{defvar} and @code{defconst} are special forms that define a symbol as "
"a @dfn{global variable}---a variable that can be accessed at any point in a "
"Lisp program. @xref{Variables}, for details about variables. To define a "
"customizable variable, use the @code{defcustom} macro, which also calls "
"@code{defvar} as a subroutine (@pxref{Customization})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:146
msgid ""
"In principle, you can assign a variable value to any symbol with "
"@code{setq}, whether or not it has first been defined as a variable. "
"However, you ought to write a variable definition for each global variable "
"that you want to use; otherwise, your Lisp program may not act correctly if "
"it is evaluated with lexical scoping enabled (@pxref{Variable Scoping})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:154
msgid ""
"@code{defun} defines a symbol as a function, creating a lambda expression "
"and storing it in the function cell of the symbol. This lambda expression "
"thus becomes the function definition of the symbol. (The term ``function "
"definition'', meaning the contents of the function cell, is derived from the "
"idea that @code{defun} gives the symbol its definition as a function.) "
"@code{defsubst} and @code{defalias} are two other ways of defining a "
"function. @xref{Functions}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:161
msgid ""
"@code{defmacro} defines a symbol as a macro. It creates a macro object and "
"stores it in the function cell of the symbol. Note that a given symbol can "
"be a macro or a function, but not both at once, because both macro and "
"function definitions are kept in the function cell, and that cell can hold "
"only one Lisp object at any given time. @xref{Macros}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:165
msgid ""
"As previously noted, Emacs Lisp allows the same symbol to be defined both as "
"a variable (e.g., with @code{defvar}) and as a function or macro (e.g., with "
"@code{defun}). Such definitions do not conflict."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:170
msgid ""
"These definitions also act as guides for programming tools. For example, "
"the @kbd{C-h f} and @kbd{C-h v} commands create help buffers containing "
"links to the relevant variable, function, or macro definitions. @xref{Name "
"Help,,, emacs, The GNU Emacs Manual}."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:172
#, no-wrap
msgid "Creating and Interning Symbols"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:173
#, no-wrap
msgid "reading symbols"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:179
msgid ""
"To understand how symbols are created in GNU Emacs Lisp, you must know how "
"Lisp reads them. Lisp must ensure that it finds the same symbol every time "
"it reads the same sequence of characters in the same context. Failure to do "
"so would cause complete confusion."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:180
#, no-wrap
msgid "symbol name hashing"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:181
#, no-wrap
msgid "hashing"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:182
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:378
#, no-wrap
msgid "obarray"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:183
#, no-wrap
msgid "bucket (in obarray)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:198
msgid ""
"When the Lisp reader encounters a name that references a symbol in the "
"source code, it reads all the characters of that name. Then it looks up "
"that name in a table called an @dfn{obarray} to find the symbol that the "
"programmer meant. The technique used in this lookup is called ``hashing'', "
"an efficient method of looking something up by converting a sequence of "
"characters to a number, known as a ``hash code''. For example, instead of "
"searching a telephone book cover to cover when looking up Jan Jones, you "
"start with the J's and go from there. That is a simple version of hashing. "
"Each element of the obarray is a @dfn{bucket} which holds all the symbols "
"with a given hash code; to look for a given name, it is sufficient to look "
"through all the symbols in the bucket for that name's hash code. (The same "
"idea is used for general Emacs hash tables, but they are a different data "
"type; see @ref{Hash Tables}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:208
msgid ""
"When looking up names, the Lisp reader also considers ``shorthands''. If "
"the programmer supplied them, this allows the reader to find a symbol even "
"if its name isn't present in its full form in the source code. Of course, "
"the reader needs to be aware of some pre-established context about such "
"shorthands, much as one needs context to be to able to refer uniquely to Jan "
"Jones by just the name ``Jan'': it's probably fine when amongst the Joneses, "
"or when Jan has been mentioned recently, but very ambiguous in any other "
"situation. @xref{Shorthands}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:209
#, no-wrap
msgid "interning"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:215
msgid ""
"If a symbol with the desired name is found, the reader uses that symbol. If "
"the obarray does not contain a symbol with that name, the reader makes a new "
"symbol and adds it to the obarray. Finding or adding a symbol with a "
"certain name is called @dfn{interning} it, and the symbol is then called an "
"@dfn{interned symbol}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:220
msgid ""
"Interning ensures that each obarray has just one symbol with any particular "
"name. Other like-named symbols may exist, but not in the same obarray. "
"Thus, the reader gets the same symbols for the same names, as long as you "
"keep reading with the same obarray."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:229
msgid ""
"Interning usually happens automatically in the reader, but sometimes other "
"programs may want to do it. For example, after the @kbd{M-x} command "
"obtains the command name as a string using the minibuffer, it then interns "
"the string, to get the interned symbol with that name. As another example, "
"a hypothetical telephone book program could intern the name of each looked "
"up person's name as a symbol, even if the obarray did not contain it, so "
"that it could attach information to that new symbol, such as the last time "
"someone looked it up."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:230
#, no-wrap
msgid "symbol equality"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:231
#, no-wrap
msgid "uninterned symbol"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:238
msgid ""
"No obarray contains all symbols; in fact, some symbols are not in any "
"obarray. They are called @dfn{uninterned symbols}. An uninterned symbol "
"has the same four cells as other symbols; however, the only way to gain "
"access to it is by finding it in some other object or as the value of a "
"variable. Uninterned symbols are sometimes useful in generating Lisp code, "
"see below."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:246
msgid ""
"In Emacs Lisp, an obarray is actually a vector. Each element of the vector "
"is a bucket; its value is either an interned symbol whose name hashes to "
"that bucket, or 0 if the bucket is empty. Each interned symbol has an "
"internal link (invisible to the user) to the next symbol in the bucket. "
"Because these links are invisible, there is no way to find all the symbols "
"in an obarray except using @code{mapatoms} (below). The order of symbols in "
"a bucket is not significant."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:252
msgid ""
"In an empty obarray, every element is 0, so you can create an obarray with "
"@code{(make-vector @var{length} 0)}. @strong{This is the only valid way to "
"create an obarray.} Prime numbers as lengths tend to result in good hashing; "
"lengths one less than a power of two are also good."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:255
msgid ""
"@strong{Do not try to put symbols in an obarray yourself.} This does not "
"work---only @code{intern} can enter a symbol in an obarray properly."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:256
#, no-wrap
msgid "CL note---symbol in obarrays"
msgstr ""
#. type: quotation
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:263
msgid ""
"@b{Common Lisp note:} Unlike Common Lisp, Emacs Lisp does not provide for "
"interning the same name in several different ``packages'', thus creating "
"multiple symbols with the same name but different packages. Emacs Lisp "
"provides a different namespacing system called ``shorthands'' "
"(@pxref{Shorthands})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:268
msgid ""
"Most of the functions below take a name and sometimes an obarray as "
"arguments. A @code{wrong-type-argument} error is signaled if the name is "
"not a string, or if the obarray is not a vector."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:269
#, no-wrap
msgid "symbol-name symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:271
msgid "This function returns the string that is @var{symbol}'s name. For example:"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:276
#, no-wrap
msgid ""
"(symbol-name 'foo)\n"
" @result{} \"foo\"\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:282
msgid ""
"@strong{Warning:} Changing the string by substituting characters does change "
"the name of the symbol, but fails to update the obarray, so don't do it!"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:284
#, no-wrap
msgid "uninterned symbol, and generating Lisp code"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:288
msgid ""
"Creating an uninterned symbol is useful in generating Lisp code, because an "
"uninterned symbol used as a variable in the code you generate cannot clash "
"with any variables used in other Lisp programs."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:289
#, no-wrap
msgid "make-symbol name"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:295
msgid ""
"This function returns a newly-allocated, uninterned symbol whose name is "
"@var{name} (which must be a string). Its value and function definition are "
"void, and its property list is @code{nil}. In the example below, the value "
"of @code{sym} is not @code{eq} to @code{foo} because it is a distinct "
"uninterned symbol whose name is also @samp{foo}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:301
#, no-wrap
msgid ""
"(setq sym (make-symbol \"foo\"))\n"
" @result{} foo\n"
"(eq sym 'foo)\n"
" @result{} nil\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:304
#, no-wrap
msgid "gensym &optional prefix"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:310
msgid ""
"This function returns a symbol using @code{make-symbol}, whose name is made "
"by appending @code{gensym-counter} to @var{prefix} and incrementing that "
"counter, guaranteeing that no two calls to this function will generate a "
"symbol with the same name. The prefix defaults to @code{\"g\"}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:315
msgid ""
"To avoid problems when accidentally interning printed representation of "
"generated code (@pxref{Printed Representation}), it is recommended to use "
"@code{gensym} instead of @code{make-symbol}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:316
#, no-wrap
msgid "intern name &optional obarray"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:322
msgid ""
"This function returns the interned symbol whose name is @var{name}. If "
"there is no such symbol in the obarray @var{obarray}, @code{intern} creates "
"a new one, adds it to the obarray, and returns it. If @var{obarray} is "
"omitted, the value of the global variable @code{obarray} is used."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:328
#, no-wrap
msgid ""
"(setq sym (intern \"foo\"))\n"
" @result{} foo\n"
"(eq sym 'foo)\n"
" @result{} t\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:333
#, no-wrap
msgid ""
"(setq sym1 (intern \"foo\" other-obarray))\n"
" @result{} foo\n"
"(eq sym1 'foo)\n"
" @result{} nil\n"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:336
#, no-wrap
msgid "CL note---interning existing symbol"
msgstr ""
#. type: quotation
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:341
msgid ""
"@b{Common Lisp note:} In Common Lisp, you can intern an existing symbol in "
"an obarray. In Emacs Lisp, you cannot do this, because the argument to "
"@code{intern} must be a string, not a symbol."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:343
#, no-wrap
msgid "intern-soft name &optional obarray"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:349
msgid ""
"This function returns the symbol in @var{obarray} whose name is @var{name}, "
"or @code{nil} if @var{obarray} has no symbol with that name. Therefore, you "
"can use @code{intern-soft} to test whether a symbol with a given name is "
"already interned. If @var{obarray} is omitted, the value of the global "
"variable @code{obarray} is used."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:353
msgid ""
"The argument @var{name} may also be a symbol; in that case, the function "
"returns @var{name} if @var{name} is interned in the specified obarray, and "
"otherwise @code{nil}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:359
#, no-wrap
msgid ""
"(intern-soft \"frazzle\") ; @r{No such symbol exists.}\n"
" @result{} nil\n"
"(make-symbol \"frazzle\") ; @r{Create an uninterned one.}\n"
" @result{} frazzle\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:362
#, no-wrap
msgid ""
"(intern-soft \"frazzle\") ; @r{That one cannot be found.}\n"
" @result{} nil\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:366
#, no-wrap
msgid ""
"(setq sym (intern \"frazzle\")) ; @r{Create an interned one.}\n"
" @result{} frazzle\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:370
#, no-wrap
msgid ""
"(intern-soft \"frazzle\") ; @r{That one can be found!}\n"
" @result{} frazzle\n"
msgstr ""
#. type: group
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:374
#, no-wrap
msgid ""
"(eq sym 'frazzle) ; @r{And it is the same one.}\n"
" @result{} t\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:381
msgid ""
"This variable is the standard obarray for use by @code{intern} and "
"@code{read}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:383
#, no-wrap
msgid "mapatoms function &optional obarray"
msgstr ""
#. type: anchor{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:389
msgid "Definition of mapatoms"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:389
msgid ""
"This function calls @var{function} once with each symbol in the obarray "
"@var{obarray}. Then it returns @code{nil}. If @var{obarray} is omitted, it "
"defaults to the value of @code{obarray}, the standard obarray for ordinary "
"symbols."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:400
#, no-wrap
msgid ""
"(setq count 0)\n"
" @result{} 0\n"
"(defun count-syms (s)\n"
" (setq count (1+ count)))\n"
" @result{} count-syms\n"
"(mapatoms 'count-syms)\n"
" @result{} nil\n"
"count\n"
" @result{} 1871\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:404
msgid ""
"See @code{documentation} in @ref{Accessing Documentation}, for another "
"example using @code{mapatoms}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:406
#, no-wrap
msgid "unintern symbol obarray"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:410
msgid ""
"This function deletes @var{symbol} from the obarray @var{obarray}. If "
"@code{symbol} is not actually in the obarray, @code{unintern} does nothing. "
"If @var{obarray} is @code{nil}, the current obarray is used."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:415
msgid ""
"If you provide a string instead of a symbol as @var{symbol}, it stands for a "
"symbol name. Then @code{unintern} deletes the symbol (if any) in the "
"obarray which has that name. If there is no such symbol, @code{unintern} "
"does nothing."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:418
msgid ""
"If @code{unintern} does delete a symbol, it returns @code{t}. Otherwise it "
"returns @code{nil}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:422
#, no-wrap
msgid "symbol property"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:429
msgid ""
"A symbol may possess any number of @dfn{symbol properties}, which can be "
"used to record miscellaneous information about the symbol. For example, "
"when a symbol has a @code{risky-local-variable} property with a "
"non-@code{nil} value, that means the variable which the symbol names is a "
"risky file-local variable (@pxref{File Local Variables})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:433
msgid ""
"Each symbol's properties and property values are stored in the symbol's "
"property list cell (@pxref{Symbol Components}), in the form of a property "
"list (@pxref{Property Lists})."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:437
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:439
#, no-wrap
msgid "Symbol Plists"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:437
msgid "Accessing symbol properties."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:437
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:523
#, no-wrap
msgid "Standard Properties"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:437
msgid "Standard meanings of symbol properties."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:440
#, no-wrap
msgid "Accessing Symbol Properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:443
msgid "The following functions can be used to access symbol properties."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:444
#, no-wrap
msgid "get symbol property"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:449
msgid ""
"This function returns the value of the property named @var{property} in "
"@var{symbol}'s property list. If there is no such property, it returns "
"@code{nil}. Thus, there is no distinction between a value of @code{nil} and "
"the absence of the property."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:452
msgid ""
"The name @var{property} is compared with the existing property names using "
"@code{eq}, so any object is a legitimate property."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:454
msgid "See @code{put} for an example."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:456
#, no-wrap
msgid "put symbol property value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:460
msgid ""
"This function puts @var{value} onto @var{symbol}'s property list under the "
"property name @var{property}, replacing any previous property value. The "
"@code{put} function returns @var{value}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:470
#, no-wrap
msgid ""
"(put 'fly 'verb 'transitive)\n"
" @result{}'transitive\n"
"(put 'fly 'noun '(a buzzing little bug))\n"
" @result{} (a buzzing little bug)\n"
"(get 'fly 'verb)\n"
" @result{} transitive\n"
"(symbol-plist 'fly)\n"
" @result{} (verb transitive noun (a buzzing little bug))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:473
#, no-wrap
msgid "symbol-plist symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:475
msgid "This function returns the property list of @var{symbol}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:477
#, no-wrap
msgid "setplist symbol plist"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:481
msgid ""
"This function sets @var{symbol}'s property list to @var{plist}. Normally, "
"@var{plist} should be a well-formed property list, but this is not "
"enforced. The return value is @var{plist}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:487
#, no-wrap
msgid ""
"(setplist 'foo '(a 1 b (2 3) c nil))\n"
" @result{} (a 1 b (2 3) c nil)\n"
"(symbol-plist 'foo)\n"
" @result{} (a 1 b (2 3) c nil)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:493
msgid ""
"For symbols in special obarrays, which are not used for ordinary purposes, "
"it may make sense to use the property list cell in a nonstandard fashion; in "
"fact, the abbrev mechanism does so (@pxref{Abbrevs})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:496
msgid ""
"You could define @code{put} in terms of @code{setplist} and "
"@code{plist-put}, as follows:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:501
#, no-wrap
msgid ""
"(defun put (symbol prop value)\n"
" (setplist symbol\n"
" (plist-put (symbol-plist symbol) prop value)))\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:504
#, no-wrap
msgid "function-get symbol property &optional autoload"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:513
msgid ""
"This function is identical to @code{get}, except that if @var{symbol} is the "
"name of a function alias, it looks in the property list of the symbol naming "
"the actual function. @xref{Defining Functions}. If the optional argument "
"@var{autoload} is non-@code{nil}, and @var{symbol} is auto-loaded, this "
"function will try to autoload it, since autoloading might set @var{property} "
"of @var{symbol}. If @var{autoload} is the symbol @code{macro}, only try "
"autoloading if @var{symbol} is an auto-loaded macro."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:515
#, no-wrap
msgid "function-put function property value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:521
msgid ""
"This function sets @var{property} of @var{function} to @var{value}. "
"@var{function} should be a symbol. This function is preferred to calling "
"@code{put} for setting properties of a function, because it will allow us "
"some day to implement remapping of old properties to new ones."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:524
#, no-wrap
msgid "Standard Symbol Properties"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:530
msgid ""
"Here, we list the symbol properties which are used for special purposes in "
"Emacs. In the following table, whenever we say ``the named function'', that "
"means the function whose name is the relevant symbol; similarly for ``the "
"named variable'' etc."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:532
#, no-wrap
msgid ":advertised-binding"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:535
msgid ""
"This property value specifies the preferred key binding, when showing "
"documentation, for the named function. @xref{Keys in Documentation}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:536
#, no-wrap
msgid "char-table-extra-slots"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:539
msgid ""
"The value, if non-@code{nil}, specifies the number of extra slots in the "
"named char-table type. @xref{Char-Tables}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:540
#, no-wrap
msgid "customized-face"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:541
#, no-wrap
msgid "face-defface-spec"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:542
#, no-wrap
msgid "saved-face"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:543
#, no-wrap
msgid "theme-face"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:548
msgid ""
"These properties are used to record a face's standard, saved, customized, "
"and themed face specs. Do not set them directly; they are managed by "
"@code{defface} and related functions. @xref{Defining Faces}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:549
#, no-wrap
msgid "customized-value"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:550
#, no-wrap
msgid "saved-value"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:551
#, no-wrap
msgid "standard-value"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:552
#, no-wrap
msgid "theme-value"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:557
msgid ""
"These properties are used to record a customizable variable's standard "
"value, saved value, customized-but-unsaved value, and themed values. Do not "
"set them directly; they are managed by @code{defcustom} and related "
"functions. @xref{Variable Definitions}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:558
#, no-wrap
msgid "disabled"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:561
msgid ""
"If the value is non-@code{nil}, the named function is disabled as a "
"command. @xref{Disabling Commands}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:562
#, no-wrap
msgid "face-documentation"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:565
msgid ""
"The value stores the documentation string of the named face. This is set "
"automatically by @code{defface}. @xref{Defining Faces}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:566
#, no-wrap
msgid "history-length"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:570
msgid ""
"The value, if non-@code{nil}, specifies the maximum minibuffer history "
"length for the named history list variable. @xref{Minibuffer History}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:571
#, no-wrap
msgid "interactive-form"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:575
msgid ""
"The value is an interactive form for the named function. Normally, you "
"should not set this directly; use the @code{interactive} special form "
"instead. @xref{Interactive Call}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:576
#, no-wrap
msgid "menu-enable"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:579
msgid ""
"The value is an expression for determining whether the named menu item "
"should be enabled in menus. @xref{Simple Menu Items}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:580
#, no-wrap
msgid "mode-class"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:583
msgid ""
"If the value is @code{special}, the named major mode is special. "
"@xref{Major Mode Conventions}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:584
#, no-wrap
msgid "permanent-local"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:588
msgid ""
"If the value is non-@code{nil}, the named variable is a buffer-local "
"variable whose value should not be reset when changing major modes. "
"@xref{Creating Buffer-Local}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:589
#, no-wrap
msgid "permanent-local-hook"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:593
msgid ""
"If the value is non-@code{nil}, the named function should not be deleted "
"from the local value of a hook variable when changing major modes. "
"@xref{Setting Hooks}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:594
#, no-wrap
msgid "pure"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:595
#, no-wrap
msgid "@code{pure} property"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:601
msgid ""
"If the value is non-@code{nil}, the named function is considered to be pure "
"(@pxref{What Is a Function}). Calls with constant arguments can be "
"evaluated at compile time. This may shift run time errors to compile time. "
"Not to be confused with pure storage (@pxref{Pure Storage})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:602
#, no-wrap
msgid "risky-local-variable"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:605
msgid ""
"If the value is non-@code{nil}, the named variable is considered risky as a "
"file-local variable. @xref{File Local Variables}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:606
#, no-wrap
msgid "safe-function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:609
msgid ""
"If the value is non-@code{nil}, the named function is considered generally "
"safe for evaluation. @xref{Function Safety}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:610
#, no-wrap
msgid "safe-local-eval-function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:613
msgid ""
"If the value is non-@code{nil}, the named function is safe to call in "
"file-local evaluation forms. @xref{File Local Variables}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:614
#, no-wrap
msgid "safe-local-variable"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:617
msgid ""
"The value specifies a function for determining safe file-local values for "
"the named variable. @xref{File Local Variables}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:618
#, no-wrap
msgid "side-effect-free"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:619
#, no-wrap
msgid "@code{side-effect-free} property"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:626
msgid ""
"A non-@code{nil} value indicates that the named function is free of side "
"effects (@pxref{What Is a Function}), so the byte compiler may ignore a call "
"whose value is unused. If the property's value is @code{error-free}, the "
"byte compiler may even delete such unused calls. In addition to byte "
"compiler optimizations, this property is also used for determining function "
"safety (@pxref{Function Safety})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:627
#, no-wrap
msgid "undo-inhibit-region"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:631
msgid ""
"If non-@code{nil}, the named function prevents the @code{undo} operation "
"from being restricted to the active region, if @code{undo} is invoked "
"immediately after the function. @xref{Undo}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:632
#, no-wrap
msgid "variable-documentation"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:636
msgid ""
"If non-@code{nil}, this specifies the named variable's documentation "
"string. This is set automatically by @code{defvar} and related functions. "
"@xref{Defining Faces}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:640
#, no-wrap
msgid "shorthands"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:641
#, no-wrap
msgid "symbolic shorthands"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:642
#, no-wrap
msgid "namespacing"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:643
#, no-wrap
msgid "namespaces"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:650
msgid ""
"The symbol @dfn{shorthands}, sometimes known as ``renamed symbols'', are "
"symbolic forms found in Lisp source. They're just like regular symbolic "
"forms, except that when the Lisp reader encounters them, it produces symbols "
"which have a different and usually longer @dfn{print name} (@pxref{Symbol "
"Components})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:654
msgid ""
"It is useful to think of shorthands as @emph{abbreviating} the full names of "
"intended symbols. Despite this, do not confuse shorthands with the Abbrev "
"system @pxref{Abbrevs}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:655
#, no-wrap
msgid "namespace etiquette"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:668
msgid ""
"Shorthands make Emacs Lisp's @dfn{namespacing etiquette} easier to work "
"with. Since all symbols are stored in a single obarray (@pxref{Creating "
"Symbols}), programmers commonly prefix each symbol name with the name of the "
"library where it originates. For example, the functions "
"@code{text-property-search-forward} and @code{text-property-search-backward} "
"both belong to the @file{text-property-search.el} library "
"(@pxref{Loading}). By properly prefixing symbol names, one effectively "
"prevents clashes between similarly named symbols which belong to different "
"libraries and thus do different things. However, this practice commonly "
"originates very long symbols names, which are inconvenient to type and read "
"after a while. Shorthands solve these issues in a clean way."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:669
#, no-wrap
msgid "read-symbol-shorthands"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:675
msgid ""
"This variable's value is an alist whose elements have the form "
"@code{(@var{shorthand-prefix} . @var{longhand-prefix})}. Each element "
"instructs the Lisp reader to read every symbol form which starts with "
"@var{shorthand-prefix} as if it started with @var{longhand-prefix} instead."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:678
msgid ""
"This variable may only be set in file-local variables (@pxref{File "
"Variables, , Local Variables in Files, emacs, The GNU Emacs Manual})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:682
msgid ""
"Here's an example of shorthands usage in a hypothetical string manipulating "
"library @file{some-nice-string-utils.el}."
msgstr ""
#. type: smalllisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:687
#, no-wrap
msgid ""
"(defun some-nice-string-utils-split (separator s &optional omit-nulls)\n"
" \"A match-data saving variant of `split-string'.\"\n"
" (save-match-data (split-string s separator omit-nulls)))\n"
"\n"
msgstr ""
#. type: smalllisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:691
#, no-wrap
msgid ""
"(defun some-nice-string-utils-lines (s)\n"
" \"Split string S at newline characters into a list of strings.\"\n"
" (some-nice-string-utils-split \"\\\\(\\r\\n\\\\|[\\n\\r]\\\\)\" s))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:696
msgid ""
"As can be seen, it's quite tedious to read or develop this code since the "
"symbol names to type are so long. We can use shorthands to alleviate that."
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:701
#, no-wrap
msgid ""
"(defun snu-split (separator s &optional omit-nulls)\n"
" \"A match-data saving variation on `split-string'.\"\n"
" (save-match-data (split-string s separator omit-nulls)))\n"
"\n"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:705
#, no-wrap
msgid ""
"(defun snu-lines (s)\n"
" \"Split string S into a list of strings on newline characters.\"\n"
" (snu-split \"\\\\(\\r\\n\\\\|[\\n\\r]\\\\)\" s))\n"
"\n"
msgstr ""
#. type: lisp
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:709
#, no-wrap
msgid ""
";; Local Variables:\n"
";; read-symbol-shorthands: ((\"snu-\" . \"some-nice-string-utils-\"))\n"
";; End:\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:721
msgid ""
"Even though the two excerpts look different, they are quite identical after "
"the Lisp reader processes them. Both will lead to the very same symbols "
"being interned (@pxref{Creating Symbols}). Thus loading or byte-compiling "
"any of the two files has equivalent results. The shorthands "
"@code{snu-split} and @code{snu-lines} used in the second version are "
"@emph{not} interned in the obarray. This is easily seen by moving point to "
"the location where the shorthands are used and waiting for ElDoc "
"(@pxref{Lisp Doc, , Local Variables in Files, emacs, The GNU Emacs Manual}) "
"to hint at the true full name of the symbol under point in the echo area."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:729
msgid ""
"Since @code{read-symbol-shorthands} is a file-local variable, it is possible "
"that multiple libraries depending on @file{some-nice-string-utils-lines.el} "
"refer to the same symbols under @emph{different} shorthands, or not using "
"shorthands at all. In the next example, the @file{my-tricks.el} library "
"refers to the symbol @code{some-nice-string-utils-lines} using the "
"@code{sns-} prefix instead of @code{snu-}."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:732
#, no-wrap
msgid ""
"(defun t-reverse-lines (s) (string-join (reverse (sns-lines s)) \"\\n\")\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:737
#, no-wrap
msgid ""
";; Local Variables:\n"
";; read-symbol-shorthands: ((\"t-\" . \"my-tricks-\")\n"
";; (\"sns-\" . \"some-nice-string-utils-\"))\n"
";; End:\n"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:739
#, no-wrap
msgid "Exceptions"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:742
msgid "There are two exceptions to rules governing Shorthand transformations:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:750
msgid ""
"Symbol forms comprised entirely of characters in the Emacs Lisp symbol "
"constituent class (@pxref{Syntax Class Table}) are not transformed. For "
"example, it's possible to use @code{-} or @code{/=} as shorthand prefixes, "
"but that won't shadow the arithmetic @emph{functions} of those names."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/symbols.texi:753
msgid "Symbol forms whose names start with @samp{#_} are not transformed."
msgstr ""