GNU bug report logs - #13437
24.3.50; doc of `but-last'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 13437 in the body.
You can then email your comments to 13437 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.3.50; doc of `but-last'
Date: Mon, 14 Jan 2013 09:39:45 -0800

Doc string:
 
 Return a copy of LIST with the last N elements removed.
 
It is better for the first line to describe the behavior with null
optional args.  E.g.:
 
 Return a copy of LIST with the last element removed.
 Optional arg N is the number of elements to remove.
 
Similarly, the doc string of `nbutlast' - e.g.,
 
 Modify LIST by removing the last element.
 Optional arg N is the number of elements to remove.

In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600)
 of 2012-12-31 on ODIEONE
Bzr revision: 111388 rudalics <at> gmx.at-20121231113513-subz2dazg6yjukzh
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.7) --no-opt --enable-checking --cflags
 -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'

Message #10 received at 13437 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Glenn Morris <rgm <at> gnu.org>
Cc: 13437 <at> debbugs.gnu.org
Subject: Re: control message for bug 13437
Date: Fri, 31 Jan 2014 23:48:25 -0800

Glenn Morris <rgm <at> gnu.org> writes:

> # cf forward-char, forward-line etc etc
> tag 13437 wontfix

forward-char is an interactive built-in function in `C source code'.

[...]

If N is omitted or nil, move point 1 character forward.
----

I think it would make sense to say what an omitted N in butlast means.

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

Message #13 received at 13437 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 13437 <at> debbugs.gnu.org
Subject: Re: bug#13437: 24.3.50; doc of `but-last'
Date: Fri, 31 Jan 2014 23:55:16 -0800

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

> Doc string:
>
>  Return a copy of LIST with the last N elements removed.
>
> It is better for the first line to describe the behavior with null
> optional args.  E.g.:
>
>  Return a copy of LIST with the last element removed.
>  Optional arg N is the number of elements to remove.
>
> Similarly, the doc string of `nbutlast' - e.g.,
>
>  Modify LIST by removing the last element.
>  Optional arg N is the number of elements to remove.

Fixed now.

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

Message #20 received at 13437 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: 13437 <at> debbugs.gnu.org
Subject: Re: bug#13437: control message for bug 13437
Date: Sat, 01 Feb 2014 14:58:35 -0500

Lars Ingebrigtsen wrote:

> Glenn Morris <rgm <at> gnu.org> writes:
>
>> # cf forward-char, forward-line etc etc
>> tag 13437 wontfix
>
> forward-char is an interactive built-in function in `C source code'.
>
> [...]
>
> If N is omitted or nil, move point 1 character forward.

forward-char did not use to say that until recently (and forward-line
etc still does not).

Pretending it's not obvious that N defaults to 1 for all such functions
is just being tediously literal-minded IMO.

But it's obviously not worth arguing about.

Previous Next

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