From owner-svn-doc-projects@FreeBSD.ORG Thu Nov 15 18:19:33 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 15D80760; Thu, 15 Nov 2012 18:19:33 +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 D66558FC12; Thu, 15 Nov 2012 18:19:32 +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 qAFIJWIf035161; Thu, 15 Nov 2012 18:19:32 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qAFIJWeI035160; Thu, 15 Nov 2012 18:19:32 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201211151819.qAFIJWeI035160@svn.freebsd.org> From: Glen Barber Date: Thu, 15 Nov 2012 18:19:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r40004 - 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 18:19:33 -0000 Author: gjb Date: Thu Nov 15 18:19:32 2012 New Revision: 40004 URL: http://svnweb.freebsd.org/changeset/doc/40004 Log: Document 'pkg install'. 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 18:19:30 2012 (r40003) +++ projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Nov 15 18:19:32 2012 (r40004) @@ -784,7 +784,48 @@ pkg-1.0.2 New generation package manag Installing and Removing Packages with <application>pkgng</application> - + In general, most &os; users will install binary packages + by running pkg install + packagename. + pkg install uses repository data, as + mentioned in . Conversely, + pkg add does not use repository data, nor + does it use the defined PACKAGESITE, so + dependencies may not be properly tracked, and missing + dependencies will not be fetched from a remote + source. + + Additional binary packages can be installed with + pkg install.  For example, to install + curl: + + &prompt.root; pkg install curl +Updating repository catalogue +Repository catalogue is up-to-date, no need to fetch fresh copy +The following packages will be installed: + + Installing ca_root_nss: 3.13.5 + Installing curl: 7.24.0 + +The installation will require 4 MB more space + +1 MB to be downloaded + +Proceed with installing packages [y/N]: y +ca_root_nss-3.13.5.txz    100%  255KB 255.1KB/s 255.1KB/s   00:00 +curl-7.24.0.txz    100% 1108KB   1.1MB/s   1.1MB/s   00:00 +Checking integrity... done +Installing ca_root_nss-3.13.5... done +Installing curl-7.24.0... done + + The new package and any additional packages that were + installed as dependencies can be seen in the installed + packages list: + + &prompt.root; pkg info +ca_root_nss-3.13.5 The root certificate bundle from the Mozilla Project +curl-7.24.0 Non-interactive tool to get files from FTP, GOPHER, HTTP(S) servers +pkg-1.0.2 New generation package manager