From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1QGIzw-0004tN-6K for garchives@archives.gentoo.org; Sat, 30 Apr 2011 22:50:48 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2D1781C048; Sat, 30 Apr 2011 22:50:39 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 0561F1C002 for ; Sat, 30 Apr 2011 22:50:12 +0000 (UTC) Received: from afta-gentoo.localnet (ip-85-198-244-135.broker.com.pl [85.198.244.135]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: arfrever) by smtp.gentoo.org (Postfix) with ESMTPSA id 1582D1B400A; Sat, 30 Apr 2011 22:50:12 +0000 (UTC) From: Arfrever Frehtes Taifersar Arahesis To: Gentoo Development Subject: Re: [gentoo-dev] python-namespaces.eclass Date: Sun, 1 May 2011 00:49:49 +0200 User-Agent: KMail/1.13.6 (Linux/2.6.34-tuxonice-r8-AFTA; KDE/4.4.5; x86_64; ; ) Cc: qa@gentoo.org References: <201104031938.18311.Arfrever@gentoo.org> <201104302327.51149.Arfrever@gentoo.org> <20110430223213.GD23166@hrair> In-Reply-To: <20110430223213.GD23166@hrair> 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="nextPart3071907.XyiAbFPejl"; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-Transfer-Encoding: 7bit Message-Id: <201105010049.51614.Arfrever@gentoo.org> X-Archives-Salt: X-Archives-Hash: 2ce12d2c5e18700975aaed63922126fc --nextPart3071907.XyiAbFPejl Content-Type: Text/Plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable 2011-05-01 00:32:13 Brian Harring napisa=C5=82(a): > On Sat, Apr 30, 2011 at 11:27:47PM +0200, Arfrever Frehtes Taifersar Arah= esis wrote: > > 2011-04-04 13:48:43 Brian Harring napisa=C5=82(a): > > > > # @ECLASS: python-namespaces.eclass > > > > # @MAINTAINER: > > > > # Gentoo Python Project > > > > # @BLURB: Eclass for packages installing Python namespaces > > > > # @DESCRIPTION: > > > > # The python-namespaces eclass defines phase functions for packages= installing Python namespaces. > > >=20 > > > ^^^ This isn't a useful description. > >=20 > > IMHO it's sufficient, but could you suggest some sentences of descripti= on? >=20 > It probably is sufficient for *you*- you're knee deep in the guts of=20 > python, and know it's purpose. Plus you wrote the eclass ;) >=20 > The purpose of the description, and general code comments is for=20 > *other* folk who may be looking at that code/problem for the first=20 > time. It needs to be written aimed at them. >=20 > I'd suggest doing a grep of DESCRIPTION w/in eclasses and working from=20 > the clearer examples- just looking at the first few examples returned,=20 > alternatives for example has enough in the opening description to=20 > understand exactly what it's for, same for apache-2. >=20 > One thing to keep in mind is that even for folk who know python, this=20 > is actually an area that doesn't match the normal verbage, and is a=20 > bit niche in it's usage- try googling 'python namespaces' sometime,=20 > note that it's scope discussions rather than pkgutil/distribute=20 > importation across multiple directories.=20 >=20 > To be clear, 'python namespaces' is a whole other thing from what this=20 > is doing- this is manipulation of importation pathways (the=20 > module/import hierarchy/namespace, rather than the common scope=20 > terminology). >=20 > Either way, rough suggestion: > """ > This eclass handles installation/creation of python 2.7 and higher __init__.py files generated by this eclass work with Python 2.4. (I haven't tested them with older versions.) > pkgutil namespaces, and the equivalent distibute functionality. See=20 > zope's (example ebuild) for examples of usage. > """ =2D-=20 Arfrever Frehtes Taifersar Arahesis --nextPart3071907.XyiAbFPejl Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) iQIcBAABAgAGBQJNvJIPAAoJENgZr6v6gHY00J4QAMpy3LQonbVlEdzn/owZ3mYF bezp6tvZwB+yNOjzvrRuQhCip+od8g0I4hpG/W/TY5h5RiQwrEnH8AikBgJ54Kc9 YX3Mp/BGe9SvBUwj/0BuUxAradF8DGIR2pcDyQL5wAPrXDS+tUN90cMtT7Jid8Qy huNDmjT3AKGnY25ZgzVFYnTw9loj+f1zFvtIWhYQ7eFeM5tGoti5WhFIeXhupv5d 8VTgwLV2UiA6GHjgyycWba8xHUT2J00GeR/c3v6LgzAeM4O+vl6Z4NXF7hdUIL02 xmJM78otq+1u+mR4YHGb5mpPtvPb9e662bUJiszFnd68uHcXuL1Za3oJ4GfACiBg FlqzX4XX3MYe1ouoyv9TrUps+vSZTkymkLF/IinojfxdSQBrSJLnLMQmTpxX+J0h W4CD/ZyLqsX9R8SLxTqhWMICc6UZh/Je0gLEw4bcWFd4HYGJo6OUXroD6/OumfCR FG6UTXNCQMrndZZsyxBalTi+nt0msmYnwDCdUvLnoQO9hcjitbep4xw2GIR8TJUJ Hbl6JsJ6dLWK3rKpLsPuJ+iG+IdQP1b0lygyzw2isWyxOGdOYM/YG3UvwVKOLr3M i5/BuYJHFqO/WRre8Mn2cb8NUNhdhAnRsgfBaJhR1pni/7skWsUsnL7mEdK9qtl4 yiB0YzLy0Xk3ITP0VLx/ =2b81 -----END PGP SIGNATURE----- --nextPart3071907.XyiAbFPejl--