From owner-svn-ports-all@FreeBSD.ORG Tue Jan 28 09:29:18 2014 Return-Path: Delivered-To: svn-ports-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 07EFC5FA; Tue, 28 Jan 2014 09:29:18 +0000 (UTC) Received: from forward6l.mail.yandex.net (forward6l.mail.yandex.net [IPv6:2a02:6b8:0:1819::6]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id B19E51956; Tue, 28 Jan 2014 09:29:17 +0000 (UTC) Received: from smtp3h.mail.yandex.net (smtp3h.mail.yandex.net [84.201.186.20]) by forward6l.mail.yandex.net (Yandex) with ESMTP id A342014E10D4; Tue, 28 Jan 2014 13:29:13 +0400 (MSK) Received: from smtp3h.mail.yandex.net (localhost [127.0.0.1]) by smtp3h.mail.yandex.net (Yandex) with ESMTP id E1D6D1B42A75; Tue, 28 Jan 2014 13:29:12 +0400 (MSK) Received: from unknown (unknown [77.66.224.37]) by smtp3h.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id PQUMoJVNXv-TCfWUoPi; Tue, 28 Jan 2014 13:29:12 +0400 (using TLSv1 with cipher CAMELLIA256-SHA (256/256 bits)) (Client certificate not present) X-Yandex-Uniq: 57034b57-73f1-4b00-897d-e453a4f405bd DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex.ru; s=mail; t=1390901352; bh=mh7DSjcjJrAcHuUABNv7HlMXuMnao+pGn9HEApr3aeU=; h=Message-ID:Date:From:User-Agent:MIME-Version:To:CC:Subject: References:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=cbx5IsKBmF4y76OmqJ/AwGlCUheDgu1R5oDb8yNA/Wwu2yNl7cYjV1/+6GcevgEbJ TliGF1XCSc6jDFyx/g2g8Ey56N48lW5CDm7zi7Xyhb079G4h9yXOAUJM2seOa+/dvy SgmL4hApAwdklujxwccGSM6AyzSXWVkVRdfx255g= Authentication-Results: smtp3h.mail.yandex.net; dkim=pass header.i=@yandex.ru Message-ID: <52E7785A.1070804@yandex.ru> Date: Tue, 28 Jan 2014 13:28:58 +0400 From: Ruslan Makhmatkhanov User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: Alexey Dokuchaev , koobs@FreeBSD.org Subject: Re: svn commit: r341401 - head/www/py-requests1 References: <201401271318.s0RDInCu014881@svn.freebsd.org> <20140127140508.GA68244@FreeBSD.org> <52E66ABB.5000002@FreeBSD.org> <20140127143457.GB71123@FreeBSD.org> In-Reply-To: <20140127143457.GB71123@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org X-BeenThere: svn-ports-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the ports tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 28 Jan 2014 09:29:18 -0000 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