Mercurial > hg > xemacs-beta
diff man/custom.texi @ 136:b980b6286996 r20-2b2
Import from CVS: tag r20-2b2
author | cvs |
---|---|
date | Mon, 13 Aug 2007 09:31:12 +0200 |
parents | 34a5b81f86ba |
children | 538048ae2ab8 |
line wrap: on
line diff
--- a/man/custom.texi Mon Aug 13 09:30:13 2007 +0200 +++ b/man/custom.texi Mon Aug 13 09:31:12 2007 +0200 @@ -13,7 +13,7 @@ @comment node-name, next, previous, up @top The Customization Library -Version: 1.89 +Version: 1.84 @menu * Introduction:: @@ -492,50 +492,9 @@ @table @code @item :type @var{value} should be a widget type. - @item :options @var{value} should be a list of possible members of the specified type. For hooks, this is a list of function names. - -@item :initialize -@var{value} should be a function used to initialize the variable. It -takes two arguments, the symbol and value given in the @code{defcustom} call. -Some predefined functions are: - -@table @code -@item custom-initialize-set -Use the @code{:set} method to initialize the variable. Do not -initialize it if already bound. This is the default @code{:initialize} -method. - -@item custom-initialize-default -Always use @code{set-default} to initialize the variable, even if a -@code{:set} method has been specified. - -@item custom-initialize-reset -If the variable is already bound, reset it by calling the @code{:set} -method with the value returned by the @code{:get} method. - -@item custom-initialize-changed -Like @code{custom-initialize-reset}, but use @code{set-default} to -initialize the variable if it is not bound and has not been set -already. -@end table - -@item :set -@var{value} should be a function to set the value of the symbol. It -takes two arguments, the symbol to set and the value to give it. The -default is @code{set-default}. - -@item :get -@var{value} should be a function to extract the value of symbol. The -function takes one argument, a symbol, and should return the current -value for that symbol. The default is @code{default-value}. - -@item :require -@var{value} should be a feature symbol. Each feature will be required -after initialization, of the the user have saved this option. - @end table @xref{Sexp Types,,,widget,The Widget Library}, for information about @@ -606,7 +565,7 @@ Internally, custom uses the symbol property @code{factory-face} for the program specified default face properties, @code{saved-face} for -properties saved by the user, and @code{face-documentation} for the +properties saved by the user, and @code{face-doc-string} for the documentation string.@refill @end defun @@ -675,6 +634,11 @@ @section Wishlist @itemize @bullet +@item +The menu items should be grayed out when the information is +missing. I.e. if a variable doesn't have a factory setting, the user +should not be allowed to select the @samp{Factory} menu item. + @item Better support for keyboard operations in the customize buffer. @@ -699,6 +663,10 @@ Make it possible to append to `choice', `radio', and `set' options. @item +Make it possible to customize code, for example to enable or disable a +global minor mode. + +@item Ask whether set or modified variables should be saved in @code{kill-buffer-hook}. @@ -721,32 +689,6 @@ Make it possible to include a comment/remark/annotation when saving an option. -@item -Add some direct support for meta variables, i.e. make it possible to -specify that this variable should be reset when that variable is -changed. - -@item -Add tutorial. - -@item -Describe the @code{:type} syntax in this manual. - -@item -Find a place is this manual for the following text: - -@strong{Radio vs. Buttons} - -Use a radio if you can't find a good way to describe the item in the -choice menu text. I.e. it is better to use a radio if you expect the -user would otherwise manually select each item from the choice menu in -turn to see what it expands too. - -Avoid radios if some of the items expands to complex structures. - -I mostly use radios when most of the items are of type -@code{function-item} or @code{variable-item}. - @end itemize @contents