Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-14 Thread Francois Gouget
On Sat, 12 Mar 2005, Scott Ritchie wrote: I wanted the Wine documentation to appear on the nice help menus, like other standard apps. I learned that the way to do this is to write an OMF file for each document, which scrollkeeper can then look at to find the metadata about where the document is an

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Dimitrie O. Paun
On Sun, Mar 13, 2005 at 09:13:31AM -0700, Brian Vincent wrote: > On Sat, 12 Mar 2005 16:57:22 -0800, Scott Ritchie <[EMAIL PROTECTED]> wrote: > > 1) Create a new directory for all XML documentation at wine/doc. This > > will also bring us to be more standard. > > The key is that we use Docbook's

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Dimitrie O. Paun
On Sun, Mar 13, 2005 at 11:53:01AM +0100, Alexandre Julliard wrote: > Scott Ritchie <[EMAIL PROTECTED]> writes: > There's nothing great about SGML, no argument here; but as far as I > can tell XML is the same mess except a bit worse. And I can't say I'm > particularly thrilled to have to change all

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Brian Vincent
On Sat, 12 Mar 2005 16:57:22 -0800, Scott Ritchie <[EMAIL PROTECTED]> wrote: > 1) Create a new directory for all XML documentation at wine/doc. This > will also bring us to be more standard. The key is that we use Docbook's SGML. Docbook now supports XML and converting the SGML is as easy Mike s

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Mike Hearn
On Sun, 13 Mar 2005 11:53:01 +0100, Alexandre Julliard wrote: > There's nothing great about SGML, no argument here; but as far as I > can tell XML is the same mess except a bit worse. And I can't say I'm > particularly thrilled to have to change all the documentation every > couple of years just to

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Alexandre Julliard
Scott Ritchie <[EMAIL PROTECTED]> writes: > Well, let's discuss it here then. What's so great about SGML, when > scrollkeeper doesn't like it and we can convert it to html/txt with > similar tools to the ones we use now? There's nothing great about SGML, no argument here; but as far as I can tel

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Scott Ritchie
On Sun, 2005-03-13 at 03:11 -0500, Dimitrie O. Paun wrote: > On Sat, Mar 12, 2005 at 04:57:22PM -0800, Scott Ritchie wrote: > > 1) Create a new directory for all XML documentation at wine/doc. This > > will also bring us to be more standard. > > You better check with Alexandre first, I doubt he'l

Re: Scrollkeeper, the documentation, XML, and the way forward

2005-03-13 Thread Dimitrie O. Paun
On Sat, Mar 12, 2005 at 04:57:22PM -0800, Scott Ritchie wrote: > 1) Create a new directory for all XML documentation at wine/doc. This > will also bring us to be more standard. You better check with Alexandre first, I doubt he'll go for it. > 3) We follow the steps at the above link to add scrol

Scrollkeeper, the documentation, XML, and the way forward

2005-03-12 Thread Scott Ritchie
I wanted the Wine documentation to appear on the nice help menus, like other standard apps. I learned that the way to do this is to write an OMF file for each document, which scrollkeeper can then look at to find the metadata about where the document is and how to index it and such. The trouble i