--- Begin Message ---
|
Subject: |
26.3; Elisp manual: add index entry for sets/kinds of variables |
|
Date: |
Fri, 25 Oct 2019 12:43:40 -0700 (PDT) |
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''
--- End Message ---
--- Begin Message ---
|
Subject: |
Re: bug#37925: 26.3; Elisp manual: add index entry for sets/kinds of variables |
|
Date: |
Thu, 16 Jan 2020 23:48:54 +0100 |
|
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) |
Eli Zaretskii <address@hidden> 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
--- End Message ---