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:
parent
0ea0848dc4
commit
3c7fb45a82
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52134
1 changed files with 55 additions and 50 deletions
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue