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:11:31 +0000 (14:11 -0500)
commitfd3e1238cb0c3ad075e0f4f3c5f106145a0a6057
treebe338811547369c96a13d30d94ad08c019d09d49
parent95cdb5e344f39d72a13a60e50697db5fc47c9255
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.025569 seconds and 4 git commands to generate.