GNU bug report logs - #21441
25.0.50; doc of `make-char-table'

Previous Next

Full log

Message #10 received at 21441-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 21441-done <at> debbugs.gnu.org
Subject: Re: bug#21441: 25.0.50; doc of `make-char-table'
Date: Wed, 09 Sep 2015 19:02:46 +0300

> Date: Wed, 9 Sep 2015 08:10:45 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> The doc is inconsistent and unclear wrt the first argument.
> 
> In (elisp) `Char-Tables' the arg is named SUBTYPE.  In the doc string it
> is named PURPOSE.  Why SUBTYPE and not TYPE?

Because "type" is char-table.

> Please make the doc clearer, reconciling the treatment of the arg as a
> "purpose" and as a "subtype".

The text before the description of make-char-table explains at length
what is the subtype.  I see nothing unclear there.  I also see no
reason to insists that the doc string and the manual use exactly the
same nomenclature for the arguments.

In sum, I see nothing that needs to be fixed here.

I'm closing the bug.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.