svn commit: r45559 - head/en_US.ISO8859-1/books/handbook/ports
Allan Jude <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
Author: allanjude
Date: Sat Sep 6 20:10:17 2014
New Revision: 45559
URL: http://svnweb.freebsd.org/changeset/doc/45559
Log:
Replace all occurances of 'pkgng' with 'pkg' in the handbook
Kept existing xml:id's to avoid breaking external links to the documentation
Sanitized the documentation of references to pkg_add
Fix an incorrect variable name: daily_backup_pkgng_enable should be daily_backup_pkgdb_enable
Fix a linebreak in the middle of a variable name
Clarify that pkg2ng is not a required step on newer systems
Approved by: bcr
Sponsored by: ScaleEngine Inc.
Modified:
head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat Sep 6 19:56:45 2014 (r45558)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat Sep 6 20:10:17 2014 (r45559)
@@ -37,7 +37,7 @@
<listitem>
<para>How to manage binary packages using
- <application>pkgng</application>.</para>
+ <application>pkg</application>.</para>
</listitem>
<listitem>
@@ -102,7 +102,7 @@
<para>A &os; package contains pre-compiled copies of all the
commands for an application, as well as any configuration files
and documentation. A package can be manipulated with the
- <application>pkgng</application> commands, such as
+ <application>pkg</application> commands, such as
<command>pkg install</command>.</para>
<para>A &os; port is a collection of files designed to automate
@@ -407,11 +407,11 @@ Info: Lists information about open fil
<para>At the present time, &os; is transitioning toward a new
method of package management. Users
may wish to investigate the benefits of using
- <link linkend="pkgng-intro">PKGng</link> to manage third-party
+ <link linkend="pkgng-intro">pkg</link> to manage third-party
software on &os;. This section describes the traditional method
for managing binary packages and only applies to those users
who have not yet migrated to the
- <application>pkgng</application> format.</para>
+ <application>pkg</application> format.</para>
<para>This method of package management uses a package database
directory, <filename>/var/db/pkg</filename>,
@@ -619,30 +619,30 @@ docbook =
-->
<sect1 xml:id="pkgng-intro">
- <title>Using <application>pkgng</application> for Binary Package
+ <title>Using <application>pkg</application> for Binary Package
Management</title>
- <para><application>pkgng</application> is the next generation
+ <para><application>pkg</application> is the next generation
replacement for the traditional &os; package management tools,
offering many features that make dealing with binary packages
faster and easier.</para>
- <para><application>pkgng</application> is not a replacement for
+ <para><application>pkg</application> is not a replacement for
port management tools like
<package>ports-mgmt/portmaster</package> or
<package>ports-mgmt/portupgrade</package>. These tools can be
used to install third-party software from both binary packages
and the Ports Collection, while
- <application>pkgng</application> installs only binary
+ <application>pkg</application> installs only binary
packages.</para>
<sect2 xml:id="pkgng-initial-setup">
<title>Getting Started with
- <application>pkgng</application></title>
+ <application>pkg</application></title>
<para>&os; 8.4 and later includes a bootstrap utility
which can be used to download and install
- <application>pkgng</application>, along with its manual
+ <application>pkg</application>, along with its manual
pages.</para>
<para>To bootstrap the system, run:</para>
@@ -650,7 +650,7 @@ docbook =
<screen>&prompt.root; <userinput>/usr/sbin/pkg</userinput></screen>
<para>For earlier &os; versions,
- <application>pkgng</application> must instead be installed
+ <application>pkg</application> must instead be installed
from the Ports Collection or as a binary package.</para>
<para>To install the port, run:</para>
@@ -659,24 +659,25 @@ docbook =
&prompt.root; <userinput>make</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
- <para>To install the binary package, run:</para>
-
- <screen>&prompt.root; <userinput>pkg_add -r pkg</userinput></screen>
-
- <para>Once <application>pkgng</application> is installed, the
+ <para>When upgrading an existing system that originally used the
+ older package system, the database must be converted to the
+ new format, so that the new tools are aware of the already
+ installed packages. Once <application>pkg</application> has
+ been installed, the
package database must be converted from the traditional format
to the new format by running this command:</para>
<screen>&prompt.root; <userinput>pkg2ng</userinput></screen>
- <para>This step is not required for new installations that do
- not yet have any third-party software installed.</para>
+ <note><para>This step is not required for new installations that
+ do not yet have any third-party software
+ installed.</para></note>
<important>
<para>This step is not reversible. Once the package database
- has been converted to the <application>pkgng</application>
+ has been converted to the <application>pkg</application>
format, the traditional <literal>pkg_*</literal> tools
- should not be used.</para>
+ should no longer be used.</para>
</important>
<note>
@@ -689,28 +690,28 @@ docbook =
</note>
<para>To ensure that the &os; Ports Collection registers
- new software with <application>pkgng</application>, and not
+ new software with <application>pkg</application>, and not
the traditional packages format, &os; versions earlier than
10.<replaceable>X</replaceable> require this line in
<filename>/etc/make.conf</filename>:</para>
<programlisting>WITH_PKGNG= yes</programlisting>
- <para>The <application>pkgng</application> package management
+ <para>The <application>pkg</application> package management
system uses a package repository for most operations. The
default package repository location is defined in
<filename>/usr/local/etc/pkg.conf</filename> or by the
<envar>PACKAGESITE</envar> environment variable, which
overrides the configuration file.</para>
- <para>Additional <application>pkgng</application>
+ <para>Additional <application>pkg</application>
configuration options are described in pkg.conf(5).</para>
- <para>Usage information for <application>pkgng</application> is
+ <para>Usage information for <application>pkg</application> is
available in pkg(8) or by running
<command>pkg</command> without additional arguments.</para>
- <para>Each <application>pkgng</application> command argument is
+ <para>Each <application>pkg</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 of these commands:</para>
@@ -721,7 +722,7 @@ docbook =
<para>The rest of this section demonstrates common binary
package management tasks which can be performed using
- <application>pkgng</application>. Each demonstrated command
+ <application>pkg</application>. Each demonstrated command
provides many switches to customize its use. Refer to a
command's help or man page for details and more
examples.</para>
@@ -737,7 +738,7 @@ docbook =
package.</para>
<para>For example, to see which version of
- <application>pkgng</application> is installed, run:</para>
+ <application>pkg</application> is installed, run:</para>
<screen>&prompt.root; <userinput>pkg info pkg</userinput>
pkg-1.1.4_1</screen>
@@ -825,7 +826,7 @@ Proceed with deleting packages [y/N]: <u
<para>Occasionally, software vulnerabilities may be discovered
in third-party applications. To address this,
- <application>pkgng</application> includes a built-in auditing
+ <application>pkg</application> includes a built-in auditing
mechanism. To determine if there are any known
vulnerabilities for the software installed on the system,
run:</para>
@@ -855,7 +856,7 @@ Deinstalling ca_root_nss-3.15.1_1... don
<title>Backing Up the Package Database</title>
<para>Unlike the traditional package management system,
- <application>pkgng</application> includes its own package
+ <application>pkg</application> includes its own package
database backup mechanism. To manually back up the contents
of the package database, run the following command, replacing
<replaceable>pkgng.db</replaceable> with a suitable file
@@ -863,16 +864,15 @@ Deinstalling ca_root_nss-3.15.1_1... don
<screen>&prompt.root; <userinput>pkg backup -d <replaceable>pkgng.db</replaceable></userinput></screen>
- <para>Additionally, <application>pkgng</application> includes
+ <para>Additionally, <application>pkg</application> includes
a &man.periodic.8; script to automatically perform a daily
back up of the package database. This functionality is
- enabled if <literal>daily_backup_pkgng_enable</literal> is
+ enabled if <literal>daily_backup_pkgdb_enable</literal> is
set to <literal>YES</literal> in &man.periodic.conf.5;.</para>
<tip>
<para>To disable the periodic script from backing up the
- package database, set <literal>daily_backup_pkgdb_
- enable</literal> to <literal>NO</literal> in
+ package database, set <literal>daily_backup_pkgdb_enable</literal> to <literal>NO</literal> in
&man.periodic.conf.5;.</para>
</tip>
@@ -885,7 +885,7 @@ Deinstalling ca_root_nss-3.15.1_1... don
<sect2 xml:id="pkgng-clean">
<title>Removing Stale Packages</title>
- <para>By default, <application>pkgng</application> stores
+ <para>By default, <application>pkg</application> stores
binary packages in a cache directory defined by
<envar>PKG_CACHEDIR</envar> in pkg.conf(5). When upgrading
packages with <command>pkg upgrade</command>, old versions
@@ -901,7 +901,7 @@ Deinstalling ca_root_nss-3.15.1_1... don
<para>Software within the &os; Ports Collection can
undergo major version number changes. To address this,
- <application>pkgng</application> has a built-in command to
+ <application>pkg</application> has a built-in command to
update package origins. This can be useful, for example, if
<package>lang/php5</package> is renamed to
<package>lang/php53</package> so that
@@ -1014,7 +1014,7 @@ Deinstalling ca_root_nss-3.15.1_1... don
&prompt.root; <userinput>make install clean</userinput></screen>
<para>If the ports tree is not available, or
- <application>pkgng</application> is being used to manage
+ <application>pkg</application> is being used to manage
packages, <application>Subversion</application> can be
installed as a package:</para>
@@ -1361,7 +1361,7 @@ The deinstallation will free 229 kB
<xref linkend="ports-using-portsnap-method"/> or
<xref linkend="ports-using-subversion-method"/>. On &os; 10
and later, or if the system has been converted to
- <application>pkgng</application>, the following command will
+ <application>pkg</application>, the following command will
list the installed ports which are out of date:</para>
<screen>&prompt.root; <userinput>pkg version -l "<"</userinput></screen>
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"