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 21:47:04 -0400 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1400723257 6800 80.91.229.3 (22 May 2014 01:47:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 May 2014 01:47:37 +0000 (UTC) Cc: emacs-devel@gnu.org To: Leo Liu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu May 22 03:47:30 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 1WnI6T-000652-31 for ged-emacs-devel@m.gmane.org; Thu, 22 May 2014 03:47:29 +0200 Original-Received: from localhost ([::1]:34320 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnI6S-0002fo-Oe for ged-emacs-devel@m.gmane.org; Wed, 21 May 2014 21:47:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47564) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnI6J-0002fP-4s for emacs-devel@gnu.org; Wed, 21 May 2014 21:47:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WnI6B-0002bQ-LV for emacs-devel@gnu.org; Wed, 21 May 2014 21:47:19 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:43970) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnI6B-0002bL-Gj for emacs-devel@gnu.org; Wed, 21 May 2014 21:47:11 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ArUGAIDvNVPO+KQe/2dsb2JhbABZgwaDSsA9gRcXdIIlAQEBAQIBViMQCw4mBwsUGA0kiAQI0hkXjnoHhDgEqRmBaoFxgVsh X-IPAS-Result: ArUGAIDvNVPO+KQe/2dsb2JhbABZgwaDSsA9gRcXdIIlAQEBAQIBViMQCw4mBwsUGA0kiAQI0hkXjnoHhDgEqRmBaoFxgVsh X-IronPort-AV: E=Sophos;i="4.97,753,1389762000"; d="scan'208";a="63616426" 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 21:47:10 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id 0839A601F5; Wed, 21 May 2014 21:47:05 -0400 (EDT) In-Reply-To: (Leo Liu's message of "Thu, 22 May 2014 08:22:59 +0800") 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:172010 Archived-At: >> 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: Pretty much, yes, tho it should insist on the fact that this is the difference between it and `reverse'. Stefan