From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#8262: string-make-*byte in elisp manual Date: Wed, 16 Mar 2011 13:40:50 -0400 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1300298840 1479 80.91.229.12 (16 Mar 2011 18:07:20 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 Mar 2011 18:07:20 +0000 (UTC) Cc: 8262-done@debbugs.gnu.org To: Arni Magnusson Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Mar 16 19:07:15 2011 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 1Pzv7p-0005AG-5F for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Mar 2011 19:07:13 +0100 Original-Received: from localhost ([127.0.0.1]:58226 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pzv7o-0006sB-6x for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Mar 2011 14:07:12 -0400 Original-Received: from [140.186.70.92] (port=39446 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pzv7h-0006pg-0K for bug-gnu-emacs@gnu.org; Wed, 16 Mar 2011 14:07:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pzv7e-0008WA-JD for bug-gnu-emacs@gnu.org; Wed, 16 Mar 2011 14:07:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58201) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pzv7e-0008W2-72 for bug-gnu-emacs@gnu.org; Wed, 16 Mar 2011 14:07:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PzujS-0005cY-M2 for bug-gnu-emacs@gnu.org; Wed, 16 Mar 2011 13:42:02 -0400 Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Mar 2011 17:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 8262 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 8262@debbugs.gnu.org, monnier@iro.umontreal.ca Original-Received: via spool by 8262-done@debbugs.gnu.org id=D8262.130029727521551 (code D ref 8262); Wed, 16 Mar 2011 17:42:02 +0000 Original-Received: (at 8262-done) by debbugs.gnu.org; 16 Mar 2011 17:41:15 +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 1Pzuig-0005bX-FC for submit@debbugs.gnu.org; Wed, 16 Mar 2011 13:41:14 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pzuid-0005bK-W9 for 8262-done@debbugs.gnu.org; Wed, 16 Mar 2011 13:41:12 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AvsEAIOTgE1MCqJN/2dsb2JhbACmD3jBNoVjBJVa X-IronPort-AV: E=Sophos;i="4.63,195,1299474000"; d="scan'208";a="96856885" Original-Received: from 76-10-162-77.dsl.teksavvy.com (HELO ceviche.home) ([76.10.162.77]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 16 Mar 2011 13:40:51 -0400 Original-Received: by ceviche.home (Postfix, from userid 20848) id F1386660BB; Wed, 16 Mar 2011 13:40:50 -0400 (EDT) In-Reply-To: (Arni Magnusson's message of "Tue, 15 Mar 2011 21:36:09 +0000 (UTC)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 16 Mar 2011 13:42:02 -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: , 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:45074 Archived-At: > The elisp manual mentions the functions `string-make-multibyte' and > string-make-unibyte' in two places (Sections 4.6 and 22.15), indicating that > these functions are defined in greater detail in Section 33.2. > This is not the case, however. Shouldn't these functions be defined in > Section 33.2? Thanks for spotting this. Indeed, the functions now documented are string-to-*byte instead, whose semantic is less likely to introduce bugs (or rather more likely to make those bugs apparent rather than latent). So I've installed the patch below. Stefan === modified file 'doc/lispref/keymaps.texi' --- doc/lispref/keymaps.texi 2011-02-19 19:40:59 +0000 +++ doc/lispref/keymaps.texi 2011-03-16 14:39:56 +0000 @@ -1705,15 +1705,11 @@ @noindent and your language environment is multibyte Latin-1, these commands -actually bind the multibyte character with code 2294, not the unibyte -Latin-1 character with code 246 (@kbd{M-v}). In order to use this -binding, you need to enter the multibyte Latin-1 character as keyboard -input. One way to do this is by using an appropriate input method -(@pxref{Input Methods, , Input Methods, emacs, The GNU Emacs Manual}). - - If you want to use a unibyte character in the key binding, you can -construct the key sequence string using @code{multibyte-char-to-unibyte} -or @code{string-make-unibyte} (@pxref{Converting Representations}). +actually bind the multibyte character with code 246, not the byte +code 246 (@kbd{M-v}) sent by a Latin-1 terminal. In order to use this +binding, you need to teach Emacs how to decode the keyboard by using an +appropriate input method (@pxref{Input Methods, , Input Methods, emacs, The GNU +Emacs Manual}). @deffn Command global-set-key key binding This function sets the binding of @var{key} in the current global map === modified file 'doc/lispref/nonascii.texi' --- doc/lispref/nonascii.texi 2011-01-25 04:08:28 +0000 +++ doc/lispref/nonascii.texi 2011-03-16 14:44:14 +0000 @@ -167,7 +167,7 @@ user that cannot be overridden automatically. Converting unibyte text to multibyte text leaves @acronym{ASCII} -characters unchanged, and converts bytes with codes 128 through 159 to +characters unchanged, and converts bytes with codes 128 through 255 to the multibyte representation of raw eight-bit bytes. Converting multibyte text to unibyte converts all @acronym{ASCII} === modified file 'doc/lispref/strings.texi' --- doc/lispref/strings.texi 2011-01-25 04:08:28 +0000 +++ doc/lispref/strings.texi 2011-03-16 14:47:55 +0000 @@ -554,8 +554,8 @@ @code{prin1-to-string} (@pxref{Output Functions}) can also convert Lisp objects into strings. @code{read-from-string} (@pxref{Input Functions}) can ``convert'' a string representation of a Lisp object -into an object. The functions @code{string-make-multibyte} and -@code{string-make-unibyte} convert the text representation of a string +into an object. The functions @code{string-to-multibyte} and +@code{string-to-unibyte} convert the text representation of a string (@pxref{Converting Representations}). @xref{Documentation}, for functions that produce textual descriptions