From owner-freebsd-doc@FreeBSD.ORG Wed Jul 9 15:36:39 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 34F584BF for ; Wed, 9 Jul 2014 15:36:39 +0000 (UTC) Received: from astart2.astart.com (108-248-95-193.lightspeed.sndgca.sbcglobal.net [108.248.95.193]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 0C8862B5A for ; Wed, 9 Jul 2014 15:36:38 +0000 (UTC) Received: from laptop_84.private (localhost [127.0.0.1]) by astart2.astart.com (8.14.4/8.14.4) with ESMTP id s69FaVjK080741 for ; Wed, 9 Jul 2014 08:36:31 -0700 (PDT) (envelope-from papowell@astart.com) Message-ID: <53BD617E.1040700@astart.com> Date: Wed, 09 Jul 2014 08:36:30 -0700 From: Patrick Powell Reply-To: papowell@astart.com Organization: Astart Technologies User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:17.0) Gecko/20130714 Thunderbird/17.0.7 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Handbook - mention portsnap in Section 5.3 - finding software, pkgng respository Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Jul 2014 15:36:39 -0000 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.