* bug#15820: 24.3.50; (elisp) `File Local Variables'
@ 2013-11-06 17:09 Drew Adams
2013-11-06 18:01 ` Glenn Morris
0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2013-11-06 17:09 UTC (permalink / raw)
To: 15820
This part of the text is unclear:
When defining a user option using `defcustom', you can set its
`safe-local-variable' property by adding the arguments `:safe FUNCTION'
to `defcustom'
FUNCTION needs to be described here. Just say that FUNCTION is the same
as the function used as the value of property `safe-local-variable'.
That will provide readers the understanding that FUNCTION "has to be a
function of one argument; any value is safe if the function returns
non-`nil' given that value."
In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
of 2013-10-19 on LEG570
Bzr revision: 114715 rgm@gnu.org-20131019023520-s8mwtib7xcx9e05w
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --enable-checking 'CFLAGS=-O0 -g3' CPPFLAGS=-DGLYPH_DEBUG=1'
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#15820: 24.3.50; (elisp) `File Local Variables'
2013-11-06 17:09 bug#15820: 24.3.50; (elisp) `File Local Variables' Drew Adams
@ 2013-11-06 18:01 ` Glenn Morris
2013-11-06 18:17 ` Drew Adams
2013-11-06 19:56 ` Michael Heerdegen
0 siblings, 2 replies; 4+ messages in thread
From: Glenn Morris @ 2013-11-06 18:01 UTC (permalink / raw)
To: 15820
Drew Adams wrote:
> This part of the text is unclear:
>
> When defining a user option using `defcustom', you can set its
> `safe-local-variable' property by adding the arguments `:safe FUNCTION'
> to `defcustom'
>
> FUNCTION needs to be described here. Just say that FUNCTION is the same
> as the function used as the value of property `safe-local-variable'.
It is explained in the immediately previous paragraph.
Repeating it seems unnecessarily verbose, and we all hate unnecessary
verbosity, don't we?
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#15820: 24.3.50; (elisp) `File Local Variables'
2013-11-06 18:01 ` Glenn Morris
@ 2013-11-06 18:17 ` Drew Adams
2013-11-06 19:56 ` Michael Heerdegen
1 sibling, 0 replies; 4+ messages in thread
From: Drew Adams @ 2013-11-06 18:17 UTC (permalink / raw)
To: Glenn Morris, 15820
> > This part of the text is unclear:
> >
> > When defining a user option using `defcustom', you can set its
> > `safe-local-variable' property by adding the arguments `:safe
> > FUNCTION' to `defcustom'
> >
> > FUNCTION needs to be described here. Just say that FUNCTION is
> > the same as the function used as the value of property
> > `safe-local-variable'.
>
> It is explained in the immediately previous paragraph.
FUNCTION is not described there. What is described there is the
function that is the value of property `safe-local-variable'.
But I was mistaken that the connection between the two is not made
clear. They are connected in the same sentence, by saying that
:safe FUNCTION _sets_ the property. It is reasonable to assume
that FUNCTION is used as the value that is set. Not a bug. Thx.
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#15820: 24.3.50; (elisp) `File Local Variables'
2013-11-06 18:01 ` Glenn Morris
2013-11-06 18:17 ` Drew Adams
@ 2013-11-06 19:56 ` Michael Heerdegen
1 sibling, 0 replies; 4+ messages in thread
From: Michael Heerdegen @ 2013-11-06 19:56 UTC (permalink / raw)
To: Glenn Morris; +Cc: 15820
Glenn Morris <rgm@gnu.org> writes:
> It is explained in the immediately previous paragraph.
> Repeating it seems unnecessarily verbose, and we all hate unnecessary
> verbosity, don't we?
Don't be so schnippisch!
Regards,
Michael.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2013-11-06 19:56 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-11-06 17:09 bug#15820: 24.3.50; (elisp) `File Local Variables' Drew Adams
2013-11-06 18:01 ` Glenn Morris
2013-11-06 18:17 ` Drew Adams
2013-11-06 19:56 ` Michael Heerdegen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).