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: Leo Liu
Subject: Re: [Emacs-diffs] trunk r117133: * doc/lispref/sequences.texi (Sequence Functions): Update nreverse.
Date: Thu, 22 May 2014 08:22:59 +0800
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (CentOS 6.5)

On 2014-05-21 08:38 -0400, Stefan Monnier wrote:
> 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.

Do you mean simplify the doc to something like this:

=== modified file 'doc/lispref/sequences.texi'
--- doc/lispref/sequences.texi  2014-05-21 03:49:58 +0000
+++ doc/lispref/sequences.texi  2014-05-22 00:21:12 +0000
@@ -265,12 +265,7 @@
 @cindex reversing a list
 @cindex reversing a vector
   This function reverses the order of the elements of @var{seq}.
-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.  If @var{seq} is a string, it works like @code{reverse} i.e., no
-destructive modifcation in preference to treat strings as immutable.
+The original @var{seq} may be modified.
 
   For example:



reply via email to

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