From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.50) id 1EXxye-0006Eo-OJ for garchives@archives.gentoo.org; Fri, 04 Nov 2005 09:35:17 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jA49YW7c019758; Fri, 4 Nov 2005 09:34:32 GMT Received: from callisto.cs.kun.nl (callisto.cs.kun.nl [131.174.33.75]) by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id jA49Wlnu004965 for ; Fri, 4 Nov 2005 09:32:47 GMT Received: from localhost (localhost [127.0.0.1]) by callisto.cs.kun.nl (Postfix) with ESMTP id B90382E800B for ; Fri, 4 Nov 2005 10:33:06 +0100 (CET) From: Paul de Vrieze To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] GLEP ??: Critical News Reporting Date: Fri, 4 Nov 2005 10:33:05 +0100 User-Agent: KMail/1.8.92 References: <20051101015125.1cc45eb4@snowdrop.home> <436AF548.8070406@ieee.org> <200511040032.25592.electronerd@monolith3d.com> In-Reply-To: <200511040032.25592.electronerd@monolith3d.com> X-Face: #Lb+'V@sGJ;ptgo5}V"W+5OCoo{LZv;bh,s,`WKLi/J)ed1_$0;6X<=?utf-8?q?700LVV/=3BLqPhiDP=5E=0A=09=27f=5Dfnv?=@%6M8\'HR1t=aFx;ePfp{ZQoBe+e)JOQ8T5*(_;mHY+cltLGq<;@$Y,=?utf-8?q?O=5C=24=0A=09Tm=23G6M?=,g![Q62J{na*S9d;R[^8pc%u\aiLqU@`kJtYl"^6pxdW Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; boundary="nextPart7039691.mAWevjIXJC"; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-Transfer-Encoding: 7bit Message-Id: <200511041033.06340.pauldv@gentoo.org> X-Archives-Salt: 314b09e6-6c43-48ef-abd6-bcfa24cdb45c X-Archives-Hash: dc7cfbc67d11f6fe3b1f771f38a2349c --nextPart7039691.mAWevjIXJC Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On Friday 04 November 2005 09:32, John Myers wrote: > [[ACK! I sent this out from the wrong address before. Hope you don't > get it twice!]] > > On Thursday 03 November 2005 21:44, Nathan L. Adams wrote: > > No, I happen to understand the that point. Emerge outputting a short > > summary is great. But the GLEP should cover the "hey mr. end user, > > the central repository for errata/full fledged migration guides is > > here: [insert url]" as well. > > [snip] > > > I happen to think that the assumption that the errata are going to be > > small is a bad one. I think if errata is neccessary in the first > > place then its going to be something larger than a screen's worth of > > console output and worth the supposed trouble of GuideXML. So why not > > approach it from the GuideXML end first, and extract the summary from > > that? > > Here's an idea for a compromise solution. Sorry it's so messy: > > The errata entries would consist of two files per language: > - An emerge news file, identical to the format ciaranm proposed. > This file would give a very general notice of the issue, such as > that given as an example in the GLEP, as well as containing the > machine-readable commands for portage to control display. > This file's name would end in .news..txt > - A GuideXML-formatted errata document. > This would be the actual migration guide, such as the contents of > the http://www.gentoo.org/doc/en/yoursql-upgrading.xml > referenced by the example. > This file's name would end in .guide..xml > - The leading part of the filename would be as in ciaranm's GLEP Oh god help. This also points to another reason why this is not such a=20 good idea. Writing guideXML is a lot more work than writing an e-mail=20 format file (ciaran's proposed format for those who didn't recognize it). Also having double files containing the same information is broken by=20 design. This doesn't mean that all information should be in the news=20 file. Let me give an example that would have been relevant some time ago. Title: Incompatible subversion repository change Author: Paul de Vrieze Content-Type: text/plain Posted: 2005-11-04 Version: 1 Display-If-Installed: =3Ddev-util/subversion-0.34.0. After installation new=20 repositories can be created and the dumps can be reloaded. =46or more information on dumping and loading see the subversion migration= =20 guide: http://subversion.tigris.org/subversion_migration. If I have to write such a file in guidexml it would be a lot more=20 complicated. Further this news item would only be relevant to people=20 providing older subversion repositories wanting to update. As erata would=20 contain all these files, it would be a swamp, hard to wade through. I also fail to see where such a file as illustrated above is unclear to=20 read. I prefer it over a bloated webpage with all kinds of slowness and=20 eyecandy. Paul =2D-=20 Paul de Vrieze Gentoo Developer Mail: pauldv@gentoo.org Homepage: http://www.devrieze.net --nextPart7039691.mAWevjIXJC Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2-ecc0.1.6 (GNU/Linux) iD8DBQBDayrSbKx5DBjWFdsRAot4AKDhz3IT55CqOEV4/mk3JM075f+vlQCfZhDS 0Nvheeyf7FEFyM8jOb3nAF0= =gifJ -----END PGP SIGNATURE----- --nextPart7039691.mAWevjIXJC-- -- gentoo-dev@gentoo.org mailing list