Re: PEAR documentation

On Tue Feb 25, 2003 at 02:5433PM +0100, Markus Wolff wrote: > Maybe that´s why there are so few people who drite docbook docs... > only those who write docbook have a test environment, those who don´t > have a test environment don´t write docbook, because they have no > place to test ;-) In the past I've used test environments on SuSE Linux and since a year or so on Debian stable and with both distributions, building the docs worked just fine out of the box. I suspect that this isn't different with Redhat et.al. > - Learn the docbook tags and document structure > - Build a test environment (and for that, they first have to search > all the needed tools, tutorials etc.pp. that is needed to make such > a thing) > > There must be better ways, i.e. a web-based frontend where the docs > are first stored in a database, having a common logical structure and > from where you can then export the docs as either plain-text, docbook > or even OpenOffice, LaTeX or PDF. A few mails ago people were longing for a more "professional" PEAR and now they are longing for a non-professional way for writing docs. Hell, in what kind of project am I involved here? ;-) > Right now, I´m writing my docs in OpenOffice and hope there´ll be a > way to convert that into docbook some day, maybe via a plugin, maybe > via XSL. Didn't Wolfram start something like that some time ago? -- - Martin Martin Jansen http://martinjansen.com/