Received: from mx0.gmx.net (mx0.gmx.net [213.165.64.100]) by h1439878.stratoserver.net (8.14.2/8.14.2/Debian-2build1) with SMTP id q0D0OKCc020394 for ; Fri, 13 Jan 2012 01:24:21 +0100 Received: (qmail 19424 invoked by alias); 13 Jan 2012 00:24:15 -0000 Delivered-To: GMX delivery to rainer.schoepf@gmx.net Received: (qmail invoked by alias); 13 Jan 2012 00:24:15 -0000 Received: from relay2.uni-heidelberg.de (EHLO relay2.uni-heidelberg.de) [129.206.210.211] by mx0.gmx.net (mx020) with SMTP; 13 Jan 2012 01:24:15 +0100 Received: from listserv.uni-heidelberg.de (listserv.uni-heidelberg.de [129.206.100.94]) by relay2.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id q0D0LiEW008805 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 13 Jan 2012 01:21:44 +0100 Received: from listserv.uni-heidelberg.de (localhost.localdomain [127.0.0.1]) by listserv.uni-heidelberg.de (8.13.1/8.13.1) with ESMTP id q0CN179Q024022; Fri, 13 Jan 2012 01:21:43 +0100 Received: by LISTSERV.UNI-HEIDELBERG.DE (LISTSERV-TCP/IP release 16.0) with spool id 1924688 for LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Fri, 13 Jan 2012 01:21:43 +0100 Received: from relay.uni-heidelberg.de (relay.uni-heidelberg.de [129.206.100.212]) by listserv.uni-heidelberg.de (8.13.1/8.13.1) with ESMTP id q0D0LhlW004556 for ; Fri, 13 Jan 2012 01:21:43 +0100 Received: from mail-lpp01m010-f49.google.com (mail-lpp01m010-f49.google.com [209.85.215.49]) by relay.uni-heidelberg.de (8.14.1/8.14.1) with ESMTP id q0D0LcWq032212 (version=TLSv1/SSLv3 cipher=RC4-SHA bits=128 verify=FAIL) for ; Fri, 13 Jan 2012 01:21:42 +0100 Received: by lagw12 with SMTP id w12so1842410lag.22 for ; Thu, 12 Jan 2012 16:21:37 -0800 (PST) MIME-Version: 1.0 Received: by 10.152.145.71 with SMTP id ss7mr60446lab.28.1326414097853; Thu, 12 Jan 2012 16:21:37 -0800 (PST) Received: by 10.152.22.195 with HTTP; Thu, 12 Jan 2012 16:21:37 -0800 (PST) References: <4EFF960F.6010407@morningstar2.co.uk> <4F0DFC2A.1020804@morningstar2.co.uk> <4F0E08EE.30007@latex-project.org> Content-Type: text/plain; charset=ISO-8859-1 X-Spam-Whitelist: Message-ID: Date: Thu, 12 Jan 2012 19:21:37 -0500 Reply-To: Mailing list for the LaTeX3 project Sender: Mailing list for the LaTeX3 project From: Bruno Le Floch Subject: Re: How to describe category codes: documentation and \char_show_value_catcode:n To: LATEX-L@listserv.uni-heidelberg.de In-Reply-To: <4F0E08EE.30007@latex-project.org> Precedence: list List-Help: , List-Unsubscribe: List-Subscribe: List-Owner: List-Archive: X-GMX-Antispam: 0 (BackTrace mail analyze); Detail=5D7Q89H36p4L00VTXC6D4q0N+AH0PUCnGL2vqOgpaBYL16oitsMrgDt/NQNpSCZFFjDOy 97xb7Zpf+wZnd5ZXNcvLDXR3Wg3wRjdQbwEMh8=V1; X-Resent-By: Forwarder X-Resent-For: rainer.schoepf@gmx.net X-Resent-To: rainer@rainer-schoepf.de Status: R X-Status: X-Keywords: X-UID: 6993 On 1/11/12, Frank Mittelbach wrote: > Am 11.01.2012 22:16, schrieb Joseph Wright: >> On 31/12/2011 23:09, Joseph Wright wrote: >>> 1) How should we refer to catcode in documentation, both in terms of >>> the text and the formatting (for example, do we want to say >>> something line 'category code')? >> >> Unless I hear that there are strong objections, I propose to make a >> change here as I indicate above, using the name of each category code as >> described in the naming of \char_set_catcode_... and using formatting >> >> category code \meta{}~(

)
>
> well, I'm not sure I parse this line. To me "code" implies more a number
> than something like "other". I'm fine with statements like "character
> category " but less so with "category code "
>
> or is the above to read as
>
>      category code \meta{other} (12)
>
>>>   2) What should we do for \char_show_value_catcode:n? 'show_value' is
>>>      not the right name for showing a symbolic meaning. I guess we just
>>>      use \prg_case_int:nnn to actually show the meaning.
>
> if you want to go for symbolic then you could have
>
>    \char_show_category:n {x}         -> 
>
> and drop "code" from the cs name

I like the idea, and I'd go further:

  \char_show_category:N x
  > letter (11).
  \char_show_lowercase:N X
  > x (120).
  \char_show_uppercase:N *
  > * (0, unchanged).
  \char_show_space_factor:N .
  > punctuation (3000).
  \char_show_math_code:N \*
  > "8000 (active).
  \char_show_math_code:N \X
  > "7158.

Ok, for math code and sfcode, this is probably too crazy. An
alternative would be to show all the relevant info at once:

  \lccode`\~=`A
  \char_show:N \~

  > category => active (13)
  > lower case => A (65)
  > upper case => ~ (0, unchanged)
  > space factor => normal (1000)
  > math code => "007E
  > delimiter code => not a delimiter.

Perhaps removing the fields that are equal to the default value, e.g.,
here "upper case", "space factor" and "delimiter code".

I note that we have no wrapper for delcode.

Regards,
Bruno