diff --git a/share/doc/handbook/handbook.sgml b/share/doc/handbook/handbook.sgml index 44c82b63a354..bbeba4e66712 100644 --- a/share/doc/handbook/handbook.sgml +++ b/share/doc/handbook/handbook.sgml @@ -1,4 +1,4 @@ - + or one of the numerous - Basics + Getting Started Introduction

FreeBSD is a 4.4BSD-Lite based operating system for Intel @@ -78,9 +78,7 @@ name="FreeBSD FTP server"> or one of the numerous &install; &basics; - Installing applications - * Installing packages - &ports; + &ports; diff --git a/share/doc/handbook/ports.sgml b/share/doc/handbook/ports.sgml index d37139caf3fa..09cd781f49f8 100644 --- a/share/doc/handbook/ports.sgml +++ b/share/doc/handbook/ports.sgml @@ -1,7 +1,7 @@ - + -The Ports collection +Installing Applications: The Ports collection

Contributed by &a.jraynard;. @@ -31,7 +31,7 @@ Foonix style unacceptable exception handling? And if not, why not?''). has already been done, and you can just type 'make install' and get a working program. -Why have a Ports Collection? +Why have a Ports Collection?

The base FreeBSD system comes with a very wide range of tools and system utilities, but a lot of popular programs are not in the base @@ -67,7 +67,7 @@ way of using standard tools that would automate the process. works in practice by combining a set of simple but very flexible tools into something very powerful. - How does the Ports collection work? + How does the Ports collection work?

Programs are typically distributed on the Internet as a consisting of @@ -184,14 +184,14 @@ id="ports:remove" name="remove"> all traces of it from your system.

See if you can match these steps to the make output. And if you were not impressed before, you should be by now! -Getting a FreeBSD Port +Getting a FreeBSD Port

There are two ways of getting hold of the FreeBSD port for a program. One requires a , the other involves using an -Compiling ports from CDROM +Compiling ports from CDROM

If you answered yes to the question ``Do you want to link the ports collection to your CDROM'' during the FreeBSD installation, the initial @@ -257,7 +257,7 @@ source in the CDROM due to licensing limitations. In that case, you will need to look at the section on -Compiling ports from the Internet

If you do not have a CDROM, or you want to make sure you get the very @@ -331,14 +331,14 @@ carried away and type 'get ports.tar.gz' unless you are prepared to download the distfiles directory as well - this contains the source code for every single port and will take a very long time to download! -Skeletons +Skeletons

A team of compulsive hackers who have forgotten to eat in a frantic attempt to make a deadline? Something unpleasant lurking in the FreeBSD attic? No, a skeleton here is a minimal framework that supplies everything needed to make the ports magic work. -Makefile +Makefile

The most important component of a skeleton is the Makefile. This contains various statements that specify how the port should be compiled and @@ -406,7 +406,7 @@ how Makefiles work; suffice it to say that the lines starting with about what to do after installing the program, so that the man pages can be compressed after they have been put in their final destination. -The files directory +The files directory

The file containing the for the port is called "md5", after the MD5 algorithm @@ -416,12 +416,12 @@ confusing name of "files". This directory can also contain other miscellaneous files that are required by the port and do not belong anywhere else. -The patches directory +The patches directory

This directory contains the needed to make everything work properly under FreeBSD. -The pkg directory +The pkg directory

This program contains three quite useful files:- @@ -436,7 +436,7 @@ DESCR - a more detailed description. PLIST - a list of all the files that will be created when the program is installed. -It does not work?! +It does not work?!

Oh. You can do one of four (4) things : @@ -475,12 +475,12 @@ dddprogram to install them to your system. -I have this program that I would like to make into a port... +I have this program that I would like to make into a port...

Great! Please see the for detailed instructions on how to do this. -Some Questions and Answers +Some Questions and Answers