From owner-svn-doc-projects@FreeBSD.ORG Fri Nov 16 01:53:05 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 8E5147E0; Fri, 16 Nov 2012 01:53:05 +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 694C98FC12; Fri, 16 Nov 2012 01:53:05 +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 qAG1r5fL095073; Fri, 16 Nov 2012 01:53:05 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qAG1r51n095072; Fri, 16 Nov 2012 01:53:05 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201211160153.qAG1r51n095072@svn.freebsd.org> From: Glen Barber Date: Fri, 16 Nov 2012 01:53:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r40024 - 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: Fri, 16 Nov 2012 01:53:05 -0000 Author: gjb Date: Fri Nov 16 01:53:04 2012 New Revision: 40024 URL: http://svnweb.freebsd.org/changeset/doc/40024 Log: Document pkg-set, and provide a few examples of setting package origins, taken from the pkg-set(8) manual page. 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 Fri Nov 16 00:54:03 2012 (r40023) +++ projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Fri Nov 16 01:53:04 2012 (r40024) @@ -976,6 +976,60 @@ Deinstalling ca_root_nss-3.13.5... done< &prompt.root; pkg clean + + + Modifying <application>pkgng</application> Package + Metadata + + Historically, software within the &os; Ports + Collection can undergo major version number changes. Unlike + pkg_install, + pkgng has a built-in command to + update package origins. For example, if lang/php5 was originally at + version 5.3, but has been renamed to + lang/php53 for the + inclusion of version 5.4, + pkg_install would require the use + of additional software such as ports-mgmt/portmaster to update + the package database, reflecting from which port the + installation originated. + + Unlike the ports-mgmt/portmaster and + ports-mgmt/portupgrade + ports, the order in which the new and old versions are + listed differ. For pkgng, the + syntax is pkg set -o + category/oldport:category/newport. + + For example, to change the package origin for the above + example, run: + + &prompt.root; pkg set -o lang/php5:lang/php53 + + As another example, to update lang/ruby18 to lang/ruby19, run: + + &prompt.root; pkg set -o lang/ruby18:lang/ruby19 + + As a final example, to change the origin of the + libglut shared libraries from graphics/libglut to <graphics/freeglut, run: + + &prompt.root; pkg set -o graphics/libglut:graphics/freeglut + + When changing package origins, in most cases it is + important to reinstall packages that are dependent on the + package that has had the origin changed. To force a + reinstallation of dependent packages, run: + + &prompt.root; pkg install -Rf category/freeglut + +