public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
From: "Nathan L. Adams" <nadams@ieee.org>
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] GLEP ??: Critical News Reporting
Date: Thu, 03 Nov 2005 19:29:45 -0500	[thread overview]
Message-ID: <436AAB79.4020700@ieee.org> (raw)
In-Reply-To: <20051103191642.1fbdbd9d@snowdrop.home>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Ciaran McCreesh wrote:
> On Thu, 03 Nov 2005 08:49:42 -0500 "Nathan L. Adams" <nadams@ieee.org>
> wrote:
> | 6. Ciaran is completely biased against XML (or anything that isn't
> | stored as a simple flat file) ;)
> 
> It's not bias. I give XML exactly what it deserves. SGML is a giant
> fire breathing stomping monster useful for crushing Tokyo. XML is the
> spawn of said giant fire breathing stomping monster that's had its
> claws and teeth removed, its jaws glued shut, its legs chained together
> and its tail nailed to the ground. And we're not trying to destroy any
> large cities here...
> 

<rant>
You're just missing the fact that a flat file (or whatever it is you're
clinging to; for the purpose of this rant, I shall refer to your simple
data format as "flat file") has trade-offs, just like XML's trade off is
parsing overhead. XML was designed to solve certain problems;
portability of data, separation and portability of presentation from the
data, etc. Complexity in the parser is the trade-off.

Flat files can be great in certain situations. Flat files do indeed make
the parsing trivial. However SIMPLE CODE ISN'T ALWAYS THE MOST IMPORTANT
REQUIREMENT. In the case of this GLEP, the most important requirement is
getting the proper migration info to the users in the best possible way.

So what are the trade-offs of the 'flat file'? If you store a migration
guide as a 'flat file', its not going to be very readable. I would
certainly rather read info in GuideXML than some garbage output by einfo
or the like (and I'm talking about the same exact data, just a different
presentation). You're being daft if you say that your average terminal
output is easier to read and understand than the same data in proper
GuideXML format. OK, you say, you have a point there. But, you say, my
flat file allows me to write a 'presentation' proggy in relatively few
lines of trivial code. Yes, but now you have to write a new presentation
program for every type of presentation you want to do. Or worse you
would imbed the presentation in the data itself and make a new copy of
the data every time you want to present it differently. But, you say,
don't you have to do that with XML (i.e. a new style sheet definition
for each presentation)? Sure, but I don't have to re-write firefox in
the process...

So the point is that, yes, XML has a down side. But plain text, CSV
files, whatever have their downsides too. And the point of this GLEP
shouldn't be to push any XML-bashing agenda, it should be to present the
user with the migration guide in the best possible way. GuideXML is the
standard for Gentoo docs for some damn good reasons!
</rant>

Nathan
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFDaqt52QTTR4CNEQARAoQ1AJ42ItHkJ37eFUY8rSoGpN/dVoKIFACeJi7b
KW6/pzn8VEKi3hO0Gqomsms=
=cSQh
-----END PGP SIGNATURE-----
-- 
gentoo-dev@gentoo.org mailing list



  reply	other threads:[~2005-11-04  0:34 UTC|newest]

