GNU bug report logs - #75143
debbugs info manual name

Previous Next

Full log

View this message in rfc822 format

From: Morgan Smith <Morgan.J.Smith <at> outlook.com>
To: 75143 <at> debbugs.gnu.org
Cc: Michael Albinus <michael.albinus <at> gmx.de>
Subject: bug#75143: debbugs info manual name
Date: Fri, 27 Dec 2024 10:16:48 -0500

Hello!

(This is about the ELPA package debbugs, not Emacs proper)

I wanted to make a quick suggestion on the debbugs info manuals names.
I think we should name the user manual "debbugs" and the programmer
manual "debbugs-programmer-manual" (NOT "debbugs-pm").

Currently the info manual is called: debbugs-ug.info
The programmer info manual is called: debbugs.info

This means people typing "info debbugs" will get the programmer info
manual, not the user info manual.

When I was first starting to use debbugs I skimmed the programmer info
manual accidentally and got quite confused trying to find the
information I wanted.  I ran "info debbugs" and opened the section
"searching bugs" hoping to find the user commands, not elisp ones.

The programmer manual does mention the user manual but as I was skimming
for something specific, not reading it carefully, I missed that.

Thanks,

Morgan

Previous Next

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