Date: Tue, 28 Jan 2014 01:18:35 +1100 From: Kubilay Kocak <koobs.freebsd@gmail.com> To: Alexey Dokuchaev <danfe@FreeBSD.org> Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org Subject: Re: svn commit: r341401 - head/www/py-requests1 Message-ID: <52E66ABB.5000002@FreeBSD.org> In-Reply-To: <20140127140508.GA68244@FreeBSD.org> References: <201401271318.s0RDInCu014881@svn.freebsd.org> <20140127140508.GA68244@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 28/01/2014 1:05 AM, Alexey Dokuchaev wrote: > On Mon, Jan 27, 2014 at 01:18:49PM +0000, Kubilay Kocak wrote: >> New Revision: 341401 >> URL: http://svnweb.freebsd.org/changeset/ports/341401 >> QAT: https://qat.redports.org/buildarchive/r341401/ >> >> COMMENT= HTTP library written in Python for human beings (Version 1.x) > > Seriously? Can this COMMENT tell anyone what this port really provides? > > ./danfe > By default, most Python maintainers use the short description found in either the modules setup.py metadata, or the short tag/summary from the projects site verbatim, unless there is good reason to do so. In this case: http://docs.python-requests.org/en/latest/ Additionally, this was a copy of www/requests that has the same COMMENT (with the appropriate version tweak) Not withstanding, the COMMENT does accurately reflect what the port provides, both functionally and from the standpoint of providing key information for a FreeBSD user to make a well informed choice to install it, though I do understand why that might not be immediately obvious. For what it's worth, "for human beings" is almost a convention in Python land for modules with 'beautiful developer API\'s' But seriously, the "seriously" wasn't necessary :) -- koobs
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52E66ABB.5000002>