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#12076: 24.1; doc about characters and `characterp' Date: Sat, 28 Jul 2012 10:14:56 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1343495769 27584 80.91.229.3 (28 Jul 2012 17:16:09 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 28 Jul 2012 17:16:09 +0000 (UTC) To: 12076@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 28 19:16:09 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 1SvAcX-0005lv-0w for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Jul 2012 19:16:05 +0200 Original-Received: from localhost ([::1]:49511 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAcW-0001ad-5c for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Jul 2012 13:16:04 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:59854) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAcS-0001aP-8m for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:16:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SvAcR-000586-0S for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:16:00 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37395) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAcQ-000581-TL for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:15:58 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SvAjF-0008Ow-OY for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:23:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Jul 2012 17:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12076 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.134349614132243 (code B ref -1); Sat, 28 Jul 2012 17:23:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Jul 2012 17:22:21 +0000 Original-Received: from localhost ([127.0.0.1]:46939 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SvAia-0008O0-My for submit@debbugs.gnu.org; Sat, 28 Jul 2012 13:22:21 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40598) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SvAiY-0008Ns-38 for submit@debbugs.gnu.org; Sat, 28 Jul 2012 13:22:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SvAbh-0004mE-S1 for submit@debbugs.gnu.org; Sat, 28 Jul 2012 13:15:14 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:58843) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAbh-0004m9-Oy for submit@debbugs.gnu.org; Sat, 28 Jul 2012 13:15:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:59299) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAbg-0001S2-Rq for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:15:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SvAbf-0004ln-Lm for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:15:12 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:38397) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SvAbf-0004lB-FU for bug-gnu-emacs@gnu.org; Sat, 28 Jul 2012 13:15:11 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q6SHF5Gm013333 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 28 Jul 2012 17:15:06 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q6SHF43a018803 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 28 Jul 2012 17:15:05 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q6SHF3Mx019994 for ; Sat, 28 Jul 2012 12:15:04 -0500 Original-Received: from dradamslap1 (/10.159.164.157) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 28 Jul 2012 10:15:03 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac1s5ILwlG/D7FTJRzqlsklWj2NlcA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) 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:62524 Archived-At: The Elisp manual has always said that in Emacs characters are integers. And so they are, still; and so the manual says, still. Good. But not all integers are characters. And we now have predicate `characterp' to distinguish those that are from those that are not. Good. But the doc for `characterp' says nothing about characters being integers. That's not good, even if the intention is for the predicate to serve at a higher level of abstraction. In Emacs Lisp things should be clear to users. Please update (elisp) `Character Codes' to make it clear, as a reminder, that (all) characters are integers. Yes, that should be clear from the use of #x... syntax etc. But a reminder helps. And please add a cross reference to node `String Basics', where characters are introduced. More importantly, the doc string of `characterp' should also mention that a character is an integer. All that's needed, to help users more, is to add a couple of words: "Return non-nil if OBJECT is an integer that is a valid character." ^^^^^^^^^^^^^^^^^^ The general doc introducing characters is in node `String Basics'. It is pretty good as it is, because it implicitly says that not all integers are characters (it explicitly says that whether an integer is a character is determined by its use), and because it cross-references node `Character Codes', which presents predicate `characterp'. Although `String Basics' is pretty good, it would be helpful to mention `characterp' there, as the predicate that determines "whether an integer is a character or not" (supposedly by examining "how it is used" (?)). IOW, mention predicate `characterp' here, and cross-reference the node where it is described in detail. In GNU Emacs 24.1.1 (i386-mingw-nt5.1.2600) of 2012-06-10 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include'