From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: oitofelix@gmail.com (Bruno =?UTF-8?Q?F=C3=A9lix?= Rezende Ribeiro) Newsgroups: gmane.emacs.bugs Subject: bug#12564: 24.1; Emacs Lisp Reference Manual; Confusing paragraph regarding association lists' definition; Section 20.6.1 "Basic Completion Functions"; 5th paragraph Date: Tue, 02 Oct 2012 16:44:21 -0300 Message-ID: <87pq508xre.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1349206991 15924 80.91.229.3 (2 Oct 2012 19:43:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 2 Oct 2012 19:43:11 +0000 (UTC) To: 12564@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 02 21:43:17 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 1TJ8Mb-0005LR-Dt for geb-bug-gnu-emacs@m.gmane.org; Tue, 02 Oct 2012 21:42:42 +0200 Original-Received: from localhost ([::1]:38064 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8MV-0003mM-Sd for geb-bug-gnu-emacs@m.gmane.org; Tue, 02 Oct 2012 15:42:35 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56527) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8MS-0003m5-Tl for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:42:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TJ8MO-00017l-OW for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:42:32 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56783) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8MO-00017h-Kn for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:42:28 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TJ8Mw-0006sK-3c for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:43:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: oitofelix@gmail.com (Bruno =?UTF-8?Q?F=C3=A9lix?= Rezende Ribeiro) Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 02 Oct 2012 19:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12564 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.134920692826366 (code B ref -1); Tue, 02 Oct 2012 19:43:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 2 Oct 2012 19:42:08 +0000 Original-Received: from localhost ([127.0.0.1]:38095 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TJ8M3-0006rD-W2 for submit@debbugs.gnu.org; Tue, 02 Oct 2012 15:42:08 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:36727) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TJ8M2-0006r6-6e for submit@debbugs.gnu.org; Tue, 02 Oct 2012 15:42:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TJ8LT-0000s6-GD for submit@debbugs.gnu.org; Tue, 02 Oct 2012 15:41:32 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:47639) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8LT-0000s2-DM for submit@debbugs.gnu.org; Tue, 02 Oct 2012 15:41:31 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56403) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8LP-0003jn-9a for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:41:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TJ8LK-0000qn-Ti for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:41:27 -0400 Original-Received: from mail-gg0-f169.google.com ([209.85.161.169]:38268) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TJ8LK-0000qj-PN for bug-gnu-emacs@gnu.org; Tue, 02 Oct 2012 15:41:22 -0400 Original-Received: by ggnf4 with SMTP id f4so1835094ggn.0 for ; Tue, 02 Oct 2012 12:41:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:user-agent:mime-version :content-type:content-transfer-encoding; bh=FiZ3ea1C5tQ7PVMlT+tkXAv0zxHuRub5RWuNNYrj0IM=; b=CXWCQHTlAGhgDw+1Wandd9FCMFaXSpPns+xydzFwXN92Bflb+2r9ee/KIa1MHRC1bU yHVM/CKz9JG6tSmyJ3TfNnO2pH8lYZaRs4LdEWekZ88tkQHHgyfbXVfPXErPXiVM73iV SFzk2OWzie+d2cGYlV17ZES4uePgReAet3bJ/U//09IFXs9weuUccbikaw6zc3nkyrmE 1IuuaRAw32ba0SvEBL2Ih1Dv7Vc3pp1yCkhKwxdL1+adPgGDOAjop8Gzz9pMAyMsX3gm jA2yJqJLOeWF0my0tRokKCJN/VKZ8RbYzU+Kgrw2slsbDhfNObdndKtF4T4WIbMzyRKw r/NA== Original-Received: by 10.100.172.2 with SMTP id u2mr6007599ane.17.1349206882380; Tue, 02 Oct 2012 12:41:22 -0700 (PDT) Original-Received: from felix-laptop ([177.30.232.206]) by mx.google.com with ESMTPS id f15sm1930287anm.9.2012.10.02.12.41.19 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 02 Oct 2012 12:41:21 -0700 (PDT) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:65125 Archived-At: This bug report will be sent to the Bug-GNU-Emacs mailing list and the GNU bug tracker at debbugs.gnu.org. Please check that the From: line contains a valid email address. After a delay of up to one day, you should receive an acknowledgement at that address. Please write in English if possible, as the Emacs maintainers usually do not have translators for other languages. Please describe exactly what actions triggered the bug, and the precise symptoms of the bug. If you can, give a recipe starting from `emacs -Q': In GNU Emacs Lisp Reference Manual, section 20.6.1, entitled "Basic Completion Functions", in the 5th paragraph one can read: If COLLECTION is an alist (*note Association Lists::), the permissible completions are the elements of the alist that are either strings, or conses whose CAR is a string or symbol. Symbols are converted to strings using `symbol-name'. Other elements of the alist are ignored. (Remember that in Emacs Lisp, the elements of alists do not _have_ to be conses.) In particular, a list of strings is allowed, even though we usually do not think of such lists as alists. The key affirmation is "... in Emacs Lisp, the elements of alists do not _have_ to be conses". In the paragraph's first sentence there is a reference to section 5.8 "Association Lists" in the same manual, where one can read in the first paragraph: An "association list", or "alist" for short, records a mapping from keys to values. It is a list of cons cells called "associations": the CAR of each cons cell is the "key", and the CDR is the "associated value".(1) The key affirmation here is "... It is [association lists] a list of cons cells ...". Hence, we conclude an association list is a list of cons cells that doesn't need to be cons cells. If we assume the manual is consistent, we only can infer, supposing a language abuse, the following: An association list is any sort of list. or, perhaps more appropriate, An association list is any list that has none elements or at least one cons cell and possibly other elements. Since I don't know what is the case, either I'm missing something trivial, = or that is a manual bug. Even if it's consistent, I think it could be more clear. Thanks. In GNU Emacs 24.1.1 (i686-pc-linux-gnu, GTK+ Version 2.24.10) of 2012-08-26 on felix-laptop Windowing system distributor `The X.Org Foundation', version 11.0.10903000 Configured using: `configure 'CFLAGS=3D-pipe -O3 -march=3Datom -mtune=3Datom -mmmx -msse -ms= se2 -msse3 -mssse3 -mfpmath=3Dsse'' --=20 ,=3D ,-_-. =3D. Bruno F=C3=A9lix Rezende Ribeiro (oitofelix) ((_/)o o(\_)) Uns o chamam de super-vaca... `-'(. .)`-' Outros de hiper-touro... \_/ Eu o chamo simplesmente: meta-gnu!