pkgsrc targets

It was proposed that we document all pkgsrc targets, but this is unreasonable and useless. Most targets are ancilliary ones; they exist because that's how make(1) works. Only few of them are useful for regular work.

The following targets may be useful to invoke from keyboard:

Cleanup targets (in separate section because of importance):

The following targets are useful in development and thus may be useful for an advanced user:

For example, package updating looks like this:

su root -c "make depends clean-depends clean" # to catch new dependencies
rm -f distinfo && su root -c "make makesum clean" && make makepatchsum
make clean && make stage-install # build
# modify patches
make makepatchsum # and build again, or
make makepatchsum && make clean && make patch # until all patches apply, if they failed at first
make print-PLIST | diff -u PLIST -
# modify PLIST
make install-clean # to remove cached PLISTs and "installation done" marker
make stage-install
# modify PLIST again or build again
make test # just to check for regressions
su root -c "make package deinstall bin-install" # or
su root -c "make package replace"