[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: