Date: Wed, 09 Jul 2014 08:36:30 -0700 From: Patrick Powell <papowell@astart.com> To: freebsd-doc@freebsd.org Subject: Handbook - mention portsnap in Section 5.3 - finding software, pkgng respository Message-ID: <53BD617E.1040700@astart.com>
next in thread | raw e-mail | index | archive | help
I notice that Section 5.3 - Finding Software describes how to search for software but there are a couple of steps left out that might confuse a newbie. I think you need to run 'portsnap fetch install' if you did not install the ports when you did the system installation. In any case, it is a good idea. You might want to put a forward reference to section 5.4 - Using pkgng. Also, on a FreeBSD 9.2 install, when you first enter 'pkg search subversion' you get the message to install pkgng. This works fine, you get pkgng version 1.2.7_3 installed. However, when you reenter the 'pkg search subversion' you get 'pkg: PACKAGESITE in pkg.conf is deprecated. Please create a repository configuration file.' I suggest that this error message be modified to be '"... Please use man pkg ...' I strongly suggest that the man page for pkgng have an example of a repository file and details of its location. Also, details of the contents of the respository file. I also extremely strongly suggest that Section 5.4 - using pkgng ... have an example and really really detailed instructions on how to install the repository file. I also suggest that since the installation of pgk has add/created the pkg.conf and pkg.conf.sample, you might as well create the /usr/local/etc/pkg/repos/FreeBSD.conf.example file as well, and point this out in the error message. I would suggest that this be done ASAP as without this information it is difficult for newbies to use/install/understand the pkgng system. Note: I think pkg is a GREAT improvement over the old pkg_add, but the legacy documentation in the FreeBSD handbook needs to be updated. If somebody sends me either a set of files for Handbook Section 5.2, 5.3, 5.4 or idiot level instructions on how to access the files (SVN, etc.) I will edit them and submit them for comment. I can put the content in the files, but some expert may need to massage the formatting a bit.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?53BD617E.1040700>