From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r117133: * doc/lispref/sequences.texi (Sequence Functions): Update nreverse. Date: Wed, 21 May 2014 08:38:32 -0400 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1400675939 2810 80.91.229.3 (21 May 2014 12:38:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 21 May 2014 12:38:59 +0000 (UTC) Cc: emacs-devel@gnu.org To: Leo Liu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed May 21 14:38:52 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Wn5nI-0002Bn-4o for ged-emacs-devel@m.gmane.org; Wed, 21 May 2014 14:38:52 +0200 Original-Received: from localhost ([::1]:59437 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wn5nH-0004Pg-K9 for ged-emacs-devel@m.gmane.org; Wed, 21 May 2014 08:38:51 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49607) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wn5n8-0004Og-8d for emacs-devel@gnu.org; Wed, 21 May 2014 08:38:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Wn5n0-0006ib-La for emacs-devel@gnu.org; Wed, 21 May 2014 08:38:42 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:15954) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wn5n0-0006iX-HD for emacs-devel@gnu.org; Wed, 21 May 2014 08:38:34 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ArUGAIDvNVPO+KQe/2dsb2JhbABZgwaDSsA9gRcXdIIlAQEBAQIBViMFCwsOJgcLFBgNJIgECNIZF456B4Q4BJRilDeBaoFxgVsh X-IPAS-Result: ArUGAIDvNVPO+KQe/2dsb2JhbABZgwaDSsA9gRcXdIIlAQEBAQIBViMFCwsOJgcLFBgNJIgECNIZF456B4Q4BJRilDeBaoFxgVsh X-IronPort-AV: E=Sophos;i="4.97,753,1389762000"; d="scan'208";a="63507733" Original-Received: from 206-248-164-30.dsl.teksavvy.com (HELO pastel.home) ([206.248.164.30]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 21 May 2014 08:38:32 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id 297A2601F5; Wed, 21 May 2014 08:38:32 -0400 (EDT) In-Reply-To: (Leo Liu's message of "Wed, 21 May 2014 04:00:52 +0000") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.181 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:171985 Archived-At: > 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