From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 06 Jul 2010 21:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6576 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 6576@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.127845209324412 (code B ref -1); Tue, 06 Jul 2010 21:35:01 +0000 Received: (at submit) by debbugs.gnu.org; 6 Jul 2010 21:34:53 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWFn2-0006Lh-PH for submit@debbugs.gnu.org; Tue, 06 Jul 2010 17:34:52 -0400 Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWFn0-0006LZ-K1 for submit@debbugs.gnu.org; Tue, 06 Jul 2010 17:34:50 -0400 Received: from lists.gnu.org ([199.232.76.165]:36929) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1OWFmw-0002co-Iu for submit@debbugs.gnu.org; Tue, 06 Jul 2010 17:34:46 -0400 Received: from [140.186.70.92] (port=60741 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OWFmv-00052Q-7i for bug-gnu-emacs@gnu.org; Tue, 06 Jul 2010 17:34:46 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE autolearn=unavailable version=3.3.1 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OWFmu-0008IC-43 for bug-gnu-emacs@gnu.org; Tue, 06 Jul 2010 17:34:45 -0400 Received: from mail-vw0-f41.google.com ([209.85.212.41]:36217) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWFmu-0008Hn-0j for bug-gnu-emacs@gnu.org; Tue, 06 Jul 2010 17:34:44 -0400 Received: by vws1 with SMTP id 1so8736224vws.0 for ; Tue, 06 Jul 2010 14:34:42 -0700 (PDT) MIME-Version: 1.0 Received: by 10.220.62.136 with SMTP id x8mr2803252vch.37.1278452081935; Tue, 06 Jul 2010 14:34:41 -0700 (PDT) Received: by 10.151.46.4 with HTTP; Tue, 6 Jul 2010 14:34:41 -0700 (PDT) Date: Tue, 6 Jul 2010 17:34:41 -0400 X-Google-Sender-Auth: zrq79vtAT4zXSd94goAZ2EqO34U Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -4.9 (----) First sentence of doc string for `string-to-char' is incorrect. ,---- (documentation 'string-to-char ) | "Convert arg STRING to a character, the first character of that | string. A multibyte character is handled correctly. | | (fn STRING)" `---- Should be something more like: "Return decimal integer value of first character in STRING." The rationale for the proposed docstring change are: - The second clause of sentence doesn't parse; - The arg string (nor its 1st char) are _not_ converted, e.g.: (let ((not-cnvrtd "bubba")) (string-to-char not-cnvrtd) not-cnvrtd) ;; <- value of not-cnvrtd is a string not a char. - It is more in keeping with what the manual says: ,---- (info "(elisp)Basic Char Syntax") | Since characters are really integers, the printed representation | of a character is a decimal number. `---- Affliced docstring appears in GNU Emacs 23.2.1 and current through Bzr-100633 -- /s_P\ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 07:15:02 +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: To: MON KEY Cc: 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.12784868817626 (code B ref 6576); Wed, 07 Jul 2010 07:15:02 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 07:14:41 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWOq8-0001yx-Fu for submit@debbugs.gnu.org; Wed, 07 Jul 2010 03:14:40 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWOq5-0001yq-O4 for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 03:14:38 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0L5600800EQACW00@a-mtaout23.012.net.il> for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 10:14:33 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.120.144]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L56008B1ES7EN00@a-mtaout23.012.net.il>; Wed, 07 Jul 2010 10:14:32 +0300 (IDT) Date: Wed, 07 Jul 2010 10:12:30 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83630r934x.fsf@gnu.org> References: X-Spam-Score: -1.0 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -1.9 (-) > Date: Tue, 6 Jul 2010 17:34:41 -0400 > From: MON KEY > Cc: > > First sentence of doc string for `string-to-char' is incorrect. > > ,---- (documentation 'string-to-char ) > | "Convert arg STRING to a character, the first character of that > | string. A multibyte character is handled correctly. > | > | (fn STRING)" > `---- > > Should be something more like: > > "Return decimal integer value of first character in STRING." The "decimal" thing has no place here, because we are not talking about the printed representation of that integer. I would suggest the following, which also takes care of the second sentence in the current doc string: "Return the Unicode codepoint of the first character of STRING. Note: eight-bit characters are returned as single-byte values in the range 160 to 255, inclusive." From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Andreas Schwab Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 08:41:02 +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: To: Eli Zaretskii Cc: MON KEY , 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.12784920079992 (code B ref 6576); Wed, 07 Jul 2010 08:41:02 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 08:40:07 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWQAp-0002b7-Ab for submit@debbugs.gnu.org; Wed, 07 Jul 2010 04:40:07 -0400 Received: from mail-out.m-online.net ([212.18.0.9]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWQAm-0002ai-Sz for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 04:40:05 -0400 Received: from frontend1.mail.m-online.net (unknown [192.168.8.180]) by mail-out.m-online.net (Postfix) with ESMTP id BB7D41C15585; Wed, 7 Jul 2010 10:40:01 +0200 (CEST) Received: from hase.home (ppp-88-217-107-219.dynamic.mnet-online.de [88.217.107.219]) by mail.mnet-online.de (Postfix) with ESMTP id 3308A1C0046E; Wed, 7 Jul 2010 10:40:01 +0200 (CEST) From: Andreas Schwab References: <83630r934x.fsf@gnu.org> X-Yow: Hey, I LIKE that POINT!! Date: Wed, 07 Jul 2010 10:40:00 +0200 In-Reply-To: <83630r934x.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 07 Jul 2010 10:12:30 +0300") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: > "Return the Unicode codepoint of the first character of STRING. This is not correct. The value is just the internal encoding of the character. It's identical to (aref STRING 0) except that it returns 0 for the empty string. > Note: eight-bit characters are returned as single-byte values in the > range 160 to 255, inclusive." That depends on the multibyteness of the string. Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different." From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 10:35:01 +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: To: Andreas Schwab Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.127849887612827 (code B ref 6576); Wed, 07 Jul 2010 10:35:01 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 10:34:36 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWRxc-0003Kq-EQ for submit@debbugs.gnu.org; Wed, 07 Jul 2010 06:34:36 -0400 Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWRxZ-0003Kk-Bo for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 06:34:34 -0400 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0L5600F00NUEJP00@a-mtaout20.012.net.il> for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 13:33:29 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.120.144]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L5600F6YNZR0Q20@a-mtaout20.012.net.il>; Wed, 07 Jul 2010 13:33:28 +0300 (IDT) Date: Wed, 07 Jul 2010 13:31:27 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <834ogb8txc.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> X-Spam-Score: -1.9 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -1.9 (-) > From: Andreas Schwab > Cc: MON KEY , 6576@debbugs.gnu.org > Date: Wed, 07 Jul 2010 10:40:00 +0200 > > Eli Zaretskii writes: > > > "Return the Unicode codepoint of the first character of STRING. > > This is not correct. The value is just the internal encoding of the > character. Which is Unicode, AFAIK. The note takes care of the extension that is specific to Emacs. If there are other extensions that I forgot, we can add more notes. > It's identical to (aref STRING 0) I don't think talking about `(aref STRING 0)' in a doc string is a good idea. Only people who know quite a lot about the internal representation and what aref does in this case will understand such a documentation. > except that it returns 0 for the empty string This fact should probably be mentioned in the doc string. > > Note: eight-bit characters are returned as single-byte values in the > > range 160 to 255, inclusive." > > That depends on the multibyteness of the string. Eight-bit characters are defined as such only in multibyte strings. But I think the note is correct for unibyte strings as well, because they by definition include raw bytes. From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Andreas Schwab Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 12:17:01 +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: To: Eli Zaretskii Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.127850499717790 (code B ref 6576); Wed, 07 Jul 2010 12:17:01 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 12:16:37 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWTYL-0004ct-58 for submit@debbugs.gnu.org; Wed, 07 Jul 2010 08:16:37 -0400 Received: from mail-out.m-online.net ([212.18.0.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWTYI-0004cn-RT for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 08:16:35 -0400 Received: from frontend1.mail.m-online.net (unknown [192.168.8.180]) by mail-out.m-online.net (Postfix) with ESMTP id 36F7F1C003A9; Wed, 7 Jul 2010 14:16:29 +0200 (CEST) Received: from hase.home (ppp-88-217-107-219.dynamic.mnet-online.de [88.217.107.219]) by mail.mnet-online.de (Postfix) with ESMTP id D1A321C001CA; Wed, 7 Jul 2010 14:16:28 +0200 (CEST) From: Andreas Schwab References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> X-Yow: I'm in LOVE with DON KNOTTS!! Date: Wed, 07 Jul 2010 14:16:28 +0200 In-Reply-To: <834ogb8txc.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 07 Jul 2010 13:31:27 +0300") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: >> From: Andreas Schwab >> Cc: MON KEY , 6576@debbugs.gnu.org >> Date: Wed, 07 Jul 2010 10:40:00 +0200 >> >> Eli Zaretskii writes: >> >> > "Return the Unicode codepoint of the first character of STRING. >> >> This is not correct. The value is just the internal encoding of the >> character. > > Which is Unicode, AFAIK. No, it is an extension of Unicode. Eight-bit characters, for example, are not part of Unicode. >> > Note: eight-bit characters are returned as single-byte values in the >> > range 160 to 255, inclusive." >> >> That depends on the multibyteness of the string. > > Eight-bit characters are defined as such only in multibyte strings. That makes it even more incorrect. For multibyte strings you'll get the internal encoding, which is not in the range 160 to 255. Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different." From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 14:27:01 +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: To: Andreas Schwab Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.127851278521309 (code B ref 6576); Wed, 07 Jul 2010 14:27:01 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 14:26:25 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWVZw-0005Xe-R2 for submit@debbugs.gnu.org; Wed, 07 Jul 2010 10:26:25 -0400 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWVZu-0005XZ-NL for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 10:26:23 -0400 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0L5600K00YFPLG00@a-mtaout22.012.net.il> for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 17:25:42 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.120.144]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L5600FF7YQSRCC0@a-mtaout22.012.net.il>; Wed, 07 Jul 2010 17:25:42 +0300 (IDT) Date: Wed, 07 Jul 2010 17:23:40 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83y6dn74lv.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> X-Spam-Score: -1.9 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -1.9 (-) > From: Andreas Schwab > Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org > Date: Wed, 07 Jul 2010 14:16:28 +0200 > > Eli Zaretskii writes: > > >> From: Andreas Schwab > >> Cc: MON KEY , 6576@debbugs.gnu.org > >> Date: Wed, 07 Jul 2010 10:40:00 +0200 > >> > >> Eli Zaretskii writes: > >> > >> > "Return the Unicode codepoint of the first character of STRING. > >> > >> This is not correct. The value is just the internal encoding of the > >> character. > > > > Which is Unicode, AFAIK. > > No, it is an extension of Unicode. Eight-bit characters, for example, > are not part of Unicode. And that's why there's this note: > >> > Note: eight-bit characters are returned as single-byte values in the > >> > range 160 to 255, inclusive." > >> > >> That depends on the multibyteness of the string. > > > > Eight-bit characters are defined as such only in multibyte strings. > > That makes it even more incorrect. For multibyte strings you'll get the > internal encoding, which is not in the range 160 to 255. Sounds like a bug, assuming it's true. From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2010 15:49:01 +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: To: schwab@linux-m68k.org, monkey@sandpframing.com Cc: 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.127851774023442 (code B ref 6576); Wed, 07 Jul 2010 15:49:01 +0000 Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 15:49:00 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWWrs-000663-6Q for submit@debbugs.gnu.org; Wed, 07 Jul 2010 11:49:00 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWWrq-00065y-9Z for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 11:48:59 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0L57004002GYN800@a-mtaout23.012.net.il> for 6576@debbugs.gnu.org; Wed, 07 Jul 2010 18:48:45 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.120.144]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L570017V2L8PTA0@a-mtaout23.012.net.il>; Wed, 07 Jul 2010 18:48:45 +0300 (IDT) Date: Wed, 07 Jul 2010 18:46:44 +0300 From: Eli Zaretskii In-reply-to: <83y6dn74lv.fsf@gnu.org> X-012-Sender: halo1@inter.net.il Message-id: <83wrt770rf.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> X-Spam-Score: -1.9 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -1.9 (-) > Date: Wed, 07 Jul 2010 17:23:40 +0300 > From: Eli Zaretskii > Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org > > > >> > Note: eight-bit characters are returned as single-byte values in the > > >> > range 160 to 255, inclusive." > > >> > > >> That depends on the multibyteness of the string. > > > > > > Eight-bit characters are defined as such only in multibyte strings. > > > > That makes it even more incorrect. For multibyte strings you'll get the > > internal encoding, which is not in the range 160 to 255. > > Sounds like a bug, assuming it's true. 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." From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: To: Eli Zaretskii Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106010904340 (code B ref 6576); Wed, 13 Jul 2011 23:52:03 +0000 Received: (at 6576) by debbugs.gnu.org; 13 Jul 2011 23:51:30 +0000 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 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 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 From: Lars Magne Ingebrigtsen In-Reply-To: <83wrt770rf.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 07 Jul 2010 18:46:44 +0300") 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> 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 MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1Qh9Cy-0007SY-31 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311205872.64796@GQIy3vivKZVsSoIVrPOa4g X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) 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/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 02:14:01 +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: To: Lars Magne Ingebrigtsen Cc: Eli Zaretskii , monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131060959225356 (code B ref 6576); Thu, 14 Jul 2011 02:14:01 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 02:13:12 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhBQM-0006av-Kv for submit@debbugs.gnu.org; Wed, 13 Jul 2011 22:13:11 -0400 Received: from vm-emlprdomr-03.its.yale.edu ([130.132.50.144]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhBQL-0006ag-QL for 6576@debbugs.gnu.org; Wed, 13 Jul 2011 22:13:10 -0400 Received: from furball (dhcp128036014059.central.yale.edu [128.36.14.59]) (authenticated bits=0) by vm-emlprdomr-03.its.yale.edu (8.14.4/8.14.4) with ESMTP id p6E2D3X5011510 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Wed, 13 Jul 2011 22:13:03 -0400 From: Chong Yidong References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> Date: Wed, 13 Jul 2011 22:13:02 -0400 In-Reply-To: (Lars Magne Ingebrigtsen's message of "Thu, 14 Jul 2011 01:50:59 +0200") Message-ID: <87ipr5pq35.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.144 X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Lars Magne Ingebrigtsen writes: > 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? How bout linking to the `String and Character Basics' node in the Elisp manual instead? From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 03:05: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: To: Lars Magne Ingebrigtsen Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106127012072 (code B ref 6576); Thu, 14 Jul 2011 03:05:03 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 03:05:01 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhCEW-0000XM-KP for submit@debbugs.gnu.org; Wed, 13 Jul 2011 23:05:01 -0400 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhCEU-0000X0-3g for 6576@debbugs.gnu.org; Wed, 13 Jul 2011 23:04:59 -0400 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LOA00700Z7KOB00@a-mtaout22.012.net.il> for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 06:04:51 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.156.102]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LOA0073CZ81J3D0@a-mtaout22.012.net.il>; Thu, 14 Jul 2011 06:04:51 +0300 (IDT) Date: Thu, 14 Jul 2011 06:06:56 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83pqldef1r.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.0 (--) > From: Lars Magne Ingebrigtsen > Cc: schwab@linux-m68k.org, monkey@sandpframing.com, 6576@debbugs.gnu.org > Date: Thu, 14 Jul 2011 01:50:59 +0200 > > > "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. Which other functions would need this? > Is there a specific reason this particular function deserves this > detailed explanation? If you can suggest a better one that takes care of the original bug report, please show your suggestion. From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: Thu, 14 Jul 2011 13:04:02 +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: To: Eli Zaretskii Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106486121688 (code B ref 6576); Thu, 14 Jul 2011 13:04:02 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 13:03:32 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhLZg-0000R3-4S for submit@debbugs.gnu.org; Thu, 14 Jul 2011 09:03:32 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhLZU-0000QX-Eo for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 09:03:20 -0400 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 1QhLZG-0005Xr-M7; Thu, 14 Jul 2011 15:03:02 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <83pqldef1r.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 14 Jul 2011 06:06:56 +0300") Date: Thu, 14 Jul 2011 15:00:17 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAHlBMVEUBAQNRHyYEBAUAAAFY XG4CAgQBAgPDvbcMBwoCAgLJIrQxAAACbElEQVQ4jWVUPYvcMBAVHE4vEJzLoCDwdkvEBVQaBL5y 0aFCXZoLpFwwuF6RQmXAKDD/Nm+k/eC4AYM8T28+pDcSWeuplDwVPemiSw74KzlPIk8adnBxYlzr GPTEmwW7DVXdbdrYVu+9ABrIphBjBBA+AJroQJRqTG7owLKtohiKZBIAioZeroBvANV9t5ZcjKk+ GNnsjuB31nFARF88m9BIu9uG0P6dpPISn1co10RyHIlRK9nUq//DfUT6Zoncbl9ssxqM1lzuvted HDJxLpgL6B/AAR74bU2dQDXoxkAHMICxE2psQNGxAuFyHVNQx2AYmLKJqB+emv42yvHEpya83/yy fTZxW6yfgdWv12MAe7suFgC+FDlK6W/WrgOAfy0SwIVPiD3bsnVgHS+zmscRPC9nufS4DGx+BmUs lxZu8XPPcZbqrDqgvOrBQEJVcF74rMeL6oX69bmVe5alXcIoZ25H8fqsAMyyG3j+/qNaqDtwN8U5 bo7x4ZfzM4DCKZT8YChD+NZxqxMNPA5G5KzNDlUT4d7MSRyfBpbxJCYd+WrtSxqgF8EXNbC+hc7Q MuTx4ws2np6O9ihiByAr168WDmEF+zuQdg4FXRlQHAcK4cogCIX3w4bhFDCLkXNAI+D+4wAQeHjD EDYADLv3/dA3okFWpgEJesbQxHeew9MJfYQGoAtUBcovJgnxBIWCLEKqNb7xPMNt4vvXOCBSmEQ4 YCrfQNHBIMRPfIEfAYGiXDKUWOFw/uYCDAM6Y5arOfCwIBwDvAcMrEx7MVjjuiXmZ4dHzeBXtwcI HhALXqEi8OIEfnia5dKczPgPd5FSJEFcq9AAAAAASUVORK5CYII= X-Now-Playing: Depeche Mode's _Stripped_: "Black day" X-Hashcash: 1:23:110714:schwab@linux-m68k.org::66alXSSNupNpyoWS:0000000000000000000000000000000000000000B51n X-Hashcash: 1:23:110714:6576@debbugs.gnu.org::4KFgJKeU/ZAyOehw:00000000000000000000000000000000000000000MC2/ X-Hashcash: 1:23:110714:monkey@sandpframing.com::/2XwhppGt3iods4n:00000000000000000000000000000000000001oP53 X-Hashcash: 1:23:110714:eliz@gnu.org::KKL3lNzC7aLbpmK2:00001y8F0 MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhLZG-0005Xr-M7 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311253383.31528@Esj9qxZ9hbpjTpjHKhpn1Q X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: >> 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. > > Which other functions would need this? `char-after', `aref' on a string, `following-char'... Basically anything that returns a character. >> Is there a specific reason this particular function deserves this >> detailed explanation? > > If you can suggest a better one that takes care of the original bug > report, please show your suggestion. I think "close, notabug" would have taken care of the bug report. :-) -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: Thu, 14 Jul 2011 13:04: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: To: Chong Yidong Cc: Eli Zaretskii , monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106486161698 (code B ref 6576); Thu, 14 Jul 2011 13:04:03 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 13:03:36 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhLZk-0000RC-70 for submit@debbugs.gnu.org; Thu, 14 Jul 2011 09:03:36 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhLZX-0000Qa-2K for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 09:03:24 -0400 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 1QhLZH-0005Xs-Vm; Thu, 14 Jul 2011 15:03:04 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <87ipr5pq35.fsf@stupidchicken.com> (Chong Yidong's message of "Wed, 13 Jul 2011 22:13:02 -0400") Date: Thu, 14 Jul 2011 15:02:53 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <87ipr5pq35.fsf@stupidchicken.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAGFBMVEUPDREVCBAPDhOTiXoU AApKLDUaEhcSEBVci6nPAAACU0lEQVQ4jWWTzU/cMBDFR1ZVrhi8OUe++Fx50143yIQrsGtzrUVi rsiH+t/vm3EKSB1pN9L88ubj2aF3GlVtuQxFS5gTcVxR285+j/gZj4raR/5rPFpyXxUfoudGyrX2 p+VDXGez+Itf76wlso6uGocB0JrB5c5ZDiodbAA5CrBVABcSkLUW8OAaiAMob61pKOZ8L6BVEEeO KzkTpzVIj+ND40qtg2ZiFHD0R0xllfSArhYGRsCJWDECsHTz0Qg4i4KnckI27zODCwNO1N7DFhhS 1h1wyLhYxIi3BeBysn2qfUHvNxCfXi84j7EreFHtp3u2edp2BS9oSRHA9vTK1sNE9KyNbHPvyg5+ iqkM3p8Tptp7VNiJVEza5C2VG6Rr7wF06EDvoNvO0YFOb2ZG8yaby+odzFMKAYDdws/9KwVL/DHI uLWSHdnL2+inZGbMFsRdbNBGbGJ38COjFJJyE+XAbieUCiEI4IDCtjrSYQfrugNHVp63vDlAWDpQ ihQTTBU7COEa7o4MlB1VO8DzJxbk8JsLwRLsUS2DhMZmKQCuMlA44lo7MCsDyxncdnuFgYeylTXc r0NZni17xAAmk86HYsJS4tPyC217D2bZDMmEoM9pfsYn45TjmSHJesCNW01MyzPexaj8urP06hO+ WgEvACNKkVzUs/9ZBp2LADRRHZCARReA8sKWWHEK1bZzAtBoXt7EW0tV0BZLmRnEfKNoRzzZIRYd QgnnKV+L3VYOCyBh8TAHKD4Bx5CxOCLGfKKvYeb/wLv8f1sYzAGXq4PvfwFj2/xGAtYVNAAAAABJ RU5ErkJggg== X-Now-Playing: Depeche Mode's _Black Celebration_ X-Hashcash: 1:23:110714:schwab@linux-m68k.org::QzdXzCJSqr9/Gml3:0000000000000000000000000000000000000000BgUg X-Hashcash: 1:23:110714:monkey@sandpframing.com::hCbeHnuukLNzhoSD:000000000000000000000000000000000000009TTj X-Hashcash: 1:23:110714:eliz@gnu.org::eL8/rbqWljCdsZvt:00000QAGR X-Hashcash: 1:23:110714:cyd@stupidchicken.com::x5X5owI7FqlzM9eV:0000000000000000000000000000000000000000FNRU X-Hashcash: 1:23:110714:6576@debbugs.gnu.org::PiAy9UVyDziT6PQl:00000000000000000000000000000000000000000XD1N MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhLZH-0005Xs-Vm X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311253384.13164@Ehvis4bbXNVerf7BIL5j/A X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Chong Yidong writes: > How bout linking to the `String and Character Basics' node in the Elisp > manual instead? I can do that if you want, but wouldn't it be better just to leave it as -- Return the first character in STRING. A multibyte character is handled correctly. -- If somebody then wonders (and they shouldn't) "hm, what's a character, then?", they probably already know that a manual exists. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 13:35:04 +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: To: Lars Magne Ingebrigtsen Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.13106504694952 (code B ref 6576); Thu, 14 Jul 2011 13:35:04 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 13:34:29 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhM3g-0001Hp-Gu for submit@debbugs.gnu.org; Thu, 14 Jul 2011 09:34:28 -0400 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhM3d-0001Ha-SV for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 09:34:27 -0400 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1QhM3X-0002UK-KF; Thu, 14 Jul 2011 09:34:19 -0400 Date: Thu, 14 Jul 2011 09:34:19 -0400 Message-Id: From: Eli Zaretskii In-reply-to: (message from Lars Magne Ingebrigtsen on Thu, 14 Jul 2011 15:00:17 +0200) References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> X-Spam-Score: -6.6 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.6 (------) > From: Lars Magne Ingebrigtsen > Cc: schwab@linux-m68k.org, monkey@sandpframing.com, 6576@debbugs.gnu.org > Date: Thu, 14 Jul 2011 15:00:17 +0200 > > > Which other functions would need this? > > `char-after', `aref' on a string, `following-char'... Basically > anything that returns a character. > > >> Is there a specific reason this particular function deserves this > >> detailed explanation? > > > > If you can suggest a better one that takes care of the original bug > > report, please show your suggestion. > > I think "close, notabug" would have taken care of the bug report. :-) The original problem which triggered the report was this part, and this part only: A multibyte character is handled correctly. To make a decent job for this bug, we need, as a minimum, to do something with this unparsable sentence. I admit that my suggestion went well beyond that, but if we want to take a step back, please suggest what to say instead. I hope you agree that this sentence cannot be left as-is. (To know what is meant by this sentence, look at the source of the function.) From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: Thu, 14 Jul 2011 14:08:01 +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: To: Eli Zaretskii Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131065242316036 (code B ref 6576); Thu, 14 Jul 2011 14:08:01 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 14:07:03 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMZ9-0004AI-Ea for submit@debbugs.gnu.org; Thu, 14 Jul 2011 10:07:03 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMZ4-0004A1-Kl for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 10:06:58 -0400 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 1QhMYp-0007H4-AE; Thu, 14 Jul 2011 16:06:39 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: (Eli Zaretskii's message of "Thu, 14 Jul 2011 09:34:19 -0400") Date: Thu, 14 Jul 2011 16:06:34 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAFVBMVEVHYXeew+kXGyJdfpwz Q1F2nscDAgNWmM19AAACWUlEQVQ4jWWTTXOjMAyGVez0HMblzjheziTCe1YdL+ckwvcO0/H//wkr O2Syzb4HGPSgD0syxIdC/CEggAm0jnHIojVvWoHGcQLQFOdXMBWPQE343wMQxce+AMU++aQJXgER 7cA3Ub+GCm6Ki7tFaF6AdorQoyNdv1c7bMB+K/CJT1EXS584bGD4Jg0A7MpBvjldcrYuio2cwv3h QzVRft1xYkxFFwj9AWPAuMQmH8QyAY7CGMgS2o9fk3cxfyVO0jxFdzBgj2fkk6QQDwVKQQlFvRWz pC8pBIS1CX0F9qTmXIs/pFY8pBU1VFxJva+l5xKo7dK1FRUA9oub+T3XQAI2Mdg1Y1x/51prazbS MQwCSIAEuopHW81tewf9esq7Gr67Z+lQw2AF2NP5kbc4YZBxF+Dm6dg+JE05Bxgh2Mz0BN1CDVCQ A1sBdmrugAl1nYJoKKA5FcB6cCBmHZVncAW8L0epHKKNBaAUbiTHyjYs2ERZ1khlFq2UZ6BxkYO7 6QZKw73UXKs24Jzn0N/kd+Xba/co2sBAied+AbWd7wlcMnN/e2t/qnqYU3/71+gqsCoZT8vT3LWh grMa2V8uT3A7LhUoxUbm9QT76/zZieUs65lYP1qbrnu0h4gj7FRnPI8y8EmP2k1vxucDFbBLBj3U +wxAeG1VPoBM0HsB3Mt9DiESSTLZYRQPaY/xsneIZQmS5HnPn6UqL+dIzMd778pjvoOdr+DZKBPy 2x2w8f4B5LWPD+ANJn5uyVLBHmBURo+Xc9pydHEDCuBCWrvQ90qhwtHG4Y8s9V/2WuQ28l2IFAAA AABJRU5ErkJggg== X-Now-Playing: Depeche Mode's _Some Great Reward_: "Master And Servant" X-Hashcash: 1:23:110714:schwab@linux-m68k.org::jHw+B77Da9uhmlYP:00000000000000000000000000000000000000003RAT X-Hashcash: 1:23:110714:monkey@sandpframing.com::TlL7wxuz3jutGZMT:000000000000000000000000000000000000005LeQ X-Hashcash: 1:23:110714:eliz@gnu.org::eCsM82JwdM9OnXg2:00000UWiU X-Hashcash: 1:23:110714:6576@debbugs.gnu.org::8VZbxlPIdMFzppeh:00000000000000000000000000000000000000001BVWl MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhMYp-0007H4-AE X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311257199.4059@ymkoBTV2gMBsRQW5rEpm0Q X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: > The original problem which triggered the report was this part, and > this part only: > > A multibyte character is handled correctly. I understand why it is there, because (presumably) in the olden times, this wasn't always true? But I think that line can be deleted, too. If the function returns the first character, then it returns the first character... -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 15:58:02 +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: To: Lars Magne Ingebrigtsen Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131065906913672 (code B ref 6576); Thu, 14 Jul 2011 15:58:02 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 15:57:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOIO-0003YS-1h for submit@debbugs.gnu.org; Thu, 14 Jul 2011 11:57:48 -0400 Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOIM-0003YG-Aw for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 11:57:46 -0400 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LOB00300YSKF900@a-mtaout20.012.net.il> for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 18:57:40 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.156.102]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LOB0022QZ02UFB0@a-mtaout20.012.net.il>; Thu, 14 Jul 2011 18:57:40 +0300 (IDT) Date: Thu, 14 Jul 2011 18:59:45 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83mxggetu6.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.0 (--) > From: Lars Magne Ingebrigtsen > Cc: schwab@linux-m68k.org, monkey@sandpframing.com, 6576@debbugs.gnu.org > Date: Thu, 14 Jul 2011 16:06:34 +0200 > > > A multibyte character is handled correctly. > > I understand why it is there, because (presumably) in the olden times, > this wasn't always true? > > But I think that line can be deleted, too. If you delete it, how would users know what does this function do with unibyte strings? What numerical value will it return when passed a unibyte string? From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: Thu, 14 Jul 2011 16:13:01 +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: To: Eli Zaretskii Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131065996914968 (code B ref 6576); Thu, 14 Jul 2011 16:13:01 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 16:12:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOWr-0003tI-36 for submit@debbugs.gnu.org; Thu, 14 Jul 2011 12:12:49 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOWm-0003t4-EF for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 12:12:44 -0400 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 1QhOWZ-0004GY-Mu; Thu, 14 Jul 2011 18:12:27 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <83mxggetu6.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 14 Jul 2011 18:59:45 +0300") Date: Thu, 14 Jul 2011 18:12:24 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> <83mxggetu6.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAFVBMVEUtGBSKWz0fCQvzzXTD hF9KLh9dQCr6v6FSAAACbklEQVQ4jWWTTW/bMAyGmazKOUwknV1hzT2I1/MMqznLWaizlYb8/z9h lLz0AxNgA+Yjki8/DKeP44koj48v+LCf1UxQ/gN9AoAEeb98fYI3qKcDfIB+PLW4VO3rrvvn8uFx TO0+dPn6HbxCMi0YTd+BT4k0N5HM3wFnEjNT9sjjV9BzllI8FUTefwVHmjzaQRBR3r8BLmhtjxbR //kKXhkxRmvjA/QPIBYt2+yL+Kev4FeOPlMkFUfXWI+CGMf4lgcNNrqCZ6Ogb0Df8Y2ckWF/jCx0 ryEqqMQlnly0fZSh2BqpwLgALhrAalDVpg86iOMC7mrElvYe7e2wg+aILPdmHPVSQbfWfkZby60e 6tJXoDWmAOphB/TEKvJkGxjEJZNAhCEEQ5MCPyjwDtJtrS6hHqBsqyIVIq6Di1qaXT2yqmjSi1+3 qw8wYbUrmHzJHQTgVIHOeqh6YjxP3p5Bc+gI1qEjmoY46GCjQ6+lbDegGYdEc8tRPQi9PcXzClS9 IqbcSrcDebkfty7A6RhW24NuunZx2SL0u6pqf9P3JnOeVkocweSb3kXuJrtJLlctm2ilG/QosMtZ h3oLJhl+ecbiEyzAiHiMGtNoM2gS5PAJyjDXyEyJpCDP0CJV4LdLj2aTceDa8vCiwOWpgYO5gdEs retGWJjKXMFPByEv6UOnVeg6+VTBj52NGcVfKuDMrvDc2jzudOdFREFnaEOSZb7UFKftVUdMqXqQ MdoR4Qqe+6JgIK5gPqiLpmmielppL32to7sdSEfuOLRQukd9v4D0wvobe2n1MT/VzZpVbncBbQMJ hU5BnDfv428C+guZS/A2IbIE1AAAAABJRU5ErkJggg== X-Now-Playing: Joni Mitchell's _Clouds_ X-Hashcash: 1:23:110714:monkey@sandpframing.com::CkHBo2TTkXNtHRAC:000000000000000000000000000000000000002xb7 X-Hashcash: 1:23:110714:schwab@linux-m68k.org::qFveywjYCbTc3ohD:00000000000000000000000000000000000000006GnM X-Hashcash: 1:23:110714:eliz@gnu.org::Pi3TYa6qM1Mfh+s4:00000F3F4 X-Hashcash: 1:23:110714:6576@debbugs.gnu.org::GAs1avLIpgp/vktD:00000000000000000000000000000000000000000BYcm MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhOWZ-0004GY-Mu X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311264747.84038@TvOpdmmAAsNUejXurRf2Jg X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: > If you delete it, how would users know what does this function do with > unibyte strings? What numerical value will it return when passed a > unibyte string? Isn't the same the case with `char-after' in a unibyte buffer, for instance? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 19:37:02 +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: To: Lars Magne Ingebrigtsen Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131067221027977 (code B ref 6576); Thu, 14 Jul 2011 19:37:02 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 19:36:50 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhRiL-0007HB-Kn for submit@debbugs.gnu.org; Thu, 14 Jul 2011 15:36:50 -0400 Received: from mtaout21.012.net.il ([80.179.55.169]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhRiJ-0007Gz-TV for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 15:36:48 -0400 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0LOC000008ZN4300@a-mtaout21.012.net.il> for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 22:35:20 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.156.102]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LOC00NDJ92V3S40@a-mtaout21.012.net.il>; Thu, 14 Jul 2011 22:35:20 +0300 (IDT) Date: Thu, 14 Jul 2011 22:37:26 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83bowwirgp.fsf@gnu.org> References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> <83mxggetu6.fsf@gnu.org> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.0 (--) > From: Lars Magne Ingebrigtsen > Cc: schwab@linux-m68k.org, monkey@sandpframing.com, 6576@debbugs.gnu.org > Date: Thu, 14 Jul 2011 18:12:24 +0200 > > Eli Zaretskii writes: > > > If you delete it, how would users know what does this function do with > > unibyte strings? What numerical value will it return when passed a > > unibyte string? > > Isn't the same the case with `char-after' in a unibyte buffer, for > instance? Yes, but so what? Are you sure users know what that does? From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect 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: Thu, 14 Jul 2011 19:40: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: To: Eli Zaretskii Cc: monkey@sandpframing.com, schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131067236928238 (code B ref 6576); Thu, 14 Jul 2011 19:40:03 +0000 Received: (at 6576) by debbugs.gnu.org; 14 Jul 2011 19:39:29 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhRku-0007LP-SJ for submit@debbugs.gnu.org; Thu, 14 Jul 2011 15:39:29 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhRks-0007LC-TV for 6576@debbugs.gnu.org; Thu, 14 Jul 2011 15:39:27 -0400 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 1QhRkf-0007it-AQ; Thu, 14 Jul 2011 21:39:13 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <83bowwirgp.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 14 Jul 2011 22:37:26 +0300") Date: Thu, 14 Jul 2011 21:39:09 +0200 Message-ID: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> <83mxggetu6.fsf@gnu.org> <83bowwirgp.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAElBMVEVMZD/l4dCFoIhqhWak uKgjKBJFDs5SAAACY0lEQVQ4jV2TW3LkIAxFVSZegBMW4Ajmn5LwfxtrAVR32P9W5srtzmRCPwpz kHT1MLW8x8XXvvy3yLDOXVx2sxhfNygCnFtbsIsW9x3fJdLyAvGno2hku+Xnfv8BWyX7vB6jnWA/ I2YlfqmKbf8WZpwIji5wOrvA0Sgz5xf4Dt2SUlJu+ZcqY2Fire+eZPwJVAOJiv1ydNihRKbCnsH+ D+jyUYia6hn9BTzw8gELVRXJV3Az5qS6uCsNqrgdXTZLYuUx3rZxWtTFIg78Ln4AfX6C3NhaEnbV lm/beKP+BEX8+lWRto0wuhCQBVegl9p8aMYjlVDbJEqaLrl70yVpolAyB9Eg7VldtPowRYJhaoGK JjkaagAVkH3TFaSmMA8EWfFLSFbYM0gwCQAw0eyJqGTj48g3ovlBng9JjugDEvy01ipczZ22MY/x yB778Ozzu/YT4HgMqq42iRpTOxyMcIIRMopbVSrfyh9xcFr0EWQlmlxzm0o7wXhaUJEUNOeU5Mvo 8gOLTsE7ku1YN9tJtyeYZlIQ6M3HfMdQX+BRUR8tYnB3bHhTTtDHwHMqWaVIbSksuVFwC4hRv79O mT9zu5slemrNjL5h/CZk0uzerFDxctBD59HRFGpe+S8Ui3QGQAHwF4qQsFi7izKAu/JzCt6DVq35 jODjwdFhpA7BemDyOs+Bgpt0dGhzX6He8loeCe3Q4pPXMUHUUc5p5XX04lOFSfGp07PXpRdO6BBG Ecl60zAEmjCPZWOeyVfyu2gBc8E0Ju2IvUIdgFSDEj4Hpglxuie8G+TXYSC8ul+WVdYHzsNfdImx 3oDWlmgAAAAASUVORK5CYII= X-Now-Playing: Joni Mitchell's _For The Roses_: "Cold Blue Steel And Sweet Fire" X-Hashcash: 1:23:110714:schwab@linux-m68k.org::wUFsJlRw+QwBN13Y:00000000000000000000000000000000000000006uxM X-Hashcash: 1:23:110714:6576@debbugs.gnu.org::v9lBW+N96QZpXReu:000000000000000000000000000000000000000007AJD X-Hashcash: 1:23:110714:eliz@gnu.org::+qPMaAo5VmQD1cjn:00000B7b7 X-Hashcash: 1:23:110714:monkey@sandpframing.com::OQnA8/G6dEn8ZbDQ:00000000000000000000000000000000000000qKSq MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhRkf-0007it-AQ X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311277153.80456@SC2MLn+PErt2fmmkHSz0wg X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: > Yes, but so what? Are you sure users know what that does? No, not really. :-) I think these functions should say that they return a character, and if that's not sufficient, they should refer you to the manual to explain what Emacs means by a character. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 Jul 2011 19:07:02 +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: To: Lars Magne Ingebrigtsen Cc: Eli Zaretskii , schwab@linux-m68k.org, 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131075680320353 (code B ref 6576); Fri, 15 Jul 2011 19:07:02 +0000 Received: (at 6576) by debbugs.gnu.org; 15 Jul 2011 19:06:43 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qhnik-0005ID-T3 for submit@debbugs.gnu.org; Fri, 15 Jul 2011 15:06:43 -0400 Received: from mail-iw0-f172.google.com ([209.85.214.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qhnii-0005I1-Pj for 6576@debbugs.gnu.org; Fri, 15 Jul 2011 15:06:41 -0400 Received: by iwn39 with SMTP id 39so1323117iwn.3 for <6576@debbugs.gnu.org>; Fri, 15 Jul 2011 12:06:34 -0700 (PDT) MIME-Version: 1.0 Received: by 10.231.121.140 with SMTP id h12mr3405086ibr.101.1310756794385; Fri, 15 Jul 2011 12:06:34 -0700 (PDT) Received: by 10.231.18.19 with HTTP; Fri, 15 Jul 2011 12:06:34 -0700 (PDT) In-Reply-To: References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> <83mxggetu6.fsf@gnu.org> <83bowwirgp.fsf@gnu.org> Date: Fri, 15 Jul 2011 15:06:34 -0400 X-Google-Sender-Auth: wEoO57_1No9Dc589Kb2LTuK6_zo Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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: -3.4 (---) On Thu, Jul 14, 2011 at 3:39 PM, Lars Magne Ingebrigtsen w= rote: > No, not really. =C2=A0:-) =C2=A0I think these functions should say that t= hey > return a character, and if that's not sufficient, they should refer you > to the manual to explain what Emacs means by a character. If it doesn't do what it says or then a pointer into the manual won't help clarify the underlying issue and only glosses over it. -- /s_P\ From unknown Sun Aug 17 01:45:55 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6576: documentation `string-to-char' is incorrect Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 21 Jul 2011 18:39:02 +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: To: MON KEY Cc: Lars Magne Ingebrigtsen , schwab@linux-m68k.org, Eli Zaretskii , 6576@debbugs.gnu.org Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.131127352925153 (code B ref 6576); Thu, 21 Jul 2011 18:39:02 +0000 Received: (at 6576) by debbugs.gnu.org; 21 Jul 2011 18:38:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qjy92-0006Xe-AF for submit@debbugs.gnu.org; Thu, 21 Jul 2011 14:38:48 -0400 Received: from vm-emlprdomr-06.its.yale.edu ([130.132.50.147]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qjy8z-0006XH-RL for 6576@debbugs.gnu.org; Thu, 21 Jul 2011 14:38:46 -0400 Received: from furball ([128.36.225.144]) (authenticated bits=0) by vm-emlprdomr-06.its.yale.edu (8.14.4/8.14.4) with ESMTP id p6LIcd8d022538 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Thu, 21 Jul 2011 14:38:39 -0400 From: Chong Yidong References: <83630r934x.fsf@gnu.org> <834ogb8txc.fsf@gnu.org> <83y6dn74lv.fsf@gnu.org> <83wrt770rf.fsf@gnu.org> <83pqldef1r.fsf@gnu.org> <83mxggetu6.fsf@gnu.org> <83bowwirgp.fsf@gnu.org> Date: Thu, 21 Jul 2011 14:38:38 -0400 In-Reply-To: (MON KEY's message of "Fri, 15 Jul 2011 15:06:34 -0400") Message-ID: <87ei1jtr69.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.147 X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) MON KEY writes: >> I think these functions should say that they return a character, and >> if that's not sufficient, they should refer you to the manual to >> explain what Emacs means by a character. > > If it doesn't do what it says or then a pointer into the manual won't > help clarify the underlying issue and only glosses over it. I removed the explanation of what a character is; there's no need to do that here, or in all the other character-related functions like char-after. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 21 14:38:43 2011 Received: (at control) by debbugs.gnu.org; 21 Jul 2011 18:38:43 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qjy8w-0006XP-Og for submit@debbugs.gnu.org; Thu, 21 Jul 2011 14:38:43 -0400 Received: from vm-emlprdomr-03.its.yale.edu ([130.132.50.144]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qjy8u-0006XB-Cu for control@debbugs.gnu.org; Thu, 21 Jul 2011 14:38:41 -0400 Received: from furball ([128.36.225.144]) (authenticated bits=0) by vm-emlprdomr-03.its.yale.edu (8.14.4/8.14.4) with ESMTP id p6LIcYRp031192 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT) for ; Thu, 21 Jul 2011 14:38:34 -0400 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 6576 Date: Thu, 21 Jul 2011 14:38:33 -0400 Message-ID: <877h7bjx7a.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.144 X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) close 6576 thanks