bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#21472: 25.0.50; REGRESSION: (emacs) `Coding Systems' uses curly quot


From: Eli Zaretskii
Subject: bug#21472: 25.0.50; REGRESSION: (emacs) `Coding Systems' uses curly quotes for Lisp strings
Date: Wed, 16 Sep 2015 13:02:00 +0300

> Cc: 21472@debbugs.gnu.org
> From: Paul Eggert <eggert@cs.ucla.edu>
> Date: Wed, 16 Sep 2015 00:48:51 -0700
> 
> Eli Zaretskii wrote:
> 
> > We index all terminology introduced in a manual, as a matter of
> > principle.
> 
> That's news to me, and the manuals often don't index terminology within @dfn. 
> For example, doc/emacs/basic.texi says @dfn{minor modes} but does not index 
> the 
> term.  A quick eyeball of that file suggests that only about half of its 
> terms 
> enclosed in @dfn are indexed.  I'm not opposed to having more index entries 
> for 
> @dfns if someone wants to do it, but it doesn't appear to be a hard rule.

Many rules of good documentation are followed only partially.  That
doesn't make them any lesser.

This rule should be obvious: if you introduce and explain some
terminology, you should always consider the possibility that someone
will want to read about that terminology, and so it should be in the
index.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]