Subject: bug#37925: closed (Re: bug#37925: 26.3; Elisp manual: add index entry for sets/kinds of variables)

From: [email-masked] (GNU bug Tracking System)
Date: Thu, 16 Jan 2020 22:50:02 +0000

Your bug report

#37925: 26.3; Elisp manual: add index entry for sets/kinds of variables

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
37925: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=37925
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#37925: 26.3; Elisp manual: add index entry for sets/kinds of variables
From: Stefan Kangas <[email-masked]>
To: Eli Zaretskii <[email-masked]>
Cc: [email-masked], Drew Adams <[email-masked]>
Date: Thu, 16 Jan 2020 23:48:54 +0100
List-Id: <debbugs-submit.debbugs.gnu.org>

Eli Zaretskii <[email-masked]> writes:

> The bug report in its entirety is not useful because it lumps together
> several (too many) sections that are almost certainly unrelated, in
> terms of why there is no index entry that you decided were necessary.
> These matters should be always considered on a case by case basis.
[...]
> So please look at each section separately, read its content, and then
> tell what index entries you think are missing, and why, and please do
> that separately for each section.  Arguing about missing index entries
> from _node_names_, just because they all end in "Variables", is the
> wrong way.
>
>> And BTW, we have these entries, which go to
>> 3 different nodes.  They're not distinguished
>> at the level of entries (except for the 2nd
>> one).
>> 
>> buffer-local variables
>> buffer-local variables in modes
>> buffer-local-variables
>
> They are all different entries, so what's wrong with them?  Also, how
> is this related to the subject of this bug report?

More information was requested, but none was given within 12 weeks, so
I'm closing this bug.  If this is still an issue, please reply to this
email (use "Reply to all" in your email client) and we can reopen the
bug report.

Best regards,
Stefan Kangas

Subject: 26.3; Elisp manual: add index entry for sets/kinds of variables
From: Drew Adams <[email-masked]>
To: [email-masked]
Date: Fri, 25 Oct 2019 12:43:40 -0700 (PDT)
List-Id: <debbugs-submit.debbugs.gnu.org>

These nodes are about particular kinds of variables:

* Buffer-Local Variables
* Completion Variables
* Condition Variables
* Connection Local Variables
* Constant Variables
* Directory Local Variables
* File Local Variables
* Generalized Variables
* Global Variables
* List Variables
* List Variables
* Local Variables
* Mode Line Variables
* Other Font Lock Variables
* Output Variables
* Variables with Restricted Values
* Void Variables
* Warning Variables

Likewise, for options:

* Warning Options
* Choosing Window Options
* Edebug Options
* Network Options

Please consider adding index entries that correspond directly to these
node names.  A user should be able to do, for example (and preferably
with or without the hyphen):

  i mode-line variables

Today that's not possible.

---

[Additional remark:
 The node names are not consistent wrt compound adjectives.
 `Buffer-Local' is the only such that uses a hyphen.  It's better to be
 consistent.  (Even better might be to always use a hyphen.)]

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''