comparison lisp/custom.el @ 42503:e95910976840

(defcustom): Documented :tag, :link and :load.

42502:3822dd3de3da

;;; custom.el --- tools for declaring and initializing options
;;
;; Copyright (C) 1996, 1997, 1999, 2001 Free Software Foundation, Inc.
;;
;; Author: Per Abrahamsen <[e-mail]>
;; Maintainer: FSF
;; Keywords: help, faces

:type	VALUE should be a widget type for editing the symbols value.
:options VALUE should be a list of valid members of the widget type.
:group  VALUE should be a customization group.
        Add SYMBOL to that group.
:initialize
	VALUE should be a function used to initialize the
	variable.  It takes two arguments, the symbol and value
	given in the `defcustom' call.  The default is
	`custom-initialize-reset'.

	it does (require VALUE) first.
:version
        VALUE should be a string specifying that the variable was
        first introduced, or its default value was changed, in Emacs
        version VERSION.
:set-after VARIABLE
	Specifies that SYMBOL should be set after VARIABLE when
	both have been customized.

Read the section about customization in the Emacs Lisp manual for more

42503:e95910976840

;;; custom.el --- tools for declaring and initializing options
;;
;; Copyright (C) 1996, 1997, 1999, 2001, 2002 Free Software Foundation, Inc.
;;
;; Author: Per Abrahamsen <[e-mail]>
;; Maintainer: FSF
;; Keywords: help, faces

:type	VALUE should be a widget type for editing the symbols value.
:options VALUE should be a list of valid members of the widget type.
:group  VALUE should be a customization group.
        Add SYMBOL to that group.
:link LINK-DATA'
        Include an external link after the documentation string for this
        item.  This is a sentence containing an active field which
        references some other documentation.
   
        There are three alternatives you can use for LINK-DATA:
   
        `(custom-manual INFO-NODE)'
             Link to an Info node; INFO-NODE is a string which specifies
             the node name, as in `\"(emacs)Top\"'.  The link appears as
             `[manual]' in the customization buffer.
   
        `(info-link INFO-NODE)'
             Like `custom-manual' except that the link appears in the
             customization buffer with the Info node name.
   
        `(url-link URL)'
             Link to a web page; URL is a string which specifies the URL.
             The link appears in the customization buffer as URL.
   
        You can specify the text to use in the customization buffer by
        adding `:tag NAME' after the first element of the LINK-DATA; for
        example, `(info-link :tag \"foo\" \"(emacs)Top\")' makes a link to the
        Emacs manual which appears in the buffer as `foo'.
   
        An item can have more than one external link; however, most items
        have none at all.
:initialize
	VALUE should be a function used to initialize the
	variable.  It takes two arguments, the symbol and value
	given in the `defcustom' call.  The default is
	`custom-initialize-reset'.

	it does (require VALUE) first.
:version
        VALUE should be a string specifying that the variable was
        first introduced, or its default value was changed, in Emacs
        version VERSION.
:tag LABEL
        Use LABEL, a string, instead of the item's name, to label the item
        a  in customization menus and buffers.
:load FILE
        Load file FILE (a string) before displaying this customization
        item.  Loading is done with `load-library', and only if the file is
        not already loaded.
:set-after VARIABLE
	Specifies that SYMBOL should be set after VARIABLE when
	both have been customized.

Read the section about customization in the Emacs Lisp manual for more