From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#34842: 26.1; Alist documentation: let-alist Date: Sun, 13 Oct 2019 13:17:51 +0100 Message-ID: <87y2xoj0uo.fsf@tcd.ie> References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="130551"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 34842@debbugs.gnu.org, =?UTF-8?Q?Sebasti=C3=A1n_?= =?UTF-8?Q?Mon=C3=ADa?= To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 13 14:19:19 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJcq9-000Xj0-3y for geb-bug-gnu-emacs@m.gmane.org; Sun, 13 Oct 2019 14:19:13 +0200 Original-Received: from localhost ([::1]:39270 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iJcq7-0003By-SN for geb-bug-gnu-emacs@m.gmane.org; Sun, 13 Oct 2019 08:19:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38410) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iJcpz-0003Aj-RM for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:19:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iJcpy-0002nq-OD for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:19:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54722) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iJcpy-0002nT-BY for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:19:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iJcpy-0003jk-6K for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:19:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 12:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157096908414298 (code B ref 34842); Sun, 13 Oct 2019 12:19:02 +0000 Original-Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 12:18:04 +0000 Original-Received: from localhost ([127.0.0.1]:35310 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJcoz-0003iJ-OM for submit@debbugs.gnu.org; Sun, 13 Oct 2019 08:18:02 -0400 Original-Received: from mail-wr1-f51.google.com ([209.85.221.51]:40842) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJcox-0003i1-Jv for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 08:18:00 -0400 Original-Received: by mail-wr1-f51.google.com with SMTP id h4so16560466wrv.7 for <34842@debbugs.gnu.org>; Sun, 13 Oct 2019 05:17:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=Es9mVKJbIL1rVk1+iFtL6tCl5gV0JD69ZsUDFlBAxD0=; b=JhET3bFbJci6ZAvdqE3ImbKjo/QEPCvh7Xx/Cx9hkqYz5vWH2pQyS/d+No1ZhUHonY 1ELHFgG5hCM3nxuWLG659G+yu9tch4USMyVRbwYq2VcE7WOBrfy8G1Kb6IDMHwPdonr7 /KBFT+KUqDgpqDujRxqLQsR8xZRGpVytJuxHQ5LzkUdpezI8A+Veg+GPFsmOjyRS0ldr YCdqjXWD7emnfLbBJUrTqjrfDMPtnjCdO5oM+1SVb+zEgyFuGzQcz5H95cqiozSJiGmE GIdC4J3tugTOWz/AWWbrkrFD2Xzj1nMbzUA8WOEChyTz4UKiXU5LTGuDJ72VfUH+jaSa gYDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=Es9mVKJbIL1rVk1+iFtL6tCl5gV0JD69ZsUDFlBAxD0=; b=RupszychnXzPctiohjyAvEI/gPrprSi62J37tDnEaoYZB9v/JuxyeLL3E0ZxGgo6qJ ct+0VyUuT69orfBSe649OtL1QZSX/eCGpq399AUr07yw4L98jjdanuXef9ty2Rw8EjJ2 c5tJgT+yfoG644MTYsEAHhxe+MFvrXfSzYyottFuK7p9hHu5QUDOeIKq1Ee0blgjrk4l JwFodloelcIkUMz+1aadm9vRmRPuxqGunvmjGDFTuBDlGqADrdEJCOZQdmRBgP7imUE/ 2nAHxNLausJS0FeWxxLshuS+lG+Ri3jaJwItvhfYnlwP9lOlDKVnBPO9UsmQ/I1qWCWr CX9Q== X-Gm-Message-State: APjAAAWTgWilLB3LtP9n/nRkXWLjgtqKcO/qkDr4BoPHYHD1bN21c11L mShrBZ28Cm3L06zdFQqrSWkWOg== X-Google-Smtp-Source: APXvYqy1I7GKJcdU62Cl1ce8IeGox41dyLU+MIo7LHlRazsAVYDBPRNzRZ++OmDZCnxE0yqihTko8Q== X-Received: by 2002:a5d:4302:: with SMTP id h2mr11916590wrq.35.1570969073793; Sun, 13 Oct 2019 05:17:53 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id x2sm18807048wrn.81.2019.10.13.05.17.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Oct 2019 05:17:53 -0700 (PDT) In-Reply-To: <87a7a5e4yc.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sun, 13 Oct 2019 04:48:11 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:169114 Archived-At: Lars Ingebrigtsen writes: > "Basil L. Contovounesios" writes: > >> Thanks. The following constitute what I think are some opportunities >> for clarifying the current doc. WDYT? > > Looks good to me, but: Thanks. >> +@samp{.} are bound. Each such @var{.symbol} is bound to the @sc{cdr} >> +of the first association for @var{symbol} in @var{alist} using >> +@code{assq}. If no such association exists, @var{.symbol} is bound to >> +@code{nil}: >> >> +@lisp >> +(let-alist colors >> + .tulip) >> + @result{} nil >> +@end lisp > > This bit seems superfluous. (cdr (assq ...)) is nil when no such > association exists, but this makes it sound like that's a special case > somehow... It's just making it explicit without having to refer to specifics of the implementation. I think it's a common style in the docs, but I don't feel strongly about it. Would you rather remove the example, the sentence, or both? -- Basil