Re: [Wireshark-commits] rev 35213: /trunk/docbook/wsdg_src/ /trunk/docbook/wsdg_src/: WSDG_chapter_build_intro.xml WSDG_preface.xml

[Stephen Fisher <steve () stephen-fisher com>]

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 :).
___________________________________________________________________________
Sent via:    Wireshark-dev mailing list <wireshark-dev () wireshark org>
Archives:    http://www.wireshark.org/lists/wireshark-dev
Unsubscribe: https://wireshark.org/mailman/options/wireshark-dev
             mailto:wireshark-dev-request () wireshark org?subject=unsubscribe