> On Wednesday, June 21, 2000, Patrik Stridvall <[EMAIL PROTECTED]> wrote:
> >
> > This means of course that Alexandre and anybody that want to write
> > documentation must have it installed but that is not
> unreasonable IMHO.
>
> Also, I would like to make a standing offer to convert any plain text
> files into DocBook and manage the details of getting it into the
> documentation system. So you don't even _have_ to know DocBook. You
> just have to know how to use a keyboard. I've been tracking
> wine/documentation and it hasn't been too difficult to keep
> the docs up
> to date.
I have only look very briefly on DocBook but it doesn't
look much more complicated than HTML and learning HTML
was very easy.
However having somebody doing an initial conversion will help
to get started, changing an existing document is much easier
than beginning from scratch reading the reference manual.
I'm currently working on a winapi_check documentation,
about half done. Having it converted to DocBook would
be appreciated since it you help me get started with
DocBook, which I, as I said, have only looked on very
briefly.
> > When Alexandre have applied a documentation patch he will need to
> > do ./tools/make_documentation or something, but then similar thing
> > are required even now for debug messages to take one example.
>
> It could also be a makefile target. For example:
No, it can't, at least not without violating the principle
that "make distclean" should remove _all_ files built by "make all".
However all the ./tools/make_* files are hacks that should be removed
somehow IMHO, eventhough I have no good suggestions as to how.
> docs:
> db2html wine-cvs-docs.sgml
>
> The db2html script is part of the Cygnus stylesheets, IIRC, and exists
> on Redhat and Debian and others.
Yes, called, not very suprisingly, cygnus-stylesheets on Debian.
apt-get install cygnus-stylesheets
is your friend if you run Debian. :-)
