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 1LtOZR-0005Tb-6p for garchives@archives.gentoo.org; Mon, 13 Apr 2009 15:59:41 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 35F3FE0764; Mon, 13 Apr 2009 15:59:40 +0000 (UTC) Received: from mail-ew0-f163.google.com (mail-ew0-f163.google.com [209.85.219.163]) by pigeon.gentoo.org (Postfix) with ESMTP id D2DCAE0764 for ; Mon, 13 Apr 2009 15:59:39 +0000 (UTC) Received: by ewy7 with SMTP id 7so2003699ewy.34 for ; Mon, 13 Apr 2009 08:59:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:date:from:to:cc:subject :message-id:in-reply-to:references:x-mailer:mime-version :content-type; bh=0PQber7ZhlTrVXkv1+AO2op31PMLM8iDqdZN3Tp3fcA=; b=Z/GA9OwnLtsS7bw6t+q9om9q7MPRHnV9Fr9yQjYXIekZyhL4gI3MMP1vpQSbBhCtgS mc6R/sKnsHJ+bdvTwmki4JCdi7g+raTjKgOK7JOKQPFznzK0Jo4eKdTTfbd4yNjUsmgT TS2ZkrJ3WlvyeRgsAZ4EpgGUq50xq4rf1cn2k= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer :mime-version:content-type; b=jYTttSuagGK6S5T3wf20kAJs84IMAPKzK8U9bEnZo60NNatFynYFO6yss3jl/L8Fky 9qiX+BZxVGA4ymae1nj4EFKTuxAtvbW9d8veBQpDPD0hshgBf5KwBwtutmJbMkJzWoa8 14LlkBbaRPeM2xLzMqixgeEABJG4QY/oOr/D0= Received: by 10.216.19.210 with SMTP id n60mr1550113wen.107.1239638379117; Mon, 13 Apr 2009 08:59:39 -0700 (PDT) Received: from snowcone (92-235-187-79.cable.ubr18.sgyl.blueyonder.co.uk [92.235.187.79]) by mx.google.com with ESMTPS id x6sm13286089gvf.12.2009.04.13.08.59.37 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 13 Apr 2009 08:59:38 -0700 (PDT) Date: Mon, 13 Apr 2009 16:59:23 +0100 From: Ciaran McCreesh To: Christian Faulhammer Cc: gentoo-pms@lists.gentoo.org Subject: Re: [gentoo-pms] EAPI 3 branch could use some reviewing Message-ID: <20090413165923.7dd916bd@snowcone> In-Reply-To: <20090413104944.54d4669f@terra.solaris> References: <20090411211410.05b02d24@snowmobile> <20090412153126.643a4c28@terra.solaris> <20090412164355.36daa3b8@snowmobile> <20090413104944.54d4669f@terra.solaris> X-Mailer: Claws Mail 3.7.1 (GTK+ 2.14.7; x86_64-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Package Manager Specification discussions X-BeenThere: gentoo-pms@gentoo.org X-BeenThere: gentoo-pms@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/1/dZYRr1iX9egtCsjPxb3MT"; protocol="application/pgp-signature"; micalg=PGP-SHA1 X-Archives-Salt: 662641cd-2e7d-4134-afd4-aa43b7c2ef15 X-Archives-Hash: 64c3cabf8fb184166540c85f1ff2d37f --Sig_/1/dZYRr1iX9egtCsjPxb3MT Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable On Mon, 13 Apr 2009 10:49:44 +0200 Christian Faulhammer wrote: > Ciaran McCreesh : > > On Sun, 12 Apr 2009 15:31:26 +0200 > > Christian Faulhammer wrote: > > > The explanations of the slot operators are a bit hard to read, > > > maybe rephrasing (and splitting in more sentences) is the way to > > > go here. > > > > I suspect those're hard to read because people are expecting a > > user-centric description of what they're for, rather than a package > > manager centric description of how they behave. >=20 > But also package manager coders are humans (at least the last time I > checked), and apart from accuracy a technical documentation needs > readability in its own special way. I wrote enough "scientific" and > technical documents to be sure that small, easy to understand > sentences are better. Actually, looking at that... I don't really see anything off about it. Which bit specifically don't you like? --=20 Ciaran McCreesh --Sig_/1/dZYRr1iX9egtCsjPxb3MT Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAknjYV0ACgkQ96zL6DUtXhFhSQCghMV3LoEcKwvlOkNQn4jPpMyf P8IAnRquIJgo05vcSqYeCHQ2qhuFc+V/ =tehc -----END PGP SIGNATURE----- --Sig_/1/dZYRr1iX9egtCsjPxb3MT--