From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Darrington Subject: Re: [PATCH] gnu: Add bedtools Date: Tue, 16 Dec 2014 11:15:45 +0100 Message-ID: <20141216101545.GA4824@intra> References: <20141215155541.GA19757@jocasta.intra> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="BOKacYhQ+x31HxR3" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42870) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y0pAk-0004Gx-PS for guix-devel@gnu.org; Tue, 16 Dec 2014 05:16:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y0pAf-0002t9-SY for guix-devel@gnu.org; Tue, 16 Dec 2014 05:16:06 -0500 Received: from de.cellform.com ([88.217.224.109]:49839 helo=jocasta.intra) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y0pAe-0002rb-TI for guix-devel@gnu.org; Tue, 16 Dec 2014 05:16:01 -0500 Content-Disposition: inline In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Ricardo Wurmus Cc: guix-devel@gnu.org --BOKacYhQ+x31HxR3 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Dec 16, 2014 at 11:06:15AM +0100, Ricardo Wurmus wrote: =20 John Darrington writes: =20 > I suggest that in the description and particularly in the synopsis f= ields you > avoid persiflage like "swiss-army knife". It doesn't add any inform= ation, and > only goes to increase the noise. > > (The same goes for phrases such as "high quality", "powerful" and "s= tate of the art"). > > J' > > On Thu, Dec 11, 2014 at 05:37:16PM +0100, Ricardo Wurmus wrote: > * gnu/packages/bioinformatics.scm (bedtools): New variable. > > + (synopsis "Swiss army knife for genome arithmetic") > + (description > + "Collectively, the bedtools utilities are a swiss-army kn= ife of tools for > +a wide-range of genomics analysis tasks. The most widely-used= tools enable > +genome arithmetic: that is, set theory on the genome. For exa= mple, bedtools > +allows one to intersect, merge, count, complement, and shuffle= genomic > +intervals from multiple files in widely-used genomic file form= ats such as BAM, > +BED, GFF/GTF, VCF.") =20 I do agree. I sheepishly copied the synopsis and description from the project website and I wasn't quite satisfied either. Do you have a suggestion? "Tools for performing genome arithmetic", maybe? =20 Without knowing the package I cannot say. But I presume that "Swiss Army K= nife" is supposed to imply that there are various tools of differing purposes. So perhaps "Miscellaneous tools for performing genome arithmetic"? On the= =20 other hand, unless there is some other package which contains some speciali= sed tools for one special branch of genome arithmetic, then the word "miscellaneous" is redun= dant and simply "Tools for performing genome arithmetic" like you suggested would be best= =2E It is short and=20 to the point as the synopsis should be. J' --=20 PGP Public key ID: 1024D/2DE827B3=20 fingerprint =3D 8797 A26D 0854 2EAB 0285 A290 8A67 719C 2DE8 27B3 See http://sks-keyservers.net or any PGP keyserver for public key. --BOKacYhQ+x31HxR3 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlSQBlAACgkQimdxnC3oJ7NsdwCeJEe03hSLZAOM7O5Tzvo8SNT0 2/AAnA5ptboZ1zosqOpGmK2dRGYnfAMj =Z7Ir -----END PGP SIGNATURE----- --BOKacYhQ+x31HxR3--