[pacman-dev] asciidoc

[Dan McGee]

On 7/16/07, Roman Kyrylych <roman.kyrylych at gmail.com> wrote:
> 2007/7/16, Dan McGee <dpmcgee at gmail.com>:
> > 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.
>
> Diamonds with a question marks are equivalent for empty squares on WinXP here.
> They mean those symbols are not suported by our font(s). :-P

Interesting, because I thought DejaVu Sans Mono pretty much had every
character under the sun in it, especially a lowly bullet symbol. I
couldn't find any other fonts that display it properly either.

-Dan