From owner-svn-doc-head@FreeBSD.ORG Wed Oct 9 19:25:45 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 07BF9AF1; Wed, 9 Oct 2013 19:25:45 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id E884D2F34; Wed, 9 Oct 2013 19:25:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r99JPibU076253; Wed, 9 Oct 2013 19:25:44 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r99JPiLK076250; Wed, 9 Oct 2013 19:25:44 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310091925.r99JPiLK076250@svn.freebsd.org> From: Dru Lavigne Date: Wed, 9 Oct 2013 19:25:44 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42919 - head/en_US.ISO8859-1/books/handbook/ports X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Oct 2013 19:25:45 -0000 Author: dru Date: Wed Oct 9 19:25:44 2013 New Revision: 42919 URL: http://svnweb.freebsd.org/changeset/doc/42919 Log: White space fix only. Translators can ignore. 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 Wed Oct 9 19:08:10 2013 (r42918) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Wed Oct 9 19:25:44 2013 (r42919) @@ -1172,20 +1172,21 @@ Deinstalling ca_root_nss-3.15.1_1... don include www/firefox, security/gpgme, and mail/sylpheed-claws. - If the port depends upon other ports which have configurable options, it may pause - several times for user interaction as the default behavior - is to prompt the user to select options from a menu. To - avoid this, run make - config-recursive within the port skeleton to do - this configuration in one batch. Then, run make + If the port depends upon other ports which have configurable + options, it may pause several times for user interaction + as the default behavior is to prompt the user to select + options from a menu. To avoid this, run make + config-recursive + within the port skeleton to do this configuration in one + batch. Then, run make install [clean] to compile and install the port. When using config-recursive, the list of ports to configure are gathered by the - all-depends-list - target. It is recommended to run make + all-depends-list target. It is + recommended to run make config-recursive until all dependent ports options have been defined, and ports options screens no longer appear, to be certain @@ -1345,9 +1346,9 @@ The deinstallation will free 229 kB the upgrade. - To perform the actual upgrade, use either - Portmaster or - Portupgrade. + To perform the actual upgrade, use either + Portmaster or + Portupgrade. Upgrading Ports Using @@ -1359,39 +1360,39 @@ The deinstallation will free 229 kB <para>The <filename role="package">ports-mgmt/portmaster</filename> - 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 class="directory">/var/db/pkg/</filename> to - determine which ports to upgrade. To install this utility - as a port:</para> + 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 + class="directory">/var/db/pkg/</filename> to determine + which ports to upgrade. To install this utility as a + port:</para> <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portmaster</userinput> &prompt.root; <userinput>make install clean</userinput></screen> - <para><application>Portmaster</application> defines - four categories of ports:</para> + <para><application>Portmaster</application> defines four + categories of ports:</para> <itemizedlist> <listitem> - <para>Root port: has no dependencies and is not a dependency of - any other ports.</para> + <para>Root port: has no dependencies and is not a + dependency of any other ports.</para> </listitem> <listitem> - <para>Trunk port: has no dependencies, but other ports depend - upon it.</para> + <para>Trunk port: has no dependencies, but other ports + depend upon it.</para> </listitem> <listitem> - <para>Branch port: has dependencies and other ports depend - upon it.</para> + <para>Branch port: has dependencies and other ports + depend upon it.</para> </listitem> <listitem> - <para>Leaf port: has dependencies but no other ports depend - upon it.</para> + <para>Leaf port: has dependencies but no other ports + depend upon it.</para> </listitem> </itemizedlist> @@ -1419,7 +1420,8 @@ The deinstallation will free 229 kB ===>>> 137 total installed ports ===>>> 83 have new versions available</screen> - <para>This command is used to upgrade all outdated ports:</para> + <para>This command is used to upgrade all outdated + ports:</para> <screen>&prompt.root; <userinput>portmaster -a</userinput></screen> @@ -1432,14 +1434,15 @@ The deinstallation will free 229 kB <application>Portmaster</application> not to automatically delete the backup. Adding <option>-i</option> will start <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 + prompting for confirmation before upgrading each port. + Many other options are available. Read through the + manual page for portmaster(8) for details regarding their usage.</para> </note> - <para>If errors are encountered during the upgrade process, add - <option>-f</option> to upgrade and rebuild all ports:</para> + <para>If errors are encountered during the upgrade process, + add <option>-f</option> to upgrade and rebuild all + ports:</para> <screen>&prompt.root; <userinput>portmaster -af</userinput></screen> @@ -1450,9 +1453,9 @@ The deinstallation will free 229 kB port in the Ports Collection:</para> <screen>&prompt.root; <userinput>portmaster <replaceable>shells/bash</replaceable></userinput></screen> - </sect3> + </sect3> - <sect3 id="portupgrade"> + <sect3 id="portupgrade"> <title>Upgrading Ports Using Portupgrade @@ -1461,46 +1464,48 @@ The deinstallation will free 229 kB Another utility that can be used to upgrade ports is Portupgrade, which is - available - as the ports-mgmt/portupgrade package or port. - This utility installs a suite of applications which can be - used to manage ports. However, it is dependent upon Ruby. - To install the port: + available as the ports-mgmt/portupgrade package + or port. This utility installs a suite of applications + which can be used to manage ports. However, it is dependent + upon Ruby. To install the port: &prompt.root; cd /usr/ports/ports-mgmt/portupgrade &prompt.root; make install clean Before performing an upgrade using this utility, it is recommended to scan the list of installed ports using - pkgdb -F and to fix all the inconsistencies - it reports. + pkgdb -F and to fix all the + inconsistencies it reports. - To upgrade all the - outdated ports installed on the system, use portupgrade -a. Alternately, include - to be asked for confirmation of every - individual upgrade: + To upgrade all the outdated ports installed on the + system, use portupgrade -a. Alternately, + include to be asked for confirmation + of every individual upgrade: &prompt.root; portupgrade -ai To upgrade only a specified application instead of all available ports, use portupgrade - pkgname. It is very important to include - to first upgrade all the ports required - by the given application: + pkgname. It is + very important to include to first + upgrade all the ports required by the given + application: &prompt.root; portupgrade -R firefox If is included, - Portupgrade searches for available packages in the local - directories listed in PKG_PATH. If none are available locally, it then fetches - packages from a remote site. If + Portupgrade searches for + available packages in the local directories listed in + PKG_PATH. If none are available locally, + it then fetches packages from a remote site. If packages can not be found locally or fetched remotely, Portupgrade will use ports. To avoid using ports entirely, specify . - This last set of options tells Portupgrade - to abort if no packages are available: + This last set of options tells + Portupgrade to abort if no + packages are available: &prompt.root; portupgrade -PP gnome2 @@ -1510,7 +1515,7 @@ The deinstallation will free 229 kB information on all of the available switches, refer to the manual page for portupgrade. - + Ports and Disk Space @@ -1521,33 +1526,37 @@ The deinstallation will free 229 kB Using the Ports Collection will use up disk space over - time. After building and installing a port, running make - clean within the ports skeleton will clean up the - temporary work - directory. If Portmaster is used - to install a port, it will automatically remove this directory - unless is specified. If - Portupgrade is installed, this command - will remove all work - directories found within the local copy of the Ports - Collection: + time. After building and installing a port, running + make clean + within the ports skeleton will clean up the temporary + work directory. If + Portmaster is used to install a + port, it will automatically remove this directory unless + is specified. If + Portupgrade is installed, this + command will remove all work directories found within + the local copy of the Ports Collection: &prompt.root; portsclean -C - In addition, a lot of out-dated source distribution files will collect - in /usr/ports/distfiles over time. + In addition, a lot of out-dated source distribution files + will collect in /usr/ports/distfiles over time. If Portupgrade is installed, this - command will delete all the distfiles that are - no longer referenced by any ports: + command will delete all the distfiles that are no longer + referenced by any ports: &prompt.root; portsclean -D - To use Portupgrade to remove all distfiles not referenced by any port - currently installed on the system: + To use Portupgrade to remove + all distfiles not referenced by any port currently installed + on the system: &prompt.root; portsclean -DD - If Portmaster is installed, use: + If Portmaster is installed, + use: &prompt.root; portmaster --clean-distfiles @@ -1555,9 +1564,9 @@ The deinstallation will free 229 kB the user to confirm if a distfile should be deleted. In addition to these commands, the ports-mgmt/pkg_cutleaves package or port automates - the task of removing installed ports that are no longer - needed. + role="package">ports-mgmt/pkg_cutleaves package + or port automates the task of removing installed ports that + are no longer needed. @@ -1623,15 +1632,16 @@ The deinstallation will free 229 kB Search to see if there is a fix pending for the port in the Problem - Report database. If so, implementing the proposed fix may - fix the issue. + Report database. If so, implementing the proposed + fix may fix the issue. Ask the maintainer of the port for help. Type make maintainer - in the ports skeleton or read the port's Makefile to find the - maintainer's email address. Remember to include the + in the ports skeleton or read the port's + Makefile to find the maintainer's + email address. Remember to include the $FreeBSD: line from the port's Makefile and the output leading up to the error in the email to the maintainer. @@ -1639,21 +1649,23 @@ The deinstallation will free 229 kB Some ports are not maintained by an individual but instead by a mailing - list. Many, but not all, of these addresses look - like mailing + list. Many, but not all, of these addresses + look like freebsd-listname@FreeBSD.org. Take this into account when sending an email. - In particular, ports shown as maintained by - ports@FreeBSD.org are - not maintained by a specific individual. Instead, any fixes and support - come from the general community who subscribe to that - mailing list. More volunteers are always needed! + In particular, ports shown as maintained by ports@FreeBSD.org are not + maintained by a specific individual. Instead, any fixes + and support come from the general community who subscribe + to that mailing list. More volunteers are always + needed! - If there is no response to the email, use &man.send-pr.1; to - submit a bug report using the instructions in If there is no response to the email, use + &man.send-pr.1; to submit a bug report using the + instructions in Writing &os; Problem Reports. @@ -1667,10 +1679,9 @@ The deinstallation will free 229 kB - Install the package instead of the port using the instructions in - or . + Install the package instead of the port using the + instructions in or .