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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#21441: closed (25.0.50; doc of `make-char-table')
Date: Wed, 09 Sep 2015 16:04:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 09 Sep 2015 19:02:46 +0300
with message-id <83oahb60nt.fsf <at> gnu.org>
and subject line Re: bug#21441: 25.0.50; doc of `make-char-table'
has caused the debbugs.gnu.org bug report #21441,
regarding 25.0.50; doc of `make-char-table'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
21441: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=21441
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; doc of `make-char-table'
Date: Wed, 9 Sep 2015 08:10:45 -0700 (PDT)

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?  There is no parent type
described anywhere, for which this arg would be the SUBtype.

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


In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2015-08-16 on LEG570
Bzr revision: f7ee23e587b01f179284b5554c67d579a2def676
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --host=i686-pc-mingw32 --enable-checking=yes,glyphs'

[Message part 3 (message/rfc822, inline)]

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.