From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 15 17:36:41 2011 Received: (at submit) by debbugs.gnu.org; 15 Mar 2011 21:36:42 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pzbuz-000404-H0 for submit@debbugs.gnu.org; Tue, 15 Mar 2011 17:36:41 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pzbux-0003zs-7G for submit@debbugs.gnu.org; Tue, 15 Mar 2011 17:36:40 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pzbur-0000sv-5E for submit@debbugs.gnu.org; Tue, 15 Mar 2011 17:36:34 -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,T_RP_MATCHES_RCVD autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([199.232.76.165]:58110) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pzbup-0000sc-7A for submit@debbugs.gnu.org; Tue, 15 Mar 2011 17:36:33 -0400 Received: from [140.186.70.92] (port=47867 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Pzbul-0002cE-IB for bug-gnu-emacs@gnu.org; Tue, 15 Mar 2011 17:36:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pzbue-0000rp-FE for bug-gnu-emacs@gnu.org; Tue, 15 Mar 2011 17:36:21 -0400 Received: from hafgarpur.hafro.is ([130.208.64.48]:47659) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pzbue-0000rT-10 for bug-gnu-emacs@gnu.org; Tue, 15 Mar 2011 17:36:20 -0400 X-Virus-Scanned: amavisd-new at hafro.is Received: from localhost6.localdomain6 (hafstormur [130.208.66.52]) by hafgarpur.hafro.is (8.14.2/8.14.2/hafro-2.46) with ESMTP id p2FLaALI010672 for ; Tue, 15 Mar 2011 21:36:10 GMT Received: from localhost6.localdomain6 (localhost [127.0.0.1]) by localhost6.localdomain6 (8.14.4/8.14.4/hafro-1.6) with ESMTP id p2FLaAVQ005071 for ; Tue, 15 Mar 2011 21:36:10 GMT Received: from localhost (arnima@localhost) by localhost6.localdomain6 (8.14.4/8.14.4/hafro-0.3) with ESMTP id p2FLa9QH005068 for ; Tue, 15 Mar 2011 21:36:10 GMT X-Authentication-Warning: localhost6.localdomain6: arnima owned process doing -bs Date: Tue, 15 Mar 2011 21:36:09 +0000 (UTC) From: Arni Magnusson To: bug-gnu-emacs@gnu.org Subject: string-make-*byte in elisp manual Message-ID: User-Agent: Alpine 2.02 (LFD 1266 2009-07-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 199.232.76.165 X-Spam-Score: -5.5 (-----) X-Debbugs-Envelope-To: submit 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: -5.5 (-----) 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, Arni --- GNU Emacs Lisp Reference Manual for Emacs version 23.3 (Rev 3.0, July 2009) From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 16 13:41:14 2011 Received: (at 8262-done) by debbugs.gnu.org; 16 Mar 2011 17:41:15 +0000 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 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" 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 Received: by ceviche.home (Postfix, from userid 20848) id F1386660BB; Wed, 16 Mar 2011 13:40:50 -0400 (EDT) From: Stefan Monnier To: Arni Magnusson Subject: Re: bug#8262: string-make-*byte in elisp manual Message-ID: References: Date: Wed, 16 Mar 2011 13:40:50 -0400 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) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-Debbugs-Envelope-To: 8262-done Cc: 8262-done@debbugs.gnu.org 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.1 (--) > 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 From unknown Mon Aug 18 02:33:07 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 14 Apr 2011 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