Date: Thu, 15 Nov 2012 16:04:14 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r40002 - projects/pkgng/en_US.ISO8859-1/books/handbook/ports Message-ID: <201211151604.qAFG4EN4013171@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Thu Nov 15 16:04:13 2012 New Revision: 40002 URL: http://svnweb.freebsd.org/changeset/doc/40002 Log: Document reading the pkg* manual pages. Add notes about pkg.conf(5). 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 15:19:51 2012 (r40001) +++ projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Nov 15 16:04:13 2012 (r40002) @@ -724,9 +724,43 @@ PKGSUFFIX= .txz</programlisting> <sect2 id="pkgng-basic-usage"> <title>Basic <application>pkgng</application> Operations</title> - <para><!-- pkg help --></para> + <para>Usage information for <application>pkgng</application> is + available in the &man.pkg.8; manual page, or by running + <command>pkg</command> without additional arguments.</para> + + <para>Each <application>pkgng</application> command argument is + documented in a command-specific manual page. To read the + manual page for <command>pkg install</command>, for example, + run either:</para> + + <screen>&prompt.root; <userinput>pkg help install</userinput></screen> + + <screen>&prompt.root; <userinput>man pkg-install</userinput></screen> + + <sect3 id="pkgng-pkg-conf"> + <title>Configuring the <application>pkgng</application> + Environment</title> + + <para>The <application>pkgng</application> package management + system uses a package repository for most operations. The + default package repository location is the + <envvar>PACKAGESITE</envvar> defined in + <filename>/usr/local/etc/pkg.conf</filename> unless + <envvar>PACKAGESITE</envvar> is defined in the local + environment.</para> - <sect3> + <note> + <para>If <envvar>PACKAGESITE</envvar> is defined in the + environment, the &man.pkg.conf.5; + <envvar>PACKAGESITE</envvar> will be ignored.</para> + </note> + + <para>Additional <application>pkgng</application> + configuration options are described in + &man.pkg.conf.5;.</para> + </sect3> + + <sect3 id="pkgng-installing-deinstalling"> <title>Installing and Removing Packages with <application>pkgng</application></title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211151604.qAFG4EN4013171>