GNU bug report logs - #72735
31.0.50; [PATCH] Make more bug-reference variables customizeable

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Björn Bidar <bjorn.bidar <at> thaodan.de>
Cc: 72735 <at> debbugs.gnu.org
Subject: bug#72735: 31.0.50; [PATCH] Make more bug-reference variables customizeable
Date: Wed, 21 Aug 2024 16:27:01 +0300

> From: Björn Bidar <bjorn.bidar <at> thaodan.de>
> Cc: 72735 <at> debbugs.gnu.org
> Date: Tue, 20 Aug 2024 22:39:18 +0300
> 
> >> +FORGE-TYPE is the type of the forge, e.g., gitlab, gitea,
> >> +sourcehut, or github.
> >
> > This leaves it unsaid how these symbols are used, and what symbols are
> > recognized.
> 
> Does the original text not say that already? The choices over all the
> existing symbols which are accepted, if it doesn't make sense to
> e.g. add a custom symbol to extend the mode than removing the (symbol)
> choice is good.

It might be enough to say that those symbols are the only predefined
ones.  The text as it is leaves the impression that they are only
examples.  Also, something should be said regarding the differences
between the symbols: why does the user need to specify these symbols
and what could happen if they use a wrong symbol?

> > Finally, I think this warrants a NEWS entry.
> 
> Should the news entry explain similarly that the variables can be set
> with defcustom and have improved documentation?

Just the fact that they are now user options, that's all.

Previous Next

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