Bug 243979

Summary: Porter's Handbook: 3.5. Checking the Port with portlint - Lacks appropriate options
Product: Documentation Reporter: Vincent DEFERT <20.100>
Component: DocumentationAssignee: freebsd-doc (Nobody) <doc>
Status: New ---    
Severity: Affects Only Me CC: linimon, marcus
Priority: --- Keywords: needs-qa
Version: LatestFlags: koobs: maintainer-feedback? (marcus)
Hardware: Any   
OS: Any   

Description Vincent DEFERT 2020-02-08 11:17:57 UTC
The documentation recommends to use portlint to check conformance with guidelines.

However, when reading portlint's man page, it seems "portlint <directory>" is enough, but when submitting the new port, you get an error report from which you realize you should have used portlint -C instead (and possibly also -A).

The porter's handbook should mention the options to use with portlint to perform the same level of verification as when the new port will be submitted.
Comment 1 Joe Marcus Clarke freebsd_committer 2020-02-09 21:11:08 UTC
I would add documentation that states committers should use -C prior to committing a port.  When building a new port, use -N (and maybe -C as well) to check it.