svn commit: r341401 - head/www/py-requests1
Ruslan Makhmatkhanov
cvs-src at yandex.ru
Tue Jan 28 09:29:18 UTC 2014
Alexey Dokuchaev wrote on 27.01.2014 18:34:
> On Tue, Jan 28, 2014 at 01:18:35AM +1100, Kubilay Kocak wrote:
>> 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/ [...]
>>
>> For what it's worth, "for human beings" is almost a convention in Python
>> land for modules with 'beautiful developer API\'s'
>
> Right, in Python land it is. However, as a generic packager (that is,
> FreeBSD Project) we should provide package descriptions (that includes
> both COMMENT and pkg-descr) that can be comprehended by anyone, not just
> someone necessarily coming from the Python land.
>
> In this particular case, more neutral COMMENT, like "convenient (or easy
> to use) HTTP module/functions bundle" would IMHO be better.
>
> This is just my nit picking of course; no need to take any immediate
> action(s).
>
> ./danfe
It's doubtful that Joe Average occasionally getting this port as
dependency will ever care about what it does. While to "someone coming
from the Python land" the meaning of it would be quite obvious.
--
Regards,
Ruslan
T.O.S. Of Reality
More information about the svn-ports-all
mailing list