Index: chapter.xml
===================================================================
--- chapter.xml
+++ chapter.xml
@@ -93,25 +93,24 @@
- 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;.
-
- 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
- pkg commands, such as
- pkg install.
-
- A &os; port is a collection of files designed to automate
+ A &os; port 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.
- The ports system can also be used to generate packages which
+ If the software has not already been adapted and tested
+ on &os;, the source code might need editing in
+ order for it to install and run properly.
+
+ However, over
+ &os.numports;
+ third-party applications have already been
+ ported to &os;. When feasible, these applications are made
+ available for download as pre-compiled packages.
+
+ Packages
can be manipulated with the &os; package management
commands.
@@ -120,6 +119,12 @@
dependent library is not already installed, the library will
automatically be installed first.
+ 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
+ pkg install.
+
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 +719,14 @@
Using the Ports CollectionThe Ports Collection is a set of
- Makefiles, patches, and description files
- stored in /usr/ports. This set of files is
- used to compile and install applications on &os;. Before an
+ Makefiles, patches, and description files.
+ Each set of these files is used to compile and install an individual
+ application on &os;, and is called a port.
+
+ By default, the Ports Collection itself is stored as a subdirectory
+ of /usr/ports.
+
+ 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 +820,12 @@
- The Ports Collection installs a series of 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
+ The Ports Collection contains directories
+ for software categories. Inside each category are
+ subdirectories for individual applications. Each application
+ subdirectory contains a set of files that
+ tells &os; how to compile and install that program,
+ called a ports skeleton. Each port
skeleton includes these files and directories: