From 1cbae532a06b6ca7d3317a8f4e8067d247dd901e Mon Sep 17 00:00:00 2001
From: Stefan Monnier <monnier@iro.umontreal.ca>
Date: Thu, 6 Dec 2012 13:26:11 -0500
Subject: [PATCH] * doc/lispref/customize.texi (Variable Definitions): Mention
the default :group for defcustoms.
Fixes: debbugs:13093
---
doc/lispref/ChangeLog | 67 ++++++++++++++++++++------------------
doc/lispref/customize.texi | 4 ++-
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}
--
2.39.5