[augeas-devel] [PATCH] Add NaturalDocs configuration and scripts

[David Lutterkort]

On Tue, 2008-09-09 at 10:58 +0200, Raphael Pinson wrote:
> # HG changeset patch
> # User Raphael Pinson <raphink at gmail.com>
> # Date 1220950704 -7200
> # Node ID baaa0889bc553b419f87ff6fc041e0122454402a
> # Parent  682d87344dedee300e0829e994ceab1f1baab318
> Add NaturalDocs configuration and scripts

I haven't had a chance to try this out in detail (partly because there's
no NaturalDocs RPM for Fedora, though there is a review request[1])

Besides that, there's a couple questions on how to best integrate that
with the current build (I am not saying you have to do that, but it
needs to be done ;):

      * the Makefile needs to be turned into a Makefile.am
      * some of the directories might need to be reshuffled (e.g.
        NDOUTPUT needs to be relative to $(builddir)
      * we shouldn't require that people have ND installed just to
        build, we should detect whether ND is present in configure.ac
        and only generate HTML docs when it's there (maybe with an
        option to tell us explicitly where the ND install is if it's not
        on $PATH)
      * should we distribute the generated HTML docs in the tarball ?

David

[1] https://bugzilla.redhat.com/show_bug.cgi?id=455164