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
This commit is contained in:
Benedict Reuschling 2018-08-16 13:18:30 +00:00
parent 0ea0848dc4
commit 3c7fb45a82
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52134

View file

@ -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 fstat(1))</screen>
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