From owner-svn-ports-all@FreeBSD.ORG Mon Jan 27 14:18:57 2014 Return-Path: Delivered-To: svn-ports-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A5AC41BE; Mon, 27 Jan 2014 14:18:57 +0000 (UTC) Received: from mail-pb0-x236.google.com (mail-pb0-x236.google.com [IPv6:2607:f8b0:400e:c01::236]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 65E071D9D; Mon, 27 Jan 2014 14:18:57 +0000 (UTC) Received: by mail-pb0-f54.google.com with SMTP id uo5so5946195pbc.13 for ; Mon, 27 Jan 2014 06:18:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:reply-to:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=DQJeYSMEHugZcHrgu9zdFdf6USBT3ZQLS14MFKbjsMU=; b=ujylDoWDrgEqFFjbeC4oOypg2lAUQhp7VZ0iEDQclfNTv/xH0oXT+JG1Wajso4vFzH OBZVuyR8S/chyJIOTJgrMpskIhW5eB2VaN+oRL2SXEFpybFFoBTlHb3+wXFjDI1ry/fd JSf9pCqLP6iV7LjRBL7UMzdULdG9KPSWym+2cXk5FGEiarh3TZ2/q3gME+/WNwEHT6f7 uSW8zclxMHbjIBgvLUK5GSvpETqQ3M+Vdy7QauLDt6k6kNUS4gFdqgvFFX/0a3wc/JjO 1fgExszBPFdZ5Qr3OMEwbkgnBoEggKH5j344AI1Un+O456PEfR5BQCvUVScMBB4eX/wB yt+g== X-Received: by 10.66.162.74 with SMTP id xy10mr30594762pab.4.1390832336824; Mon, 27 Jan 2014 06:18:56 -0800 (PST) Received: from [192.168.1.7] (ppp59-167-128-11.static.internode.on.net. [59.167.128.11]) by mx.google.com with ESMTPSA id y9sm86162707pas.10.2014.01.27.06.18.53 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 27 Jan 2014 06:18:56 -0800 (PST) Message-ID: <52E66ABB.5000002@FreeBSD.org> Date: Tue, 28 Jan 2014 01:18:35 +1100 From: Kubilay Kocak User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:27.0) Gecko/20100101 Thunderbird/27.0 MIME-Version: 1.0 To: Alexey Dokuchaev Subject: Re: svn commit: r341401 - head/www/py-requests1 References: <201401271318.s0RDInCu014881@svn.freebsd.org> <20140127140508.GA68244@FreeBSD.org> In-Reply-To: <20140127140508.GA68244@FreeBSD.org> X-Enigmail-Version: 1.6 Content-Type: text/plain; charset=ISO-8859-1 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 Reply-To: koobs@FreeBSD.org List-Id: SVN commit messages for the ports tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 27 Jan 2014 14:18:57 -0000 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