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

List:       wine-devel
Subject:    Re: Documentation updating / XML?
From:       Francois Gouget <fgouget () free ! fr>
Date:       2008-04-30 11:58:07
Message-ID: alpine.DEB.1.10.0804241625210.3375 () amboise ! dolphin
[Download RAW message or body]

On Tue, 22 Apr 2008, Austin English wrote:
[...]
> On Tue, Apr 22, 2008 at 5:25 AM, Alexandre Julliard <julliard@winehq.org>
> wrote:
> 
> > "Austin English" <austinenglish@gmail.com> writes:
> >
> > > I've been working on some of the documentation, then remembered that
> > > Scott requested a move to XML:
> > > http://bugs.winehq.org/show_bug.cgi?id=12217
> > >
> > > There are quite a few programs to convert SGML to XML, and I've got a
> > > bit of time to kill. Alexandre, would you accept a move to XML, or 
> > > would this be a waste of time?
[...]
> Web/html/PDF/XML?

I would vote for DocBook XML so we can get Html and PDF documents out of 
it. Also now po4a works quite well with it. I could give you a hand on 
the po4a part.

However I'd say that there are some subtle but important differences 
between DocBook SGML and DocBook XML, especially around the include 
mechanism. So I'm a bit skeptical that automated tools can really 
produce clean DocBook XML code. But then they can probably be a good 
starting point.

It would also be nice if we could switch to a Git repository. Since 
it's not possible with SourceForge it would mean moving elsewhere. Would 
it be possible to have get it hosted on winehq.org?

-- 
Francois Gouget <fgouget@free.fr>              http://fgouget.free.fr/
 Advice is what we ask for when we already know the answer but wish we didn't
                                 -- Eric Jong


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