Re: [Shepherd][PATCH 1/4] build: Build Guile objects before generating man pages.

[Ludovic Courtès]

Mathieu Lirzin <address@hidden> skribis:

>   GEN      shepherd
>   GEN      herd
>   GEN      halt
>   GEN      reboot
>   HELP2MAN shepherd.1
> help2man: impossible de récupérer l'information « --help » de ./shepherd
> Try `--no-discard-stderr' if option outputs to stderr
> Makefile:1943: recipe for target 'shepherd.1' failed
> make[2]: [shepherd.1] Error 1 (ignorée)

[...]

> Another iteration of ‘make’ is required to build the man pages.

Thanks for explaining!

This is weird, I don’t understand why that happens.  I can’t even
reproduce it:

--8<---------------cut here---------------start------------->8---
address@hidden /tmp$ git clone /data/src/dmd/
Cloning into 'dmd'...
done.
address@hidden /tmp$ cd dmd/
address@hidden /tmp/dmd$ autoreconf -vfi
autoreconf: Entering directory `.'
autoreconf: configure.ac: not using Gettext
autoreconf: running: aclocal --force 
autoreconf: configure.ac: tracing
autoreconf: configure.ac: not using Libtool
autoreconf: running: 
/gnu/store/w29nf3k2yclf7b33i8iibblj67687my2-autoconf-2.69/bin/autoconf --force
autoreconf: configure.ac: not using Autoheader
autoreconf: running: automake --add-missing --copy --force-missing
configure.ac:53: installing 'build-aux/compile'
configure.ac:17: installing 'build-aux/config.guess'
configure.ac:17: installing 'build-aux/config.sub'
configure.ac:11: installing 'build-aux/install-sh'
configure.ac:11: installing 'build-aux/missing'
Makefile.am: installing './INSTALL'
Makefile.am:65: installing 'build-aux/mdate-sh'
Makefile.am:65: installing 'build-aux/texinfo.tex'
parallel-tests: installing 'build-aux/test-driver'
autoreconf: Leaving directory `.'
address@hidden /tmp/dmd$ mkdir +build
address@hidden /tmp/dmd$ cd +build/
address@hidden /tmp/dmd/+build$ ../configure -C && make -j4 V=1
configure: creating cache config.cache
checking for a BSD-compatible install... 
/run/current-system/profile/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /run/current-system/profile/bin/mkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking whether make supports nested variables... yes
checking whether make supports nested variables... (cached) yes
checking build system type... x86_64-unknown-linux-gnu
checking host system type... x86_64-unknown-linux-gnu
checking for a sed that does not truncate output... 
/run/current-system/profile/bin/sed
checking for guile... /home/ludo/soft/bin/guile
checking for Guile version >= 2.0... 2.0.11
checking for guild... /home/ludo/soft/bin/guild
checking for guile-config... /home/ludo/soft/bin/guile-config
checking whether it is Guile 2.0... yes
checking for guild... (cached) /home/ludo/soft/bin/guild
checking for gcc... gcc
checking whether the C compiler works... yes
checking for C compiler default output file name... a.out
checking for suffix of executables... 
checking whether we are cross compiling... no
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking whether gcc understands -c and -o together... yes
checking for style of include used by make... GNU
checking dependency style of gcc... none
checking the '_SC_OPEN_MAX' value... 4
checking <sys/reboot.h> constants... done
configure: updating cache config.cache
checking that generated files are newer than configure... done
configure: creating ./config.status
config.status: creating Makefile
config.status: creating modules/shepherd/system.scm
config.status: executing depfiles commands
/run/current-system/profile/bin/mkdir -p "`dirname modules/shepherd/config.scm`"
/run/current-system/profile/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/tmp/dmd/+build/../modules,g' -e 
's,%modbuilddir%,/tmp/dmd/+build/modules,g' -e 
's,%localstatedir%,/usr/local/var,g' -e 's,%sysconfdir%,/usr/local/etc,g' -e 
's,%VERSION%,0.3,g' -e 's,%PACKAGE_BUGREPORT%,address@hidden,g' -e 
's,%PACKAGE_NAME%,GNU Shepherd,g' -e 
's,%PACKAGE_URL%,http://www.gnu.org/software/shepherd/,g' -e 
's,%GUILE%,/home/ludo/soft/bin/guile,g' < ../modules/shepherd/config.scm.in 
>modules/shepherd/config.scm
make  all-am
make[1]: Entering directory '/tmp/dmd/+build'
/run/current-system/profile/bin/mkdir -p "`dirname shepherd`" ;         \
/run/current-system/profile/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/tmp/dmd/+build/../modules,g' -e 
's,%modbuilddir%,/tmp/dmd/+build/modules,g' -e 
's,%localstatedir%,/usr/local/var,g' -e 's,%sysconfdir%,/usr/local/etc,g' -e 
's,%VERSION%,0.3,g' -e 's,%PACKAGE_BUGREPORT%,address@hidden,g' -e 
's,%PACKAGE_NAME%,GNU Shepherd,g' -e 
's,%PACKAGE_URL%,http://www.gnu.org/software/shepherd/,g' -e 
's,%GUILE%,/home/ludo/soft/bin/guile,g' < ../shepherd.in >shepherd ;            
   \
 chmod +x shepherd
/run/current-system/profile/bin/mkdir -p "`dirname herd`" ;             \
/run/current-system/profile/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/tmp/dmd/+build/../modules,g' -e 
's,%modbuilddir%,/tmp/dmd/+build/modules,g' -e 
's,%localstatedir%,/usr/local/var,g' -e 's,%sysconfdir%,/usr/local/etc,g' -e 
's,%VERSION%,0.3,g' -e 's,%PACKAGE_BUGREPORT%,address@hidden,g' -e 
's,%PACKAGE_NAME%,GNU Shepherd,g' -e 
's,%PACKAGE_URL%,http://www.gnu.org/software/shepherd/,g' -e 
's,%GUILE%,/home/ludo/soft/bin/guile,g' < ../herd.in >herd ;               \
 chmod +x herd
/run/current-system/profile/bin/mkdir -p "`dirname halt`" ;             \
/run/current-system/profile/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/tmp/dmd/+build/../modules,g' -e 
's,%modbuilddir%,/tmp/dmd/+build/modules,g' -e 
's,%localstatedir%,/usr/local/var,g' -e 's,%sysconfdir%,/usr/local/etc,g' -e 
's,%VERSION%,0.3,g' -e 's,%PACKAGE_BUGREPORT%,address@hidden,g' -e 
's,%PACKAGE_NAME%,GNU Shepherd,g' -e 
's,%PACKAGE_URL%,http://www.gnu.org/software/shepherd/,g' -e 
's,%GUILE%,/home/ludo/soft/bin/guile,g' < ../halt.in >halt ;               \
 chmod +x halt
make[2]: Entering directory '/tmp/dmd/+build'
/run/current-system/profile/bin/mkdir -p "`dirname reboot`" ;           \
/run/current-system/profile/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/tmp/dmd/+build/../modules,g' -e 
's,%modbuilddir%,/tmp/dmd/+build/modules,g' -e 
's,%localstatedir%,/usr/local/var,g' -e 's,%sysconfdir%,/usr/local/etc,g' -e 
's,%VERSION%,0.3,g' -e 's,%PACKAGE_BUGREPORT%,address@hidden,g' -e 
's,%PACKAGE_NAME%,GNU Shepherd,g' -e 
's,%PACKAGE_URL%,http://www.gnu.org/software/shepherd/,g' -e 
's,%GUILE%,/home/ludo/soft/bin/guile,g' < ../reboot.in >reboot ;           \
 chmod +x reboot
LANGUAGE= /bin/sh /tmp/dmd/build-aux/missing help2man --source=GNU 
--info-page=shepherd --output="doc/shepherd.1" "./`basename "doc/shepherd.1" 
.1`"
LANGUAGE= /bin/sh /tmp/dmd/build-aux/missing help2man --source=GNU 
--info-page=shepherd --output="doc/herd.1" "./`basename "doc/herd.1" .1`"
make[2]: Leaving directory '/tmp/dmd/+build'
LANGUAGE= /bin/sh /tmp/dmd/build-aux/missing help2man --source=GNU 
--info-page=shepherd --section=8 --output="doc/halt.8"       \
  "./`basename "doc/halt.8" .8`"
Updating ../doc/version.texi
LANGUAGE= /bin/sh /tmp/dmd/build-aux/missing help2man --source=GNU 
--info-page=shepherd --section=8 --output="doc/reboot.8"     \
  "./`basename "doc/reboot.8" .8`"
/run/current-system/profile/bin/mkdir -p "`dirname "modules/shepherd.go"`" ;    
\
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd.go" "../modules/shepherd.scm" >&$out
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/scripts/halt.go"`" ;       \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/scripts/halt.go" "../modules/shepherd/scripts/halt.scm" 
>&$out
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/scripts/herd.go"`" ;       \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/scripts/herd.go" "../modules/shepherd/scripts/herd.scm" 
>&$out
wrote `modules/shepherd/scripts/halt.go'
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/scripts/reboot.go"`" ;     \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/scripts/reboot.go" 
"../modules/shepherd/scripts/reboot.scm" >&$out
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/config.go"`" ;     \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/config.go" "modules/shepherd/config.scm" >&$out
wrote `modules/shepherd.go'
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/system.go"`" ;     \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/system.go" "modules/shepherd/system.scm" >&$out
wrote `modules/shepherd/config.go'
/run/current-system/profile/bin/mkdir -p "`dirname "modules/shepherd/args.go"`" 
;       \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/args.go" "../modules/shepherd/args.scm" >&$out
wrote `modules/shepherd/scripts/herd.go'
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/service.go"`" ;    \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/service.go" "../modules/shepherd/service.scm" >&$out
wrote `modules/shepherd/system.go'
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/support.go"`" ;    \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/support.go" "../modules/shepherd/support.scm" >&$out
wrote `modules/shepherd/scripts/reboot.go'
/run/current-system/profile/bin/mkdir -p "`dirname 
"modules/shepherd/runlevel.go"`" ;   \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/runlevel.go" "../modules/shepherd/runlevel.scm" >&$out
wrote `modules/shepherd/args.go'
/run/current-system/profile/bin/mkdir -p "`dirname "modules/shepherd/comm.go"`" 
;       \
: && out=1 || out=- ;                   \
unset GUILE_LOAD_COMPILED_PATH ; LC_ALL=C       \
/home/ludo/soft/bin/guild compile --target="x86_64-unknown-linux-gnu"           
\
  -L "./modules"                        \
  -L "../modules"                       \
  -Wformat -Wunbound-variable -Warity-mismatch  \
  -o "modules/shepherd/comm.go" "../modules/shepherd/comm.scm" >&$out
