When deciding between PLIST_FILES or pkg-plist, portlint and the
handbook conflict. The handbook has the following note,

    Usage of PLIST_FILES should not be abused. When looking for the origin
    of a file, people usually try to grep through the pkg-plist files in
    the ports tree. Listing files in PLIST_FILES in the Makefile makes
    that search more difficult. [1]

On the other hand, portlint will give the following warning,

    WARN: category/portname/pkg-plist: There are only 1 items in the
    plist.  Consider using PLIST_FILES instead of pkg-plist when
    installing less than 6 items.

I know this is kind of trivial, but this is a somewhat common theme in
the documentation. How abusive is using PLIST_FILES? Does ports
prioritize pkg-plist greppers? If pkg-plist is the authority for
finding which port provides a file, then PLIST_FILES shouldn't be
provided as an option.

So, either the communication has to be fixed and using pkg-plist vs
PLIST_FILES is just a touchy feely kinda situation. Or there's a clear
authoritative way to collect this data. If it's the latter, it should
be enforced by the ports framework.

// Paco

[1] https://docs.freebsd.org/en/books/porters-handbook/book/#porting-pkg-plist

Attachment: publickey - me@pacopascal.com - 0xFC77B9BF.asc
Description: application/pgp-keys

Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to