From unknown Mon Aug 18 21:49:32 2025 X-Loop: help-debbugs@gnu.org Subject: bug#8262: string-make-*byte in elisp manual Resent-From: Arni Magnusson Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 15 Mar 2011 21:37:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8262 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 8262@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.130022500215383 (code B ref -1); Tue, 15 Mar 2011 21:37:02 +0000 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 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-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 unknown Mon Aug 18 21:49:32 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Arni Magnusson Subject: bug#8262: closed (Re: bug#8262: string-make-*byte in elisp manual) Message-ID: References: X-Gnu-PR-Message: they-closed 8262 X-Gnu-PR-Package: emacs Reply-To: 8262@debbugs.gnu.org Date: Wed, 16 Mar 2011 17:42:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1300297322-21607-1" This is a multi-part message in MIME format... ------------=_1300297322-21607-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #8262: string-make-*byte in elisp manual which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 8262@debbugs.gnu.org. --=20 8262: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D8262 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1300297322-21607-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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 ------------=_1300297322-21607-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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) ------------=_1300297322-21607-1--