[pacman-dev] asciidoc

[Dan McGee]

On 7/13/07, Dan McGee <dpmcgee at gmail.com> wrote:
> On 7/13/07, Aaron Griffin <aaronmgriffin at gmail.com> wrote:
> > On 7/6/07, Dan McGee <dpmcgee at gmail.com> wrote:
> > > get stuck doing the autoconf goodness as well (things like checking
> > > for asciidoc, making the doc/ target optional, etc.).
> >
> > Just a quick note here, because I didn't chime in.  I'm a huge fan of
> > asciidoc in general BUT once you start delving into it, it gets crazy.
> >  Try installing asciidoc on a crippled system (dreamhost) and it might
> > make your eyes bleed.
> >
> > Still, as long as we actually generate the docs in the release
> > tarballs, it will be all good, heh.
>
> I think I have it working pretty smoothly in the asciidoc branch in
> either my or Andrew's repo. Test it out and break it if you can. If
> you actually want to generate the docs, you have to explicitly give
> the --enable-asciidoc flag to configure, otherwise you will just end
> up with the manpages from the tarball. Of course, as a developer, you
> need to use --enable-asciidoc to get those in the tarball in the first
> place.
>
> I just did a little check for my own sanity, and 'make dist' does
> include them in the tarball, which is good to see.
>
> -Dan
>

OK, I've heavily revised the manpages today because I knew our
documentation was in need of some work. There is probably still more
to do, but it is a start.

One quick question- why are bulleted lists rendering weird in man
pages for me? Not sure if it is a charset or pager issue, but I get
these symbols when it renders:

AUTHORS
       �   Judd Vinet <jvinet at zeroflux.org>
       �   Aurelien Foret <aurelien at archlinux.org>
       �   Aaron Griffin <aaron at archlinux.org>
       �   Dan McGee <dan at archlinux.org>

If that doesn't go through email, they are diamonds with a question
mark inside. I've seen this in other manpages as well. A good example
is the git manpages, also generated with asciidoc.

-Dan