pkg/52708: pkgsrc/doc/pkgsrc.txt: paragraph about *not* generating pkgs for deps is misleading

[bapabooiee%gmail.com@localhost]

>Number:         52708
>Category:       pkg
>Synopsis:       pkgsrc/doc/pkgsrc.txt: paragraph about *not* generating pkgs for deps is misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Nov 08 23:40:00 +0000 2017
>Originator:     Dean Matzkov
>Release:        HEAD
>Organization:
>Environment:
NetBSD localhost 7.1 NetBSD 7.1 (GENERIC.201703111743Z) amd64
>Description:
The paragraph in question can be found at<https://github.com/NetBSD/pkgsrc/blob/b0108ef500d76d0e86d41f2a4c72c1bed6e716ae/doc/pkgsrc.txt#L1431>, and reads as follows:

-----SNIP-----
  * DEPENDS_TARGET: By default, dependencies are only installed, and no binary
    package is created for them. You can set this variable to package-install
    to automatically create binary packages after installing dependencies.
    Please note that the PKGSRC_KEEP_BIN_PKGS can be set to yes to preserve
    binary packages when using the install as well.
-----/SNIP-----

Based on my experience of using pkgsrc (with mk.confs that shouldn't mess with the above) on multiple platforms, pkgsrc seems to *always* put freshly-build packages into $PACKAGES, whether they're explicitly-installed or pulled-in as dependencies. So, the paragraph should be adjusted to reflect that.

And in pkgsrc/mk/default/mk.conf, there's also ``PKGSRC_KEEP_BIN_PKGS?=  yes''.
>How-To-Repeat:
``make install'' any random package in pkgsrc HEAD with an unmodified mk.conf, and check $PACKAGES for any packages that were installed as dependencies.
>Fix:
Show the keyboard who's boss.