[Xapian-discuss] Xapian documentation

[James Aylett]

On Mon, May 08, 2006 at 11:11:27AM -0500, Peter Karman wrote:

> >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.

True :)

> 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. :)

<grins>

I'm all for semantic beauty, I just need to be able to write the damn
things too :-)

You don't happen to know in XML Minds how to start a new same-level
section quickly, do you? I'm still looking for the relevant key
press...

J

-- 
/--------------------------------------------------------------------------\
  James Aylett                                                  xapian.org
  james at tartarus.org                               uncertaintydivision.org