../modules/shepherd/support.scm:204:2: warning: non-literal format string
wrote `modules/shepherd/support.go'
restore=: && backupdir=".am$$" && \
am__cwd=`pwd` && CDPATH="${ZSH_VERSION+.}:" && cd .. && \
rm -rf $backupdir && mkdir $backupdir && \
if (/bin/sh /tmp/dmd/build-aux/missing makeinfo --version) >/dev/null 2>&1; 
then \
  for f in ../doc/shepherd.info ../doc/shepherd.info-[0-9] 
../doc/shepherd.info-[0-9][0-9] ../doc/shepherd.i[0-9] 
../doc/shepherd.i[0-9][0-9]; do \
    if test -f $f; then mv $f $backupdir; restore=mv; else :; fi; \
  done; \
else :; fi && \
cd "$am__cwd"; \
if /bin/sh /tmp/dmd/build-aux/missing makeinfo   -I doc -I ../doc \
 -o ../doc/shepherd.info ../doc/shepherd.texi; \
then \
  rc=0; \
  CDPATH="${ZSH_VERSION+.}:" && cd ..; \
else \
  rc=$?; \
  CDPATH="${ZSH_VERSION+.}:" && cd .. && \
  $restore $backupdir/* `echo "./../doc/shepherd.info" | sed 's|[^/]*$||'`; \
fi; \
rm -rf $backupdir; exit $rc
../modules/shepherd/runlevel.scm:106:6: warning: possibly unbound variable 
`next-services'
wrote `modules/shepherd/runlevel.go'
wrote `modules/shepherd/comm.go'
wrote `modules/shepherd/service.go'
make[1]: Leaving directory '/tmp/dmd/+build'
address@hidden /tmp/dmd/+build$ git describe 
v0.2-109-gcc6ba32
address@hidden /tmp/dmd/+build$ ls doc/*.[18]
doc/halt.8  doc/herd.1  doc/reboot.8  doc/shepherd.1
--8<---------------cut here---------------end--------------->8---

(There’s the problem that man pages end up in $builddir instead of
$srcdir; oh well.)

> I think this is important enough to be fixed before the release.  ;)

I think it’s OK because people building from the tarball won’t have this
problem since man pages are included in the tarball.

So I’m punting on this for now, and I suggest that we keep investigating
after the release.

Thank you,
Ludo’.