[pacman-dev] asciidoc

[Andrew Fyfe]

Dan McGee wrote:
> On 7/2/07, Andrew Fyfe <andrew at neptune-one.net> wrote:
>> Dan McGee wrote:
>>  > -Dan
>>  >
>>  > PS Did you see my asciidoc branch? It should be ready for any more
>>  > manpages you have up your sleeve.
>>
>>
>> I've rebased my asciidoc branch off of your's Dan and added the rest of
>> the man pages. There's still some format tweaks required.
> 
> Looking good so far. A few things of note:
> 1. We should probably make doc/ generation 'optional' in the sense
> that we ship with premade manpages but users can still regenerate them
> on their own. This way they are not required to have the whole
> asciidoc toolchain. (Note to self: move asciidoc into extra.)
Yes the release tarballs should contain pre-generated man pages and 
maybe html versions (and Doxygen?)

> 2. Guessing you haven't ran a make yet- it fails on a few of our
> manpages, those that do not contain a SYNOPSIS section. Any way to get
> around this? Manpages in section 5 shouldn't require this (a quick
> glance at a few don't have it).
Forgot to mention I've patched my copy of asciidoc so it doesn't require 
a SYNOPSIS section.

> 
> At the very least we can keep this as a side branch for a while, and
> worry about doing the merge later once we have everything looking
> pretty. These will be much easier to maintain than the old ones
I need to sit down and go through each page and sort out the formatting 
issues, I know there's a problem with white space after indented blocks 
and 2nd level definition lists aren't working.

> though, and we should be able to get some pretty-looking HTML as well.
HTML pages can be generated by switching one or to options to asciidoc.

Andrew
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: asciidoc-remove_require_synopsis.patch
URL: <http://archlinux.org/pipermail/pacman-dev/attachments/20070706/46ff7e01/attachment.diff>