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-...

[Roman Bogorodskiy]

  Mathieu Arnold wrote:

> Le 18/12/2016 à 12:36, Roman Bogorodskiy a écrit :
> > +COMMENT=	Xstatic-angular-bootstrap
> >
> > Added: head/devel/py-XStatic-Angular-Bootstrap/pkg-descr
> > ==============================================================================
> > --- /dev/null	00:00:00 1970	(empty, because file is newly added)
> > +++ head/devel/py-XStatic-Angular-Bootstrap/pkg-descr	Sun Dec 18 11:36:26 2016	(r428845)
> > @@ -0,0 +1,3 @@
> > +XStatic-Angular-Bootstrap
> > +
> > +WWW: http://pypi.python.org/pypi/XStatic-Angular-Bootstrap
> 
> > +COMMENT=	Angular-fileupload 12.0.4 (xstatic packaging standard)
> >
> > Added: head/devel/py-XStatic-Angular-FileUpload/pkg-descr
> > ==============================================================================
> > --- /dev/null	00:00:00 1970	(empty, because file is newly added)
> > +++ head/devel/py-XStatic-Angular-FileUpload/pkg-descr	Sun Dec 18 11:36:26 2016	(r428845)
> > @@ -0,0 +1,3 @@
> > +Angular-FileUpload 12.0.4 (XStatic packaging standard)
> > +
> > +WWW: http://pypi.python.org/pypi/XStatic-Angular-FileUpload
> 
> ...
> 
> I understand those were mechanically created, but all the COMMENT[1] and
> pkg-descr[2] files fall very short of our requirements.
> 
> 1:
> https://www.freebsd.org/doc/en/books/porters-handbook/makefile-comment.html
> 
> 2: https://www.freebsd.org/doc/en/books/porters-handbook/porting-desc.html

This is generally an information obtained from the corresponding Python
packages. E.g. for XStatic-Angular-FileUpload we only have:

Comment = Angular-FileUpload 12.0.4 (XStatic packaging standard)
Description:

---
Angular-FileUpload JavaScript library packaged for setuptools (easy_install) / pip.

This package is intended to be used by **any** project that needs these files.

It intentionally does **not** provide any extra code except some metadata
**nor** has any extra requirements. You MAY use some minimal support code from
the XStatic base package, if you like.

You can find more info about the xstatic packaging way in the package `XStatic`.
---

We probably can add README contents to pkg-descr (I'm not sure it brings
a lot of value though, it looks likes it's more or less common for these
packages with only package name changed), but I'm not sure how can we
improve COMMENT.

Roman Bogorodskiy
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 455 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/svn-ports-head/attachments/20161218/ad1cec43/attachment.sig>