documentation_emacs_test/source/lispref/customize.texi.fr.po

3855 lines
133 KiB
Plaintext
Raw Normal View History

2022-03-08 11:11:57 +01:00
# 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: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:5
#, no-wrap
msgid "Customization"
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:6
#, no-wrap
msgid "Customization Settings"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:8
#, no-wrap
msgid "customization item"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:14
msgid ""
"Users of Emacs can customize variables and faces without writing Lisp code, "
"by using the Customize interface. @xref{Easy Customization,,, emacs, The "
"GNU Emacs Manual}. This chapter describes how to define @dfn{customization "
"items} that users can interact with through the Customize interface."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:17
msgid ""
"Customization items include customizable variables, which are defined with "
"the"
msgstr ""
#. type: ifinfo
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:19
msgid "@code{defcustom} macro (@pxref{Variable Definitions});"
msgstr ""
#. type: ifnotinfo
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:22
msgid "@code{defcustom} macro;"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:26
msgid ""
"customizable faces, which are defined with @code{defface} (described "
"separately in @ref{Defining Faces}); and @dfn{customization groups}, defined "
"with"
msgstr ""
#. type: ifinfo
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:28
msgid "@code{defgroup} (@pxref{Group Definitions}),"
msgstr ""
#. type: ifnotinfo
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:31
msgid "@code{defgroup},"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:33
msgid "which act as containers for groups of related customization items."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:44
#, no-wrap
msgid "Common Keywords"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Common keyword arguments for all kinds of customization declarations."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:212
#, no-wrap
msgid "Group Definitions"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Writing customization group definitions."
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:284
#, no-wrap
msgid "Variable Definitions"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Declaring user options."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:535
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:536
#, no-wrap
msgid "Customization Types"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Specifying the type of a user option."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1349
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1350
#, no-wrap
msgid "Applying Customizations"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Functions to apply customization settings."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1406
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1407
#, no-wrap
msgid "Custom Themes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:42
msgid "Writing Custom themes."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:45
#, no-wrap
msgid "Common Item Keywords"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:47
#, no-wrap
msgid "customization keywords"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:53
msgid ""
"The customization declarations that we will describe in the next few "
"sections---@code{defcustom}, @code{defgroup}, etc.---all accept keyword "
"arguments (@pxref{Constant Variables}) for specifying various information. "
"This section describes keywords that apply to all types of customization "
"declarations."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:58
msgid ""
"All of these keywords, except @code{:tag}, can be used more than once in a "
"given item. Each use of the keyword has an independent effect. The keyword "
"@code{:tag} is an exception because any given item can only display one "
"name."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:60
#, no-wrap
msgid ":tag @var{label}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:61
#, no-wrap
msgid "tag@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:66
msgid ""
"Use @var{label}, a string, instead of the item's name, to label the item in "
"customization menus and buffers. @strong{Don't use a tag which is "
"substantially different from the item's real name; that would cause "
"confusion.}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:67
#, no-wrap
msgid "group@r{, customization keyword}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:68
#, no-wrap
msgid ":group @var{group}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:72
msgid ""
"Put this customization item in group @var{group}. If this keyword is "
"missing from a customization item, it'll be placed in the same group that "
"was last defined (in the current file)."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:75
msgid ""
"When you use @code{:group} in a @code{defgroup}, it makes the new group a "
"subgroup of @var{group}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:79
msgid ""
"If you use this keyword more than once, you can put a single item into more "
"than one group. Displaying any of those groups will show this item. Please "
"don't overdo this, since the result would be annoying."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:80
#, no-wrap
msgid ":link @var{link-data}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:81
#, no-wrap
msgid "link@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:85
msgid ""
"Include an external link after the documentation string for this item. This "
"is a sentence containing a button that references some other documentation."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:87
msgid "There are several alternatives you can use for @var{link-data}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:89
#, no-wrap
msgid "(custom-manual @var{info-node})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:94
msgid ""
"Link to an Info node; @var{info-node} is a string which specifies the node "
"name, as in @code{\"(emacs)Top\"}. The link appears as @samp{[Manual]} in "
"the customization buffer and enters the built-in Info reader on "
"@var{info-node}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:95
#, no-wrap
msgid "(info-link @var{info-node})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:98
msgid ""
"Like @code{custom-manual} except that the link appears in the customization "
"buffer with the Info node name."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:99
#, no-wrap
msgid "(url-link @var{url})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:104
msgid ""
"Link to a web page; @var{url} is a string which specifies the "
"@acronym{URL}. The link appears in the customization buffer as @var{url} "
"and invokes the WWW browser specified by @code{browse-url-browser-function}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:105
#, no-wrap
msgid "(emacs-commentary-link @var{library})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:108
msgid ""
"Link to the commentary section of a library; @var{library} is a string which "
"specifies the library name. @xref{Library Headers}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:109
#, no-wrap
msgid "(emacs-library-link @var{library})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:112
msgid ""
"Link to an Emacs Lisp library file; @var{library} is a string which "
"specifies the library name."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:113
#, no-wrap
msgid "(file-link @var{file})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:116
msgid ""
"Link to a file; @var{file} is a string which specifies the name of the file "
"to visit with @code{find-file} when the user invokes this link."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:117
#, no-wrap
msgid "(function-link @var{function})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:121
msgid ""
"Link to the documentation of a function; @var{function} is a string which "
"specifies the name of the function to describe with @code{describe-function} "
"when the user invokes this link."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:122
#, no-wrap
msgid "(variable-link @var{variable})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:126
msgid ""
"Link to the documentation of a variable; @var{variable} is a string which "
"specifies the name of the variable to describe with @code{describe-variable} "
"when the user invokes this link."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:127
#, no-wrap
msgid "(face-link @var{face})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:131
msgid ""
"Link to the documentation of a face; @var{face} is a string which specifies "
"the name of the face to describe with @code{describe-face} when the user "
"invokes this link."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:132
#, no-wrap
msgid "(custom-group-link @var{group})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:135
msgid ""
"Link to another customization group. Invoking it creates a new "
"customization buffer for @var{group}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:141
msgid ""
"You can specify the text to use in the customization buffer by adding "
"@code{:tag @var{name}} after the first element of the @var{link-data}; for "
"example, @code{(info-link :tag \"foo\" \"(emacs)Top\")} makes a link to the "
"Emacs manual which appears in the buffer as @samp{foo}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:143
msgid "You can use this keyword more than once, to add multiple links."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:144
#, no-wrap
msgid ":load @var{file}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:145
#, no-wrap
msgid "load@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:149
msgid ""
"Load file @var{file} (a string) before displaying this customization item "
"(@pxref{Loading}). Loading is done with @code{load}, and only if the file "
"is not already loaded."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:150
#, no-wrap
msgid ":require @var{feature}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:151
#, no-wrap
msgid "require@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:154
msgid ""
"Execute @code{(require '@var{feature})} when your saved customizations set "
"the value of this item. @var{feature} should be a symbol."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:158
msgid ""
"The most common reason to use @code{:require} is when a variable enables a "
"feature such as a minor mode, and just setting the variable won't have any "
"effect unless the code which implements the mode is loaded."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:159
#, no-wrap
msgid ":version @var{version}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:160
#, no-wrap
msgid "version@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:164
msgid ""
"This keyword specifies that the item was first introduced in Emacs version "
"@var{version}, or that its default value was changed in that version. The "
"value @var{version} must be a string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:165
#, no-wrap
msgid ":package-version '(@var{package} . @var{version})"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:166
#, no-wrap
msgid "package-version@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:171
msgid ""
"This keyword specifies that the item was first introduced in @var{package} "
"version @var{version}, or that its meaning or default value was changed in "
"that version. This keyword takes priority over @code{:version}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:177
msgid ""
"@var{package} should be the official name of the package, as a symbol (e.g., "
"@code{MH-E}). @var{version} should be a string. If the package "
"@var{package} is released as part of Emacs, @var{package} and @var{version} "
"should appear in the value of @code{customize-package-emacs-version-alist}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:182
msgid ""
"Packages distributed as part of Emacs that use the @code{:package-version} "
"keyword must also update the @code{customize-package-emacs-version-alist} "
"variable."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:183
#, no-wrap
msgid "customize-package-emacs-version-alist"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:187
msgid ""
"This alist provides a mapping for the versions of Emacs that are associated "
"with versions of a package listed in the @code{:package-version} keyword. "
"Its elements are:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:190
#, no-wrap
msgid "(@var{package} (@var{pversion} . @var{eversion})@dots{})\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:196
msgid ""
"For each @var{package}, which is a symbol, there are one or more elements "
"that contain a package version @var{pversion} with an associated Emacs "
"version @var{eversion}. These versions are strings. For example, the MH-E "
"package updates this alist with the following:"
msgstr ""
#. type: smallexample
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:204
#, no-wrap
msgid ""
"(add-to-list 'customize-package-emacs-version-alist\n"
" '(MH-E (\"6.0\" . \"22.1\") (\"6.1\" . \"22.1\") (\"7.0\" "
". \"22.1\")\n"
" (\"7.1\" . \"22.1\") (\"7.2\" . \"22.1\") (\"7.3\" "
". \"22.1\")\n"
" (\"7.4\" . \"22.1\") (\"8.0\" . \"22.1\")))\n"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:210
msgid ""
"The value of @var{package} needs to be unique and it needs to match the "
"@var{package} value appearing in the @code{:package-version} keyword. Since "
"the user might see the value in an error message, a good choice is the "
"official name of the package, such as MH-E or Gnus."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:213
#, no-wrap
msgid "Defining Customization Groups"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:214
#, no-wrap
msgid "define customization group"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:215
#, no-wrap
msgid "customization groups, defining"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:225
msgid ""
"Each Emacs Lisp package should have one main customization group which "
"contains all the options, faces and other groups in the package. If the "
"package has a small number of options and faces, use just one group and put "
"everything in it. When there are more than twenty or so options and faces, "
"then you should structure them into subgroups, and put the subgroups under "
"the package's main customization group. It is OK to put some of the options "
"and faces in the package's main group alongside the subgroups."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:231
msgid ""
"The package's main or only group should be a member of one or more of the "
"standard customization groups. (To display the full list of them, use "
"@kbd{M-x customize}.) Choose one or more of them (but not too many), and "
"add your group to each of them using the @code{:group} keyword."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:233
msgid "The way to declare new customization groups is with @code{defgroup}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:234
#, no-wrap
msgid "defgroup group members doc [keyword value]@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:238
msgid ""
"Declare @var{group} as a customization group containing @var{members}. Do "
"not quote the symbol @var{group}. The argument @var{doc} specifies the "
"documentation string for the group."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:243
msgid ""
"The argument @var{members} is a list specifying an initial set of "
"customization items to be members of the group. However, most often "
"@var{members} is @code{nil}, and you specify the group's members by using "
"the @code{:group} keyword when defining those members."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:249
msgid ""
"If you want to specify group members through @var{members}, each element "
"should have the form @code{(@var{name} @var{widget})}. Here @var{name} is a "
"symbol, and @var{widget} is a widget type for editing that symbol. Useful "
"widgets are @code{custom-variable} for a variable, @code{custom-face} for a "
"face, and @code{custom-group} for a group."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:253
msgid ""
"When you introduce a new group into Emacs, use the @code{:version} keyword "
"in the @code{defgroup}; then you need not use it for the individual members "
"of the group."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:256
msgid ""
"In addition to the common keywords (@pxref{Common Keywords}), you can also "
"use this keyword in @code{defgroup}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:258
#, no-wrap
msgid ":prefix @var{prefix}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:259
#, no-wrap
msgid "prefix@r{, @code{defgroup} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:264
msgid ""
"If the name of an item in the group starts with @var{prefix}, and the "
"customizable variable @code{custom-unlispify-remove-prefixes} is "
"non-@code{nil}, the item's tag will omit @var{prefix}. A group can have any "
"number of prefixes."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:266
#, no-wrap
msgid "@code{custom-group} property"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:272
msgid ""
"The variables and subgroups of a group are stored in the @code{custom-group} "
"property of the group's symbol. @xref{Symbol Plists}. The value of that "
"property is a list of pairs whose @code{car} is the variable or subgroup "
"symbol and the @code{cdr} is either @code{custom-variable} or "
"@code{custom-group}."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:274
#, no-wrap
msgid "custom-unlispify-remove-prefixes"
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:278
msgid ""
"If this variable is non-@code{nil}, the prefixes specified by a group's "
"@code{:prefix} keyword are omitted from tag names, whenever the user "
"customizes the group."
msgstr ""
#. type: defopt
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:282
msgid ""
"The default value is @code{nil}, i.e., the prefix-discarding feature is "
"disabled. This is because discarding prefixes often leads to confusing "
"names for options and faces."
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:285
#, no-wrap
msgid "Defining Customization Variables"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:286
#, no-wrap
msgid "define customization options"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:287
#, no-wrap
msgid "customizable variables, how to define"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:288
#, no-wrap
msgid "user options, how to define"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:298
msgid ""
"@dfn{Customizable variables}, also called @dfn{user options}, are global "
"Lisp variables whose values can be set through the Customize interface. "
"Unlike other global variables, which are defined with @code{defvar} "
"(@pxref{Defining Variables}), customizable variables are defined using the "
"@code{defcustom} macro. In addition to calling @code{defvar} as a "
"subroutine, @code{defcustom} states how the variable should be displayed in "
"the Customize interface, the values it is allowed to take, etc."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:299
#, no-wrap
msgid "defcustom option standard doc [keyword value]@dots{}"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:302
msgid ""
"This macro declares @var{option} as a user option (i.e., a customizable "
"variable). You should not quote @var{option}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:311
msgid ""
"The argument @var{standard} is an expression that specifies the standard "
"value for @var{option}. Evaluating the @code{defcustom} form evaluates "
"@var{standard}, but does not necessarily bind the option to that value. If "
"@var{option} already has a default value, it is left unchanged. If the user "
"has already saved a customization for @var{option}, the user's customized "
"value is installed as the default value. Otherwise, the result of "
"evaluating @var{standard} is installed as the default value."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:316
msgid ""
"Like @code{defvar}, this macro marks @code{option} as a special variable, "
"meaning that it should always be dynamically bound. If @var{option} is "
"already lexically bound, that lexical binding remains in effect until the "
"binding construct exits. @xref{Variable Scoping}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:321
msgid ""
"The expression @var{standard} can be evaluated at various other times, "
"too---whenever the customization facility needs to know @var{option}'s "
"standard value. So be sure to use an expression which is harmless to "
"evaluate at any time."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:324
msgid "The argument @var{doc} specifies the documentation string for the variable."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:328
msgid ""
"If a @code{defcustom} does not specify any @code{:group}, the last group "
"defined with @code{defgroup} in the same file will be used. This way, most "
"@code{defcustom} do not need an explicit @code{:group}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:329
#, no-wrap
msgid "@code{eval-defun}, and @code{defcustom} forms"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:337
msgid ""
"When you evaluate a @code{defcustom} form with @kbd{C-M-x} in Emacs Lisp "
"mode (@code{eval-defun}), a special feature of @code{eval-defun} arranges to "
"set the variable unconditionally, without testing whether its value is "
"void. (The same feature applies to @code{defvar}, @pxref{Defining "
"Variables}.) Using @code{eval-defun} on a defcustom that is already defined "
"calls the @code{:set} function (see below), if there is one."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:344
msgid ""
"If you put a @code{defcustom} in a pre-loaded Emacs Lisp file "
"(@pxref{Building Emacs}), the standard value installed at dump time might be "
"incorrect, e.g., because another variable that it depends on has not been "
"assigned the right value yet. In that case, use "
"@code{custom-reevaluate-setting}, described below, to re-evaluate the "
"standard value after Emacs starts up."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:348
msgid ""
"In addition to the keywords listed in @ref{Common Keywords}, this macro "
"accepts the following keywords:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:350
#, no-wrap
msgid ":type @var{type}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:355
msgid ""
"Use @var{type} as the data type for this option. It specifies which values "
"are legitimate, and how to display the value (@pxref{Customization Types}). "
"Every @code{defcustom} should specify a value for this keyword."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:356
#, no-wrap
msgid ":options @var{value-list}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:357
#, no-wrap
msgid "options@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:361
msgid ""
"Specify the list of reasonable values for use in this option. The user is "
"not restricted to using only these values, but they are offered as "
"convenient alternatives."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:365
msgid ""
"This is meaningful only for certain types, currently including @code{hook}, "
"@code{plist} and @code{alist}. See the definition of the individual types "
"for a description of how to use @code{:options}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:369
msgid ""
"Re-evaluating a @code{defcustom} form with a different @code{:options} value "
"does not clear the values added by previous evaluations, or added by calls "
"to @code{custom-add-frequent-value} (see below)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:370
#, no-wrap
msgid ":set @var{setfunction}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:371
#, no-wrap
msgid "set@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:380
msgid ""
"Specify @var{setfunction} as the way to change the value of this option when "
"using the Customize interface. The function @var{setfunction} should take "
"two arguments, a symbol (the option name) and the new value, and should do "
"whatever is necessary to update the value properly for this option (which "
"may not mean simply setting the option as a Lisp variable); preferably, "
"though, it should not modify its value argument destructively. The default "
"for @var{setfunction} is @code{set-default}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:383
msgid ""
"If you specify this keyword, the variable's documentation string should "
"describe how to do the same job in hand-written Lisp code."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:384
#, no-wrap
msgid ":get @var{getfunction}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:385
#, no-wrap
msgid "get@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:391
msgid ""
"Specify @var{getfunction} as the way to extract the value of this option. "
"The function @var{getfunction} should take one argument, a symbol, and "
"should return whatever customize should use as the current value for that "
"symbol (which need not be the symbol's Lisp value). The default is "
"@code{default-value}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:397
msgid ""
"You have to really understand the workings of Custom to use @code{:get} "
"correctly. It is meant for values that are treated in Custom as variables "
"but are not actually stored in Lisp variables. It is almost surely a "
"mistake to specify @var{getfunction} for a value that really is stored in a "
"Lisp variable."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:398
#, no-wrap
msgid ":initialize @var{function}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:399
#, no-wrap
msgid "initialize@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:404
msgid ""
"@var{function} should be a function used to initialize the variable when the "
"@code{defcustom} is evaluated. It should take two arguments, the option "
"name (a symbol) and the value. Here are some predefined functions meant for "
"use in this way:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:406
#, no-wrap
msgid "custom-initialize-set"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:409
msgid ""
"Use the variable's @code{:set} function to initialize the variable, but do "
"not reinitialize it if it is already non-void."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:410
#, no-wrap
msgid "custom-initialize-default"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:417
msgid ""
"Like @code{custom-initialize-set}, but use the function @code{set-default} "
"to set the variable, instead of the variable's @code{:set} function. This "
"is the usual choice for a variable whose @code{:set} function enables or "
"disables a minor mode; with this choice, defining the variable will not call "
"the minor mode function, but customizing the variable will do so."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:418
#, no-wrap
msgid "custom-initialize-reset"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:423
msgid ""
"Always use the @code{:set} function to initialize the variable. If the "
"variable is already non-void, reset it by calling the @code{:set} function "
"using the current value (returned by the @code{:get} method). This is the "
"default @code{:initialize} function."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:424
#, no-wrap
msgid "custom-initialize-changed"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:428
msgid ""
"Use the @code{:set} function to initialize the variable, if it is already "
"set or has been customized; otherwise, just use @code{set-default}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:429
#, no-wrap
msgid "custom-initialize-delay"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:437
msgid ""
"This function behaves like @code{custom-initialize-set}, but it delays the "
"actual initialization to the next Emacs start. This should be used in files "
"that are preloaded (or for autoloaded variables), so that the initialization "
"is done in the run-time context rather than the build-time context. This "
"also has the side-effect that the (delayed) initialization is performed with "
"the @code{:set} function. @xref{Building Emacs}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:439
#, no-wrap
msgid ":local @var{value}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:440
#, no-wrap
msgid "local@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:444
msgid ""
"If the @var{value} is @code{t}, mark @var{option} as automatically "
"buffer-local; if the value is @code{permanent}, also set @var{option}s "
"@code{permanent-local} property to @code{t}. @xref{Creating Buffer-Local}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:445
#, no-wrap
msgid ":risky @var{value}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:446
#, no-wrap
msgid "risky@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:449
msgid ""
"Set the variable's @code{risky-local-variable} property to @var{value} "
"(@pxref{File Local Variables})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:450
#, no-wrap
msgid ":safe @var{function}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:451
#, no-wrap
msgid "safe@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:454
msgid ""
"Set the variable's @code{safe-local-variable} property to @var{function} "
"(@pxref{File Local Variables})."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:455
#, no-wrap
msgid ":set-after @var{variables}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:456
#, no-wrap
msgid "set-after@r{, @code{defcustom} keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:462
msgid ""
"When setting variables according to saved customizations, make sure to set "
"the variables @var{variables} before this one; i.e., delay setting this "
"variable until after those others have been handled. Use @code{:set-after} "
"if setting this variable won't work properly unless those other variables "
"already have their intended values."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:468
msgid ""
"It is useful to specify the @code{:require} keyword for an option that turns "
"on a certain feature. This causes Emacs to load the feature, if it is not "
"already loaded, whenever the option is set. @xref{Common Keywords}. Here "
"is an example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:475
#, no-wrap
msgid ""
"(defcustom frobnicate-automatically nil\n"
" \"Non-nil means automatically frobnicate all buffers.\"\n"
" :type 'boolean\n"
" :require 'frobnicate-mode\n"
" :group 'frobnicate)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:485
msgid ""
"If a customization item has a type such as @code{hook} or @code{alist}, "
"which supports @code{:options}, you can add additional values to the list "
"from outside the @code{defcustom} declaration by calling "
"@code{custom-add-frequent-value}. For example, if you define a function "
"@code{my-lisp-mode-initialization} intended to be called from "
"@code{emacs-lisp-mode-hook}, you might want to add that to the list of "
"reasonable values for @code{emacs-lisp-mode-hook}, but not by editing its "
"definition. You can do it thus:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:489
#, no-wrap
msgid ""
"(custom-add-frequent-value 'emacs-lisp-mode-hook\n"
" 'my-lisp-mode-initialization)\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:491
#, no-wrap
msgid "custom-add-frequent-value symbol value"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:494
msgid ""
"For the customization option @var{symbol}, add @var{value} to the list of "
"reasonable values."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:497
msgid ""
"The precise effect of adding a value depends on the customization type of "
"@var{symbol}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:501
msgid ""
"Since evaluating a @code{defcustom} form does not clear values added "
"previously, Lisp programs can use this function to add values for user "
"options not yet defined."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:512
msgid ""
"Internally, @code{defcustom} uses the symbol property @code{standard-value} "
"to record the expression for the standard value, @code{saved-value} to "
"record the value saved by the user with the customization buffer, and "
"@code{customized-value} to record the value set by the user with the "
"customization buffer, but not saved. @xref{Symbol Properties}. In "
"addition, there's @code{themed-value}, which is used to record the value set "
"by a theme (@pxref{Custom Themes}). These properties are lists, the car of "
"which is an expression that evaluates to the value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:513
#, no-wrap
msgid "custom-reevaluate-setting symbol"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:519
msgid ""
"This function re-evaluates the standard value of @var{symbol}, which should "
"be a user option declared via @code{defcustom}. If the variable was "
"customized, this function re-evaluates the saved value instead. Then it "
"sets the user option to that value (using the option's @code{:set} property "
"if that is defined)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:525
msgid ""
"This is useful for customizable options that are defined before their value "
"could be computed correctly. For example, during startup Emacs calls this "
"function for some user options that were defined in pre-loaded Emacs Lisp "
"files, but whose initial values depend on information available only at "
"run-time."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:527
#, no-wrap
msgid "custom-variable-p arg"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:533
msgid ""
"This function returns non-@code{nil} if @var{arg} is a customizable "
"variable. A customizable variable is either a variable that has a "
"@code{standard-value} or @code{custom-autoload} property (usually meaning it "
"was declared with @code{defcustom}), or an alias for another customizable "
"variable."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:538
#, no-wrap
msgid "customization types"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:543
msgid ""
"When you define a user option with @code{defcustom}, you must specify its "
"@dfn{customization type}. That is a Lisp object which describes (1) which "
"values are legitimate and (2) how to display the value in the customization "
"buffer for editing."
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:544
#, no-wrap
msgid "type@r{, @code{defcustom} keyword}"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:550
msgid ""
"You specify the customization type in @code{defcustom} with the @code{:type} "
"keyword. The argument of @code{:type} is evaluated, but only once when the "
"@code{defcustom} is executed, so it isn't useful for the value to vary. "
"Normally we use a quoted constant. For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:556
#, no-wrap
msgid ""
"(defcustom diff-command \"diff\"\n"
" \"The command to use to run diff.\"\n"
" :type '(string)\n"
" :group 'diff)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:563
msgid ""
"In general, a customization type is a list whose first element is a symbol, "
"one of the customization type names defined in the following sections. "
"After this symbol come a number of arguments, depending on the symbol. "
"Between the type symbol and its arguments, you can optionally write "
"keyword-value pairs (@pxref{Type Keywords})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:569
msgid ""
"Some type symbols do not use any arguments; those are called @dfn{simple "
"types}. For a simple type, if you do not use any keyword-value pairs, you "
"can omit the parentheses around the type symbol. For example just "
"@code{string} as a customization type is equivalent to @code{(string)}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:572
msgid ""
"All customization types are implemented as widgets; see @ref{Top, , "
"Introduction, widget, The Emacs Widget Library}, for details."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:581
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:582
#, no-wrap
msgid "Simple Types"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
msgid "Simple customization types: sexp, integer, etc."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:673
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:674
#, no-wrap
msgid "Composite Types"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
msgid "Build new types from other types or data."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1024
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1025
#, no-wrap
msgid "Splicing into Lists"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
msgid "Splice elements into list with @code{:inline}."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1075
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1076
#, no-wrap
msgid "Type Keywords"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
msgid "Keyword-argument pairs in a customization type."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1278
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1279
#, no-wrap
msgid "Defining New Types"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:579
msgid "Give your type a name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:587
msgid ""
"This section describes all the simple customization types. For several of "
"these customization types, the customization widget provides inline "
"completion with @kbd{C-M-i} or @kbd{M-@key{TAB}}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:589
#, no-wrap
msgid "sexp"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:593
msgid ""
"The value may be any Lisp object that can be printed and read back. You can "
"use @code{sexp} as a fall-back for any option, if you don't want to take the "
"time to work out a more specific type to use."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:594
#, no-wrap
msgid "integer"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:596
msgid "The value must be an integer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:597
#, no-wrap
msgid "natnum"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:599
msgid "The value must be a nonnegative integer."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:600
#, no-wrap
msgid "number"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:602
msgid "The value must be a number (floating point or integer)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:603
#, no-wrap
msgid "float"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:605
msgid "The value must be floating point."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:606
#, no-wrap
msgid "string"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:609
msgid ""
"The value must be a string. The customization buffer shows the string "
"without delimiting @samp{\"} characters or @samp{\\} quotes."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:610
#, no-wrap
msgid "regexp"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:613
msgid ""
"Like @code{string} except that the string must be a valid regular "
"expression."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:614
#, no-wrap
msgid "character"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:618
msgid ""
"The value must be a character code. A character code is actually an "
"integer, but this type shows the value by inserting the character in the "
"buffer, rather than by showing the number."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:619
#, no-wrap
msgid "file"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:621
msgid "The value must be a file name. The widget provides completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:622
#, no-wrap
msgid "(file :must-match t)"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:625
msgid ""
"The value must be a file name for an existing file. The widget provides "
"completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:626
#, no-wrap
msgid "directory"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:628
msgid "The value must be a directory. The widget provides completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:629
#, no-wrap
msgid "hook"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:634
msgid ""
"The value must be a list of functions. This customization type is used for "
"hook variables. You can use the @code{:options} keyword in a hook "
"variable's @code{defcustom} to specify a list of functions recommended for "
"use in the hook; @xref{Variable Definitions}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:635
#, no-wrap
msgid "symbol"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:638
msgid ""
"The value must be a symbol. It appears in the customization buffer as the "
"symbol name. The widget provides completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:639
#, no-wrap
msgid "function"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:642
msgid ""
"The value must be either a lambda expression or a function name. The widget "
"provides completion for function names."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:643
#, no-wrap
msgid "variable"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:645
msgid "The value must be a variable name. The widget provides completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:646
#, no-wrap
msgid "face"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:649
msgid ""
"The value must be a symbol which is a face name. The widget provides "
"completion."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:650
#, no-wrap
msgid "boolean"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:656
msgid ""
"The value is boolean---either @code{nil} or @code{t}. Note that by using "
"@code{choice} and @code{const} together (see the next section), you can "
"specify that the value must be @code{nil} or @code{t}, but also specify the "
"text to describe each value in a way that fits the specific meaning of the "
"alternative."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:657
#, no-wrap
msgid "key-sequence"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:661
msgid ""
"The value is a key sequence. The customization buffer shows the key "
"sequence using the same syntax as the @kbd{kbd} function. @xref{Key "
"Sequences}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:662
#, no-wrap
msgid "coding-system"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:665
msgid ""
"The value must be a coding-system name, and you can do completion with "
"@kbd{M-@key{TAB}}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:666
#, no-wrap
msgid "color"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:671
msgid ""
"The value must be a valid color name. The widget provides completion for "
"color names, as well as a sample and a button for selecting a color name "
"from a list of color names shown in a @file{*Colors*} buffer."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:675
#, no-wrap
msgid "composite types (customization)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:681
msgid ""
"When none of the simple types is appropriate, you can use composite types, "
"which build new types from other types or from specified data. The "
"specified types or data are called the @dfn{arguments} of the composite "
"type. The composite type normally looks like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:684
#, no-wrap
msgid "(@var{constructor} @var{arguments}@dots{})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:689
msgid "but you can also add keyword-value pairs before the arguments, like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:692
#, no-wrap
msgid ""
"(@var{constructor} @r{@{}@var{keyword} @var{value}@r{@}}@dots{} "
"@var{arguments}@dots{})\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:696
msgid ""
"Here is a table of constructors and how to use them to write composite "
"types:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:698
#, no-wrap
msgid "(cons @var{car-type} @var{cdr-type})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:703
msgid ""
"The value must be a cons cell, its @sc{car} must fit @var{car-type}, and its "
"@sc{cdr} must fit @var{cdr-type}. For example, @code{(cons string symbol)} "
"is a customization type which matches values such as @code{(\"foo\" . foo)}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:706
msgid ""
"In the customization buffer, the @sc{car} and @sc{cdr} are displayed and "
"edited separately, each according to their specified type."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:707
#, no-wrap
msgid "(list @var{element-types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:711
msgid ""
"The value must be a list with exactly as many elements as the "
"@var{element-types} given; and each element must fit the corresponding "
"@var{element-type}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:715
msgid ""
"For example, @code{(list integer string function)} describes a list of three "
"elements; the first element must be an integer, the second a string, and the "
"third a function."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:718
msgid ""
"In the customization buffer, each element is displayed and edited "
"separately, according to the type specified for it."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:719
#, no-wrap
msgid "(group @var{element-types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:723
msgid ""
"This works like @code{list} except for the formatting of text in the Custom "
"buffer. @code{list} labels each element value with its tag; @code{group} "
"does not."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:724
#, no-wrap
msgid "(vector @var{element-types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:727
msgid ""
"Like @code{list} except that the value must be a vector instead of a list. "
"The elements work the same as in @code{list}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:728
#, no-wrap
msgid "(alist :key-type @var{key-type} :value-type @var{value-type})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:734
msgid ""
"The value must be a list of cons-cells, the @sc{car} of each cell "
"representing a key of customization type @var{key-type}, and the @sc{cdr} of "
"the same cell representing a value of customization type @var{value-type}. "
"The user can add and delete key/value pairs, and edit both the key and the "
"value of each pair."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:737
msgid "If omitted, @var{key-type} and @var{value-type} default to @code{sexp}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:745
msgid ""
"The user can add any key matching the specified key type, but you can give "
"some keys a preferential treatment by specifying them with the "
"@code{:options} (see @ref{Variable Definitions}). The specified keys will "
"always be shown in the customize buffer (together with a suitable value), "
"with a checkbox to include or exclude or disable the key/value pair from the "
"alist. The user will not be able to edit the keys specified by the "
"@code{:options} keyword argument."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:749
msgid ""
"The argument to the @code{:options} keywords should be a list of "
"specifications for reasonable keys in the alist. Ordinarily, they are "
"simply atoms, which stand for themselves. For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:752
#, no-wrap
msgid ":options '(\"foo\" \"bar\" \"baz\")\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:757
msgid ""
"specifies that there are three known keys, namely @code{\"foo\"}, "
"@code{\"bar\"} and @code{\"baz\"}, which will always be shown first."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:763
msgid ""
"You may want to restrict the value type for specific keys, for example, the "
"value associated with the @code{\"bar\"} key can only be an integer. You "
"can specify this by using a list instead of an atom in the list. The first "
"element will specify the key, like before, while the second element will "
"specify the value type. For example:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:766
#, no-wrap
msgid ":options '(\"foo\" (\"bar\" integer) \"baz\")\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:775
msgid ""
"Finally, you may want to change how the key is presented. By default, the "
"key is simply shown as a @code{const}, since the user cannot change the "
"special keys specified with the @code{:options} keyword. However, you may "
"want to use a more specialized type for presenting the key, like "
"@code{function-item} if you know it is a symbol with a function binding. "
"This is done by using a customization type specification instead of a symbol "
"for the key."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:780
#, no-wrap
msgid ""
":options '(\"foo\"\n"
" ((function-item some-function) integer)\n"
" \"baz\")\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:784
msgid ""
"Many alists use lists with two elements, instead of cons cells. For "
"example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:789
#, no-wrap
msgid ""
"(defcustom list-alist\n"
" '((\"foo\" 1) (\"bar\" 2) (\"baz\" 3))\n"
" \"Each element is a list of the form (KEY VALUE).\")\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:793
msgid "instead of"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:798
#, no-wrap
msgid ""
"(defcustom cons-alist\n"
" '((\"foo\" . 1) (\"bar\" . 2) (\"baz\" . 3))\n"
" \"Each element is a cons-cell (KEY . VALUE).\")\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:804
msgid ""
"Because of the way lists are implemented on top of cons cells, you can treat "
"@code{list-alist} in the example above as a cons cell alist, where the value "
"type is a list with a single element containing the real value."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:809
#, no-wrap
msgid ""
"(defcustom list-alist '((\"foo\" 1) (\"bar\" 2) (\"baz\" 3))\n"
" \"Each element is a list of the form (KEY VALUE).\"\n"
" :type '(alist :value-type (group integer)))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:813
msgid ""
"The @code{group} widget is used here instead of @code{list} only because the "
"formatting is better suited for the purpose."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:816
msgid ""
"Similarly, you can have alists with more values associated with each key, "
"using variations of this trick:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:824
#, no-wrap
msgid ""
"(defcustom person-data '((\"brian\" 50 t)\n"
" (\"dorith\" 55 nil)\n"
" (\"ken\" 52 t))\n"
" \"Alist of basic info about people.\n"
"Each element has the form (NAME AGE MALE-FLAG).\"\n"
" :type '(alist :value-type (group integer boolean)))\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:826
#, no-wrap
msgid "(plist :key-type @var{key-type} :value-type @var{value-type})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:831
msgid ""
"This customization type is similar to @code{alist} (see above), except that "
"(i) the information is stored as a property list, (@pxref{Property Lists}), "
"and (ii) @var{key-type}, if omitted, defaults to @code{symbol} rather than "
"@code{sexp}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:832
#, no-wrap
msgid "(choice @var{alternative-types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:835
msgid ""
"The value must fit one of @var{alternative-types}. For example, "
"@code{(choice integer string)} allows either an integer or a string."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:839
msgid ""
"In the customization buffer, the user selects an alternative using a menu, "
"and can then edit the value in the usual way for that alternative."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:845
msgid ""
"Normally the strings in this menu are determined automatically from the "
"choices; however, you can specify different strings for the menu by "
"including the @code{:tag} keyword in the alternatives. For example, if an "
"integer stands for a number of spaces, while a string is text to use "
"verbatim, you might write the customization type this way,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:849
#, no-wrap
msgid ""
"(choice (integer :tag \"Number of spaces\")\n"
" (string :tag \"Literal text\"))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:853
msgid "so that the menu offers @samp{Number of spaces} and @samp{Literal text}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:857
msgid ""
"In any alternative for which @code{nil} is not a valid value, other than a "
"@code{const}, you should specify a valid default for that alternative using "
"the @code{:value} keyword. @xref{Type Keywords}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:862
msgid ""
"If some values are covered by more than one of the alternatives, customize "
"will choose the first alternative that the value fits. This means you "
"should always list the most specific types first, and the most general "
"last. Here's an example of proper usage:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:866
#, no-wrap
msgid ""
"(choice (const :tag \"Off\" nil)\n"
" symbol (sexp :tag \"Other\"))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:871
msgid ""
"This way, the special value @code{nil} is not treated like other symbols, "
"and symbols are not treated like other Lisp expressions."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:872
#, no-wrap
msgid "radio, customization types"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:873
#, no-wrap
msgid "(radio @var{element-types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:879
msgid ""
"This is similar to @code{choice}, except that the choices are displayed "
"using radio buttons rather than a menu. This has the advantage of "
"displaying documentation for the choices when applicable and so is often a "
"good choice for a choice between constant functions (@code{function-item} "
"customization types)."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:880
#, no-wrap
msgid "(const @var{value})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:882
msgid "The value must be @var{value}---nothing else is allowed."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:886
msgid ""
"The main use of @code{const} is inside of @code{choice}. For example, "
"@code{(choice integer (const nil))} allows either an integer or @code{nil}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:889
msgid ""
"@code{:tag} is often used with @code{const}, inside of @code{choice}. For "
"example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:894
#, no-wrap
msgid ""
"(choice (const :tag \"Yes\" t)\n"
" (const :tag \"No\" nil)\n"
" (const :tag \"Ask\" foo))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:899
msgid ""
"describes a variable for which @code{t} means yes, @code{nil} means no, and "
"@code{foo} means ``ask''."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:900
#, no-wrap
msgid "(other @var{value})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:903
msgid ""
"This alternative can match any Lisp value, but if the user chooses this "
"alternative, that selects the value @var{value}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:906
msgid ""
"The main use of @code{other} is as the last element of @code{choice}. For "
"example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:911
#, no-wrap
msgid ""
"(choice (const :tag \"Yes\" t)\n"
" (const :tag \"No\" nil)\n"
" (other :tag \"Ask\" foo))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:919
msgid ""
"describes a variable for which @code{t} means yes, @code{nil} means no, and "
"anything else means ``ask''. If the user chooses @samp{Ask} from the menu "
"of alternatives, that specifies the value @code{foo}; but any other value "
"(not @code{t}, @code{nil} or @code{foo}) displays as @samp{Ask}, just like "
"@code{foo}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:920
#, no-wrap
msgid "(function-item @var{function})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:925
msgid ""
"Like @code{const}, but used for values which are functions. This displays "
"the documentation string as well as the function name. The documentation "
"string is either the one you specify with @code{:doc}, or @var{function}'s "
"own documentation string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:926
#, no-wrap
msgid "(variable-item @var{variable})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:931
msgid ""
"Like @code{const}, but used for values which are variable names. This "
"displays the documentation string as well as the variable name. The "
"documentation string is either the one you specify with @code{:doc}, or "
"@var{variable}'s own documentation string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:932
#, no-wrap
msgid "(set @var{types}@dots{})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:935
msgid ""
"The value must be a list, and each element of the list must match one of the "
"@var{types} specified."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:943
msgid ""
"This appears in the customization buffer as a checklist, so that each of "
"@var{types} may have either one corresponding element or none. It is not "
"possible to specify two different elements that match the same one of "
"@var{types}. For example, @code{(set integer symbol)} allows one integer "
"and/or one symbol in the list; it does not allow multiple integers or "
"multiple symbols. As a result, it is rare to use nonspecific types such as "
"@code{integer} in a @code{set}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:946
msgid ""
"Most often, the @var{types} in a @code{set} are @code{const} types, as shown "
"here:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:949
#, no-wrap
msgid "(set (const :bold) (const :italic))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:952
msgid "Sometimes they describe possible elements in an alist:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:956
#, no-wrap
msgid ""
"(set (cons :tag \"Height\" (const height) integer)\n"
" (cons :tag \"Width\" (const width) integer))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:961
msgid ""
"That lets the user specify a height value optionally and a width value "
"optionally."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:962
#, no-wrap
msgid "(repeat @var{element-type})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:967
msgid ""
"The value must be a list and each element of the list must fit the type "
"@var{element-type}. This appears in the customization buffer as a list of "
"elements, with @samp{[INS]} and @samp{[DEL]} buttons for adding more "
"elements or removing elements."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:968
#, no-wrap
msgid "restricted-sexp, customization types"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:969
#, no-wrap
msgid "(restricted-sexp :match-alternatives @var{criteria})"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:974
msgid ""
"This is the most general composite type construct. The value may be any "
"Lisp object that satisfies one of @var{criteria}. @var{criteria} should be "
"a list, and each element should be one of these possibilities:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:981
msgid ""
"A predicate---that is, a function of one argument that returns either "
"@code{nil} or non-@code{nil} according to the argument. Using a predicate "
"in the list says that objects for which the predicate returns non-@code{nil} "
"are acceptable."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:985
msgid ""
"A quoted constant---that is, @code{'@var{object}}. This sort of element in "
"the list says that @var{object} itself is an acceptable value."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:988
msgid "For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:992
#, no-wrap
msgid ""
"(restricted-sexp :match-alternatives\n"
" (integerp 't 'nil))\n"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:996
msgid "allows integers, @code{t} and @code{nil} as legitimate values."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:999
msgid ""
"The customization buffer shows all legitimate values using their read "
"syntax, and the user edits them textually."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1003
msgid ""
"Here is a table of the keywords you can use in keyword-value pairs in a "
"composite type:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1005
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1162
#, no-wrap
msgid ":tag @var{tag}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1009
msgid ""
"Use @var{tag} as the name of this alternative, for user communication "
"purposes. This is useful for a type that appears inside of a @code{choice}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1010
#, no-wrap
msgid ":match-alternatives @var{criteria}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1011
#, no-wrap
msgid "match-alternatives@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1014
msgid ""
"Use @var{criteria} to match possible values. This is used only in "
"@code{restricted-sexp}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1015
#, no-wrap
msgid ":args @var{argument-list}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1016
#, no-wrap
msgid "args@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1022
msgid ""
"Use the elements of @var{argument-list} as the arguments of the type "
"construct. For instance, @code{(const :args (foo))} is equivalent to "
"@code{(const foo)}. You rarely need to write @code{:args} explicitly, "
"because normally the arguments are recognized automatically as whatever "
"follows the last keyword-value pair."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1032
msgid ""
"The @code{:inline} feature lets you splice a variable number of elements "
"into the middle of a @code{list} or @code{vector} customization type. You "
"use it by adding @code{:inline t} to a type specification which is contained "
"in a @code{list} or @code{vector} specification."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1040
msgid ""
"Normally, each entry in a @code{list} or @code{vector} type specification "
"describes a single element type. But when an entry contains @code{:inline "
"t}, the value it matches is merged directly into the containing sequence. "
"For example, if the entry matches a list with three elements, those become "
"three elements of the overall sequence. This is analogous to @samp{,@@} in "
"a backquote construct (@pxref{Backquote})."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1044
msgid ""
"For example, to specify a list whose first element must be @code{baz} and "
"whose remaining arguments should be zero or more of @code{foo} and "
"@code{bar}, use this customization type:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1047
#, no-wrap
msgid "(list (const baz) (set :inline t (const foo) (const bar)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1052
msgid ""
"This matches values such as @code{(baz)}, @code{(baz foo)}, @code{(baz bar)} "
"and @code{(baz foo bar)}."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1053
#, no-wrap
msgid "choice, customization types"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1059
msgid ""
"When the element-type is a @code{choice}, you use @code{:inline} not in the "
"@code{choice} itself, but in (some of) the alternatives of the "
"@code{choice}. For example, to match a list which must start with a file "
"name, followed either by the symbol @code{t} or two strings, use this "
"customization type:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1064
#, no-wrap
msgid ""
"(list file\n"
" (choice (const t)\n"
" (list :inline t string string)))\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1071
msgid ""
"If the user chooses the first alternative in the choice, then the overall "
"list has two elements and the second element is @code{t}. If the user "
"chooses the second alternative, then the overall list has three elements and "
"the second and third must be strings."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1074
msgid ""
"The widgets can specify predicates to say whether an inline value matches "
"the widget with the @code{:match-inline} element."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1081
msgid ""
"You can specify keyword-argument pairs in a customization type after the "
"type name symbol. Here are the keywords you can use, and their meanings:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1083
#, no-wrap
msgid ":value @var{default}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1085
msgid "Provide a default value."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1088
msgid ""
"If @code{nil} is not a valid value for the alternative, then it is essential "
"to specify a valid default with @code{:value}."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1093
msgid ""
"If you use this for a type that appears as an alternative inside of "
"@code{choice}; it specifies the default value to use, at first, if and when "
"the user selects this alternative with the menu in the customization buffer."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1096
msgid ""
"Of course, if the actual value of the option fits this alternative, it will "
"appear showing the actual value, not @var{default}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1097
#, no-wrap
msgid ":format @var{format-string}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1098
#, no-wrap
msgid "format@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1102
msgid ""
"This string will be inserted in the buffer to represent the value "
"corresponding to the type. The following @samp{%} escapes are available for "
"use in @var{format-string}:"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1104
#, no-wrap
msgid "%[@var{button}%]"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1109
msgid ""
"Display the text @var{button} marked as a button. The @code{:action} "
"attribute specifies what the button will do if the user invokes it; its "
"value is a function which takes two arguments---the widget which the button "
"appears in, and the event."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1112
msgid "There is no way to specify two different buttons with different actions."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1113
#, no-wrap
msgid "%@{@var{sample}%@}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1115
msgid "Show @var{sample} in a special face specified by @code{:sample-face}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1116
#, no-wrap
msgid "%v"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1119
msgid ""
"Substitute the item's value. How the value is represented depends on the "
"kind of item, and (for variables) on the customization type."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1120
#, no-wrap
msgid "%d"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1122
msgid "Substitute the item's documentation string."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1123
#, no-wrap
msgid "%h"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1126
msgid ""
"Like @samp{%d}, but if the documentation string is more than one line, add a "
"button to control whether to show all of it or just the first line."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1127
#, no-wrap
msgid "%t"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1130
msgid "Substitute the tag here. You specify the tag with the @code{:tag} keyword."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1131
#, no-wrap
msgid "%%"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1133
msgid "Display a literal @samp{%}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1135
#, no-wrap
msgid ":action @var{action}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1136
#, no-wrap
msgid "action@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1138
msgid "Perform @var{action} if the user clicks on a button."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1139
#, no-wrap
msgid ":button-face @var{face}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1140
#, no-wrap
msgid "button-face@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1143
msgid ""
"Use the face @var{face} (a face name or a list of face names) for button "
"text displayed with @samp{%[@dots{}%]}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1144
#, no-wrap
msgid ":button-prefix @var{prefix}"
msgstr ""
#. type: itemx
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1145
#, no-wrap
msgid ":button-suffix @var{suffix}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1146
#, no-wrap
msgid "button-prefix@r{, customization keyword}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1147
#, no-wrap
msgid "button-suffix@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1150
msgid "These specify the text to display before and after a button. Each can be:"
msgstr ""
#. type: code{#1}
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1152
#, no-wrap
msgid "nil"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1154
msgid "No text is inserted."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1155
#, no-wrap
msgid "a string"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1157
msgid "The string is inserted literally."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1158
#, no-wrap
msgid "a symbol"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1160
msgid "The symbol's value is used."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1165
msgid ""
"Use @var{tag} (a string) as the tag for the value (or part of the value) "
"that corresponds to this type."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1166
#, no-wrap
msgid ":doc @var{doc}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1167
#, no-wrap
msgid "doc@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1172
msgid ""
"Use @var{doc} as the documentation string for this value (or part of the "
"value) that corresponds to this type. In order for this to work, you must "
"specify a value for @code{:format}, and use @samp{%d} or @samp{%h} in that "
"value."
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1176
msgid ""
"The usual reason to specify a documentation string for a type is to provide "
"more information about the meanings of alternatives inside a @code{choice} "
"type or the parts of some other composite type."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1177
#, no-wrap
msgid ":help-echo @var{motion-doc}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1178
#, no-wrap
msgid "help-echo@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1185
msgid ""
"When you move to this item with @code{widget-forward} or "
"@code{widget-backward}, it will display the string @var{motion-doc} in the "
"echo area. In addition, @var{motion-doc} is used as the mouse "
"@code{help-echo} string and may actually be a function or form evaluated to "
"yield a help string. If it is a function, it is called with one argument, "
"the widget."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1186
#, no-wrap
msgid ":match @var{function}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1187
#, no-wrap
msgid "match@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1192
msgid ""
"Specify how to decide whether a value matches the type. The corresponding "
"value, @var{function}, should be a function that accepts two arguments, a "
"widget and a value; it should return non-@code{nil} if the value is "
"acceptable."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1193
#, no-wrap
msgid ":match-inline @var{function}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1194
#, no-wrap
msgid "match-inline@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1200
msgid ""
"Specify how to decide whether an inline value matches the type. The "
"corresponding value, @var{function}, should be a function that accepts two "
"arguments, a widget and an inline value; it should return non-@code{nil} if "
"the value is acceptable. See @ref{Splicing into Lists} for more information "
"about inline values."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1201
#, no-wrap
msgid ":validate @var{function}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1207
msgid ""
"Specify a validation function for input. @var{function} takes a widget as "
"an argument, and should return @code{nil} if the widget's current value is "
"valid for the widget. Otherwise, it should return the widget containing the "
"invalid data, and set that widget's @code{:error} property to a string "
"explaining the error."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1208
#, no-wrap
msgid ":type-error @var{string}"
msgstr ""
#. type: kindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1209
#, no-wrap
msgid "type-error@r{, customization keyword}"
msgstr ""
#. type: table
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1214
msgid ""
"@var{string} should be a string that describes why a value doesn't match the "
"type, as determined by the @code{:match} function. When the @code{:match} "
"function returns @code{nil}, the widget's @code{:error} property will be set "
"to @var{string}."
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1216
#, no-wrap
msgid ":indent @var{columns}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1222
#, no-wrap
msgid ":offset @var{extra}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1227
#, no-wrap
msgid ":extra-offset @var{n}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1231
#, no-wrap
msgid ":notify @var{function}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1237
#, no-wrap
msgid ":menu-tag @var{tag-string}"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1241
#, no-wrap
msgid ":menu-tag-get"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1247
#, no-wrap
msgid ":tab-order"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1255
#, no-wrap
msgid ""
"Widgets with tabbing order @code{-1} are ignored.\n"
"\n"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1260
#, no-wrap
msgid ""
"(Unimplemented) When on a widget with tabbing order @var{n}, go to the\n"
"next widget in the buffer with tabbing order @var{n+1} or @code{nil},\n"
"whichever comes first.\n"
"\n"
msgstr ""
#. type: enumerate
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1264
#, no-wrap
msgid ""
"When on a widget with no tabbing order specified, go to the next widget\n"
"in the buffer with a positive tabbing order, or @code{nil}\n"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1266
#, no-wrap
msgid ":parent"
msgstr ""
#. type: item
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1270
#, no-wrap
msgid ":sibling-args"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1280
#, no-wrap
msgid "customization types, define new"
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1281
#, no-wrap
msgid "define new customization types"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1291
msgid ""
"In the previous sections we have described how to construct elaborate type "
"specifications for @code{defcustom}. In some cases you may want to give "
"such a type specification a name. The obvious case is when you are using "
"the same type for many user options: rather than repeat the specification "
"for each option, you can give the type specification a name, and use that "
"name each @code{defcustom}. The other case is when a user option's value is "
"a recursive data structure. To make it possible for a datatype to refer to "
"itself, it needs to have a name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1298
msgid ""
"Since custom types are implemented as widgets, the way to define a new "
"customize type is to define a new widget. We are not going to describe the "
"widget interface here in details, see @ref{Top, , Introduction, widget, The "
"Emacs Widget Library}, for that. Instead we are going to demonstrate the "
"minimal functionality needed for defining new customize types by a simple "
"example."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1309
#, no-wrap
msgid ""
"(define-widget 'binary-tree-of-string 'lazy\n"
" \"A binary tree made of cons-cells and strings.\"\n"
" :offset 4\n"
" :tag \"Node\"\n"
" :type '(choice (string :tag \"Leaf\" :value \"\")\n"
" (cons :tag \"Interior\"\n"
" :value (\"\" . \"\")\n"
" binary-tree-of-string\n"
" binary-tree-of-string)))\n"
"\n"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1313
#, no-wrap
msgid ""
"(defcustom foo-bar \"\"\n"
" \"Sample variable holding a binary tree of strings.\"\n"
" :type 'binary-tree-of-string)\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1326
msgid ""
"The function to define a new widget is called @code{define-widget}. The "
"first argument is the symbol we want to make a new widget type. The second "
"argument is a symbol representing an existing widget, the new widget is "
"going to be defined in terms of difference from the existing widget. For "
"the purpose of defining new customization types, the @code{lazy} widget is "
"perfect, because it accepts a @code{:type} keyword argument with the same "
"syntax as the keyword argument to @code{defcustom} with the same name. The "
"third argument is a documentation string for the new widget. You will be "
"able to see that string with the @kbd{M-x widget-browse @key{RET} "
"binary-tree-of-string @key{RET}} command."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1337
msgid ""
"After these mandatory arguments follow the keyword arguments. The most "
"important is @code{:type}, which describes the data type we want to match "
"with this widget. Here a @code{binary-tree-of-string} is described as being "
"either a string, or a cons-cell whose car and cdr are themselves both "
"@code{binary-tree-of-string}. Note the reference to the widget type we are "
"currently in the process of defining. The @code{:tag} attribute is a string "
"to name the widget in the user interface, and the @code{:offset} argument is "
"there to ensure that child nodes are indented four spaces relative to the "
"parent node, making the tree structure apparent in the customization buffer."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1340
msgid ""
"The @code{defcustom} shows how the new widget can be used as an ordinary "
"customization type."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1348
msgid ""
"The reason for the name @code{lazy} is that the other composite widgets "
"convert their inferior widgets to internal form when the widget is "
"instantiated in a buffer. This conversion is recursive, so the inferior "
"widgets will convert @emph{their} inferior widgets. If the data structure "
"is itself recursive, this conversion is an infinite recursion. The "
"@code{lazy} widget prevents the recursion: it convert its @code{:type} "
"argument only when needed."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1351
#, no-wrap
msgid "applying customizations"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1359
msgid ""
"The following functions are responsible for installing the user's "
"customization settings for variables and faces, respectively. When the user "
"invokes @samp{Save for future sessions} in the Customize interface, that "
"takes effect by writing a @code{custom-set-variables} and/or a "
"@code{custom-set-faces} form into the custom file, to be evaluated the next "
"time Emacs starts."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1360
#, no-wrap
msgid "custom-set-variables &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1363
msgid ""
"This function installs the variable customizations specified by @var{args}. "
"Each argument in @var{args} should have the form"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1366
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1453
#, no-wrap
msgid "(@var{var} @var{expression} [@var{now} [@var{request} [@var{comment}]]])\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1371
msgid ""
"@var{var} is a variable name (a symbol), and @var{expression} is an "
"expression which evaluates to the desired customized value."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1379
msgid ""
"If the @code{defcustom} form for @var{var} has been evaluated prior to this "
"@code{custom-set-variables} call, @var{expression} is immediately evaluated, "
"and the variable's value is set to the result. Otherwise, @var{expression} "
"is stored into the variable's @code{saved-value} property, to be evaluated "
"when the relevant @code{defcustom} is called (usually when the library "
"defining that variable is loaded into Emacs)."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1386
msgid ""
"The @var{now}, @var{request}, and @var{comment} entries are for internal use "
"only, and may be omitted. @var{now}, if non-@code{nil}, means to set the "
"variable's value now, even if the variable's @code{defcustom} form has not "
"been evaluated. @var{request} is a list of features to be loaded "
"immediately (@pxref{Named Features}). @var{comment} is a string describing "
"the customization."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1388
#, no-wrap
msgid "custom-set-faces &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1391
msgid ""
"This function installs the face customizations specified by @var{args}. "
"Each argument in @var{args} should have the form"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1394
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1467
#, no-wrap
msgid "(@var{face} @var{spec} [@var{now} [@var{comment}]])\n"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1399
msgid ""
"@var{face} is a face name (a symbol), and @var{spec} is the customized face "
"specification for that face (@pxref{Defining Faces})."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1404
msgid ""
"The @var{now} and @var{comment} entries are for internal use only, and may "
"be omitted. @var{now}, if non-@code{nil}, means to install the face "
"specification now, even if the @code{defface} form has not been evaluated. "
"@var{comment} is a string describing the customization."
msgstr ""
#. type: cindex
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1409
#, no-wrap
msgid "custom themes"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1417
msgid ""
"@dfn{Custom themes} are collections of settings that can be enabled or "
"disabled as a unit. @xref{Custom Themes,,, emacs, The GNU Emacs Manual}. "
"Each Custom theme is defined by an Emacs Lisp source file, which should "
"follow the conventions described in this section. (Instead of writing a "
"Custom theme by hand, you can also create one using a Customize-like "
"interface; @pxref{Creating Custom Themes,,, emacs, The GNU Emacs Manual}.)"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1422
msgid ""
"A Custom theme file should be named @file{@var{foo}-theme.el}, where "
"@var{foo} is the theme name. The first Lisp form in the file should be a "
"call to @code{deftheme}, and the last form should be a call to "
"@code{provide-theme}."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1423
#, no-wrap
msgid "deftheme theme &optional doc"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1429
msgid ""
"This macro declares @var{theme} (a symbol) as the name of a Custom theme. "
"The optional argument @var{doc} should be a string describing the theme; "
"this is the description shown when the user invokes the "
"@code{describe-theme} command or types @kbd{?} in the @samp{*Custom Themes*} "
"buffer."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1434
msgid ""
"Two special theme names are disallowed (using them causes an error): "
"@code{user} is a dummy theme that stores the user's direct customization "
"settings, and @code{changed} is a dummy theme that stores changes made "
"outside of the Customize system."
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1436
#, no-wrap
msgid "provide-theme theme"
msgstr ""
#. type: defmac
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1439
msgid ""
"This macro declares that the theme named @var{theme} has been fully "
"specified."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1445
msgid ""
"In between @code{deftheme} and @code{provide-theme} are Lisp forms "
"specifying the theme settings: usually a call to "
"@code{custom-theme-set-variables} and/or a call to "
"@code{custom-theme-set-faces}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1446
#, no-wrap
msgid "custom-theme-set-variables theme &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1450
msgid ""
"This function specifies the Custom theme @var{theme}'s variable settings. "
"@var{theme} should be a symbol. Each argument in @var{args} should be a "
"list of the form"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1458
msgid ""
"where the list entries have the same meanings as in "
"@code{custom-set-variables}. @xref{Applying Customizations}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1460
#, no-wrap
msgid "custom-theme-set-faces theme &rest args"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1464
msgid ""
"This function specifies the Custom theme @var{theme}'s face settings. "
"@var{theme} should be a symbol. Each argument in @var{args} should be a "
"list of the form"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1472
msgid ""
"where the list entries have the same meanings as in "
"@code{custom-set-faces}. @xref{Applying Customizations}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1481
msgid ""
"In theory, a theme file can also contain other Lisp forms, which would be "
"evaluated when loading the theme, but that is bad form. To protect against "
"loading themes containing malicious code, Emacs displays the source file and "
"asks for confirmation from the user before loading any non-built-in theme "
"for the first time. As such, themes are not ordinarily byte-compiled, and "
"source files usually take precedence when Emacs is looking for a theme to "
"load."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1484
msgid ""
"The following functions are useful for programmatically enabling and "
"disabling themes:"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1485
#, no-wrap
msgid "custom-theme-p theme"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1490
msgid ""
"This function return a non-@code{nil} value if @var{theme} (a symbol) is "
"the name of a Custom theme (i.e., a Custom theme which has been loaded into "
"Emacs, whether or not the theme is enabled). Otherwise, it returns "
"@code{nil}."
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1492
#, no-wrap
msgid "custom-known-themes"
msgstr ""
#. type: defvar
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1501
msgid ""
"The value of this variable is a list of themes loaded into Emacs. Each "
"theme is represented by a Lisp symbol (the theme name). The default value "
"of this variable is a list containing two dummy themes: @code{(user "
"changed)}. The @code{changed} theme stores settings made before any Custom "
"themes are applied (e.g., variables set outside of Customize). The "
"@code{user} theme stores settings the user has customized and saved. Any "
"additional themes declared with the @code{deftheme} macro are added to the "
"front of this list."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1503
#, no-wrap
msgid "Command load-theme theme &optional no-confirm no-enable"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1512
msgid ""
"This function loads the Custom theme named @var{theme} from its source file, "
"looking for the source file in the directories specified by the variable "
"@code{custom-theme-load-path}. @xref{Custom Themes,,, emacs, The GNU Emacs "
"Manual}. It also @dfn{enables} the theme (unless the optional argument "
"@var{no-enable} is non-@code{nil}), causing its variable and face settings "
"to take effect. It prompts the user for confirmation before loading the "
"theme, unless the optional argument @var{no-confirm} is non-@code{nil}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1514
#, no-wrap
msgid "require-theme feature &optional noerror"
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1522
msgid ""
"This function searches @code{custom-theme-load-path} for a file that "
"provides @var{feature} and then loads it. This is like the function "
"@code{require} (@pxref{Named Features}), except it searches "
"@code{custom-theme-load-path} instead of @code{load-path} (@pxref{Library "
"Search}). This can be useful in Custom themes that need to load supporting "
"Lisp files when @code{require} is unsuitable for that."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1528
msgid ""
"If @var{feature}, which should be a symbol, is not already present in the "
"current Emacs session according to @code{featurep}, then "
"@code{require-theme} searches for a file named @var{feature} with an added "
"@samp{.elc} or @samp{.el} suffix, in that order, in the directories "
"specified by @code{custom-theme-load-path}."
msgstr ""
#. type: defun
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1536
msgid ""
"If a file providing @var{feature} is successfully found and loaded, then "
"@code{require-theme} returns @var{feature}. The optional argument "
"@var{noerror} determines what happens if the search or loading fails. If it "
"is @code{nil}, the function signals an error; otherwise, it returns "
"@code{nil}. If the file loads successfully but does not provide "
"@var{feature}, then @code{require-theme} signals an error; this cannot be "
"suppressed."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1538
#, no-wrap
msgid "Command enable-theme theme"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1541
msgid ""
"This function enables the Custom theme named @var{theme}. It signals an "
"error if no such theme has been loaded."
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1543
#, no-wrap
msgid "Command disable-theme theme"
msgstr ""
#. type: deffn
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/lispref/customize.texi:1547
msgid ""
"This function disables the Custom theme named @var{theme}. The theme "
"remains loaded, so that a subsequent call to @code{enable-theme} will "
"re-enable it."
msgstr ""