GNU bug report logs - #76901
[PATCH] ; * doc/emacs/trouble.texi (Coding Standards): Add manual reference

Previous Next

Full log

Message #11 received at 76901 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: jb <at> jeremybryant.net, 76901 <at> debbugs.gnu.org
Subject: Re: bug#76901: [PATCH] ; * doc/emacs/trouble.texi (Coding Standards):
 Add manual reference
Date: Mon, 10 Mar 2025 16:56:30 +0200

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Sun, 9 Mar 2025 16:25:37 -0700
> Cc: Eli Zaretskii <eliz <at> gnu.org>
> 
> Jeremy Bryant via "Bug reports for GNU Emacs, the Swiss army knife of
> text editors" <bug-gnu-emacs <at> gnu.org> writes:
> 
> > The Emacs manual suggests that the GNU Coding Standards may be available
> > locally as an Info manual.
> > This patch inserts the explicit manual cross-reference.
> >
> > It may be suitable as a documentation patch for the emacs-30 branch, or
> > otherwise for master.
> >
> > Any comments please let me know.
> 
> I would guess that the reason why there is no reference is that most
> GNU/Linux distributions do not distribute this Info manual, or at least
> they don'tt by default or with commonly installed packages.
> 
> It's also never available as a printed manual, AFAIK.
> 
> I have no opinion on adding such a reference now.  Eli, WDYT?

We have there a reference to the manual in HTML, isn't that enough?
In any case, having a URL and then a cross-reference to the Info
manuals in the next sentence sounds strange to me.  At the very least,
we should have there text saying that the manual can be either read
on-line in HTML format (with the URL), or locally in Info (with a Info
reference), to explain why we have both.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.