From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Mike Gran Newsgroups: gmane.lisp.guile.devel Subject: Re: Minor queries about Unicode char docs Date: Mon, 31 Aug 2009 18:40:29 -0700 Message-ID: <1251769229.17414.5768.camel@localhost.localdomain> References: <87ocpwuvui.fsf@arudy.ossau.uklinux.net> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1251769301 24558 80.91.229.12 (1 Sep 2009 01:41:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 1 Sep 2009 01:41:41 +0000 (UTC) Cc: Guile Development To: Neil Jerram Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Tue Sep 01 03:41:34 2009 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MiINH-0005Ym-6G for guile-devel@m.gmane.org; Tue, 01 Sep 2009 03:41:31 +0200 Original-Received: from localhost ([127.0.0.1]:42413 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MiING-00078K-F6 for guile-devel@m.gmane.org; Mon, 31 Aug 2009 21:41:30 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MiIMp-0006mB-9e for guile-devel@gnu.org; Mon, 31 Aug 2009 21:41:03 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MiIMo-0006kz-DK for guile-devel@gnu.org; Mon, 31 Aug 2009 21:41:02 -0400 Original-Received: from [199.232.76.173] (port=56735 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MiIMo-0006kj-4u for guile-devel@gnu.org; Mon, 31 Aug 2009 21:41:02 -0400 Original-Received: from smtp104.prem.mail.sp1.yahoo.com ([98.136.44.59]:44869) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1MiIMn-0005mq-M6 for guile-devel@gnu.org; Mon, 31 Aug 2009 21:41:01 -0400 Original-Received: (qmail 95029 invoked from network); 1 Sep 2009 01:41:00 -0000 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.com; h=Received:X-Yahoo-SMTP:X-YMail-OSG:X-Yahoo-Newman-Property:Subject:From:To:Cc:In-Reply-To:References:Content-Type:Date:Message-Id:Mime-Version:X-Mailer:Content-Transfer-Encoding; b=L9sxJ0DE+n8cfLXHxnrYVPtKIb04552T+JFab82fCi8h3n95he6EP/HF95EEK/Y8jqqDRVneo2/X56EGjVzAW2mMAvtqq+TqwG4XpdzzNWCpor0y0tNq4HFCsM2oAtyJvBTcGujgzsewft33ISClt+CPBxNXdUZeDGxbS13sr/E= ; Original-Received: from adsl-71-130-218-93.dsl.irvnca.pacbell.net (spk121@71.130.218.93 with plain) by smtp104.prem.mail.sp1.yahoo.com with SMTP; 31 Aug 2009 18:41:00 -0700 PDT X-Yahoo-SMTP: FzNaA9iswBDuBl1BmgaIRDaP9Q-- X-YMail-OSG: TSUwyCEVM1nUTyCkJJT4GZrptfOElC437fc_cbc6abMpbAvTEJfoIpSjIKx2yUDXHBu4h3xCJfRDJtLpy6Wq6Tf9KysshsF8DOs6q1xUpt.FKNPGisNeLUD3V0bTmfqveBIi_kVeXJ9OHjo6wstkHzHqHkIyhrsorLBvhxwHVohNeaWTkU1vn73ofVG0avkSoHqrmNlPddMf8Kjjd71JY8Aytle8YyfbQ2cNnjmpVCZOsibiL2OVJXdGhvpTAc.99wP0 X-Yahoo-Newman-Property: ymail-3 In-Reply-To: <87ocpwuvui.fsf@arudy.ossau.uklinux.net> X-Mailer: Evolution 2.24.5 (2.24.5-2.fc10) X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:9227 Archived-At: On Mon, 2009-08-31 at 11:21 +0100, Neil Jerram wrote: > I think there's a case here for making the docstring not identical to > the corresponding manual text. In the manual context, the section > begins with talking about Unicode, so "Unicode" can be assumed for > everything that follows. But in the docstring, when someone types > (help char > Return `#t' iff the code point of `x' is less than the code > point of `y', else `#f'. > > For this context I think it would be clearer to say > > Return `#t' iff the Unicode code point of `x' is less than the > code point of `y', else `#f'. Sounds good. > > +Case-insensitive character comparisons of characters use @emph{Unicode > +case folding}. In case folding comparisons, if a character is > +lowercase and has an uppercase form that can be expressed as a single > +character, it is converted to uppercase before comparison. Unicode > +case folding is language independent: it uses rules that are generally > +true, but, it cannot cover all cases for all languages. > > That's very clear, but what if a character doesn't have an uppercase > form that can be expressed as a single character? Does Guile then > throw an exception, or does it perform the comparison with the > lowercase code point? I see what you mean. The text should have something like... "In case folding comparisons, if a character is lowercase and has an uppercase form that can be expressed as a single character, its uppercase form is used in the comparison. All other characters are not modified for the comparison. Note that the German letter Sharp S (Eszett) is not uppercased before the comparison since its plural has two characters instead of one." > > Thanks! > > Neil Thanks, Mike