[Xapian-discuss] Xapian documentation

[Peter Karman]

James Aylett scribbled on 5/8/06 10:54 AM:

> 
> I'd argue (although mostly for the sake of arguing :-) that doing
> something because the majority of the Linux world does it is actually
> a very bad idea. (Gee, let's all use CORBA :-)

oh, I agree. I wasn't trying to suggest that since "everyone else is 
doing it, so should we." Merely that there is a great deal of experience 
out there with DocBook and so it is fairly portable and has a decent 
tool set.

> 
>> There are many good free tools for DocBook publishing, the best
>> among them the XSLT stuff from Norm Walsh et al.
> 
> Having played a little with XML Mind's editor, I'm inclined to think
> DocBook is probably the way to go. It's just a pity it's still so
> damned ugly :-)
> 

when my old company switched from nroff man pages to XML man pages, we 
pretty much doubled the size of our doc set overnight. But then, we 
suddenly had an enforceable, testable document type definition and 
semantic meaning to our markup. I still like nroff/troff (it's great for 
certain appliations) but I was glad to get the added benefits of DocBook.

so ugliness in one sense can be beauty in another. :)

-- 
Peter Karman  .  http://peknet.com/  .  peter at peknet.com