From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([69.77.167.62] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1Lc4KY-00044D-DT for garchives@archives.gentoo.org; Tue, 24 Feb 2009 20:56:42 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2E584E0564; Tue, 24 Feb 2009 20:56:41 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 0CE14E0564 for ; Tue, 24 Feb 2009 20:56:41 +0000 (UTC) Received: from vrm378-02.vrm378.am.mot.com (unknown [144.190.95.61]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id 55E3464C95 for ; Tue, 24 Feb 2009 20:56:40 +0000 (UTC) Date: Tue, 24 Feb 2009 15:56:32 -0500 From: Jim Ramsay To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Issues regarding glep-55 (Was: [gentoo-council] Re: Preliminary Meeting-Topics for 12 February 2009) Message-ID: <20090224155632.03a34569@vrm378-02.vrm378.am.mot.com> In-Reply-To: <20090224204154.6fc34e4c@snowcone> References: <1234257125.18160.2016.camel@localhost> <20090212172109.778fb268@snowcone> <20090212173743.GD3652@comet> <20090212180350.0d9a9df5@snowcone> <1235037961.13198.779.camel@localhost> <20090219125124.33eaa66c@snowcone> <1235077892.13198.1923.camel@localhost> <20090222171658.278ae167@halo.dirtyepic.sk.ca> <49A1E1CB.1000806@gentoo.org> <20090222234800.29d64b8d@snowcone> <49A206A7.3050604@gentoo.org> <49A39CE7.4010201@gentoo.org> <49A3AAA1.6080207@gentoo.org> <49A3B947.2020907@gentoo.org> <49A3D0F6.6080307@gentoo.org> <49A41656.7020100@gentoo.org> <20090224155654.602f6c88@snowcone> <20090224122527.1e800f30@vrm378-02.vrm378.am.mot.com> <20090224182023.5d858986@snowcone> <20090224140845.73053f4c@vrm378-02.vrm378.am.mot.com> <20090224191928.6b9e52db@snowcone> <20090224150729.2c83596f@vrm378-02.vrm378.am.mot.com> <20090224201319.173144e6@snowcone> <20090224153736.71804732@vrm378-02.vrm378.am.mot.com> <20090224204154.6fc34e4c@snowcone> X-Mailer: Claws Mail 3.7.0 (GTK+ 2.14.7; x86_64-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/NeDDlSt.V7Qgg97.QdDg56d"; protocol="application/pgp-signature"; micalg=PGP-SHA1 X-Archives-Salt: 8dca30ae-94cd-45b6-97ed-f4daac5c2964 X-Archives-Hash: e12fdfd8ac038283bf9f21cdb2ef9fa8 --Sig_/NeDDlSt.V7Qgg97.QdDg56d Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Ciaran McCreesh wrote: > On Tue, 24 Feb 2009 15:37:36 -0500 > Jim Ramsay wrote: > > > They only ended up nicely documented after people moaned a lot > > > that they were having a hard time keeping track of EAPIs... > >=20 > > You can't possibly be suggesting that everyone will be able to keep > > an ever-increasing number of feature sets in his or her mind, or > > that changing from a two-level to a one-level EAPI definition will > > remove the need for documentation going forward, so I'm not sure > > what you mean by this. >=20 > That's exactly what I mean. Developers can probably just about keep up > with the two or three EAPIs they'll ever be working with on a regular > basis, but they probably can't keep up with that if you double it. Well, if you're assuming only two or three EAPIs in 'mental cache' at any one time under glep-55, I'm not sure how this changes wrt. a two-level system. A two-level system doesn't change the number of EAPIs in the tree or available to developers, it just changes how they are named. Regardless, this does not remove the need for documentation. All the EAPIs should be documented in both the PMS and the devmanual. This makes it possible for new developers to learn about the current features available, and also helps existing devs who may need to recover from 'mental page faults' from time to time. --=20 Jim Ramsay Gentoo Developer (rox/fluxbox/gkrellm/vim) --Sig_/NeDDlSt.V7Qgg97.QdDg56d Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.10 (GNU/Linux) iEYEARECAAYFAkmkXwQACgkQelWXok6VKuhxwgCg2Kxt88L+XgkzU412+JwU2g97 9hsAn3jGENsMyI3spUBrZDgIj/ZT3BMs =qXib -----END PGP SIGNATURE----- --Sig_/NeDDlSt.V7Qgg97.QdDg56d--