Date: Mon, 8 Feb 2016 00:29:32 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48155 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201602080029.u180TW9Z071559@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201602080029.u180TW9Z071559>