Index: chapter.xml =================================================================== --- chapter.xml +++ chapter.xml @@ -93,18 +93,6 @@ - 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 the process of compiling an application from source code. The files that comprise a port contain all the necessary information @@ -111,7 +99,15 @@ 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 adapated and tested + on &os;, the source code may 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 +116,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 +718,14 @@ Using the Ports Collection The 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 termed a port. + + By default these files are stored under + /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 +819,12 @@ - The Ports Collection installs a series of directories + 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, + referred to as a ports skeleton. Each port skeleton includes these files and directories: