From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Leo Liu Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r117133: * doc/lispref/sequences.texi (Sequence Functions): Update nreverse. Date: Thu, 22 May 2014 08:22:59 +0800 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1400718300 23193 80.91.229.3 (22 May 2014 00:25:00 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 May 2014 00:25:00 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu May 22 02:24:53 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 1WnGoW-0001Rj-7J for ged-emacs-devel@m.gmane.org; Thu, 22 May 2014 02:24:52 +0200 Original-Received: from localhost ([::1]:34160 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnGoV-0007tk-FF for ged-emacs-devel@m.gmane.org; Wed, 21 May 2014 20:24:51 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55261) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnGoK-0007nh-AB for emacs-devel@gnu.org; Wed, 21 May 2014 20:24:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WnGoB-0003dE-2W for emacs-devel@gnu.org; Wed, 21 May 2014 20:24:40 -0400 Original-Received: from mail-pb0-x229.google.com ([2607:f8b0:400e:c01::229]:37295) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnGoA-0003d0-Qc for emacs-devel@gnu.org; Wed, 21 May 2014 20:24:30 -0400 Original-Received: by mail-pb0-f41.google.com with SMTP id uo5so1928371pbc.0 for ; Wed, 21 May 2014 17:24:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:face:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=KnbyS+EeQHLc3q1GPNENsD93MfTHPMKnV8ucek/tWoc=; b=yE+t6bRm6y3Y9NjzO2j+tHM6lWthkPTez7uW0axF2K1vPnJ5xpGQj0A3kZAWGJTJRN JrzCAWUAYmcmeaqh4xC9FvoQDcaktEKV7ybwAM109WFhPIUtUB0R1yKcEPFRHuoLEc3+ wnMePJ9p0PmRinMz1VCTZfGKCz5UkBs8BiNVErZy2ulKQVUXyPUZWSv8S/IsGRMrrJQg PD0q78DGbgp1j5GOR2hn6AkwuJXom5XKJNM9BS7r4MANODUG2XeYuicDaUKw3L+pVjRG JrSL5Q4oipKvGalMVFYO+wUuEWgXNgT6/9gU6V3yVx3r8IZt8YN+EtfG2kFyyIqCYp1P iwIg== X-Received: by 10.66.165.100 with SMTP id yx4mr198733pab.110.1400718269217; Wed, 21 May 2014 17:24:29 -0700 (PDT) Original-Received: from fortuna ([123.119.93.100]) by mx.google.com with ESMTPSA id py7sm9975798pbb.78.2014.05.21.17.24.18 for (version=TLSv1.1 cipher=RC4-SHA bits=128/128); Wed, 21 May 2014 17:24:28 -0700 (PDT) Face: iVBORw0KGgoAAAANSUhEUgAAACgAAAAoBAMAAAB+0KVeAAAAMFBMVEUaFRZLMy1dTENxVzKQ WiCrXQ97cmO/dSqSh3akjGTApXy5sJ7Sxo/Sz8Xo6eP9//xJbkruAAAAAWJLR0QAiAUdSAAAAAlw SFlzAAACxQAAAsUBidZ/7wAAAAd0SU1FB9cBBwMJOwHXewoAAAIBSURBVCjPVdNBiNNAFADQ6J4F x3hThHZBBC+WCFI8SS0iezRDcMHLHkLAg6gJH/fgYQ9xYlj2sLK4KHgqCgXFhda2Idmr4kkQPZQ0 nkQMbTypbMmMM2m7ZgYSmMef/5OZPwo7HFnx3uKPcmj0Dht1LWZJ+Hvr7dIFZXRUwl9VRTuuKDJ+ U44gjscknK4hhJaCkYRsWjmBtLqXlJAG2wipNe18OZJu1BBq1E8xafl4s6Jq2mUZGftU1y7CCxnp FVUDWJXx4C66BKBnErbuoaYNtoRTu6EZBsCbMn7W+5qOAR6WvxNOby9jHWC9hAf3n304CdiAByXs 3Nh9roLDkyb/sWV712vYwaLSAn8CPMHIAAzOPDKP2COAFm4Y4ODVWc6xG7KXsN7UeUJjjimx2uwd gCgNhr0i8C/xyCD5CiCKAMY3Bf5oDzx//w/fimscdcAZU2jv9sedx6+nYPPFIoWI/GK6QZ+EFGOR ErAjCnV3vPZ7XqlTIMbOLY7fLcvvmT7rXNWaGDexIY44N12TG2PDp7vqyl57dnCeuWwyNpnEURxk fTbDYeBnKRn4oejPYI4sH6WviBumEZ/GxX4X/x6EcURFZ7E071bjQGAxpcOAEOJuTiroDEea5Szv rVWLYfl7ZiQwSUToxrkux7OLixAWGz22+HIyWTRYcVfomOwvzusfjtVIGgLHf3MAAAAASUVORK5C YII= In-Reply-To: (Stefan Monnier's message of "Wed, 21 May 2014 08:38:32 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (CentOS 6.5) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:400e:c01::229 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:172009 Archived-At: 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: