[pacman-dev] [GIT] pacman branch, master now at v3.0.0-410-g7325ebb

[Dan McGee]

On 9/18/07, Andrew Fyfe <andrew at neptune-one.net> wrote:
> Xavier wrote:
> > On Tue, Sep 18, 2007 at 12:04:23AM -0400, Dan McGee wrote:
> >> commit 708488f6fe8bf5e06ae724243381b40586301633
> >> Merge: b0aa51059233849b0a7ef8d6a851750776ce6645 f131ee9c56b99429374dfcce583872ad9259ed96
> >> Author: Dan McGee <dan at archlinux.org>
> >> Date:   Sun Sep 16 21:10:44 2007 -0500
> >>
> >>     Merge branch 'asciidoc' into working
> >>
> >>     We're getting close to release, so might as well do this now so people can
> >>     actually update some of our documentation.
> >>
> >
> > Hmm, apparently pacman doesn't build anymore, I get :
> > Making all in doc
> > make[2]: Entering directory `/data/share/devel/pacman/pacman/doc'
> > make[2]: *** No rule to make target `pacman.8', needed by `all-am'.  Stop.
> > make[2]: Leaving directory `/data/share/devel/pacman/pacman/doc'
> > make[1]: *** [all-recursive] Error 1
> > make[1]: Leaving directory `/data/share/devel/pacman/pacman'
> > make: *** [all] Error 2
> >
> > After checking asciidoc was installed, doing ./configure --enable-asciidoc ,
> > and installing docbook-xsl , it compiled fine.
> >
> > I'm a bit confused. So now for getting man pages, we need asciidoc and
> > docbook-xsl as makedepends , and adding that --enable-asciidoc configure
> > flag, right?
> >
> > And if --enable-asciidoc isn't specified, no man pages can be built at all,
> > and it's just a little quirck left in the Makefiles?

> Official source releases will come with the man pages built, that was
> the plan wasn't it Dan?
>
> Andrew

Correct. The way it works is this- you will have to build with
asciidoc enabled at least once to get the manpages, and they are never
cleaned up in a "make clean" target call. They are also distributed in
the pacman tarball created by "make dist" or "make distcheck".

As a developer, I figure everyone can get asciidoc installed in order
to build the manpages. If not...well if you can come up with a patch
that still satisfies the above requirements, then I'll take it (some
sort of patch that doesn't fail if targets in doc/ can't be built).

Thus, we don't need asciidoc or docbook-xsl as makedepends, and also
the reason --enable-asciidoc is off by default. Something to check,
however- "make dist" should probably enforce that --enable-asciidoc is
actually enabled and working.

-Dan