Re: Problems with whole buffer Custom functions.

[Juri Linkov <juri@jurta.org>]

> Of course, ordinary self-inserting characters _should_ self-insert in
> editable fields.  But note that TAB still moves to next button or
> editable field (I guess that list should now also include "link").

In the patch below I've added "link" to the docstring of `custom-mode'
to custom.texi, and fixed examples in custom.texi since links
in customization buffer don't have square brackets anymore.

Index: lisp/cus-edit.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/cus-edit.el,v
retrieving revision 1.279
diff -c -r1.279 cus-edit.el
*** lisp/cus-edit.el	19 Jan 2006 23:26:04 -0000	1.279
--- lisp/cus-edit.el	22 Jan 2006 00:33:54 -0000
***************
*** 4425,4436 ****
  
  The following commands are available:
  
! Move to next button or editable field.     \\[widget-forward]
! Move to previous button or editable field. \\[widget-backward]
! \\<widget-field-keymap>\
  Complete content of editable text field.   \\[widget-complete]
  \\<custom-mode-map>\
! Invoke button under the mouse pointer.     \\[Custom-move-and-invoke]
  Invoke button under point.		   \\[widget-button-press]
  Set all options from current text.         \\[Custom-set]
  Make values in current text permanent.     \\[Custom-save]
--- 4430,4442 ----
  
  The following commands are available:
  
! \\<widget-keymap>\
! Move to next button, link or editable field.     \\[widget-forward]
! Move to previous button, link or editable field. \\[widget-backward]
! \\<custom-field-keymap>\
  Complete content of editable text field.   \\[widget-complete]
  \\<custom-mode-map>\
! Invoke button under the mouse pointer.     \\[widget-move-and-invoke]
  Invoke button under point.		   \\[widget-button-press]
  Set all options from current text.         \\[Custom-set]
  Make values in current text permanent.     \\[Custom-save]

Index: man/custom.texi
===================================================================
RCS file: /sources/emacs/emacs/man/custom.texi,v
retrieving revision 1.104
diff -c -r1.104 custom.texi
*** man/custom.texi	19 Jan 2006 17:34:34 -0000	1.104
--- man/custom.texi	22 Jan 2006 00:34:47 -0000
***************
*** 202,208 ****
  
    The appearance of the example buffers in this section is typically
  different under a window system, since faces are then used to indicate
! buttons and editable fields.
  
  @menu
  * Groups: Customization Groups.   How settings are classified in a structure.
--- 202,208 ----
  
    The appearance of the example buffers in this section is typically
  different under a window system, since faces are then used to indicate
! buttons, links and editable fields.
  
  @menu
  * Groups: Customization Groups.   How settings are classified in a structure.
***************
*** 232,243 ****
  /- Emacs group: ---------------------------------------------------\
        [State]: visible group members are all at standard values.
     Customization of the One True Editor.
!    See also [Manual].
  
! Editing group: [Go to Group]
  Basic text editing facilities.
  
! External group: [Go to Group]
  Interfacing to external utilities.
  
  @var{more second-level groups}
--- 232,243 ----
  /- Emacs group: ---------------------------------------------------\
        [State]: visible group members are all at standard values.
     Customization of the One True Editor.
!    See also Manual.
  
! Editing group: Go to Group
  Basic text editing facilities.
  
! External group: Go to Group
  Interfacing to external utilities.
  
  @var{more second-level groups}
***************
*** 256,271 ****
  
  @cindex editable fields (customization buffer)
  @cindex buttons (customization buffer)
    Most of the text in the customization buffer is read-only, but it
  typically includes some @dfn{editable fields} that you can edit.
! There are also @dfn{buttons}, which do something when you @dfn{invoke}
! them.  To invoke a button, either click on it with @kbd{Mouse-1}, or
! move point to it and type @key{RET}.
! 
!   For example, the phrase @samp{[Go to Group]} that appears in a
! second-level group is a button.  Invoking it creates a new
! customization buffer, which shows that group and its contents.  This
! is a kind of hypertext link to another group.
  
    The @code{Emacs} group includes a few settings, but mainly it
  contains other groups, which contain more groups, which contain the
--- 256,273 ----
  
  @cindex editable fields (customization buffer)
  @cindex buttons (customization buffer)
+ @cindex links (customization buffer)
    Most of the text in the customization buffer is read-only, but it
  typically includes some @dfn{editable fields} that you can edit.
! There are also @dfn{buttons} and @dfn{links}, which do something when
! you @dfn{invoke} them.  To invoke a button or a link, either click on
! it with @kbd{Mouse-1}, or move point to it and type @key{RET}.
! 
!   For example, the phrase @samp{[State]} that appears in
! a second-level group is a button.  It operates on the same
! customization buffer.  But the phrase @samp{Go to Group} is a kind
! of hypertext link to another group.  Invoking it creates a new
! customization buffer, which shows that group and its contents.
  
    The @code{Emacs} group includes a few settings, but mainly it
  contains other groups, which contain more groups, which contain the
***************
*** 288,295 ****
  @samp{[+]}.  When the group contents are visible, this button changes to
  @samp{[-]}; invoking that hides the group contents.
  
!   Each setting in this buffer has a button which says @samp{[Group]},
! @samp{[Option]} or @samp{[Face]}.  Invoking this button creates an
  ordinary customization buffer showing just that group and its
  contents, just that user option, or just that face.  This is the way
  to change settings that you find with @kbd{M-x customize-browse}.
--- 290,297 ----
  @samp{[+]}.  When the group contents are visible, this button changes to
  @samp{[-]}; invoking that hides the group contents.
  
!   Each setting in this buffer has a link which says @samp{Group},
! @samp{Option} or @samp{Face}.  Invoking this link creates an
  ordinary customization buffer showing just that group and its
  contents, just that user option, or just that face.  This is the way
  to change settings that you find with @kbd{M-x customize-browse}.

-- 
Juri Linkov
http://www.jurta.org/emacs/