* doc/lispref/customize.texi (Variable Definitions): Mention the default :group

for defcustoms.

Fixes: debbugs:13093

2 files changed, 38 insertions, 33 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 702db101549..210897f6de3 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2012-12-06  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+	* customize.texi (Variable Definitions): Mention the default :group
+	for defcustoms (bug#13093).
+
 2012-12-05  Chong Yidong  <cyd@gnu.org>
 
 	* lists.texi (Plist Access): Move put example to Symbol Plists.
@@ -17,7 +22,7 @@
 	* display.texi (Defining Faces):
 	* sequences.texi (Char-Tables): Fix xref.
 
-	* keymaps.texi (Key Sequences): kbd is now a function.
+	* keymaps.texi (Key Sequences): `kbd' is now a function.
 
 	* commands.texi (Using Interactive): Fix index entry.
 
@@ -27,16 +32,14 @@
 	(Windows and Frames): Fix example.  Move description of
 	window-in-direction here.
 	(Recombining Windows): Fix example.
-	(Buffers and Windows): Fix description of
-	replace-buffer-in-windows.
+	(Buffers and Windows): Fix description of replace-buffer-in-windows.
 	(Switching Buffers): Reword.
 	(Display Action Functions): Minor adjustments.
 	(Choosing Window Options): Minor fixes.
 	(Window History): Minor rewording.
 	(Dedicated Windows): Correct and reword part describing how
 	dedicatedness affects functions removing buffers or windows.
-	* buffers.texi (The Buffer List): Fix description of
-	bury-buffer.
+	* buffers.texi (The Buffer List): Fix description of bury-buffer.
 
 2012-11-23  Chong Yidong  <cyd@gnu.org>
 
@@ -97,8 +100,8 @@
 
 	* windows.texi (Choosing Window): Rewrite description of
 	display-buffer-alist (Bug#12167).
-	(Display Action Functions): Mention inhibit-switch-frame.  Fix
-	description of display-buffer-below-selected.  Reorder actions.
+	(Display Action Functions): Mention inhibit-switch-frame.
+	Fix description of display-buffer-below-selected.  Reorder actions.
 	Add example (Bug#12848).
 
 2012-11-15  Stefan Monnier  <monnier@iro.umontreal.ca>
@@ -188,11 +191,11 @@
 	switch-to-buffer-preserve-window-point.
 	(Display Action Functions): Document window-height and
 	window-width alist entries.
-	(Display Action Functions): Document
-	display-buffer-below-selected and
+	(Display Action Functions):
+	Document display-buffer-below-selected and
 	display-buffer-in-previous-window.
-	(Quitting Windows): Document quit-restore-window.  Rewrite
-	section.
+	(Quitting Windows): Document quit-restore-window.
+	Rewrite section.
 	(Window Configurations): In window-state-get mention that
 	argument window must be valid.
 	(Window Parameters): Document quit-restore window parameter
@@ -292,8 +295,8 @@
 	* minibuf.texi (Text from Minibuffer): Document read-regexp
 	changes.
 
-	* nonascii.texi (Selecting a Representation): Document
-	set-buffer-multibyte changes.
+	* nonascii.texi (Selecting a Representation):
+	Document set-buffer-multibyte changes.
 
 	* keymaps.texi (Toolkit Differences): Node deleted.
 	(Easy Menu): New node.
@@ -1065,8 +1068,8 @@
 
 2012-04-12  Jari Aalto  <jari.aalto@cante.net>
 
-	* processes.texi (Synchronous Processes): Mention
-	`default-directory' (bug#7515).
+	* processes.texi (Synchronous Processes):
+	Mention `default-directory' (bug#7515).
 
 2012-04-09  Chong Yidong  <cyd@gnu.org>
 
@@ -1089,8 +1092,8 @@
 
 	* minibuf.texi (Programmed Completion): Remove obsolete variable
 	completion-annotate-function.
-	(Completion Variables): Rename from Completion Styles.  Document
-	completion-extra-properties.  Document completion-styles-alist
+	(Completion Variables): Rename from Completion Styles.
+	Document completion-extra-properties.  Document completion-styles-alist
 	change.
 	(Reading File Names): minibuffer-local-filename-must-match-map is
 	not used anymore.
@@ -1225,8 +1228,8 @@
 	Minor clarifications.
 	(Defining Faces): Copyedits.  Update face example.
 	(Attribute Functions): Mark set-face-foreground etc as commands.
-	(Face Remapping): Mention text-scale-adjust.  Clarify
-	face-remapping-alist and related docs.
+	(Face Remapping): Mention text-scale-adjust.
+	Clarify face-remapping-alist and related docs.
 	(Face Functions): Don't document make-face or copy-face.
 
 2012-03-20  Chong Yidong  <cyd@gnu.org>
@@ -1567,8 +1570,8 @@
 	(Syntax Properties): Document syntax-propertize-function and
 	syntax-propertize-extend-region-functions.
 	(Motion via Parsing): Clarify scan-lists. Fix indentation.
-	(Parser State): Update for the new "c" comment style.  Fix
-	description of item 7 (comment style).
+	(Parser State): Update for the new "c" comment style.
+	Fix description of item 7 (comment style).
 
 	* modes.texi (Minor Modes): Update how mode commands should treat
 	arguments now.
@@ -1646,9 +1649,9 @@
 
 	* debugging.texi (Debugging): Copyedits.  Describe testcover, ERT.
 	(Error Debugging): Note that debug-ignored-errors overrides list
-	values of debug-on-error too.  Add xref to Signaling Errors.  Note
-	that debug-on-signal is not customizable.  Mention
-	condition-case-unless-debug.
+	values of debug-on-error too.  Add xref to Signaling Errors.
+	Note that debug-on-signal is not customizable.
+	Mention condition-case-unless-debug.
 	(Compilation Errors): Node deleted.
 
 	* compile.texi (Compiler Errors): Move a paragraph here from
@@ -1764,15 +1767,15 @@
 2012-02-04  Chong Yidong  <cyd@gnu.org>
 
 	* functions.texi (What Is a Function): Add closures.  Mention
-	"return value" terminology.  Add xref for command-execute.  Remove
-	unused "keystroke command" terminology.
+	"return value" terminology.  Add xref for command-execute.
+	Remove unused "keystroke command" terminology.
 	(Lambda Expressions): Give a different example than in the
 	following subsection.  Add xref to Anonymous Functions.
 	(Function Documentation): Remove gratuitous markup.
 	(Function Names): Move introductory text to `What Is a Function'.
 	(Defining Functions): Fix defun argument spec.
-	(Anonymous Functions): Document lambda macro explicitly.  Mention
-	effects on lexical binding.
+	(Anonymous Functions): Document lambda macro explicitly.
+	Mention effects on lexical binding.
 	(Function Cells): Downplay direct usage of fset.
 	(Closures): New node.
 	(Inline Functions): Remove "open-code" terminology.
@@ -1903,8 +1906,8 @@
 	* variables.texi (Variables, Local Variables, Void Variables):
 	Edit to make the descriptions less specific to dynamic binding.
 	(Local Variables): Default max-specpdl-size is now 1300.
-	(Defining Variables): Edits for lexical scoping.  Delete
-	information about starting docstrings with *.  De-document
+	(Defining Variables): Edits for lexical scoping.
+	Delete information about starting docstrings with *.  De-document
 	user-variable-p.
 	(Tips for Defining): Remove an unimportant discussion of quitting
 	in the middle of a load.
@@ -1992,8 +1995,8 @@
 
 2012-01-06  Chong Yidong  <cyd@gnu.org>
 
-	* variables.texi (Directory Local Variables): Document
-	hack-dir-local-variables-non-file-buffer.
+	* variables.texi (Directory Local Variables):
+	Document hack-dir-local-variables-non-file-buffer.
 
 2012-01-06  Glenn Morris  <rgm@gnu.org>
 
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index 1fb8bb3e71a..14076fe9408 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -303,7 +303,9 @@ evaluate at any time.
 The argument @var{doc} specifies the documentation string for the
 variable.
 
-Every @code{defcustom} should specify @code{:group} at least once.
+If a @code{defcustom} does not specify any @code{:group}, the last group
+defined with @code{defgroup} in the same file will be used.  This way, most
+@code{defcustom} do not need an explicit @code{:group}.
 
 When you evaluate a @code{defcustom} form with @kbd{C-M-x} in Emacs Lisp
 mode (@code{eval-defun}), a special feature of @code{eval-defun}