From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 28 13:22:21 2012 Received: (at submit) by debbugs.gnu.org; 28 Jul 2012 17:22:21 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 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 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 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 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 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 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 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 Received: from dradamslap1 (/10.159.164.157) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 28 Jul 2012 10:15:03 -0700 From: "Drew Adams" To: Subject: 24.1; doc about characters and `characterp' Date: Sat, 28 Jul 2012 10:14:56 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) 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' From debbugs-submit-bounces@debbugs.gnu.org Tue Aug 14 13:14:59 2012 Received: (at 12076) by debbugs.gnu.org; 14 Aug 2012 17:14:59 +0000 Received: from localhost ([127.0.0.1]:56665 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1Khm-0003Yl-Fy for submit@debbugs.gnu.org; Tue, 14 Aug 2012 13:14:59 -0400 Received: from mail-ob0-f172.google.com ([209.85.214.172]:46084) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1Khj-0003Ya-QV for 12076@debbugs.gnu.org; Tue, 14 Aug 2012 13:14:56 -0400 Received: by obbwc20 with SMTP id wc20so764809obb.3 for <12076@debbugs.gnu.org>; Tue, 14 Aug 2012 10:06:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=segdV6vCOGqMv09Wxhs7/qEMvxMmFg38KUUV8Q2W8wM=; b=QuqToLAK273tpwL4tcZ1tJb4pHajuL8Z60920c3uvEZqfPf5FWCVKmQm1ra8xjzoer 4GqynE6OidVZiIMNg6gL2Ge+hsMainq94d4dgyc8x5RI9RCw9h5ZNcGeN34Wkfyqm0iL tpZIS+rhvx59Fw05htH0tdb2AoujAfAKs/1iyJIDST20/5d2/0A+USZE19lbCsNCpEo5 BsjlNYLV1NCrE9VfDF4NH8rJnzdDNFv2HNDWaBP0MtIdmDpCEZZLXQlQtxHrbP9v85f8 qLfYMwG/q7E5sWQFPdoRMtgMvKJf4bLI4jvj8x3n4HWsrcLTtHiN8brVqEw5mSu2PQmL xdHw== Received: by 10.182.110.40 with SMTP id hx8mr19766619obb.47.1344963976520; Tue, 14 Aug 2012 10:06:16 -0700 (PDT) Received: from ulysses ([155.69.183.59]) by mx.google.com with ESMTPS id bp7sm3192400obc.12.2012.08.14.10.06.13 (version=SSLv3 cipher=OTHER); Tue, 14 Aug 2012 10:06:15 -0700 (PDT) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#12076: 24.1; doc about characters and `characterp' References: Date: Wed, 15 Aug 2012 01:06:11 +0800 In-Reply-To: (Drew Adams's message of "Sat, 28 Jul 2012 10:14:56 -0700") Message-ID: <871uj9l7y4.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 12076 Cc: 12076@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > But the doc for `characterp' says nothing about characters being > integers. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Tue Aug 14 13:19:20 2012 Received: (at control) by debbugs.gnu.org; 14 Aug 2012 17:19:20 +0000 Received: from localhost ([127.0.0.1]:56683 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1Kly-0004W5-KX for submit@debbugs.gnu.org; Tue, 14 Aug 2012 13:19:19 -0400 Received: from mail-yw0-f44.google.com ([209.85.213.44]:53301) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1Klx-0004Vx-5R for control@debbugs.gnu.org; Tue, 14 Aug 2012 13:19:17 -0400 Received: by yhq56 with SMTP id 56so821170yhq.3 for ; Tue, 14 Aug 2012 10:10:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=k/cBZFCpSLapuI6cOMk4uGrzWikBTMIBispSbewFjqw=; b=Hm/ZSnNWWP8IgIN206eL6m0g1ASPccm9/ViuYp7MQtgGzH2S3WCy4VxLh8tSKn+bk7 nM+vRZSk2z4oRLKRAeMW1IEjrDrywgEOFZ0m+xa47Oc1Hmr31kZ2LP/dn81/DYFpA9qe XTIL/aRoMimwY1rmxNQPwTtyJh9j1MRahPBQHY7j7vctFgqj1KZiM4OxbgYEMrYYjE4x hHHU8tAjRc8MCvelv7+kjOvgM4N4pCCju3LbfJnNPvnOnX4n/uv6lSKr4rzPIiReBov9 OxFVN+LwJ1ud1eP+Yx6qf9uh6bYB7NRiX+XLnEtRV57eYymlLefbs5tUf2dQc2Id3tBm rFog== Received: by 10.42.123.130 with SMTP id s2mr13681083icr.50.1344964237528; Tue, 14 Aug 2012 10:10:37 -0700 (PDT) Received: from ulysses ([155.69.183.59]) by mx.google.com with ESMTPS id dk6sm9848191igb.0.2012.08.14.10.10.35 (version=SSLv3 cipher=OTHER); Tue, 14 Aug 2012 10:10:36 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 10881 Date: Wed, 15 Aug 2012 01:10:33 +0800 Message-ID: <874no58kmu.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) close 10881 close 12076 close 11040 close 11542 thanks From unknown Mon Aug 18 14:25:51 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 12 Sep 2012 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator