On Sat, Oct 25, 2025 at 03:14:18PM -0400, Alfred M. Szmidt wrote: > > Alfred and all, > > gendocs.sh, gendocs_template: Add files from > texinfo/contrib/perldoc-all. > > About this recent commit to gnustandards ... > > There are nontrivial differences between these files and the ones in > gnulib (build-aux/gendocs.sh and doc/gendocs_template*). It seems > undesirable to have different versions in gnustandards vs. gnulib. > > That is something for texinfo and gnulib to figure out I think. > gnustandards just pulls in the canonical one in texinfo. >
I don't know what the context to this email is, but the copy of "gendocs-sh" that exists in the Texinfo sources is under the "contrib/perldoc-all" subdirectory which is code to generate Texinfo from the Perl POD documentation. (It is not used by anybody, to my knowledge.) It is hardly a "canonical" source for this file (gendocs.sh) and it should be considered specific to the perldoc-all directory. I expect you would get the canonical version from gnulib. In general you should treat anything under the "contrib" directory in the Texinfo sources with a degree of caution. > texinfo/contrib/README > > Copyright 2013-2025 Free Software Foundation, Inc. > > Copying and distribution of this file, with or without modification, > are permitted in any medium without royalty provided the copyright > notice and this notice are preserved. > > The items here are for your amusement and/or hacking pleasure. > See comments and/or --help strings in each for their purpose(s). > > They are all free software, but not officially part of Texinfo, and the > Texinfo maintainers don't support them (and generally have no knowledge > about them, just passing them on). > > The perldoc-all subdirectory is about making Texinfo out of the standard > Perl *.pod files.
