From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#6576: documentation `string-to-char' is incorrect Date: Wed, 07 Jul 2010 10:12:30 +0300 Message-ID: <83630r934x.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1278487809 17168 80.91.229.12 (7 Jul 2010 07:30:09 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 7 Jul 2010 07:30:09 +0000 (UTC) Cc: 6576@debbugs.gnu.org To: MON KEY Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 07 09:30:06 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OWP54-0001t5-1a for geb-bug-gnu-emacs@m.gmane.org; Wed, 07 Jul 2010 09:30:06 +0200 Original-Received: from localhost ([127.0.0.1]:35603 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OWP52-0002RO-Sd for geb-bug-gnu-emacs@m.gmane.org; Wed, 07 Jul 2010 03:30:04 -0400 Original-Received: from [140.186.70.92] (port=41656 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OWP4q-0002Pw-LR for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2010 03:29:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OWP4p-0000Js-Ab for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2010 03:29:52 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46140) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OWP4p-0000Jn-7Z for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2010 03:29:51 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OWOqU-0001zP-RH; Wed, 07 Jul 2010 03:15:02 -0400 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 6576-submit@debbugs.gnu.org id=B6576.12784868817626 (code B ref 6576); Wed, 07 Jul 2010 07:15:02 +0000 Original-Received: (at 6576) by debbugs.gnu.org; 7 Jul 2010 07:14:41 +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 1OWOq8-0001yx-Fu for submit@debbugs.gnu.org; Wed, 07 Jul 2010 03:14:40 -0400 Original-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 Original-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) Original-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) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 07 Jul 2010 03:15:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:38279 Archived-At: > 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."