From: Samuel Bronson <naesten@gmail.com>
To: 10635@debbugs.gnu.org
Subject: bug#10635: 23.3; Docstring for `defcustom' fails to mention that `:safe' keyword takes a predicate.
Date: Sat, 28 Jan 2012 19:34:44 -0500 [thread overview]
Message-ID: <87y5sr9wij.fsf@naesten.dyndns.org> (raw)
I've taken the liberty of creating a patch, in which I also fix a
`checkdoc' warning:
diff -u -L /usr/share/emacs/23.3/lisp/custom.el.gz -L /tmp/buffer-content-21867Fhg /tmp/jka-com21867Srm /tmp/buffer-content-21867Fhg
--- /usr/share/emacs/23.3/lisp/custom.el.gz
+++ /tmp/buffer-content-21867Fhg
@@ -197,7 +197,7 @@
Neither SYMBOL nor VALUE need to be quoted.
If SYMBOL is not already bound, initialize it to VALUE.
-The remaining arguments should have the form
+The remaining arguments (ARGS) should have the form
[KEYWORD VALUE]...
@@ -222,7 +222,9 @@
for this option, then when your `.emacs' file loads the value,
it does (require VALUE) first.
:risky Set SYMBOL's `risky-local-variable' property to VALUE.
-:safe Set SYMBOL's `safe-local-variable' property to VALUE.
+:safe Set SYMBOL's `safe-local-variable' property to VALUE,
+ a predicate telling whether any given value is safe for the
+ variable. See Info node `(elisp) File Local Variables'.
The following common keywords are also meaningful.
Diff finished. Sat Jan 28 19:22:47 2012
In GNU Emacs 23.3.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
of 2011-10-25 on murphy, modified by Debian
configured using `configure '--build' 'i486-linux-gnu' '--build' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs23:/etc/emacs:/usr/local/share/emacs/23.3/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/23.3/site-lisp:/usr/share/emacs/site-lisp' '--with-crt-dir=/usr/lib/i386-linux-gnu' '--with-x=yes' '--with-x-toolkit=lucid' '--with-toolkit-scroll-bars' '--without-gconf' 'build_alias=i486-linux-gnu' 'CFLAGS=-DDEBIAN -g -O2''
--
Hi! I'm a .signature virus! Copy me into your ~/.signature to help me spread!
next reply other threads:[~2012-01-29 0:34 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-01-29 0:34 Samuel Bronson [this message]
2012-01-29 10:03 ` bug#10635: 23.3; Docstring for `defcustom' fails to mention that `:safe' keyword takes a predicate Chong Yidong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87y5sr9wij.fsf@naesten.dyndns.org \
--to=naesten@gmail.com \
--cc=10635@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.