Page MenuHomeFreeBSD
Files F134692856

D8839.id23217.diff
No OneTemporary
Actions

D8839.id23217.diff
View Options

Index: chapter.xml
===================================================================
--- chapter.xml
+++ chapter.xml
@@ -93,25 +93,24 @@
</step>
</procedure>
- <para>If the software package was not deliberately ported, or
- tested to work, on &os;, the source code may need editing in
- order for it to install and run properly. At the time of this
- writing, over &os.numports; third-party applications have been
- ported to &os;.</para>
-
- <para>A &os; package contains pre-compiled copies of all the
- commands for an application, as well as any configuration files
- and documentation. A package can be manipulated with the
- <application>pkg</application> commands, such as
- <command>pkg install</command>.</para>
-
- <para>A &os; port is a collection of files designed to automate
+ <para>A &os; <emphasis>port</emphasis> is a collection of files
+ designed to automate
the process of compiling an application from source code. The
files that comprise a port contain all the necessary information
to automatically download, extract, patch, compile, and install
the application.</para>
- <para>The ports system can also be used to generate packages which
+ <para>If the software has not already been adapated and tested
+ on &os;, the source code may 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>Packages
can be manipulated with the &os; package management
commands.</para>
@@ -120,6 +119,12 @@
dependent library is not already installed, the library will
automatically be installed first.</para>
+ <para>A &os; package contains pre-compiled copies of all the
+ commands for an application, as well as any configuration files
+ and documentation. A package can be manipulated with the
+ &man.pkg.8; commands, such as
+ <command>pkg install</command>.</para>
+
<para>While the two technologies are similar, packages and
ports each have their own strengths. Select the technology that
meets your requirements for installing a particular
@@ -714,9 +742,17 @@
<title>Using the Ports Collection</title>
<para>The Ports Collection is a set of
- <filename>Makefiles</filename>, patches, and description files
- stored in <filename>/usr/ports</filename>. This set of files is
- used to compile and install applications on &os;. Before an
+ <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>
+
+ <para>These files are further grouped into subdirectories called
+ <emphasis>categories</emphasis>.</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
@@ -810,11 +846,12 @@
</step>
</procedure>
- <para>The Ports Collection installs a series of directories
+ <para>The Ports Collection installs directories
representing software categories with each category having
- a subdirectory for each application. Each subdirectory, also
- referred to as a ports skeleton, contains a set of files that
- tell &os; how to compile and install that program. Each port
+ a subdirectory for each application. That directory
+ contains a set of files that
+ tell &os; how to compile and install that program,
+ called a <emphasis>ports skeleton</emphasis>. Each port
skeleton includes these files and directories:</para>
<itemizedlist>

File Metadata

Mime Type
text/plain
Expires
Wed, Nov 5, 12:55 AM (10 h, 13 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
24799483
Default Alt Text
D8839.id23217.diff (4 KB)

Event Timeline