From unknown Sun Jun 22 04:06:37 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16687: 24.3.50; completion doc errors Resent-From: Leo Liu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 02:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 16687 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 16687@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.13918267134407 (code B ref -1); Sat, 08 Feb 2014 02:32:02 +0000 Received: (at submit) by debbugs.gnu.org; 8 Feb 2014 02:31:53 +0000 Received: from localhost ([127.0.0.1]:55668 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBxhx-000190-1R for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:31:53 -0500 Received: from eggs.gnu.org ([208.118.235.92]:41669) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBxhu-00018q-Az for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:31:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WBxhl-0002VF-FH for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:31:49 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05,FREEMAIL_FROM, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:48061) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBxhl-0002V9-CN for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:31:41 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:43361) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBxhc-000194-Oz for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:31:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WBxhU-0002TY-9I for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:31:32 -0500 Received: from mail-pd0-x232.google.com ([2607:f8b0:400e:c02::232]:61832) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBxhU-0002TS-0n for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:31:24 -0500 Received: by mail-pd0-f178.google.com with SMTP id y13so3883852pdi.23 for ; Fri, 07 Feb 2014 18:31:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:mime-version:content-type; bh=1XixZ27j791ZPPw3AR3+aAqL3smqlm3Z1iYCAc7d30I=; b=cEm583sPkS/boSCO35W9pfc2VWu4CoEBpl3Jt3Eqn1qtAKKPq3aPx8smTy1y0gAe2r zgCoTe9LIn9u1DwzJw1AnizR/lATl1CxNcR6XvHMzS+6CiKh2dzugIqxZbpBVxdmtLXf xAoQ/04dUpCymsVSlgXlU5Gted1Xct1GQ+Cw7nsv0GFR0IPf4Nxev/CLXEJxedQHYOgi 7OccjB8Q2N5uJrGvkkNUZ0vT/eZaj4qstQgxII3mKdPLKpmOYifKRdtO/OZgOltlhPel 8JmwbEMLjwE+3G1w6BIiZKRFkeqS/SV68LHHGrAxivVtkeaLsT4t1KUaWJ///4IVqypi stVw== X-Received: by 10.66.139.169 with SMTP id qz9mr11900994pab.16.1391826683072; Fri, 07 Feb 2014 18:31:23 -0800 (PST) Received: from Zeuss-MacBook.local ([123.119.94.210]) by mx.google.com with ESMTPSA id q7sm18357541pbc.20.2014.02.07.18.31.21 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 07 Feb 2014 18:31:22 -0800 (PST) From: Leo Liu Date: Sat, 08 Feb 2014 10:31:17 +0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) The doc disagrees with the function's doc-string: ,----[ (info "(elisp)Completion Variables") ] | The TRY-COMPLETION and ALL-COMPLETIONS functions should each | accept four arguments: STRING, COLLECTION, PREDICATE, and POINT. | The STRING, COLLECTION, and PREDICATE arguments have the same | meanings as in `try-completion' (*note Basic Completion::), and | the POINT argument is the position of point within STRING. Each | function should return a non-`nil' value if it performed its job, | and `nil' if it did not (e.g., if there is no way to complete | STRING according to the completion style). `---- It seems this should be `five' instead of `four': ,----[ (info "(elisp)Programmed Completion") ] | * A flag specifying the type of completion operation to perform. | This is one of the following four values: `---- Leo From unknown Sun Jun 22 04:06:37 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16687: 24.3.50; completion doc errors Resent-From: nljlistbox2@gmail.com (N. Jackson) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 23 Mar 2016 16:03:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16687 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Leo Liu Cc: 16687@debbugs.gnu.org Received: via spool by 16687-submit@debbugs.gnu.org id=B16687.145874892811352 (code B ref 16687); Wed, 23 Mar 2016 16:03:01 +0000 Received: (at 16687) by debbugs.gnu.org; 23 Mar 2016 16:02:08 +0000 Received: from localhost ([127.0.0.1]:34615 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ailEW-0002x1-Ci for submit@debbugs.gnu.org; Wed, 23 Mar 2016 12:02:08 -0400 Received: from mail-io0-f173.google.com ([209.85.223.173]:35333) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ailEU-0002wc-DK for 16687@debbugs.gnu.org; Wed, 23 Mar 2016 12:02:06 -0400 Received: by mail-io0-f173.google.com with SMTP id v187so18709501ioe.2 for <16687@debbugs.gnu.org>; Wed, 23 Mar 2016 09:02:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=/4oKDg0e8xSs3y8mj54yRJ/uJzpxaupDqRsXaia3M4A=; b=YaSbCNzha/BgE6NxlbCgGxmbOcBlA6nc8msL+V9Q7VVtjyJrORZRSC55/yHKNMD3kf +Wrz9f3DCZFOR/w1vBzUWpMA1woVkF1pm4/jlGqoZgkzWw7olPX+BGH1iACLsEuK7GFS pr/95UKMfz3IQglwN2szOzPpAOBmid6VH7hVJ8WkB55EY2mq+G/UqqElQi+khnx04mAU G0b4YvY64vQIFUxhVSwqJYASF1RlF0p3oDP2s19Q+OGlQ14A1EG/oaI6hBTl1iwCOyeJ +uKTTrGl7GN6go7jduDoht9CqToJNATu2HduSVWz1AwCYJ6qCcJwMrHBWoJHoB8JqdlR ytsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=/4oKDg0e8xSs3y8mj54yRJ/uJzpxaupDqRsXaia3M4A=; b=JoR73FsJgP1sy1QL8GkJfK2S0hJLqOMasBkKt3vF/2/JkusWnxYSAjzXE0se9aYnwq b0jwF3YI0r+f5lhdkdbbp7Fhn6WWkMyyLuOzrOUC61G2thrNarNsBBfTpv5RmE/s06yU WPm5tcBX1jmO6ppnmWXcwSaNYajZJqBKFoAT/z9A6rig8o22DkzeLvxMxxi8qQ/8+VSB v3DByY/i/EGsAsxAp4TtPsk9qGNy/rs/B2fIxRidH8gfudsxeScksDaCWsTPpJvVfpb9 uoeExdlGeVjGcQ4kwAoQYGEnWqVy+adZWpNvKnHtT5sgt67JYpO5oZrnsNbetEbNiqFB yoYg== X-Gm-Message-State: AD7BkJJOlQYuorM4Av2Yjt6cXy2Q+us7Sy7KzYbd01jgfXbSZmzn0uF+8DtgH0R/RzeeeA== X-Received: by 10.107.137.38 with SMTP id l38mr4528128iod.133.1458748896923; Wed, 23 Mar 2016 09:01:36 -0700 (PDT) Received: from moondust.nodomain.none (T86F8.WPA.Dal.Ca. [134.190.134.248]) by smtp.gmail.com with ESMTPSA id y190sm1366809iod.14.2016.03.23.09.01.35 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 23 Mar 2016 09:01:36 -0700 (PDT) From: nljlistbox2@gmail.com (N. Jackson) References: Date: Wed, 23 Mar 2016 13:01:34 -0300 In-Reply-To: (Leo Liu's message of "Sat, 08 Feb 2014 10:31:17 +0800") Message-ID: <87d1qlgp41.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.4 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.4 (/) Hi Leo, At 09:31 +0800 on Saturday 2014-02-08, Leo Liu wrote: > > The doc disagrees with the function's doc-string: > > ,----[ (info "(elisp)Completion Variables") ] > | The TRY-COMPLETION and ALL-COMPLETIONS functions should each > | accept four arguments: STRING, COLLECTION, PREDICATE, and > | POINT. The STRING, COLLECTION, and PREDICATE arguments have > | the same meanings as in `try-completion' (*note Basic > | Completion::), and the POINT argument is the position of > | point within STRING. Each function should return a non-`nil' > | value if it performed its job, and `nil' if it did not (e.g., > | if there is no way to complete STRING according to the > | completion style). > `---- To which function are you referring? This is the doc of the _variable_ `completion-styles-alist'. If you mean the function `try-completion', the doc doesn't say that the TRY-COMPLETION and ALL-COMPLETIONS functions should have the same "signature" as `try-completion', only that their arguments named STRING, COLLECTION, and PREDICATE have the same meaning as the arguments, with the same names, to `try-completion'. The docstring of `try-completion' indeed documents the meaning of these three arguments and I don't see any obvious inconsistency there. Can you be more specific about the inconsistency you see? > It seems this should be `five' instead of `four': > > ,----[ (info "(elisp)Programmed Completion") ] > | * A flag specifying the type of completion operation to > | perform. This is one of the following four values: > `---- This bit of documention now reads: =E2=80=A2 A flag specifying the type of completion operation to perform. This flag may be one of the following values. So this part of the bug is now fixed. :) N. From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 17 19:21:57 2019 Received: (at control) by debbugs.gnu.org; 17 Apr 2019 23:21:57 +0000 Received: from localhost ([127.0.0.1]:40990 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hGtsL-0007h5-3U for submit@debbugs.gnu.org; Wed, 17 Apr 2019 19:21:57 -0400 Received: from mail-qt1-f169.google.com ([209.85.160.169]:40984) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hGtsJ-0007gq-1x for control@debbugs.gnu.org; Wed, 17 Apr 2019 19:21:55 -0400 Received: by mail-qt1-f169.google.com with SMTP id w30so246829qta.8 for ; Wed, 17 Apr 2019 16:21:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version; bh=iWIPCJ/CzN1YMidFOYTQ4ZVzRdvZWLHcfN3F3FCul44=; b=NRR7Jc7vvzoaMoW5KdgonaYmTIXfjAb5/ppkc3lWBCiBb4GGJQx6r+e1XMIKH0dNqL +lSXD4oOS9jeMk9NmnhcWxzPHOU3Ug/fMmI5X0Dv0CaNVriXwPJcrCM1OPBQ2h+tLOXh p9espckj5IHKWWzl5xEUuHPr4BN8qgN3U2aCZqAUE5Vv6mAjGpXSkatP56GCWDQWEe2J bioeb1Zgirq7yv2X3xLMXMkYheqV0V7NatdZgGKAQkzc7s/g+zN2UI/+c4QR6Pjb6ggs UnuRnx7RqJu1RACsLkX2nEPEpN5aZ/Z0IztPSAVQyipCmR7AxNZTRl7z9MRDwpJPlDnp m18Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version; bh=iWIPCJ/CzN1YMidFOYTQ4ZVzRdvZWLHcfN3F3FCul44=; b=F07MB5DWBxKYOYF10RWsllFZT8kLvQ9wZf4HnfK1x13yyrx8Hmw7cUivQxpsXRMTZB sR6zcFT6QJGIAhyZWYyUROBCi8I3n0rdo4JwSdkbLjF32he4y9yNJ+eZtIznJD5343sI Ta0h2fb0kR2F2r9f64iKaoE3j78nbdAFc0i2/b4VRkfJDsS6dkdVZhaxtcpjoYobAP2q EYC/xnTzocC104dkHUvB4/lL+BMBamN/EHFANl6Qmvww6AZgS0Jn90JNB/IkirargE74 /4pN+y82//55AmkESX52L9fr6KiYdj3CKcq9EgX/a6xSCzlQQVvT6c37KNJWTIJHh7bF yl6w== X-Gm-Message-State: APjAAAVTiFzcjRnU/LkUUG8iIHywxQMgHV0hBpcGRZy6CrsieaL7+ckq 8P6fg0LEb3gamRgcigi98k4d5Gd/ X-Google-Smtp-Source: APXvYqxx+f1b7rIOBWu7mKA7uWHQZZkuTljXzJPLoj/WbxEZwSdyE22AQhTAaJurTWB3XpdF+ExPhQ== X-Received: by 2002:a0c:b0ea:: with SMTP id p39mr2120556qvc.242.1555543309466; Wed, 17 Apr 2019 16:21:49 -0700 (PDT) Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id 56sm281332qto.57.2019.04.17.16.21.48 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 17 Apr 2019 16:21:48 -0700 (PDT) From: Noam Postavsky To: control@debbugs.gnu.org Subject: control message for bug #16687 Date: Wed, 17 Apr 2019 19:21:47 -0400 Message-ID: <87tveww73o.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) close 16687 quit