[pacman-dev] asciidoc

[Roman Kyrylych]

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

-- 
Roman Kyrylych (Роман Кирилич)