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#17403: 24.4.50; package-alist doc-string error Date: Wed, 17 Jul 2019 15:23:03 +0100 Message-ID: <87o91sg2pk.fsf@tcd.ie> References: <87d0ic1ylf.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="65427"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 17403@debbugs.gnu.org, Noam Postavsky To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 17 16:24:08 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 1hnkql-000Gu6-VV for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jul 2019 16:24:08 +0200 Original-Received: from localhost ([::1]:57820 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hnkql-0004kt-0R for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jul 2019 10:24:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39361) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hnkqh-0004kR-Gn for bug-gnu-emacs@gnu.org; Wed, 17 Jul 2019 10:24:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hnkqg-0008Hq-Gv for bug-gnu-emacs@gnu.org; Wed, 17 Jul 2019 10:24:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43967) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hnkqg-0008HY-4t for bug-gnu-emacs@gnu.org; Wed, 17 Jul 2019 10:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hnkqf-0006rQ-Un for bug-gnu-emacs@gnu.org; Wed, 17 Jul 2019 10:24: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: Wed, 17 Jul 2019 14:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17403 X-GNU-PR-Package: emacs Original-Received: via spool by 17403-submit@debbugs.gnu.org id=B17403.156337339726319 (code B ref 17403); Wed, 17 Jul 2019 14:24:01 +0000 Original-Received: (at 17403) by debbugs.gnu.org; 17 Jul 2019 14:23:17 +0000 Original-Received: from localhost ([127.0.0.1]:52787 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnkpw-0006qL-P0 for submit@debbugs.gnu.org; Wed, 17 Jul 2019 10:23:17 -0400 Original-Received: from mail-wm1-f53.google.com ([209.85.128.53]:54637) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnkpu-0006q1-Ro for 17403@debbugs.gnu.org; Wed, 17 Jul 2019 10:23:15 -0400 Original-Received: by mail-wm1-f53.google.com with SMTP id p74so22349215wme.4 for <17403@debbugs.gnu.org>; Wed, 17 Jul 2019 07:23:14 -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=4aRBzx7R0joGvwbYw4i+W01IJOgLuJkakriukIHj2Ug=; b=LbATK6Sr4erZ/z8X0ZL1UxIOyUp4Pwxdo91xqvDKON1xyyrGzLpdyRVMttht8vPSp5 Ot2sXfUmcLgkimd2084ezLKzfeLnkPWnOjfFTE2grAlLzbezlP1OJl1vNfre51xMEnJp hKzo+KwQcEKmnPjIBUy5z14hFLvYHe/3RTnOgpV3d3laAlmFS7VXGLcS/KJ1c18xG96W YZGu4jvU/42P7WrOAzB0wQJHufkqjFe+9nuRPNmOzmZQPmBcCIStmACFCdK1KEdjS/Iq 1dD8u8Vmhk8nnrvZxFHIMvQPkqTdV2Bolt0KMpdvZ0q8blTmm36LvomUJZha42rkqr1a mG5g== 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=4aRBzx7R0joGvwbYw4i+W01IJOgLuJkakriukIHj2Ug=; b=D/UsMQN9LqyWTFdvVK2XIactLKUWeFLZz9xvLyO3MhcDeMVwlAoTnbEnhfqFayNOaq rqdvQhzyBt/ZIsKs7DqhsHiSCqDON3YH6qwQpip/gVhgl/Yq/toZt45z3TGs7N+SsC1C lbf9UjBYWGQ0YYjprTJyvoFxH4quzv6HvqDXxTJCrMWwqzLRKBEPQXZxwplOImVbvY6a iNi2vQcwKIQxfHQbzIy7A/cjw6TmgTNEKTAApagrTJgt1orneZGAtUEqTX/cztQgONHW 2Fi3c6ZJezI4Mn7jNbtfr+nlbPRl/WRdaEf5olInQhaO5EH4qEu5doSdJbqgmhMZkx6C RRlw== X-Gm-Message-State: APjAAAUqdDvLnjKiiGPeYcn5TlbEiXfzofTwPXF4bGON3S8pbet3Eeem qcGBOY4BKnO2CwptkSPN3Sn1WA== X-Google-Smtp-Source: APXvYqxep/Fa5Yu34VQLAjW/jQ/FaRgTogB3HZcF5ToKT4nfkzOYVOsKl1Gk6VUPLLvSRJLhaPvOXQ== X-Received: by 2002:a1c:1f41:: with SMTP id f62mr37758302wmf.176.1563373388893; Wed, 17 Jul 2019 07:23:08 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id v12sm22537222wrr.87.2019.07.17.07.23.07 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 17 Jul 2019 07:23:08 -0700 (PDT) In-Reply-To: (Stefan Kangas's message of "Sun, 14 Jul 2019 17:58:16 +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:163244 Archived-At: tags 17403 notabug close 17403 quit Stefan Kangas writes: > Is it a problem that this is documented as "(PKG . DESCS)" when the > printed representation is "(PKG DESCS)"? No, because the implicit printed representation is actually (PKG DESC...), not (PKG DESCS). In other words, the cadr of each alist element is a single package-desc structure, not a list thereof. Both the code and the docstring agree on this AFAICT. Dotted notation is often employed in documentation in order to more explicitly describe metasyntactic structure. This may initially confuse users who see the implicit printed representation, but sooner or later all Emacsites ought to learn that (A B) is equivalent to (A . (B)). > If not, we can close this as notabug. Done, thanks. -- Basil