GNU bug report logs - #10346
24.0.92; doc string of `save-buffer'

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 10346 <at> debbugs.gnu.org
Subject: bug#10346: 24.0.92; doc string of `save-buffer'
Date: Sat, 08 Feb 2014 21:35:45 -0800

"Drew Adams" <drew.adams <at> oracle.com> writes:

> Please describe the optional argument ARGS (which should be called ARG,
> BTW, since it is not &rest and it is not a cons in general).

Fixed on trunk.

> The doc string talks about the prefix arg, but no connection is made to
> ARGS for use in Lisp.

Yes.  But the values for ARG are so...  non-Lispey, I have a feeling
that it's been left off by choice.  The values are basically 0, 4, 16
and 64, which are ... kinda opaque when calling a function like that.

I don't know.  Should these values be documented or not?

> Furthermore, "With a numeric argument of 0" is incorrect and misleads.
> For an interactive user, this should be stated in terms of the numeric
> value of the prefix argument, not just "a numeric argument".

Fixed on trunk.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.