From owner-svn-doc-projects@FreeBSD.ORG Thu Nov 15 14:40:22 2012 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 28A7AC16; Thu, 15 Nov 2012 14:40:22 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 10B178FC0C; Thu, 15 Nov 2012 14:40:22 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id qAFEeLEH099715; Thu, 15 Nov 2012 14:40:21 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qAFEeLYN099713; Thu, 15 Nov 2012 14:40:21 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201211151440.qAFEeLYN099713@svn.freebsd.org> From: Glen Barber Date: Thu, 15 Nov 2012 14:40:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r40000 - projects/pkgng/en_US.ISO8859-1/books/handbook/ports X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Nov 2012 14:40:22 -0000 Author: gjb Date: Thu Nov 15 14:40:21 2012 New Revision: 40000 URL: http://svnweb.freebsd.org/changeset/doc/40000 Log: Document the following procedures for pkgng: - Bootstrapping and installation from ports/packages - Converting the package database to pkgng format with pkg2ng - Setting WITH_PKGNG and PKGSUFFIX in make.conf Modified: projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Nov 15 13:38:34 2012 (r39999) +++ projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Nov 15 14:40:21 2012 (r40000) @@ -658,12 +658,67 @@ docbook = Getting Started with <application>pkgng</application> - + &os; 9.1 and later includes a "bootstrap" + utility for pkgng. The bootstrap + utility will download and install + pkgng. + + To bootstrap the system, run: + + &prompt.root; /usr/sbin/pkg + + For earlier &os; versions, + pkgng must be installed from the + Ports Collection, or as a binary package. + + To install the pkgng port, + run: + + &prompt.root; cd /usr/ports/ports-mgmt/pkg +&prompt.root; make +&prompt.root; make install clean + + To install the binary package, run: + + &prompt.root; pkg_add -r pkg + + + The pkgng package management + utility is not supported on + &os; 7.X or early + &os; 8.X versions. + + + Existing &os; installations require conversion of the + pkg_install package database to the + new format. To convert the package database, run: + + &prompt.root; pkg2ng + + This step is not required for new installations that do + not have third-party software installed. + + + The package database conversion may emit errors as the + contents are converted to the new version. Generally, these + errors can be safely ignored, however a list of third-party + software that was not successfully converted will be listed + after pkg2ng has finished. These must be + fixed by hand. + + + To ensure the &os; Ports Collection registers new + software with pkgng, and not + pkg_install, add the following + lines to /etc/make.conf: + + WITH_PKGNG= yes +PKGSUFFIX= .txz + + + This step is not required on + &os; 10.X. +