2016-08-28

Ports have options with short names, like TOOLS or DOCS.

Sometimes the descriptions for these options are not useful to the
person installing the port.  That person needs to know what the option
does before enabling or disabling it, and describing an option called
TOOLS with "Enables TOOLS support" is not useful.

This proof-of-concept Perl program checks port option descriptions to
see if they actually describe the option.  Rather than parse the
Makefile, it runs make(1) to get the variable values.  As such, a pass
over the full ports tree takes a while.  Checking an individual port is
not bad, and even a whole category is not terrible.  Having this program
parse the Makefiles would be much quicker, and probably not too
difficult.

Presently, this does not have any complex or smart tests, but still
finds a lot of not-very-useful redundant descriptions.

optcheck is the program, optcheck-output.txt is a full pass over the
current ports tree.