svn commit: r46682 - head/en_US.ISO8859-1/books/handbook/ports

Author: brd
Date: Tue May 12 14:24:05 2015
New Revision: 46682
URL: https://svnweb.freebsd.org/changeset/doc/46682

Log:
  Reword the section about pkg backups to reflect that they are enabled by default now.

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	Tue May 12 10:27:17 2015	(r46681)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Tue May 12 14:24:05 2015	(r46682)
@@ -854,34 +854,38 @@ Deinstalling ca_root_nss-3.15.1_1... don
     </sect2>
 
     <sect2 xml:id="pkgng-backup">
-      <title>Backing Up the Package Database</title>
+      <title>Restoring the Package Database</title>
 
       <para>Unlike the traditional package management system,
 	<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
-	name:</para>
-
-      <screen>&prompt.root; <userinput>pkg backup -d <replaceable>pkgng.db</replaceable></userinput></screen>
-
-      <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_pkgdb_enable</literal> is
-	set to <literal>YES</literal> in &man.periodic.conf.5;.</para>
+	database backup mechanism.  This functionality is enabled by
+	default.</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 &man.periodic.conf.5;.</para>
+	  <literal>daily_backup_pkgdb_enable="NO"</literal> in
+	  &man.periodic.conf.5;.</para>
       </tip>
 
       <para>To restore the contents of a previous package database
-	backup, run:</para>
+	backup, run the following command replacing
+	<replaceable>/path/to/pkg.sql</replaceable> with the location of
+	the backup:</para>
 
-      <screen>&prompt.root; <userinput>pkg backup -r <replaceable>/path/to/pkgng.db</replaceable></userinput></screen>
+      <screen>&prompt.root; <userinput>pkg backup -r <replaceable>/path/to/pkg.sql</replaceable></userinput></screen>
+
+      <note>
+	<para>If restoring a backup taken by the periodic script,
+	  it must be decompressed prior to be restored.</para>
+      </note>
+
+      <para>To run a manual backup of the
+	<application>pkg</application> database, run the following
+	command, replacing <replaceable>/path/to/pkg.sql</replaceable>
+	with a suitable file name and location:</para>
+
+      <screen>&prompt.root; <userinput>pkg backup -d <replaceable>/path/to/pkg.sql</replaceable></userinput></screen>
     </sect2>
 
     <sect2 xml:id="pkgng-clean">
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"