[OpenAFS-devel] pod2man vandalism

Jim Rees rees@umich.edu
Tue, 20 Dec 2005 15:47:16 -0500


I'm not convinced that pod2man should be done from regen.sh.  I'd be happier
if the docs were a target in some Makefile.  Maybe regen.sh should go away
and be replaced by some kind of pre-configure Makefile.

The vandalism appears to be due to a difference between my OpenBSD pod2doc
and the one that regen.sh is expecting to use.

% sh -x regen.sh
+ echo Updating configuration...
Updating configuration...
+ echo Running aclocal
Running aclocal
+ aclocal -I src/cf
+ echo Running autoconf
Running autoconf
+ autoconf
configure.in:6: warning: AC_TRY_RUN called without default to allow cross compiling
 
configure.in:6: warning: AC_TRY_RUN called without default to allow cross compiling
 
+ echo Running autoconf for configure-libafs
Running autoconf for configure-libafs
+ autoconf configure-libafs.in
+ > configure-libafs 
configure-libafs.in:7: warning: AC_TRY_RUN called without default to allow cross compiling
 
configure-libafs.in:7: warning: AC_TRY_RUN called without default to allow cross compiling
 
+ chmod +x configure-libafs
+ echo Running autoheader
Running autoheader
+ autoheader
configure.in:6: warning: AC_TRY_RUN called without default to allow cross compiling
 
+ echo Building man pages
Building man pages
+ test -d doc
+ mkdir -p doc/man-pages/man1 doc/man-pages/man5 doc/man-pages/man8
+ basename doc/man-pages/pod1/*.pod
+ sed s/\.pod$//
+ pod2man -c AFS Command Reference -r OpenAFS -s 1 -n CVS INSTALL Makefile Makefile-libafs.in Makefile.in NEWS README README-NT README-WIN9X README.CVS README.DEVEL README.OBSOLETE README.SECURITY acconfig.h acinclude.m4 acinclude.m4~ aclocal.m4 config.cache config.guess config.log config.status config.sub configure configure-libafs configure-libafs.in configure.in doc include install-sh lib libafsdep missing mkinstalldirs regen.sh src doc/man-pages/pod1/*.pod
+ echo doc/man-pages/pod1/*.pod
+ sed -e s%pod1/%man1/% -e s/\.pod$/.1/
+ > doc/man-pages/man1/*.1 
doc is a directory, not POD input!
 at /usr/bin/pod2man line 60
+ basename doc/man-pages/pod5/*.pod
+ sed s/\.pod$//
+ pod2man -c AFS File Reference -r OpenAFS -s 5 -n CVS INSTALL Makefile Makefile-libafs.in Makefile.in NEWS README README-NT README-WIN9X README.CVS README.DEVEL README.OBSOLETE README.SECURITY acconfig.h acinclude.m4 acinclude.m4~ aclocal.m4 config.cache config.guess config.log config.status config.sub configure configure-libafs configure-libafs.in configure.in doc include install-sh lib libafsdep missing mkinstalldirs regen.sh src doc/man-pages/pod5/*.pod
+ echo doc/man-pages/pod5/*.pod
+ sed -e s%pod5/%man5/% -e s/\.pod$/.5/
+ > doc/man-pages/man5/*.5 
doc is a directory, not POD input!
 at /usr/bin/pod2man line 60
+ basename doc/man-pages/pod8/*.pod
+ sed s/\.pod$//
+ pod2man -c AFS Command Reference -r OpenAFS -s 8 -n CVS INSTALL Makefile Makefile-libafs.in Makefile.in NEWS README README-NT README-WIN9X README.CVS README.DEVEL README.OBSOLETE README.SECURITY acconfig.h acinclude.m4 acinclude.m4~ aclocal.m4 config.cache config.guess config.log config.status config.sub configure configure-libafs configure-libafs.in configure.in doc include install-sh lib libafsdep missing mkinstalldirs regen.sh src doc/man-pages/pod8/*.pod
+ echo doc/man-pages/pod8/*.pod
+ sed -e s%pod8/%man8/% -e s/\.pod$/.8/
+ > doc/man-pages/man8/*.8 
doc is a directory, not POD input!
 at /usr/bin/pod2man line 60