Sync pkg.conf.5 with the list of config variables in pkg_config.c

Sort into alphabetical order.

Fix some of the descriptive text in pkg_config.c

Fixes: #756
Merge branch 'master' of github.com:freebsd/pkg