On 2025-10-25 12:54, Alfred M. Szmidt wrote:
gendocs.sh has always been maintained by texinfo.
That was true for many years, but ten years ago the GNU coding standards
have said that one should get gendocs from Gnulib; see CVS revision
1.249 of maintain.texi dated 2014-12-19. The Gnulib copy is actively
maintained; any changes that have been made independently to the Texinfo
copy should be merged into it.
The GNU coding standards specify a procedure for generating
documentation (fetch gendocs; then run it) which means that the GNU
Coding Standards themselves do not need a copy of the gendocs script. So
a simple fix for this issue would be to remove gendocs.sh and
gendocs_template from the GNU Coding Standards. (At least that way we'd
have one less copy of these files floating around. :-)
After looking at this I did see a glitch in maintain.texi: although it
says in multiple places to get gendocs from Gnulib, there's one place
where it says to send bug reports to the old Texinfo address. I suppose
this email address was not noticed back on 2014, so I installed the
attached patch to maintain.texi.
This stuff should be simplified somehow, for someone that has the time
to look into that.Index: maintain.texi
===================================================================
RCS file: /sources/gnustandards/gnustandards/maintain.texi,v
retrieving revision 1.293
retrieving revision 1.294
diff -b -w -u -r1.293 -r1.294
--- maintain.texi 12 Sep 2025 07:45:28 -0000 1.293
+++ maintain.texi 25 Oct 2025 20:03:40 -0000 1.294
@@ -5,7 +5,7 @@
@c For double-sided printing, uncomment:
@c @setchapternewpage odd
@c This date is automagically updated when you save this file:
-@set lastupdate June 22, 2025
+@set lastupdate October 25, 2025
@c %**end of header
@documentencoding UTF-8
@@ -2606,7 +2606,7 @@
options, environment variables, and more information.
Please email bug reports, enhancement requests, or other
-correspondence about @command{gendocs} to @email{bug-texinfo@@gnu.org}.
+correspondence about @command{gendocs} to @email{bug-gnulib@@gnu.org}.
@node CVS Keywords in Web Pages
