From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Thu, 1 Aug 2019 12:48:09 +0000 (+0200)
Subject: Doc string clarification for defcustom
X-Git-Tag: emacs-27.0.90~1780
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=716f8cb1f93473189ace3c5165936bd836792af0;p=emacs.git

Doc string clarification for defcustom

* lisp/custom.el (defcustom): Mention `custom-declare-variable' in
the doc string(bug#22703).
---

diff --git a/lisp/custom.el b/lisp/custom.el
index 736460fec7b..9bd9712b65c 100644
--- a/lisp/custom.el
+++ b/lisp/custom.el
@@ -336,6 +336,11 @@ to load a file defining variables with this form, or with
 _outside_ any bindings for these variables.  (`defvar' and
 `defconst' behave similarly in this respect.)
 
+This macro calls `custom-declare-variable'.  If you want to
+programmatically alter a customizable variable (for instance, to
+write a package that extends the syntax of a variable), you can
+call that functcion directly.
+
 See Info node `(elisp) Customization' in the Emacs Lisp manual
 for more information."
   (declare (doc-string 3) (debug (name body)))