emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Emacs-diffs] trunk r117133: * doc/lispref/sequences.texi (Sequence


From: Stefan Monnier
Subject: Re: [Emacs-diffs] trunk r117133: * doc/lispref/sequences.texi (Sequence Functions): Update nreverse.
Date: Wed, 21 May 2014 08:38:32 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (gnu/linux)

>    This function reverses the order of the elements of @var{seq}.
> -If @var{seq} is a list, @code{nreverse} alters its by reversing the @sc{cdr}s
> +If @var{seq} is a list, @code{nreverse} alters it by reversing the @sc{cdr}s
>  in the cons cells.  The cons cell that used to be the last one in @var{seq}
>  becomes the first cons cell of the value.  If @var{seq} is a vector or
> -bool vector, its items are placed in the same vector in a reversed order.
> +bool vector, its items are placed in the same vector in a reversed
> +order.  If @var{seq} is a string, it works like @code{reverse} i.e., no
> +destructive modifcation in preference to treat strings as immutable.
 
The docstring is good, but the above manual entry is too specific.
We don't want to specify when side-effects are used and when not.


        Stefan



reply via email to

[Prev in Thread] Current Thread [Next in Thread]