From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#12314: 24.2.50; `add-to-history': use `setq' with `delete' Date: Sun, 09 Sep 2012 12:25:25 +0400 Message-ID: <504C5275.7040609@yandex.ru> References: <7602D24B74DE42CF9901322634B85CA2@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1347179144 2643 80.91.229.3 (9 Sep 2012 08:25:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Sep 2012 08:25:44 +0000 (UTC) Cc: 12314@debbugs.gnu.org To: cyd@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 09 10:25:46 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1TAcpq-0001g7-B8 for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Sep 2012 10:25:42 +0200 Original-Received: from localhost ([::1]:49124 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TAcpm-0001pb-LX for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Sep 2012 04:25:38 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60881) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TAcpj-0001ou-Il for bug-gnu-emacs@gnu.org; Sun, 09 Sep 2012 04:25:36 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TAcpi-0004EJ-Jt for bug-gnu-emacs@gnu.org; Sun, 09 Sep 2012 04:25:35 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39996) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TAcpi-0004EF-GB for bug-gnu-emacs@gnu.org; Sun, 09 Sep 2012 04:25:34 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TAcq9-00057i-NF for bug-gnu-emacs@gnu.org; Sun, 09 Sep 2012 04:26:01 -0400 X-Loop: help-debbugs@gnu.org In-Reply-To: <7602D24B74DE42CF9901322634B85CA2@us.oracle.com> Resent-From: Dmitry Gutov Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Sep 2012 08:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12314 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12314-submit@debbugs.gnu.org id=B12314.134717915919685 (code B ref 12314); Sun, 09 Sep 2012 08:26:01 +0000 Original-Received: (at 12314) by debbugs.gnu.org; 9 Sep 2012 08:25:59 +0000 Original-Received: from localhost ([127.0.0.1]:49542 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TAcq6-00057Q-Et for submit@debbugs.gnu.org; Sun, 09 Sep 2012 04:25:59 -0400 Original-Received: from forward4h.mail.yandex.net ([84.201.186.22]:58631) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TAcq1-00057G-Ox for 12314@debbugs.gnu.org; Sun, 09 Sep 2012 04:25:56 -0400 Original-Received: from smtp1h.mail.yandex.net (smtp1h.mail.yandex.net [84.201.187.144]) by forward4h.mail.yandex.net (Yandex) with ESMTP id EF5AD1B20194; Sun, 9 Sep 2012 12:25:23 +0400 (MSK) Original-Received: from smtp1h.mail.yandex.net (localhost [127.0.0.1]) by smtp1h.mail.yandex.net (Yandex) with ESMTP id 97ADF134014D; Sun, 9 Sep 2012 12:25:23 +0400 (MSK) Original-Received: from 5x166x246x245.dynamic.spb.ertelecom.ru (5x166x246x245.dynamic.spb.ertelecom.ru [5.166.246.245]) by smtp1h.mail.yandex.net (nwsmtp/Yandex) with ESMTP id PMU0Nhto-PNUi8VYU; Sun, 9 Sep 2012 12:25:23 +0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex.ru; s=mail; t=1347179123; bh=Q2VL0VmhWTYuFQSHuaru++nYpJBCZUNi049dYuCPg5o=; h=Message-ID:Date:From:User-Agent:MIME-Version:To:CC:Subject: Content-Type:Content-Transfer-Encoding; b=ZGv/LSaq7vcyO5HaGhJ5OvfSXEs/SSBwMpgjte54JTrkIJNR+jd/Bm+eIkXsYotU9 0dsZaJEbGkSqWyf1b/2JQse+kMbaupk0RdZ0RiKJlqomg5DI5KP7tJRSphHjtWfNot N2GGpRkrX8hIt2yiKmWZPkFbe+yDMSBWW5DTY47U= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:15.0) Gecko/20120824 Thunderbird/15.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:63995 Archived-At: Chong Yidong writes: > Eli Zaretskii writes: > >> But the manual should cater first and foremost to newbies. The rest >> will get the point when they read the detailed description of how the >> list is modified. > > I modified the manual to hopefully make the situation clearer. In > particular, the descriptions of delq and delete explicitly say that you > typically ought to use the return value. > > The docstrings are harder, since they should be succinct. Here is what > I suggest; WDYT? > > > (delq ELT LIST) > > ... > > Therefore, write `(setq foo (delq element foo))' to be sure of > changing the value of `foo'. I think the last sentence could be better: (a) the value of foo won't necessarily change, even if we do (setq ...), (b) our goal is for foo to have the correct value, some not changed one. How about this? Therefore, write `(setq foo (delq element foo))' to make sure that `foo' points to the result.