doc/man: only require asciidoc-attrs.conf when building the man pages
authorPhilippe Proulx <eeppeliteloop@gmail.com>
Fri, 28 Oct 2016 22:33:19 +0000 (18:33 -0400)
committerJérémie Galarneau <jeremie.galarneau@efficios.com>
Wed, 16 Nov 2016 19:21:08 +0000 (14:21 -0500)
commite50eabc64fa339ca9794a3787a151de55ced8bf2
tree574c9468fbf513dc7b85b4fc74762e7a5a5a2e84
parent350d9f9890d2f1b911c4a561b39741b50d41193c
doc/man: only require asciidoc-attrs.conf when building the man pages

Situations:

* If you want to and can build the man pages:
  * If it's a tarball tree:
    * Make the man page destinations depend on asciidoc-attrs.conf.
      Since it's a generated file, its date is greater than the
      date of the prebuilt man pages, therefore the man pages are
      built again, which is a good thing because they include the
      default values of this build.
  * If it's a Git tree:
    * Always build the man pages anyway (no prebuilt man pages here).
* If you want to, but cannot build the man pages:
  * If it's a tarball tree:
    * Make the man page destinations NOT depend on asciidoc-attrs.conf,
      because its recent date would ask said destinations to be rebuilt
      and this is not possible because we don't have the tools.

      However, warn the user at configure time that the prebuilt man
      pages will be installed, which means that they will contain the
      project's default values, not this build's default values.
  * If it's a Git tree:
    * Not valid: error at configure time as usual.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
configure.ac
doc/man/Makefile.am
This page took 0.026568 seconds and 4 git commands to generate.