From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#13177: 24.3.50; doc of `read-char-by-name' Date: Sat, 15 Dec 2012 15:39:29 -0800 Message-ID: <156AF208FCA440DDB10CA4CFBF2815AF@us.oracle.com> References: <4AF22BD1F38E4AF2A650D1F537B47069@us.oracle.com><8762431shy.fsf@mail.jurta.org><9D74DAC118B44C3DAF75A8CFC6AE7FB3@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1355614806 30060 80.91.229.3 (15 Dec 2012 23:40:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 15 Dec 2012 23:40:06 +0000 (UTC) Cc: 13177@debbugs.gnu.org To: "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 16 00:40:20 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Tk1L3-0006fe-9Y for geb-bug-gnu-emacs@m.gmane.org; Sun, 16 Dec 2012 00:40:13 +0100 Original-Received: from localhost ([::1]:55148 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tk1Kq-0003Kf-6N for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Dec 2012 18:40:00 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:43306) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tk1Kn-0003KZ-Gv for bug-gnu-emacs@gnu.org; Sat, 15 Dec 2012 18:39:59 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Tk1Km-0005gV-JS for bug-gnu-emacs@gnu.org; Sat, 15 Dec 2012 18:39:57 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34218) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tk1Km-0005gR-Fz for bug-gnu-emacs@gnu.org; Sat, 15 Dec 2012 18:39:56 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1Tk1Lq-00035R-5N for bug-gnu-emacs@gnu.org; Sat, 15 Dec 2012 18:41:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 15 Dec 2012 23:41:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13177 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 13177-submit@debbugs.gnu.org id=B13177.135561485311850 (code B ref 13177); Sat, 15 Dec 2012 23:41:02 +0000 Original-Received: (at 13177) by debbugs.gnu.org; 15 Dec 2012 23:40:53 +0000 Original-Received: from localhost ([127.0.0.1]:44469 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Tk1Lg-000355-Ju for submit@debbugs.gnu.org; Sat, 15 Dec 2012 18:40:52 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:24156) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Tk1Lc-00034w-Uw for 13177@debbugs.gnu.org; Sat, 15 Dec 2012 18:40:49 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qBFNdcTU001380 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 15 Dec 2012 23:39:39 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qBFNdbTV029456 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 15 Dec 2012 23:39:38 GMT Original-Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qBFNdbp7000671; Sat, 15 Dec 2012 17:39:37 -0600 Original-Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 15 Dec 2012 15:39:37 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 Thread-Index: Ac3bGr4v5A/KkqxERp2cPzuMhZZcKAAAivgA X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:68592 Archived-At: > > The problem for me is that I don't know what the intention (design) > > was or why. Maybe someone has a good reason to return nil or to > > return a number that does not correspond to a recognized code point? > > It's called "read-char-by-name", so the intention is pretty clear: it > should return a char. Great. That's what I would prefer also. And that was exactly what I said in the original bug report: that's what the other `read*' functions do: return the thing their names say they read. So we start with a code bug - make sure it always returns a char. Then we fix the doc. However, this function has been around for a while, so there might be some code that expects it to sometimes return nil or sometimes a non code-point number. Hopefully, any code expecting nil is only trying to workaround this same bug... Anyway, FWIW you've got my vote in favor of fixing the code to always return a char.