[pacman-dev] asciidoc

[Andrew Fyfe]

Dan McGee wrote:
> 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
> _______________________________________________
> pacman-dev mailing list
> pacman-dev at archlinux.org
> http://archlinux.org/mailman/listinfo/pacman-dev
What does it look like in a normal console (not xterm)?

Andrew