2007/7/16, Dan McGee <dpmcgee@gmail.com>:
On 7/13/07, Dan McGee <dpmcgee@gmail.com> wrote:
On 7/13/07, Aaron Griffin <aaronmgriffin@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 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 -- Roman Kyrylych (Роман Кирилич)