Date: Thu, 16 Aug 2018 13:18:30 +0000 (UTC) From: Benedict Reuschling <bcr@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52134 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201808161318.w7GDIUle076908@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bcr Date: Thu Aug 16 13:18:30 2018 New Revision: 52134 URL: https://svnweb.freebsd.org/changeset/doc/52134 Log: Wrap overlong lines in the ports chapter, cleanup trailing whitespace on a sentence break, and change the capitalization of a title. Found by: textproc/igor 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 Thu Aug 16 12:45:32 2018 (r52133) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Aug 16 13:18:30 2018 (r52134) @@ -71,7 +71,8 @@ <step> <para>Unpack the software from its distribution format. This is typically a tarball compressed with a program such as - &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or &man.xz.1;.</para> + &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or + &man.xz.1;.</para> </step> <step> @@ -104,11 +105,11 @@ on &os;, the source code might need editing in order for it to install and run properly.</para> - <para>However, over - <link xlink:href="&url.base;/ports/index.html">&os.numports;</link> - third-party applications have already been - ported to &os;. When feasible, these applications are made - available for download as pre-compiled <emphasis>packages</emphasis>.</para> + <para>However, over <link + xlink:href="&url.base;/ports/index.html">&os.numports;</link> + third-party applications have already been ported to &os;. When + feasible, these applications are made available for download as + pre-compiled <emphasis>packages</emphasis>.</para> <para>Packages can be manipulated with the &os; package management @@ -277,10 +278,10 @@ subversion-static-<replaceable>1.8.8_2</replaceable> subversion16-<replaceable>1.6.23_4</replaceable> subversion17-<replaceable>1.7.16_2</replaceable></screen> - <para>Package names include the version number and, in the case of - ports based on python, the version number of the version of - python the package was built with. Some ports also have - multiple versions available. In the case of + <para>Package names include the version number and, in the + case of ports based on python, the version number of the + version of python the package was built with. Some ports + also have multiple versions available. In the case of <application>Subversion</application>, there are different versions available, as well as different compile options. In this case, the statically linked version of @@ -409,9 +410,9 @@ Info: Lists information about open files (similar to from the &os; mirrors, managing packages with <application>pkg</application> can be sufficient.</para> - <para>However, for those sites building from source or using - their own repositories, a separate - <link linkend="ports-upgrading-tools">port management tool</link> + <para>However, for those sites building from source or using their + own repositories, a separate <link + linkend="ports-upgrading-tools">port management tool</link> will be needed.</para> <para>Since <application>pkg</application> only works with @@ -741,17 +742,17 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen> <para>The Ports Collection is a set of <filename>Makefiles</filename>, patches, and description files. - Each set of these files is used to compile and install an individual - application on &os;, and is called a <emphasis>port</emphasis>.</para> + Each set of these files is used to compile and install an + individual application on &os;, and is called a + <emphasis>port</emphasis>.</para> - <para>By default, the Ports Collection itself is stored as a subdirectory - of <filename>/usr/ports</filename>.</para> + <para>By default, the Ports Collection itself is stored as a + subdirectory of <filename>/usr/ports</filename>.</para> - <para>Before an - application can be compiled using a port, the Ports Collection - must first be installed. If it was not installed during the - installation of &os;, use one of the following methods to - install it:</para> + <para>Before an application can be compiled using a port, the + Ports Collection must first be installed. If it was not + installed during the installation of &os;, use one of the + following methods to install it:</para> <procedure xml:id="ports-using-portsnap-method"> <title>Portsnap Method</title> @@ -1001,15 +1002,14 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen> options, or allow for other customizations. Examples include <package>www/firefox</package>, <package>security/gpgme</package>, and - <package>mail/sylpheed-claws</package>. - 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 and do all of the configuration - in one batch, run <command>make config-recursive</command> - within the port skeleton. Then, run <command>make - install [clean]</command> to compile and install the - port.</para> + <package>mail/sylpheed-claws</package>. 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 and do all of the configuration in one + batch, run <command>make config-recursive</command> within + the port skeleton. Then, run <command>make install + [clean]</command> to compile and install the port.</para> <tip> <para>When using @@ -1171,15 +1171,16 @@ The deinstallation will free 229 kB </important> <sect3 xml:id="ports-upgrading-tools"> - <title>Tools To Upgrade And Manage Ports</title> + <title>Tools to Upgrade and Manage Ports</title> <indexterm> <primary>ports</primary> <secondary>upgrading-tools</secondary> </indexterm> - <para>The Ports Collection contains several utilities to perform - the actual upgrade. Each has its strengths and weaknesses.</para> + <para>The Ports Collection contains several utilities to + perform the actual upgrade. Each has its strengths and + weaknesses.</para> <para>Historically, most installations used either <application>Portmaster</application> or @@ -1188,9 +1189,10 @@ The deinstallation will free 229 kB alternative.</para> <note> - <para>The choice of which tool is best for a particular system - is up to the system administrator. It is recommended practice - to back up your data before using any of these tools.</para> + <para>The choice of which tool is best for a particular + system is up to the system administrator. It is + recommended practice to back up your data before using any + of these tools.</para> </note> </sect3> @@ -1297,8 +1299,9 @@ The deinstallation will free 229 kB <screen>&prompt.root; <userinput>portmaster <replaceable>shells/bash</replaceable></userinput></screen> - <para>More information about <package>ports-mgmt/portmaster</package> - may be found in its <filename>pkg-descr</filename>.</para> + <para>More information about + <package>ports-mgmt/portmaster</package> may be found in its + <filename>pkg-descr</filename>.</para> </sect3> <sect3 xml:id="portupgrade"> @@ -1308,11 +1311,11 @@ The deinstallation will free 229 kB <primary>portupgrade</primary> </indexterm> - <para><package>ports-mgmt/portupgrade</package> is - another utility that can be used to upgrade ports. It - installs a suite of applications - which can be used to manage ports. However, it is dependent - upon Ruby. To install the port:</para> + <para><package>ports-mgmt/portupgrade</package> is another + utility that can be used to upgrade ports. It installs a + suite of applications which can be used to manage ports. + However, it is dependent upon Ruby. To install the + port:</para> <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portupgrade</userinput> &prompt.root; <userinput>make install clean</userinput></screen> @@ -1358,8 +1361,9 @@ The deinstallation will free 229 kB information on all of the available switches, refer to the manual page for <command>portupgrade</command>.</para> - <para>More information about <package>ports-mgmt/portupgrade</package> - may be found in its <filename>pkg-descr</filename>.</para> + <para>More information about + <package>ports-mgmt/portupgrade</package> may be found in + its <filename>pkg-descr</filename>.</para> </sect3> </sect2> @@ -1453,9 +1457,9 @@ The deinstallation will free 229 kB other configuration values are adequate.</para> <para>The number of processor cores detected is used to define how - many builds will run in parallel. Supply enough virtual - memory, either with <acronym>RAM</acronym> or swap space. If - virtual memory runs out, the compilation jails will stop and be torn + many builds will run in parallel. Supply enough virtual memory, + either with <acronym>RAM</acronym> or swap space. If virtual + memory runs out, the compilation jails will stop and be torn down, resulting in weird error messages.</para> <sect2 xml:id="poudriere-initialization"> @@ -1701,7 +1705,8 @@ ports-mgmt/pkg list</link>. Many, but not all, of these addresses look like <email role="nolink">freebsd-<replaceable>listname</replaceable>@FreeBSD.org</email>. - Please take this into account when sending an email.</para> + Please take this into account when sending an + email.</para> <para>In particular, ports maintained by <email role="nolink">ports@FreeBSD.org</email> are not
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201808161318.w7GDIUle076908>