Dan McGee wrote:
On 7/16/07, Roman Kyrylych <roman.kyrylych@gmail.com> wrote:
2007/7/16, Dan McGee <dpmcgee@gmail.com>:
On 7/13/07, Dan McGee <dpmcgee@gmail.com> wrote:
On 7/6/07, Dan McGee <dpmcgee@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
On 7/13/07, Aaron Griffin <aaronmgriffin@gmail.com> wrote: 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@zeroflux.org> � Aurelien Foret <aurelien@archlinux.org> � Aaron Griffin <aaron@archlinux.org> � Dan McGee <dan@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@archlinux.org http://archlinux.org/mailman/listinfo/pacman-dev What does it look like in a normal console (not xterm)?
Andrew