From: aglet
Date: 11:28 on 17 Oct 2003
Subject: bind9 documentation
we hates unreadable docbook documentation
[...]
>Section 8</I
></SPAN
> contains troubleshooting help. The
main body of the document is followed by several
<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Appendices</I
></SPAN
> which contain useful reference
information, such as a <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
[...]
From: peter (Peter da Silva) Date: 19:19 on 17 Oct 2003 Subject: Re: bind9 documentation > we hates unreadable docbook documentation The beggars must have used some kinda XML-aware program for that, because there's no reason to make Docbook incomprehensible like that.
From: Aglet Date: 22:49 on 17 Oct 2003 Subject: Re: bind9 documentation On Fri, 17 Oct 2003 14:19:19 -0500, Peter da Silva wrote: > there's no reason to make Docbook incomprehensible like that. They no doubt used Jade (or DSSSL, can't remember which) to generate that evil XHTML, but I still hates it. <question type="rhetorical" tone="sarcastic">What's wrong with plain text?</question> At least they could have pretty-printed it. It's not strictly software, but while I'm on my DNS hobby horse I really hates the way that given a zone file with a YYYYMMDDnn serial number Americans sometimes "accidentally" put YYYYDDMMnn; now I can't use the date for my serial number until 2004. Which part of "most significant part first" don't you understand, cowboy? I suppose I could add another n. But I'd hate to do that. PS Pan won't let me post without something it thinks is a valid email. Of course, it didn't bother telling me this when I created the profile. I hates it.
From: Nik Clayton Date: 22:47 on 17 Oct 2003 Subject: Re: bind9 documentation > we hates unreadable docbook documentation > [...] That's not DocBook. It looks like the result of converting DocBook to HTML. Just run it through tidy(1). ObHate: iChat on OS X isn't smart enough to try Rendezvous networking across both active network interfaces. N
From: Simon Cozens Date: 22:52 on 17 Oct 2003 Subject: Re: bind9 documentation Nik Clayton: > That's not DocBook. It looks like the result of converting DocBook to > HTML. Correct. Tag layouts like <foo > are a symptom of the oh-so-wonderful Jade. ObHate: dhcpd, network aliases. 'nuff said. Oh, and bonus hate: challenge/response email systems.
From: Aglet Date: 22:55 on 17 Oct 2003 Subject: Re: bind9 documentation On Fri, 17 Oct 2003 23:47:11 +0100, Nik Clayton wrote: >> we hates unreadable docbook documentation >> [...] > > That's not DocBook. It looks like the result of converting DocBook to > HTML. Just run it through tidy(1). I want the benighted authors of the documents to run them through tidy(1) *before* they give them to me, so I don't need tidy(1) or a web "browser" disturbing the karmic balance of my DNS server. Or better still, run them through lynx --dump and give me a text file. I can live without the emphasis, thanks, but I can't live with that nonsense, valid XHTML or no.
From: Nik Clayton Date: 22:47 on 17 Oct 2003 Subject: Re: bind9 documentation > we hates unreadable docbook documentation > [...] That's not DocBook. It looks like the result of converting DocBook to HTML. Just run it through tidy(1). ObHate: iChat on OS X isn't smart enough to try Rendezvous networking across both active network interfaces. N
From: Michel Rodriguez Date: 23:30 on 17 Oct 2003 Subject: Re: bind9 documentation On Fri, 17 Oct 2003, Nik Clayton wrote: > > we hates unreadable docbook documentation > > [...] > > That's not DocBook. It looks like the result of converting DocBook to > HTML. Just run it through tidy(1). > > ObHate: iChat on OS X isn't smart enough to try Rendezvous networking > across both active network interfaces. It actually looks like the formatted output of nsgmls or one of its descendants. There is actually a reason for the weird position of the \n, within the tags: in SGML/XML, it is the only place where it is absolutely certain that a whitespace is non-significant. Hence it looks bad but at least the file is broken into several lines. To come back to the topic of the list, I HATE getting several megabytes worth of SGML/XML in one big happy line. vi is NOT happy with it! -- Michel Rodriguez Perl & XML http://www.xmltwig.com
Generated at 10:26 on 16 Apr 2008 by mariachi