some thoughts on port docs

[Walt Pawley]

On the page ...

<http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-distfiles.html>

... under the subheading ...

5.4.2 MASTER_SITES

... it says ...

These variables are defined in /usr/ports/Mk/bsd.sites.mk.
There are new entries added all the time, so make sure to check
the latest version of this file before submitting a port.

... which is just fine ... as far as it goes.

IMHO, telling people to be sure they check something without
telling them how, or at least linking to how, is poor form. I
understand that old hands don't need this but new hands do and
that's largely who good documentation is needed for.

On the page ...

<http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-depend.html>

... under the subheading ...

5.7.1 LIB_DEPENDS

... it says ...

Note: The lib part is a regular expression which is being
looked up in the ldconfig -r output. Values such as intl.[5-7]
and intl are allowed. The first pattern, intl.[5-7], will match
any of: intl.5, intl.6 or intl.7. The second pattern, intl,
will match any version of the intl library.

... which, I suspect, is correct enough, I guess, but isn't it
the case that a value for the lib part of intl.[5-7] would also
match things like intlX5 or intl/7?
-- 

Walter M. Pawley <walt at wump.org>
Wump Research & Company
676 River Bend Road, Roseburg, OR 97470
         541-672-8975