manual: update the Reporting Bugs / Known Bugs sections

This commit is contained in:
Adam Spiers 2021-04-05 15:35:13 +01:00
parent c30792270e
commit 2c7d3d4762

View file

@ -1267,9 +1267,32 @@ perl/bin/perl stow/bin/stow -vv *
@node Reporting Bugs, Known Bugs, Bootstrapping, Top @node Reporting Bugs, Known Bugs, Bootstrapping, Top
@chapter Reporting Bugs @chapter Reporting Bugs
Please send bug reports to the current maintainers by electronic You can report bugs to the current maintainers in one of three ways:
mail. The address to use is @samp{<bug-stow@@gnu.org>}. Please
include: @enumerate
@item
Send e-mail to @email{bug-stow@@gnu.org}.
@item
File an issue in @uref{https://savannah.gnu.org/bugs/?group=stow,
the Savannah bug tracker}.
@item
File an issue in
@uref{https://github.com/aspiers/stow/issues/, the GitHub project}.
@end enumerate
While GitHub is arguably the most convenient of these three options, it
@uref{https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub,
is not the most ethical or freedom-preserving way to host software
projects}. Therefore the GitHub project may be
@uref{https://github.com/aspiers/stow/issues/43, moved to a more ethical
hosting service} in the future.
Before reporting a bug, it is recommended to check whether it is already
known, so please first @pxref{Known Bugs}.
When reporting a new bug, please include:
@itemize @bullet @itemize @bullet
@item @item
@ -1307,13 +1330,22 @@ something that doesn't need reporting.
@node Known Bugs, GNU General Public License, Reporting Bugs, Top @node Known Bugs, GNU General Public License, Reporting Bugs, Top
@chapter Known Bugs @chapter Known Bugs
There are no known bugs in Stow version @value{VERSION}! Known bugs can be found in the following locations:
If you think you have found one, please @pxref{Reporting Bugs}.
@c @itemize @bullet @itemize
@c @item @item
@c Put known bugs here @uref{https://github.com/aspiers/stow/issues/, the GitHub issue tracker}
@c @end itemize
@item
@uref{https://savannah.gnu.org/bugs/?group=stow, the Savannah bug
tracker}
@item
the @uref{https://lists.gnu.org/archive/html/bug-stow/, bug-stow list
archives}
@end itemize
If you think you have found a new bug, please @pxref{Reporting Bugs}.
@c =========================================================================== @c ===========================================================================
@node GNU General Public License, Index, Known Bugs, Top @node GNU General Public License, Index, Known Bugs, Top