bug#13437: 24.3.50; doc of `but-last'

bug#13437: 24.3.50; doc of `but-last'

[Drew Adams]

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@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'

bug#13437: control message for bug 13437

[Lars Ingebrigtsen]

Glenn Morris <rgm@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/

bug#13437: 24.3.50; doc of `but-last'

[Lars Ingebrigtsen]

"Drew Adams" <drew.adams@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/

bug#13437: control message for bug 13437

[Glenn Morris]

Lars Ingebrigtsen wrote:

> Glenn Morris <rgm@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.