- Add hyphens where needed (for example s/third party/third-party/);

- s/Pentium IV/Pentium 4 to match Intel syntax;
- Some rewordings for clarification of some points;
- Add reference to sha256(1).

PR:		docs/114272
Submitted by:	Ben Kaduk <minimarmot@gmail.com>
This commit is contained in:
Marc Fonvieille 2007-07-06 07:59:56 +00:00
parent e404b4525c
commit 39d19b72e9
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=30421

View file

@ -16,7 +16,7 @@
part of the base system. However, there is only so much one can part of the base system. However, there is only so much one can
do before needing to install an additional third-party do before needing to install an additional third-party
application to get real work done. FreeBSD provides two application to get real work done. FreeBSD provides two
complementary technologies for installing third party software complementary technologies for installing third-party software
on your system: the FreeBSD Ports Collection (for installing from on your system: the FreeBSD Ports Collection (for installing from
source), and packages (for installing from pre-built binaries). source), and packages (for installing from pre-built binaries).
Either method may be used to install the Either method may be used to install the
@ -53,7 +53,7 @@
<title>Overview of Software Installation</title> <title>Overview of Software Installation</title>
<para>If you have used a &unix; system before you will know that <para>If you have used a &unix; system before you will know that
the typical procedure for installing third party software goes the typical procedure for installing third-party software goes
something like this:</para> something like this:</para>
<procedure> <procedure>
@ -97,7 +97,7 @@
<quote>traditional</quote> way with FreeBSD. However, FreeBSD <quote>traditional</quote> way with FreeBSD. However, FreeBSD
provides two technologies which can save you a lot of effort: provides two technologies which can save you a lot of effort:
packages and ports. At the time of writing, over &os.numports; packages and ports. At the time of writing, over &os.numports;
third party applications have been made available in this third-party applications have been made available in this
way.</para> way.</para>
<para>For any given application, the FreeBSD package for that <para>For any given application, the FreeBSD package for that
@ -174,11 +174,11 @@
because they have to run on the maximum number of systems. By because they have to run on the maximum number of systems. By
installing from the port, you can tweak the compilation options to installing from the port, you can tweak the compilation options to
(for example) generate code that is specific to a Pentium (for example) generate code that is specific to a Pentium
IV or Athlon processor.</para> 4 or Athlon processor.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Some applications have compile time options relating to <para>Some applications have compile-time options relating to
what they can and cannot do. For example, what they can and cannot do. For example,
<application>Apache</application> can be configured with a <application>Apache</application> can be configured with a
wide variety of different built-in options. By building wide variety of different built-in options. By building
@ -193,7 +193,7 @@
whether or not you have installed an X11 server. This sort whether or not you have installed an X11 server. This sort
of rough tweaking is possible with packages, but rapidly of rough tweaking is possible with packages, but rapidly
becomes impossible if an application has more than one or becomes impossible if an application has more than one or
two different compile time options.</para> two different compile-time options.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -238,7 +238,7 @@
</warning> </warning>
<para>The remainder of this chapter will explain how to use <para>The remainder of this chapter will explain how to use
packages and ports to install and manage third party software on packages and ports to install and manage third-party software on
FreeBSD.</para> FreeBSD.</para>
</sect1> </sect1>
@ -414,8 +414,8 @@ local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
<para>The example above would download the correct package and <para>The example above would download the correct package and
add it without any further user intervention. add it without any further user intervention.
If you want to specify an alternative &os; Packages Mirror, If you want to specify an alternative &os; Packages Mirror,
instead of the main distribution site, you have to set instead of the main distribution site, you have to set the
<envar>PACKAGESITE</envar> accordingly, to <envar>PACKAGESITE</envar> environment variable accordingly, to
override the default settings. &man.pkg.add.1; override the default settings. &man.pkg.add.1;
uses &man.fetch.3; to download the files, which honors various uses &man.fetch.3; to download the files, which honors various
environment variables, including environment variables, including
@ -436,8 +436,8 @@ local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
&os.stable;. If you run a -RELEASE version, it will grab &os.stable;. If you run a -RELEASE version, it will grab
the version of the package that was built with your the version of the package that was built with your
release. It is possible to change this behavior by release. It is possible to change this behavior by
overriding the <envar>PACKAGESITE</envar> environment overriding <envar>PACKAGESITE</envar>.
variable. For example, if you run a &os;&nbsp;5.4-RELEASE For example, if you run a &os;&nbsp;5.4-RELEASE
system, by default &man.pkg.add.1; will try to fetch system, by default &man.pkg.add.1; will try to fetch
packages from packages from
<literal>ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-5.4-release/Latest/</literal>. <literal>ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-5.4-release/Latest/</literal>.
@ -553,6 +553,13 @@ docbook =
</para> </para>
<screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen> <screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen>
<para>Note that &man.pkg.delete.1; requires the full package
name and number; the above command would not work if
<replaceable>xchat</replaceable> was given instead of
<replaceable>xchat-1.7.1</replaceable>. It is, however, easy
to use &man.pkg.version.1; to find the version of the
installed package.</para>
</sect2> </sect2>
<sect2> <sect2>
@ -817,9 +824,10 @@ docbook =
<listitem> <listitem>
<para>A <filename>distinfo</filename> file. This file <para>A <filename>distinfo</filename> file. This file
contains information about the files that must be contains information about the files that must be
downloaded to build the port and their checksums, to downloaded to build the port, and their checksums
(using &man.md5.1; and &man.sha256.1;), to
verify that files have not been corrupted during the verify that files have not been corrupted during the
download using &man.md5.1;.</para> download.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -985,7 +993,7 @@ docbook =
documentation for your shell for more information.</para> documentation for your shell for more information.</para>
</note> </note>
<para>Some third party DVD-ROM products such as the FreeBSD Toolkit <para>Some third-party DVD-ROM products such as the FreeBSD Toolkit
from the <ulink url="http://www.freebsdmall.com/">FreeBSD from the <ulink url="http://www.freebsdmall.com/">FreeBSD
Mall</ulink> contain distfiles. They can be used with the Ports Mall</ulink> contain distfiles. They can be used with the Ports
Collection. Mount the DVD-ROM on <filename>/cdrom</filename>. If Collection. Mount the DVD-ROM on <filename>/cdrom</filename>. If