On Sun, Mar 11, 2007 at 02:45:58PM +1100, Scott Smedley wrote: > > The current > > state of the XML documentation prevents me from writing any > > documentation. As almost everything I do has to be documented, it > > prevents me to do almost anything. > > I understand your concerns about the man-page output not being > rendered perfectly & I'll endeavour to fix them for you ASAP. But, > that is just cosmetic. If there's a technical reason why you can't edit > the XML documentation please let me know so I can address it.
The "technical" reason is that my mind can't cope with text split into hundreds of files. For me, an XML document is about as readable as a "word" document, and with separate files I'll be unable to find anything. I *know* I can grep over the files, but then a change I can now make in one minute will take ten. And I think the whole process is so slow because xsltproc has to be started hundreds of times. Don't get me wrong, I'm all for a better document format if the resulting man page is the same quality as the old one. But you can't ignore the needs of the people who *write* the man page completely. > > We're not talking about source but documentation. In my eyes > > having split pages is the one "feature" in html docs that makes it > > completely unusable: you can not browse or search it in a > > sensible way. And it's hell to read. A single page with intra- > > document links is much more usable. > > We have this too: > > http://members.optusnet.com.au/~scott.fvwm/fvwm/fvwm.man.html > > It's the bold link on the front page - it was the first thing I did. Nice. Now it should have a command index too. > > In any case, we're talking about Unix, not windoze. > > I'm confused. What has this got to do with anything? (Perhaps my > confusion comes from not having used Windoze since ~1998.) Forget it, nobody seems to get the joke :-) Ciao Dominik ^_^ ^_^ -- Dominik Vogt, [EMAIL PROTECTED]
signature.asc
Description: Digital signature
