[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/customize.texi
From: |
Richard M . Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/customize.texi |
Date: |
Mon, 07 Mar 2005 22:06:04 -0500 |
Index: emacs/lispref/customize.texi
diff -c emacs/lispref/customize.texi:1.41 emacs/lispref/customize.texi:1.42
*** emacs/lispref/customize.texi:1.41 Sat Jan 29 13:55:46 2005
--- emacs/lispref/customize.texi Tue Mar 8 03:06:04 2005
***************
*** 84,96 ****
not already loaded.
@item :require @var{feature}
! Require feature @var{feature} (a symbol) when installing a value for
! this item (an option or a face) that was saved using the customization
! feature. This is done by calling @code{require}.
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.
@end table
@node Group Definitions
--- 84,100 ----
not already loaded.
@item :require @var{feature}
! Execute @code{(require '@var{feature})} when your saved customizations
! set the value of this item. @var{feature} should be a symbol.
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.
+
+ @item :version @var{version}
+ This option 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.
@end table
@node Group Definitions
***************
*** 130,146 ****
Useful widgets are @code{custom-variable} for a variable,
@code{custom-face} for a face, and @code{custom-group} for a group.
! When a new group is introduced into Emacs, use this keyword in
! @code{defgroup}:
!
! @table @code
! @item :version @var{version}
! This option specifies that the group was first introduced in Emacs
! version @var{version}. The value @var{version} must be a string.
! @end table
!
! Tag the group with a version like this when it is introduced, rather
! than the individual members (@pxref{Variable Definitions}).
In addition to the common keywords (@pxref{Common Keywords}), you can
also use this keyword in @code{defgroup}:
--- 134,142 ----
Useful widgets are @code{custom-variable} for a variable,
@code{custom-face} for a face, and @code{custom-group} for a group.
! 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.
In addition to the common keywords (@pxref{Common Keywords}), you can
also use this keyword in @code{defgroup}:
***************
*** 223,248 ****
@code{hook}, @code{plist} and @code{alist}. See the definition of the
individual types for a description of how to use @code{:options}.
- @item :version @var{version}
- This option specifies that the variable was first introduced, or its
- default value was changed, in Emacs version @var{version}. The value
- @var{version} must be a string. For example,
-
- @example
- (defcustom foo-max 34
- "*Maximum number of foo's allowed."
- :type 'integer
- :group 'foo
- :version "20.3")
- @end example
-
@item :set @var{setfunction}
! Specify @var{setfunction} as the way to change the value of this option.
! The function @var{setfunction} should take two arguments, a symbol 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). The default for @var{setfunction} is
! @code{set-default}.
@item :get @var{getfunction}
Specify @var{getfunction} as the way to extract the value of this
--- 219,231 ----
@code{hook}, @code{plist} and @code{alist}. See the definition of the
individual types for a description of how to use @code{:options}.
@item :set @var{setfunction}
! Specify @var{setfunction} as the way to change the value of this
! option. 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). The default for
! @var{setfunction} is @code{set-default}.
@item :get @var{getfunction}
Specify @var{getfunction} as the way to extract the value of this
***************
*** 258,267 ****
that really is stored in a Lisp variable.
@item :initialize @var{function}
! @var{function} should be a function used to initialize the variable when
! the @code{defcustom} is evaluated. It should take two arguments, the
! symbol and value. Here are some predefined functions meant for use in
! this way:
@table @code
@item custom-initialize-set
--- 241,250 ----
that really is stored in a Lisp variable.
@item :initialize @var{function}
! @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:
@table @code
@item custom-initialize-set
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/lispref/customize.texi,
Richard M . Stallman <=