Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

TorgoX (1933)

TorgoX
  sburkeNO@SPAMcpan.org
http://search.cpan.org/~sburke/

"Il est beau comme la retractilité des serres des oiseaux rapaces [...] et surtout, comme la rencontre fortuite sur une table de dissection d'une machine à coudre et d'un parapluie !" -- Lautréamont

Journal of TorgoX (1933)

Friday April 12, 2002
04:31 PM

Bad prose

[ #4162 ]
Dear Log,

I used to think that regexp(5) on HPUX was the worst prose ever. This pair of paragraphs is representative of it:

«The concatenation of patterns matching a single character is a valid pattern that matches the concatenation of the single characters or collating elements matched by each of the concatenated patterns. For example, the pattern a[bc] matches the string ab and ac.

The concatenation of one or more patterns matching a single character with one or more asterisks is a valid pattern. In such patterns, each asterisk matches a string of zero or more characters, up to the first character that matches the character following the asterisk in the pattern.»

-- regexp(5)

But Specification of Abstract Syntax Notation One (ASN.1), ITU-T Recommendation X.208 is absolutely breathtaking. Here is but one paragraph, from page 48:

The resulting type and value of an instance of use of the new value notation is determined by the value (and the type of the value) finally assigned to the distinguished local value reference identified by the keyword VALUE, according to the processing of the macrodefinition for the new type notation followed by that for the new value notation.

-- [as a PDF]

The SGML Handbook could ALMOST stand a chance at besting that, except that it's not really even in a human language -- it's just lots of weird alphanumeric cartouches, with some commentary in English. It ends up looking like a PostScript error. Here is one of the more coherent pages, which I scanned in so I could show it to the incredulous. Look -- IF YOU DARE!

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • Hey! Don't badmouth the SGML Handbook! I used to refer to it all the time, and I even knew how to use the hyper-linking system (for our younger audience, that's what the weird numbers are).It was the only reference book available on the subject. Practical SGML (sounds like an oxymoron doesn't it ;--) of course was a much easier read. And then we discovered HyTime... the pure delight of reading a standard and having no idea what the heck they might be talking about, what it should be used for, what it all me

    --
    mirod