Hi! On Mon, 2023-02-06 at 17:11:26 +0800, Torrekie wrote: > Package: libdpkg-perl > Version: 1.21.19 > Source: dpkg > Severity: minor
> When installing dpkg 1.21.19 from source, I got several pod2man > warnings that indicates some of the documentations has not been > correctly generated. > $ make install DESTDIR=`pwd`/destroot > ... > for module in Dpkg/Arch.pm Dpkg/BuildEnv.pm […] Dpkg.pm ; do \ > name=`echo $module | sed -e 's|/|::|g' -e 's/\.pm$//'`; \ > pod2man --utf8 --center=libdpkg-perl --release=1.21.19 \ > --name="$name" --section=3perl ./$module \ > >/buildroot/dpkg-1.21.19/destroot/usr/share/man/man3/$name.3perl; \ > test -s /buildroot/dpkg-1.21.19/destroot/usr/share/man/man3/$name.3perl || \ > rm -f /buildroot/dpkg-1.21.19/destroot/usr/share/man/man3/$name.3perl; \ > done > pod2man: unable to format ./Dpkg/Dist/Files.pm > pod2man: unable to format ./Dpkg/ErrorHandling.pm […] > pod2man: unable to format ./Dpkg/Source/Quilt.pm > pod2man: unable to format ./Dpkg/Vars.pm This is expected, as these modules are private and were not supposed to be documented to avoid misleading developers into using them. But I see how that can be non-obvious from the outside and such messages can add to the confusion. So I've minimally documented them as being private to make this explicit and these messages will no longer show anymore. I'll include this in my upcoming push targeting 1.22.x. Thanks, Guillem