Thread overview: 144+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2005-11-01  1:51 [gentoo-dev] GLEP ??: Critical News Reporting Ciaran McCreesh
2005-11-01  2:08 ` [gentoo-dev] " Dan Meltzer
2005-11-01  2:19   ` Brian Harring
2005-11-01  2:20   ` Ciaran McCreesh
2005-11-01  2:25     ` Dan Meltzer
2005-11-01  2:37       ` Ciaran McCreesh
2005-11-01  3:02       ` Alec Warner
2005-11-01  3:21         ` pclouds
2005-11-01  2:16 ` [gentoo-dev] " Brian Harring
2005-11-01  2:24   ` Ciaran McCreesh
2005-11-01  2:39     ` Brian Harring
2005-11-01  8:25 ` Wernfried Haas
2005-11-01 11:56   ` Ciaran McCreesh
2005-11-01  9:21 ` [gentoo-dev] " Duncan
2005-11-01 12:21   ` Ciaran McCreesh
2005-11-01 10:00 ` [gentoo-dev] " Thierry Carrez
2005-11-01 10:45   ` Re[2]: " Jakub Moc
2005-11-01 12:13     ` Georgi Georgiev
2005-11-01 12:20       ` [gentoo-dev] " Dan Meltzer
2005-11-01 11:23   ` [gentoo-dev] " John Myers
2005-11-01 11:58   ` Ciaran McCreesh
2005-11-01 12:16     ` Thierry Carrez
2005-11-01 12:26       ` Ciaran McCreesh
2005-11-01 12:39         ` Re[2]: " Jakub Moc
2005-11-01 12:48           ` Ciaran McCreesh
2005-11-01 13:32             ` Re[2]: " Jakub Moc
2005-11-01 18:18               ` Ciaran McCreesh
2005-11-04  0:45                 ` Nathan L. Adams
2005-11-04  0:56                   ` Ciaran McCreesh
2005-11-04  1:05                     ` Nathan L. Adams
2005-11-04  1:19                       ` Ciaran McCreesh
2005-11-04  1:25                         ` Nathan L. Adams
2005-11-06 19:41                   ` [gentoo-dev] " R Hill
2005-11-01 13:34             ` [gentoo-dev] " Alec Warner
2005-11-01 13:43               ` Ciaran McCreesh
2005-11-01 14:07           ` Re[2]: " Paul de Vrieze
2005-11-02 20:49           ` Eldad Zack
2005-11-01 14:38         ` Chris Gianelloni
2005-11-04  0:54           ` Nathan L. Adams
2005-11-01 13:54 ` Andrej Kacian
2005-11-01 14:23   ` Christian Birchinger
2005-11-01 18:18   ` Ciaran McCreesh
2005-11-01 19:20     ` Andrej Kacian
2005-11-01 19:36       ` Alec Joseph Warner
2005-11-01 19:44       ` Grant Goodyear
2005-11-01 20:36         ` Andrej Kacian
2005-11-01 14:16 ` Paul de Vrieze
2005-11-01 18:26   ` Ciaran McCreesh
2005-11-01 16:22 ` Jan Kundrát
2005-11-01 18:25   ` Ciaran McCreesh
2005-11-01 21:57     ` Jan Kundrát
2005-11-01 22:16       ` Ciaran McCreesh
2005-11-02  1:29         ` Brian Harring
2005-11-02  0:52           ` Ciaran McCreesh
2005-11-02 11:26           ` Michiel de Bruijne
2005-11-02 14:19           ` Chris Gianelloni
2005-11-02 18:33         ` Jan Kundrát
2005-11-02 22:34           ` Ciaran McCreesh
2005-11-03  9:59             ` Jan Kundrát
2005-11-04 14:26             ` Xavier Neys
2005-11-04 18:39               ` Ciaran McCreesh
2005-11-04 21:30                 ` Jan Kundrát
2005-11-04 21:33                   ` Dan Meltzer
2005-11-05  0:13                 ` Xavier Neys
2005-11-04 18:59               ` Danny van Dyk
2005-11-05  0:11                 ` Xavier Neys
2005-11-05  1:30                   ` Danny van Dyk
2005-11-03 13:54         ` Nathan L. Adams
2005-11-03 14:24           ` pclouds
2005-11-03 13:49     ` Nathan L. Adams
2005-11-03 19:16       ` Ciaran McCreesh
2005-11-04  0:29         ` Nathan L. Adams [this message]
2005-11-04  0:42           ` Ciaran McCreesh
2005-11-04  1:02             ` Nathan L. Adams
2005-11-04  1:11               ` Ciaran McCreesh
2005-11-04  1:24                 ` Nathan L. Adams
2005-11-04  1:31                   ` Ciaran McCreesh
2005-11-04  1:36                     ` Nathan L. Adams
2005-11-04  1:46                       ` Stephen P. Becker
2005-11-04  1:53                         ` Nathan L. Adams
2005-11-04  2:30                           ` Luis F. Araujo
2005-11-04 21:37                             ` Jan Kundrát
2005-11-04  1:48                       ` Ciaran McCreesh
2005-11-04  1:55                         ` Nathan L. Adams
2005-11-04  3:06                           ` Qian Qiao
2005-11-04  9:06                       ` Paul de Vrieze
2005-11-04 14:21                         ` Chris Gianelloni
2005-11-04 14:04                       ` Chris Gianelloni
2005-11-04 16:05                         ` Nathan L. Adams
2005-11-04 16:46                           ` Chris Gianelloni
2005-11-04 17:08                             ` Nathan L. Adams
2005-11-04 17:29                               ` Daniel Ostrow
2005-11-04 17:29                               ` Jon Portnoy
2005-11-08  3:16                               ` Luca Barbato
2005-11-10 20:29                       ` Stuart Herbert
2005-11-04  1:33                   ` Brian Harring
2005-11-04  1:41                     ` Nathan L. Adams
2005-11-04  1:51                       ` Ciaran McCreesh
2005-11-04  1:43                     ` Nathan L. Adams
2005-11-04  9:12                       ` Paul de Vrieze
2005-11-04 12:32                       ` Dan Meltzer
2005-11-04 13:34                         ` Nathan L. Adams
2005-11-04 14:03                     ` Chris Gianelloni
2005-11-04  1:43                   ` Stephen P. Becker
2005-11-04  1:52                     ` Nathan L. Adams
2005-11-04  9:15                       ` Paul de Vrieze
2005-11-04 14:07                     ` Chris Gianelloni
2005-11-04  1:50                   ` Lance Albertson
2005-11-04  5:30                     ` Nathan L. Adams
2005-11-04 21:50                     ` Jan Kundrát
2005-11-06 22:11                       ` Marius Mauch
2005-11-04  9:02                   ` Paul de Vrieze
2005-11-04 13:38                     ` Nathan L. Adams
2005-11-04 14:05                       ` Paul de Vrieze
2005-11-04 15:55                         ` Nathan L. Adams
2005-11-07 10:24                           ` Paul de Vrieze
2005-11-04 14:19                     ` Chris Gianelloni
2005-11-04 14:02                   ` Chris Gianelloni
2005-11-04 15:58                     ` Nathan L. Adams
2005-11-04 16:41                       ` Chris Gianelloni
2005-11-04 16:57                         ` Nathan L. Adams
2005-11-04 17:07                           ` Lance Albertson
2005-11-04 17:15                             ` Nathan L. Adams
2005-11-04  2:08               ` Grant Goodyear
2005-11-04  2:18                 ` Lance Albertson
2005-11-04  5:44                 ` Nathan L. Adams
2005-11-04  8:32                   ` John Myers
2005-11-04  9:33                     ` Paul de Vrieze
2005-11-04 10:15                       ` Thierry Carrez
2005-11-04 13:18                         ` Marius Mauch
2005-11-04 13:46                         ` Nathan L. Adams
2005-11-04 14:27                         ` Xavier Neys
2005-11-04 16:08                           ` Nathan L. Adams
2005-11-04  8:21             ` Wernfried Haas
2005-11-04  9:55           ` Tres Melton
2005-11-04 16:35       ` Danny van Dyk
2005-11-04 16:52         ` Grobian
2005-11-04 17:10           ` Nathan L. Adams
2005-11-01 19:34 ` Stuart Herbert
2005-11-04 14:37 ` Lance Albertson
2005-11-04 18:48   ` Ciaran McCreesh
2005-11-04 19:12     ` Lance Albertson
2005-11-04 20:10       ` Ciaran McCreesh
2005-11-04 22:00     ` Jan Kundrát

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=436AAB79.4020700@ieee.org \
    --to=nadams@ieee.org \
    --cc=gentoo-dev@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox