From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bill Freeman Newsgroups: gmane.emacs.bugs Subject: bug#15558: [gnu.org #859332] Error in elisp on line documentation Date: Tue, 8 Oct 2013 13:32:47 -0400 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=047d7b60457e3801e704e83e2841 X-Trace: ger.gmane.org 1381254071 8497 80.91.229.3 (8 Oct 2013 17:41:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 8 Oct 2013 17:41:11 +0000 (UTC) Bcc: rgm@gnu.org To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 08 19:41:13 2013 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 1VTbHU-0002Wh-OA for geb-bug-gnu-emacs@m.gmane.org; Tue, 08 Oct 2013 19:41:12 +0200 Original-Received: from localhost ([::1]:38101 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VTbHU-0002wk-B7 for geb-bug-gnu-emacs@m.gmane.org; Tue, 08 Oct 2013 13:41:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60205) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VTbHN-0002tx-C6 for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2013 13:41:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VTbHL-0007e3-QE for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2013 13:41:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:55363) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VTbHL-0007d9-Fe for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2013 13:41:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1VTbHL-0002zq-5B for bug-gnu-emacs@gnu.org; Tue, 08 Oct 2013 13:41:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Bill Freeman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 08 Oct 2013 17:41:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15558 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 15558-submit@debbugs.gnu.org id=B15558.138125405011493 (code B ref 15558); Tue, 08 Oct 2013 17:41:03 +0000 Original-Received: (at 15558) by debbugs.gnu.org; 8 Oct 2013 17:40:50 +0000 Original-Received: from localhost ([127.0.0.1]:35422 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VTbH7-0002zI-Ol for submit@debbugs.gnu.org; Tue, 08 Oct 2013 13:40:50 -0400 Original-Received: from fencepost.gnu.org ([208.118.235.10]:34185) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VTbCI-0002r4-CJ for 15558@debbugs.gnu.org; Tue, 08 Oct 2013 13:35:50 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1VTbCH-0008Ik-RE for 15558@debbugs.gnu.org; Tue, 08 Oct 2013 13:35:50 -0400 Resent-Message-ID: <21076.17013.772862.377459@gnu.org> Resent-Date: Tue, 8 Oct 2013 13:35:49 -0400 Resent-From: Glenn Morris Resent-To: 15558@debbugs.gnu.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=+/p+3Nlt+h7lUcjN+JOlheFhNZSrlYd5N8HLUAlaI+c=; b=LnnZ4qT/1R8APqDB3zHLw+HH/rbEVy/AeuVUiTY7Ys3KZ75oKNwCoktc617HtYRjMg bfDzIyVOoYEETdn3WEK08t7Hi5LtyKAUC4SyOALrlHMF1qNkt73uvh/UPXEIJNT3L7Z7 kxwq/uo4uEvBIEC5gtBxsWv71WSF7zyc/8OIugO3/6Ru4PoQxf7oSlvedFiEOsjem023 cyunwr93Whhq1UreC55PM2iVgsBjkrVWhCfN2F2GNs3oBMliS9qujLYLXwbNezj+2/Iu BkpD16/f8xSP8TIxTSxT9eGOsW3/NRluMvv66TCgVBCzMSYlSEBvJszBZVJlemrRLVbH 1qaA== X-Received: by 10.224.111.195 with SMTP id t3mr4914503qap.49.1381253567216; Tue, 08 Oct 2013 10:32:47 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Bogosity: no, spamicity=0.047834, v1.2.1 X-Mailman-Approved-At: Tue, 08 Oct 2013 13:40:45 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:79048 Archived-At: --047d7b60457e3801e704e83e2841 Content-Type: text/plain; charset=ISO-8859-1 Yes, thanks, I see that now. (And I thought I was reading carefully.) But might I suggest that the line: If every condition evaluates to nil, so that every clause fails, condreturns nil. be placed after the line: Then, if condition is non-nil when tested, the value of conditionbecomes the value of the cond form. Bill On Tue, Oct 8, 2013 at 12:17 PM, Glenn Morris wrote: > > "Robert Musial via RT" wrote: > > >> Yet it is perfectly legal for a clause to have no body-forms, only a > >> condition. > [...] > >> The current text actually leaves the value undefined for this case. It > is > >> a useful case, and should be correctly documented. > > It is documented (if a little clunkily): > > A clause may also look like this: > > (condition) > > Then, if condition is non-nil when tested, the value of condition > becomes the value of the cond form. > > > PS: Please report Emacs documentation issues via M-x report-emacs-bug > (or mail to bug-gnu-emacs@gnu.org) rather than emailing GNU webmasters. > --047d7b60457e3801e704e83e2841 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
Yes, thanks, I see that now.=A0 (And I thou= ght I was reading carefully.)

But might I suggest that the lin= e:

=A0=A0=A0 If every condition evaluates to nil, so that every clause fails, cond returns nil.
be placed after the line:

=A0=A0=A0 <= /code>Then, if condition is non-nil when tested, th= e value of condition becomes the value of the cond form.
Bill


On Tue, Oct 8, 2013 at 12:17 PM, Glenn Morris &l= t;rgm@gnu.org> wrote:

"Robert Musial via RT" wrote:

>> Yet it is perfectly legal for a clause to have no body-forms, only= a
>> condition.
[...]
>> The current text actually leaves the value undefined for this case= . =A0It is
>> a useful case, and should be correctly documented.

It is documented (if a little clunkily):

=A0 =A0 A clause may also look like this:

=A0 =A0 (condition)

=A0 =A0 Then, if condition is non-nil when tested, the value of condition =A0 =A0 becomes the value of the cond form.


PS: Please report Emacs documentation issues via M-x report-emacs-bug
(or mail to bug-gnu-emacs@gnu.org<= /a>) rather than emailing GNU webmasters.

--047d7b60457e3801e704e83e2841--