3855 lines
133 KiB
Plaintext
3855 lines
133 KiB
Plaintext
# SOME DESCRIPTIVE TITLE
|
|
# Copyright (C) YEAR Free Software Foundation, Inc.
|
|
# This file is distributed under the same license as the PACKAGE package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: PACKAGE VERSION\n"
|
|
"POT-Creation-Date: 2021-11-07 12:11+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"Language: \n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#. type: 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 ""
|