From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#6576: documentation `string-to-char' is incorrect Date: Thu, 14 Jul 2011 01:50:59 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310601225 27537 80.91.229.12 (13 Jul 2011 23:53:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 13 Jul 2011 23:53:45 +0000 (UTC) Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 14 01:53:39 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh9FL-0006EJ-2H for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 01:53:39 +0200 Original-Received: from localhost ([::1]:47503 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qh9FK-0000xB-Cw for geb-bug-gnu-emacs@m.gmane.org; Wed, 13 Jul 2011 19:53:38 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:48607) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qh9Du-0000bj-A7 for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 19:52:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qh9Do-0000AW-KL for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 19:52:10 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33714) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qh9Do-0000AS-FC for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 19:52:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qh9Do-00019I-0D; Wed, 13 Jul 2011 19:52:04 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 13 Jul 2011 23:52:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6576 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106010904340 (code B ref 6576); Wed, 13 Jul 2011 23:52:03 +0000 Original-Received: (at 6576) by debbugs.gnu.org; 13 Jul 2011 23:51:30 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh9DF-00017w-JB for submit@debbugs.gnu.org; Wed, 13 Jul 2011 19:51:29 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh9DB-000172-UU for 6576@debbugs.gnu.org; Wed, 13 Jul 2011 19:51:26 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qh9Cy-0007SY-31; Thu, 14 Jul 2011 01:51:12 +0200 In-Reply-To: <83wrt770rf.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 07 Jul 2010 18:46:44 +0300") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Depeche Mode's _A Broken Frame_: "See You" X-Hashcash: 1:23:110713:schwab@linux-m68k.org::hMK9xesQ7n+JiMhK:00000000000000000000000000000000000000003cRi X-Hashcash: 1:23:110713:eliz@gnu.org::KYJ9lvCYAUtPhGog:00000GUcS X-Hashcash: 1:23:110713:6576@debbugs.gnu.org::rVlvVaO54bhamts6:00000000000000000000000000000000000000000/YuF X-Hashcash: 1:23:110713:monkey@sandpframing.com::ba73zaGn28P29vTo:00000000000000000000000000000000000001vr+Z X-MailScanner-ID: 1Qh9Cy-0007SY-31 MailScanner-NULL-Check: 1311205872.64796@GQIy3vivKZVsSoIVrPOa4g X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 13 Jul 2011 19:52:04 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:48957 Archived-At: Eli Zaretskii writes: > Actually, there's no way we could return the eight-bit characters in > the 160 to 255 range, since that range is already taken by Unicode > codepoints of Latin characters. So how about > > "Return the codepoint of the first character of STRING. > > Value is the Unicode codepoint, if it is below #x110000 (in hex). > Codepoints beyond that are Emacs extensions of Unicode. In > particular, eight-bit characters are returned as codepoints in > the range #x3FFF80 through #x3FFFFF, inclusive." I've now installed a slight variation on this in Emacs 24. But after checking it in, I started wondering whether this doc string really makes sense. The function returns an Emacs character, and it would be rather weird if all functions that take or return an Emacs character goes through that entire explanation. Is there a specific reason this particular function deserves this detailed explanation? If not, I'd rather just revert the change I just checked in... -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/