--- a/man/custom.texi	Mon Aug 13 08:51:05 2007 +0200
+++ b/man/custom.texi	Mon Aug 13 08:51:32 2007 +0200
@@ -13,7 +13,7 @@
 @comment  node-name,  next,  previous,  up
 @top The Customization Library
 
-Version: 1.44
+Version: 1.46
 
 @menu
 * Introduction::                
@@ -410,6 +410,7 @@
 * Declaring Groups::            
 * Declaring Variables::         
 * Declaring Faces::             
+* Usage for Package Authors::   
 @end menu
 
 All the customization declarations can be changes by keyword arguments.
@@ -510,7 +511,7 @@
 member.  For other types variables, the effect is undefined."
 @end defun
 
-@node  Declaring Faces,  , Declaring Variables, Declarations
+@node  Declaring Faces, Usage for Package Authors, Declaring Variables, Declarations
 @comment  node-name,  next,  previous,  up
 @subsection Declaring Faces
 
@@ -564,6 +565,22 @@
 
 @end defun
 
+@node Usage for Package Authors,  , Declaring Faces, Declarations
+@comment  node-name,  next,  previous,  up
+@subsection Usage for Package Authors
+
+The recommended usage for the author of a typical emacs lisp package is
+to create one group identifying the package, and make all user options
+and faces members of that group.  If the package has more than around 20
+such options, they should be divided into a number of subgroups, with
+each subgroup being member of the top level group.
+
+The top level group for the package should itself be member of one or
+more of the standard customization groups.  There exists a group for
+each @emph{finder} keyword.  Press @kbd{C-c p} to see a list of finder
+keywords, and add you group to each of them, using the @code{:group}
+keyword. 
+
 @node  Utilities, The Init File, Declarations, Top
 @comment  node-name,  next,  previous,  up
 @section Utilities