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:03 +0000 (14:21 -0500)
commit20290f25a4224913da313547d6aba427195c0752
treea258c581d0784241f830da0b9b17631bf17cd663
parenta9f870009eb38ea4bb3af1eae0bb0bb6196b3575
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.027458 seconds and 5 git commands to generate.