[prev in list] [next in list] [prev in thread] [next in thread] 

List:       vorbis-dev
Subject:    Re: [Vorbis-dev] Vorbis documentation creation process
From:       "Ralph Giles" <giles () xiph ! org>
Date:       2008-11-27 21:45:17
Message-ID: 5d88ef650811271345w455ff70ds78ca4097a94d518d () mail ! gmail ! com
[Download RAW message or body]

On Thu, Nov 27, 2008 at 1:21 PM, Ivo Emanuel Gonçalves
<justivo@gmail.com> wrote:

> On 11/27/08, Christopher Montgomery <xiphmont@gmail.com> wrote:
>> We probably need to migrate the docs.

If you want to build the docs you have to get docbook working. I'm
fine with any path that generates reasonable looking output. Fop, for
example, might be up to the job these days.

Given that passivetex has gone unmantained, and apparently xmlto as
well, since it's just a wrapper that's supposed to call the most
appropriate tools to generate whatever format one reqeuests, we've
talked about giving up on docbook, and porting the spec back to html
or over to latex, like the theora spec. Either of those is work, of
course.

I'd suggest going back to html at this point. With a nice stylesheet
and mathml, it prints reasonably well, while it's still hard to turn
latex into html for online reference, which is probably the more
common use. The vorbis spec doesn't have nearly as many equations as
the theora spec, so the pain there is reasonable.

FWIW,
 -r
_______________________________________________
Vorbis-dev mailing list
Vorbis-dev@xiph.org
http://lists.xiph.org/mailman/listinfo/vorbis-dev

[prev in list] [next in list] [prev in thread] [next in thread]