From owner-freebsd-ports@FreeBSD.ORG Mon May 12 18:39:31 2014 Return-Path: Delivered-To: freebsd-ports@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 0F582DB6 for ; Mon, 12 May 2014 18:39:31 +0000 (UTC) Received: from smtp.infracaninophile.co.uk (smtp6.infracaninophile.co.uk [IPv6:2001:8b0:151:1:3cd3:cd67:fafa:3d78]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "smtp.infracaninophile.co.uk", Issuer "ca.infracaninophile.co.uk" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id AA4472290 for ; Mon, 12 May 2014 18:39:30 +0000 (UTC) Received: from seedling.black-earth.co.uk (seedling.black-earth.co.uk [81.2.117.99]) (authenticated bits=0) by smtp.infracaninophile.co.uk (8.14.8/8.14.8) with ESMTP id s4CIdMEt074402 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO) for ; Mon, 12 May 2014 19:39:23 +0100 (BST) (envelope-from matthew@FreeBSD.org) Authentication-Results: lucid-nonsense.infracaninophile.co.uk; dmarc=none header.from=FreeBSD.org DKIM-Filter: OpenDKIM Filter v2.8.3 smtp.infracaninophile.co.uk s4CIdMEt074402 Authentication-Results: smtp.infracaninophile.co.uk/s4CIdMEt074402; dkim=none reason="no signature"; dkim-adsp=none Message-ID: <5371154F.2060600@FreeBSD.org> Date: Mon, 12 May 2014 19:39:11 +0100 From: Matthew Seaman User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:24.0) Gecko/20100101 Thunderbird/24.5.0 MIME-Version: 1.0 To: freebsd-ports@freebsd.org Subject: Re: make check-plist ok, but portlint complains: %%PORTDOCS%%@dirrm %%DOCSDIR%% missing References: <201405121736.s4CHaCPe087201@mech-cluster241.men.bris.ac.uk> In-Reply-To: <201405121736.s4CHaCPe087201@mech-cluster241.men.bris.ac.uk> X-Enigmail-Version: 1.6 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="sm17dbPCJmB1lJ7HJ3BRG1OQq6ivN025u" X-Virus-Scanned: clamav-milter 0.98.1 at lucid-nonsense.infracaninophile.co.uk X-Virus-Status: Clean X-Spam-Status: No, score=-3.3 required=5.0 tests=ALL_TRUSTED,AWL,BAYES_00 autolearn=ham autolearn_force=no version=3.4.0 X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on lucid-nonsense.infracaninophile.co.uk X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 May 2014 18:39:31 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --sm17dbPCJmB1lJ7HJ3BRG1OQq6ivN025u Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable On 12/05/2014 18:36, Anton Shterenlikht wrote: > I'm updating devel/robodoc to staging. > As suggested on the wiki page, > env DEVELOPER=3Dyes make stage && make check-plist && make package > runs fine, no issues. > However, portlint -A reports: >=20 > # portlint -A > WARN: /usr/ports/devel/robodoc/pkg-plist: Both ``%%PORTDOCS%%@dirrm %%D= OCSDIR%%'' and ``%%PORTDOCS%%@unexec %D/%%DOCSDIR%% 2>/dev/null || true''= are missing. At least one should be used. >=20 > I have in pkg-plist: >=20 > bin/robodoc > bin/robohdrs > man/man1/robodoc.1.gz > man/man1/robohdrs.1.gz > %%DOCSDIR%%/AUTHORS > %%DOCSDIR%%/ChangeLog > %%DOCSDIR%%/NEWS > %%DOCSDIR%%/README > %%DOCSDIR%%/manual.css > %%DOCSDIR%%/manual.html > %%DOCSDIR%%/robodoc_example.rc > %%EXAMPLESDIR%%/PerlExample/Source/Box.pm > %%EXAMPLESDIR%%/PerlExample/Source/Box/RectangularBox.pm > %%EXAMPLESDIR%%/PerlExample/Source/Box/SquareBox.pm > %%EXAMPLESDIR%%/PerlExample/Source/Cargo.txt > %%EXAMPLESDIR%%/PerlExample/Source/Loader.txt > %%EXAMPLESDIR%%/PerlExample/Source/SmartLoader.pm > %%EXAMPLESDIR%%/PerlExample/Source/TruckPacker.pl > %%EXAMPLESDIR%%/PerlExample/robodoc.rc > @dirrmtry %%DOCSDIR%% > @dirrmtry %%EXAMPLESDIR%%/PerlExample/Source/Box > @dirrmtry %%EXAMPLESDIR%%/PerlExample/Source > @dirrmtry %%EXAMPLESDIR%%/PerlExample > @dirrmtry %%EXAMPLESDIR%% >=20 > What's the problem? >=20 > As recommended on the wiki page I made > the docs and examples non-optional, because > they are very small. portlint results are guidelines: if there's a good reason to do things in a way that portlint complains about, then go right ahead. However, you may have to justify your choices and persuade a committer to commit as is. Given you're installing some docs and examples, I'd add support for making them optional, even if they are pretty neglible in size. It's probably better for your port to behave in-line with other ports even if not doing that is a reasonable choice. Enabling DOCS and EXAMPLES in your port is pretty simple. You need to add %%PORTDOCS%% and %%PORTEXAMPLES%% to the appropriate lines in pkg-plist and add OPTIONS_DEFINE+=3D DOCS EXAMPLES to the Makefile if you want them to show up in an options dialogue. Cheers, Matthew --=20 Dr Matthew J Seaman MA, D.Phil. PGP: http://www.infracaninophile.co.uk/pgpkey --sm17dbPCJmB1lJ7HJ3BRG1OQq6ivN025u Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.0.20 (Darwin) Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQJ8BAEBCgBmBQJTcRVZXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQ2NTNBNjhCOTEzQTRFNkNGM0UxRTEzMjZC QjIzQUY1MThFMUE0MDEzAAoJELsjr1GOGkATIUkQAIhY2sNfyIvfskMmG2IzqUAc DqWz/JDdVqwNw5QZI69KlGtUDX54vqcgNb7F5KNiDtXo1ZzpfIxqO6a1TRcxWfet y9FPLc7UyKCMGh04O+aMvS7/JTP1ZDm64KGX6fqq3DhkFFPHuCzJHZlMa1ReyW+o u2qlvEiz9C2kEq7S+zbkDwpwM4y/hXEYgpIxMfPt4QxaFdhWUfrOYnOThZWBcRN/ Sc+x/c06tCBYTUchqP3GzL2jJGbQuf3P36/TGy2qpMFpomFUpvnl+o2yPKDogt39 DoOC377dmS5HS7zyqZt6cwqDYl7SfTkqu8jo2tKUbRyvgCvvYG4O6STPXe9qikQi GMSmeYRB2ZFER56drOsVMjQEN5hRB9Saz3JCrAbCc4JuPnqzXSeu5D7HoJNfrRA9 dAIVBZEVi2WJ93V0Ro/0aLfZfQ8NBlS4uQ00bz5OJLDHfmTDdCFVKlKg9WNn878/ XqgEFdEM8TDua7PwBmpmHCXmDgFMqm6LmAxIV2nVU5CXTnhFtEnnXREl03LpRmWf HpQCOzU7knf2tDln7ciXl0eJ12qFtNsgJB1tbU6ZRYuT87mffxnVoDcUooX3JUls t3OHD35DL3lKsqfVbS9JKmIDv03RxFxKH6bM6jtAlWGRptYJDyVEjqHcuwhgGchj HaYgb2mo7ietRfjhAeRS =0cFi -----END PGP SIGNATURE----- --sm17dbPCJmB1lJ7HJ3BRG1OQq6ivN025u--