Wireshark-dev: Re: [Wireshark-dev] [Wireshark-commits] rev 35213: /trunk/docbook/wsdg_src/ /tru
Date Index · Thread Index · Other Months · All Mailing Lists
Date Prev · Date Next · Thread Prev · Thread Next
From: Stephen Fisher <steve@xxxxxxxxxxxxxxxxxx>
Date: Mon, 20 Dec 2010 11:17:03 -0700
On Mon, Dec 20, 2010 at 10:06:40AM -0500, Jeff Morriss wrote:

> I have to admit that I can see the benefit of having just one set of 
> documentation. And I can see the advantage of having "pretty" (or 
> hyper-linked) PDF/HTML documentation.  But I just can't bring myself 
> to let go of README.developer...

I agree.

XML drives me crazy with it's opening AND closing tags, DTDs, and 
everything else.  The complexity isn't worth the benefits it offers.  I 
rather like the simple markup in our Perl Documentation (pod) documents.  

A good alternative to XML, at least for representing data sets, is YAML 
a lot more human readable 
(http://en.wikipedia.org/wiki/YAML#Sample_document) than XML, which I 
thought was the original purpose of XML anyway :).