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 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 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: