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#18024: 24.4.50; doc of `y-or-n-p' misses the main functionality: what it returns Date: Tue, 15 Jul 2014 14:34:34 -0700 (PDT) Message-ID: <9efb298c-a039-4b77-801a-91d3419e23ad@default> References: <11537e47-82da-4913-9f97-8afb105bdada@default> 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 1405460135 28500 80.91.229.3 (15 Jul 2014 21:35:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 15 Jul 2014 21:35:35 +0000 (UTC) To: Glenn Morris , 18024@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 15 23:35:28 2014 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 1X7ANf-0004DS-2k for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Jul 2014 23:35:23 +0200 Original-Received: from localhost ([::1]:36767 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X7ANe-0002r7-Me for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Jul 2014 17:35:22 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47706) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X7ANT-0002oi-JB for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 17:35:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X7ANK-0007VZ-OK for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 17:35:11 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60617) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X7ANK-0007V2-LS for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 17:35:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1X7ANJ-0006iN-Q8 for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 17:35:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 15 Jul 2014 21:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18024 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 18024-submit@debbugs.gnu.org id=B18024.140546008625788 (code B ref 18024); Tue, 15 Jul 2014 21:35:01 +0000 Original-Received: (at 18024) by debbugs.gnu.org; 15 Jul 2014 21:34:46 +0000 Original-Received: from localhost ([127.0.0.1]:55883 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X7AN4-0006hr-67 for submit@debbugs.gnu.org; Tue, 15 Jul 2014 17:34:46 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:22934) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X7AN1-0006hb-Lz for 18024@debbugs.gnu.org; Tue, 15 Jul 2014 17:34:44 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s6FLYaxg002026 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 15 Jul 2014 21:34:37 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s6FLYZwW028026 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 15 Jul 2014 21:34:36 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s6FLYZGf028013; Tue, 15 Jul 2014 21:34:35 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:91576 Archived-At: > what integerp returns when the argument is not an integer?! > Or floatp when the argument is not a float?! > The list goes on! Somebody fix this ASAP! Good idea, Glenn. Those doc strings too should speak about t and nil, rather than just t. They should start by saying that they test whether OBJECT is an integer etc., and end by stating what the return values are. TIA.