From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#22748: 24.5; (elisp) `Type Predicates': Repeat the rule from `Coding Conventions' Date: Sat, 20 Feb 2016 11:10:44 -0800 (PST) Message-ID: <3544db59-c0b7-46e8-853b-7fd6f546be34@default> References: <<6f905e9f-8bb4-4ec1-8cce-b00a6bf7a402@default>> <<83io1jnrjg.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1455995484 14919 80.91.229.3 (20 Feb 2016 19:11:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 20 Feb 2016 19:11:24 +0000 (UTC) Cc: 22748-done@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 20 20:11:08 2016 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 1aXCvr-0001Pa-Hf for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Feb 2016 20:11:07 +0100 Original-Received: from localhost ([::1]:35030 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXCvq-0003Nf-8z for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Feb 2016 14:11:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50566) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXCvn-0003NX-4f for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2016 14:11:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aXCvm-0007Cj-Au for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2016 14:11:03 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:38459) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXCvm-0007CG-6z for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2016 14:11:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aXCvl-0005fH-Pu for bug-gnu-emacs@gnu.org; Sat, 20 Feb 2016 14:11:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 20 Feb 2016 19:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22748 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22748-done@debbugs.gnu.org id=D22748.145599545421763 (code D ref 22748); Sat, 20 Feb 2016 19:11:01 +0000 Original-Received: (at 22748-done) by debbugs.gnu.org; 20 Feb 2016 19:10:54 +0000 Original-Received: from localhost ([127.0.0.1]:35586 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aXCve-0005ex-8S for submit@debbugs.gnu.org; Sat, 20 Feb 2016 14:10:54 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:30552) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aXCvc-0005ej-3K for 22748-done@debbugs.gnu.org; Sat, 20 Feb 2016 14:10:52 -0500 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u1KJAjmW015747 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 20 Feb 2016 19:10:45 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u1KJAj8O027864 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 20 Feb 2016 19:10:45 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u1KJAiaQ002756; Sat, 20 Feb 2016 19:10:44 GMT In-Reply-To: <<83io1jnrjg.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] 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: 208.118.235.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:113374 Archived-At: > "Coding Conventions" are about future code; No, they describe the conventions that we follow. That's general: past, present, future. > "Type Predicates" describe the reality. These two are not > necessarily identical. Agreed. But `Type Predicates' specifically points to the convention. It should link to it, so readers can understand just what that _convention_ is - as opposed to the more lax description of "the reality". FWIW: I was pretty sure that this convention was described somewhere, so I tried `i predicate' and then narrowed that to "type predicates" and landed at `Type Predicates'. I did not find what I was looking for there, wrt the rule for naming type predicates. I then resorted to, yes, searching the manual (I even searched the Emacs manual, as well), using regexps such as "[^CM]-p\b"... Eventually, I got to (elisp) `Coding Conventions'. Sure, I should have started there, perhaps. But I should have also been able to get there easily from `Type Predicates' after using `i predicate'. Just one user, sure. Why you would not want to add a cross-reference to the node that actually defines the "general Lisp convention for predicate functions" is beyond me. Perhaps you are having a bad day? If you don't have time to add that cross-ref now, why not leave the bug open until someone does? Why should this node mention, vaguely, "a general Lisp convention for predicate functions" without helping users find out what that convention is? > Closing. Too bad.