From owner-svn-ports-all@freebsd.org Sun Dec 18 14:51:10 2016 Return-Path: Delivered-To: svn-ports-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2292EC87857; Sun, 18 Dec 2016 14:51:10 +0000 (UTC) (envelope-from alexander.nusov@nfvexpress.com) Received: from sender163-mail.zoho.com (sender163-mail.zoho.com [74.201.84.163]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 0EBB7A41; Sun, 18 Dec 2016 14:51:10 +0000 (UTC) (envelope-from alexander.nusov@nfvexpress.com) Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1482072663692320.4672640220516; Sun, 18 Dec 2016 06:51:03 -0800 (PST) Date: Sun, 18 Dec 2016 17:51:03 +0300 From: Alexander Nusov To: "Mathieu Arnold" Cc: "Roman Bogorodskiy" , "Roman Bogorodskiy" , "" , "" , "" Message-Id: <159126a267f.e5a6cf2011970.2285015541543481905@nfvexpress.com> In-Reply-To: References: <201612181136.uBIBaQLG037821@repo.freebsd.org> <56123f95-c5dc-1e3a-3db5-d87043949c45@FreeBSD.org> <20161218135215.GA48900@kloomba> Subject: Re: svn commit: r428845 - in head/devel: . py-XStatic py-XStatic-Angular py-XStatic-Angular-Bootstrap py-XStatic-Angular-FileUpload py-XStatic-Angular-Gettext py-XStatic-Angular-Schema-Form py-XStatic-... MIME-Version: 1.0 X-Priority: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.23 X-BeenThere: svn-ports-all@freebsd.org X-Mailman-Version: 2.1.23 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: Sun, 18 Dec 2016 14:51:10 -0000 Hello, I agree that adding README content will not bring a lot of value but I'm go= ing to make them more meaningful.=20 XStatic-Angular-Bootstrap 2.2.0.0 current COMMENT:=20 Angular-Bootstrap 2.2.0 (XStatic packaging standard) proposed COMMENT: XStatic package for angular-bootstrap 2.2.0 module However I don't understand what do you mean for "Do not include the package= name or version number of software." in this case, You may notice that versioning for xstatic modules is a bit different XStatic-Angular-Cookies 1.2.1.1 module bundles angular-cookies module (from= npmjs.org) version 1.2.1. The last part (.1) is the xstatic thing. What about: XStatic package for AngularJS module for cookies? But in frontend world for one task you may find a dozen of different module= s. angular-cookies angular-cookie ng-cookie ng2-cookie If we drop the javascript (npm) module name in COMMENT it would not be clea= r what npm module the port provides. -- thanks, alex ---- On Sun, 18 Dec 2016 17:26:28 +0300 Mathieu Arnold <mat@FreeBSD.org&= gt; wrote ---- Le 18/12/2016 =C3=A0 14:52, Roman Bogorodskiy a =C3=A9crit :=20 > Mathieu Arnold wrote:=20 >=20 >> Le 18/12/2016 =C3=A0 12:36, Roman Bogorodskiy a =C3=A9crit :=20 >>> +COMMENT=3D Xstatic-angular-bootstrap=20 >>>=20 >>> Added: head/devel/py-XStatic-Angular-Bootstrap/pkg-descr=20 >>> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=20 >>> --- /dev/null 00:00:00 1970 (empty, because file is newl= y added)=20 >>> +++ head/devel/py-XStatic-Angular-Bootstrap/pkg-descr Sun D= ec 18 11:36:26 2016 (r428845)=20 >>> @@ -0,0 +1,3 @@=20 >>> +XStatic-Angular-Bootstrap=20 >>> +=20 >>> +WWW: http://pypi.python.org/pypi/XStatic-Angular-Bootstrap=20 >>> +COMMENT=3D Angular-fileupload 12.0.4 (xstatic packaging st= andard)=20 >>>=20 >>> Added: head/devel/py-XStatic-Angular-FileUpload/pkg-descr=20 >>> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=20 >>> --- /dev/null 00:00:00 1970 (empty, because file is newl= y added)=20 >>> +++ head/devel/py-XStatic-Angular-FileUpload/pkg-descr Sun = Dec 18 11:36:26 2016 (r428845)=20 >>> @@ -0,0 +1,3 @@=20 >>> +Angular-FileUpload 12.0.4 (XStatic packaging standard)=20 >>> +=20 >>> +WWW: http://pypi.python.org/pypi/XStatic-Angular-FileUpload= =20 >> ...=20 >>=20 >> I understand those were mechanically created, but all the COMMENT[= 1] and=20 >> pkg-descr[2] files fall very short of our requirements.=20 >>=20 >> 1:=20 >> https://www.freebsd.org/doc/en/books/porters-handbook/makefile-com= ment.html=20 >>=20 >> 2: https://www.freebsd.org/doc/en/books/porters-handbook/porting-d= esc.html=20 > This is generally an information obtained from the corresponding Pytho= n=20 > packages. E.g. for XStatic-Angular-FileUpload we only have:=20 =20 Let me quote one of the rules for COMMENT:=20 =20 2) Do not include the package name or version number of software.=20 =20 The fact that python does not enforce rules on their packages does not=20 mean we do not.=20 =20 > We probably can add README contents to pkg-descr (I'm not sure it brin= gs=20 > a lot of value though, it looks likes it's more or less common for the= se=20 > packages with only package name changed), but I'm not sure how can we= =20 > improve COMMENT.=20 =20 Please read the handbook links I gave you. COMMENT is a short, one line,=20 description of the software. pkg-descr is a longer description, it=20 should tell me what does, what it is, why it is usefull.=20 Especially, I should not have to go to the web site to understand those=20 things.=20 =20 =20 --=20 Mathieu Arnold=20 =20 =20