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

[Warren Block]

Author: wblock
Date: Mon Feb  8 00:29:31 2016
New Revision: 48155
URL: https://svnweb.freebsd.org/changeset/doc/48155

Log:
  Revise the portmaster section to remove the "recommended" word.  Clarify
  and simplify some other points, and fix a couple of spelling errors.

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	Sun Feb  7 19:13:26 2016	(r48154)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Mon Feb  8 00:29:31 2016	(r48155)
@@ -278,7 +278,7 @@ subversion17-<replaceable>1.7.16_2</repl
 	  multiple versions available.  In case of
 	  <application>subversion</application> there are different
 	  versions available, as well as different compile options.
-	  In this case, the staticly linked version of
+	  In this case, the statically linked version of
 	  <application>subversion</application>.  When indicating
 	  which package to install, it is best to specify the
 	  application by the port origin, which is the path in the
@@ -706,7 +706,7 @@ docbook                     =
 	options are described in &man.pkg.conf.5;.</para>
 
       <para>Usage information for <application>pkg</application> is
-	available in the &man.pkg.8; manpage or by running
+	available in the &man.pkg.8; manual page or by running
 	<command>pkg</command> without additional arguments.</para>
 
       <para>Each <application>pkg</application> command argument is
@@ -1297,7 +1297,7 @@ Deinstalling ca_root_nss-3.15.1_1... don
 
       <para>Installed ports can be uninstalled using <command>pkg
 	  delete</command>.  Examples for using this command can be
-	found in the &man.pkg-delete.8; manpage.</para>
+	found in the &man.pkg-delete.8; manual page.</para>
 
       <para>Alternately, <command>make deinstall</command> can be
 	run in the port's directory:</para>
@@ -1378,12 +1378,11 @@ The deinstallation will free 229 kB
 	  <primary>portmaster</primary>
 	</indexterm>
 
-	<para>The <package>ports-mgmt/portmaster</package> package or
-	  port is the recommended tool for upgrading installed ports
-	  as it is designed to use the tools installed with &os;
-	  without depending upon other ports.  It uses the
-	  information in <filename>/var/db/pkg/</filename> to
-	  determine which ports to upgrade.  To install this utility
+	<para><package>ports-mgmt/portmaster</package> is a very
+	  small utility for upgrading installed ports.
+	  It is designed to use the tools installed with &os;
+	  without depending on other ports or databases.
+	  To install this utility
 	  as a port:</para>
 
 	<screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portmaster</userinput>
@@ -1444,17 +1443,17 @@ The deinstallation will free 229 kB
 	<screen>&prompt.root; <userinput>portmaster -a</userinput></screen>
 
 	<note>
-	  <para>By default, <application>Portmaster</application> will
-	    make a backup package before deleting the existing port.
+	  <para>By default, <application>Portmaster</application>
+	    makes a backup package before deleting the existing port.
 	    If the installation of the new version is successful,
-	    <application>Portmaster</application> will delete the
-	    backup.  Using <option>-b</option> will instruct
+	    <application>Portmaster</application> deletes the
+	    backup.  Using <option>-b</option> instructs
 	    <application>Portmaster</application> not to automatically
-	    delete the backup.  Adding <option>-i</option> will start
+	    delete the backup.  Adding <option>-i</option> starts
 	    <application>Portmaster</application> in interactive mode,
 	    prompting for confirmation before upgrading each port.
 	    Many other options are available.  Read through the
-	    manual page for portmaster(8) for details regarding
+	    manual page for &man.portmaster.8; for details regarding
 	    their usage.</para>
 	</note>