* bug#24827: 24.5; Elisp manual: add index entries for syntax highlighting
@ 2016-10-30 16:48 Drew Adams
2016-10-30 17:08 ` Eli Zaretskii
0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2016-10-30 16:48 UTC (permalink / raw)
To: 24827
While trying to help someone find information about using font-locking,
I said to use `i' in the Elisp manual. I expected that the common
terminology "syntax highlighting" would get them to the manual sections
about font-locking.
There is apparently no index entry that includes "highlight", and in
particular no index entries for "syntax highlighting", "highlighting
syntax", etc.
Please consider adding such entries. Someone new to Emacs will likely
think in terms of syntax highlighting and may not be familiar with the
Emacsism "font-locking".
In GNU Emacs 24.5.1 (i686-pc-mingw32)
of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/usr --host=i686-pc-mingw32'
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#24827: 24.5; Elisp manual: add index entries for syntax highlighting
2016-10-30 16:48 bug#24827: 24.5; Elisp manual: add index entries for syntax highlighting Drew Adams
@ 2016-10-30 17:08 ` Eli Zaretskii
0 siblings, 0 replies; 3+ messages in thread
From: Eli Zaretskii @ 2016-10-30 17:08 UTC (permalink / raw)
To: Drew Adams; +Cc: 24827
> Date: Sun, 30 Oct 2016 09:48:32 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
>
> There is apparently no index entry that includes "highlight", and in
> particular no index entries for "syntax highlighting", "highlighting
> syntax", etc.
There is such an index entry in the Emacs user manual.
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#24827: 24.5; Elisp manual: add index entries for syntax highlighting
[not found] ` <<83pomhpxx3.fsf@gnu.org>
@ 2016-10-30 17:13 ` Drew Adams
0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2016-10-30 17:13 UTC (permalink / raw)
To: Eli Zaretskii, Drew Adams; +Cc: 24827
> > There is apparently no index entry that includes "highlight", and
> > in particular no index entries for "syntax highlighting",
> > "highlighting syntax", etc.
>
> There is such an index entry in the Emacs user manual.
Great. That's a good start. Please consider adding it to
the Elisp manual as well.
Some (maybe most) users who want to implement or customize
syntax highlighting will go directly to the Elisp manual,
expecting (correctly) that this is done using Elisp.
And in fact one of the most relevant nodes for this topic
is `Customizing Keywords'. "Customizing" is a human task -
this is a case where the Elisp manual (correctly) includes
some guide-like information.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2016-10-30 17:13 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-10-30 16:48 bug#24827: 24.5; Elisp manual: add index entries for syntax highlighting Drew Adams
2016-10-30 17:08 ` Eli Zaretskii
[not found] <<5628477d-2abf-4065-9c45-f598e3a6663b@default>
[not found] ` <<83pomhpxx3.fsf@gnu.org>
2016-10-30 17:13 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).