Re: fancy-splash-screen customize group...

[Lennart Borgman]

Richard M. Stallman wrote:

> I don't want to make these changes, for the following reasons:
>
>    ! * Saving Customizations::    How to save customizations in a different 
> file.
>    !                                 And why they can not be saved when emacs 
> was
>    !                                 invoked with -Q.
>
> Menu items should not be that detailed--it is clumsy.
>  
Ok, I have removed removed "And why ..."

>    + @node Searching for Options
>    + @subsection Searching for Options
>    + 
>    +   You can search for customization options and groups by name using
>    + regular expressions. The search functions are available in the menus
>    + under Options - Customize Emacs.  See also the function
>    + customize-apropos in (@pxref{Specific Customization}).
>
> Such small nodes are wasteful and undesirable.
>  
I do not understand why they are wasteful, but I have added some more 
information which I believe is useful.

>      @item M-x customize-apropos @key{RET} @var{regexp} @key{RET}
>      Set up a customization buffer with all the variables, faces and groups
>    ! that match @var{regexp}. There are also more specific functions:
>    ! customize-apropos-options, customize-apropos-faces and
>    ! customize-apropos-groups.
>
> In a table which is structured as one command per item,
> it is inconsistent to mention other commands in the same item.
>  
I removed customize-apropos-* here.

I have attached a new patch.

> I do not see why it is worth documenting customize-apropos-options,
> etc.  customize-apropos seems to be good enough.
>  
Maybe customize-apropos should prompt for searching just options, faces 
or groups?
Index: custom.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/custom.texi,v
retrieving revision 1.95
diff -c -r1.95 custom.texi
*** custom.texi 10 Dec 2005 00:46:09 -0000      1.95
--- custom.texi 10 Dec 2005 14:29:08 -0000
***************
*** 206,213 ****
  
  @menu
  * Groups: Customization Groups.   How options are classified in a structure.
  * Changing a Variable::      How to edit a value and set an option.
! * Saving Customizations::    Details of saving customizations.
  * Face Customization::       How to edit the attributes of a face.
  * Specific Customization::   Making a customization buffer for specific
                                  variables, faces, or groups.
--- 206,214 ----
  
  @menu
  * Groups: Customization Groups.   How options are classified in a structure.
+ * Searching: Searching for Options.    How to search for options using 
regexps.
  * Changing a Variable::      How to edit a value and set an option.
! * Saving Customizations::    How to save customizations in a different file.
  * Face Customization::       How to edit the attributes of a face.
  * Specific Customization::   Making a customization buffer for specific
                                  variables, faces, or groups.
***************
*** 290,295 ****
--- 291,314 ----
  that active field creates an ordinary customization buffer showing just
  that group and its contents, just that variable, or just that face.
  This is the way to set values in it.
+ 
+ @node Searching for Options
+ @subsection Searching for Options
+ 
+   You can search for customization options and groups by name using
+ regular expressions.  The search result is shown in the customization
+ buffer which is setup with all matching options of the choosen kind.
+ 
+   To start a search you can use @kbd{M-x customize-apropos} (see
+ @pxref{Specific Customization}).  The search functions are also
+ available in the menus under Options - Customize Emacs.
+ 
+   Tip 1: In the customization buffer you can use @pxref{Incremental
+ Search} like in any other buffer.
+ 
+   Tip 2: If you did not find exactly what you searched for you may find
+ the links to `Parent groups' (if there are any parent groups) beneath
+ the options in the customization buffer useful.
  
  @node Changing a Variable
  @subsection Changing a Variable