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

[Mathieu Lirzin]

address@hidden (Ludovic Courtès) writes:

> Mathieu Lirzin <address@hidden> skribis:
>
>> Before that, man pages were not successfully generated for VPATH builds.
>
> How so?

Using commit bc7757cd1f3d0a162e765d0ecebde052765a6a23:

--8<---------------cut here---------------start------------->8---
address@hidden:~/src/shepherd$ git clean -xdf
[...]
address@hidden:~/src/shepherd$ 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: /usr/bin/autoconf --force
autoreconf: configure.ac: not using Autoheader
autoreconf: running: automake --add-missing --copy --force-missing
Unescaped left brace in regex is deprecated, passed through in regex; marked by 
<-- HERE in m/\${ <-- HERE ([^ \t=:+{}]+)}/ at /usr/bin/automake line 3936.
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:~/src/shepherd$ mkdir bd
address@hidden:~/src/shepherd$ cd bd
address@hidden:~/src/shepherd/bd$ ../configure
[...]
configure: creating ./config.status
config.status: creating Makefile
config.status: creating examples/Makefile
config.status: creating modules/shepherd/system.scm
config.status: executing depfiles commands
address@hidden:~/src/shepherd/bd$ make
/bin/mkdir -p "`dirname modules/shepherd/config.scm`"
/bin/sed -e 's,%PREFIX%,/usr/local,g' -e 
's,%modsrcdir%,/home/mthl/src/shepherd/bd/../modules,g' -e 
's,%modbuilddir%,/home/mthl/src/shepherd/bd/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%,/usr/bin/guile,g' < ../modules/shepherd/config.scm.in 
>modules/shepherd/config.scm
make  all-recursive
make[1]: Entering directory '/home/mthl/src/shepherd/bd'
Making all in examples
make[2]: Entering directory '/home/mthl/src/shepherd/bd/examples'
make[2]: Nothing to be done for 'all'.
make[2]: Leaving directory '/home/mthl/src/shepherd/bd/examples'
make[2]: Entering directory '/home/mthl/src/shepherd/bd'
Updating ../version.texi
  MAKEINFO ../shepherd.info
  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)
  HELP2MAN herd.1
help2man: impossible de récupérer l'information « --help » de ./herd
Try `--no-discard-stderr' if option outputs to stderr
Makefile:1940: recipe for target 'herd.1' failed
make[2]: [herd.1] Error 1 (ignorée)
  HELP2MAN halt.8
help2man: impossible de récupérer l'information « --help » de ./halt
Try `--no-discard-stderr' if option outputs to stderr
Makefile:1940: recipe for target 'halt.8' failed
make[2]: [halt.8] Error 1 (ignorée)
  HELP2MAN reboot.8
help2man: impossible de récupérer l'information « --help » de ./reboot
Try `--no-discard-stderr' if option outputs to stderr
Makefile:1940: recipe for target 'reboot.8' failed
make[2]: [reboot.8] Error 1 (ignorée)
  GUILEC   modules/shepherd.go
  GUILEC   modules/shepherd/scripts/halt.go
  GUILEC   modules/shepherd/scripts/herd.go
  GUILEC   modules/shepherd/scripts/reboot.go
  GUILEC   modules/shepherd/config.go
  GUILEC   modules/shepherd/system.go
  GUILEC   modules/shepherd/args.go
  GUILEC   modules/shepherd/service.go
  GUILEC   modules/shepherd/support.go
../modules/shepherd/support.scm:203:2: warning: non-literal format string
  GUILEC   modules/shepherd/runlevel.go
../modules/shepherd/runlevel.scm:106:6: warning: possibly unbound variable 
`next-services'
  GUILEC   modules/shepherd/comm.go
make[2]: Leaving directory '/home/mthl/src/shepherd/bd'
make[1]: Leaving directory '/home/mthl/src/shepherd/bd'
address@hidden:~/src/shepherd/bd$ 
--8<---------------cut here---------------end--------------->8---

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

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

--
Mathieu Lirzin.