View | Details | Raw Unified | Return to bug 114272
Collapse All | Expand All

(-)chapter.sgml (-14 / +22 lines)
Lines 16-22 Link Here
16
      part of the base system.  However, there is only so much one can
16
      part of the base system.  However, there is only so much one can
17
      do before needing to install an additional third-party
17
      do before needing to install an additional third-party
18
      application to get real work done.  FreeBSD provides two
18
      application to get real work done.  FreeBSD provides two
19
      complementary technologies for installing third party software
19
      complementary technologies for installing third-party software
20
      on your system: the FreeBSD Ports Collection (for installing from
20
      on your system: the FreeBSD Ports Collection (for installing from
21
      source), and packages (for installing from pre-built binaries).
21
      source), and packages (for installing from pre-built binaries).
22
      Either method may be used to install the
22
      Either method may be used to install the
Lines 53-59 Link Here
53
    <title>Overview of Software Installation</title>
53
    <title>Overview of Software Installation</title>
54
54
55
    <para>If you have used a &unix; system before you will know that
55
    <para>If you have used a &unix; system before you will know that
56
      the typical procedure for installing third party software goes
56
      the typical procedure for installing third-party software goes
57
      something like this:</para>
57
      something like this:</para>
58
58
59
    <procedure>
59
    <procedure>
Lines 97-103 Link Here
97
      <quote>traditional</quote> way with FreeBSD.  However, FreeBSD
97
      <quote>traditional</quote> way with FreeBSD.  However, FreeBSD
98
      provides two technologies which can save you a lot of effort:
98
      provides two technologies which can save you a lot of effort:
99
      packages and ports.  At the time of writing, over &os.numports;
99
      packages and ports.  At the time of writing, over &os.numports;
100
      third party applications have been made available in this
100
      third-party applications have been made available in this
101
      way.</para>
101
      way.</para>
102
102
103
    <para>For any given application, the FreeBSD package for that
103
    <para>For any given application, the FreeBSD package for that
Lines 174-184 Link Here
174
	  because they have to run on the maximum number of systems.  By
174
	  because they have to run on the maximum number of systems.  By
175
	  installing from the port, you can tweak the compilation options to
175
	  installing from the port, you can tweak the compilation options to
176
	  (for example) generate code that is specific to a Pentium
176
	  (for example) generate code that is specific to a Pentium
177
	  IV or Athlon processor.</para>
177
	  4 or Athlon processor.</para>
178
      </listitem>
178
      </listitem>
179
179
180
      <listitem>
180
      <listitem>
181
	<para>Some applications have compile time options relating to
181
	<para>Some applications have compile-time options relating to
182
	  what they can and cannot do.  For example,
182
	  what they can and cannot do.  For example,
183
	  <application>Apache</application> can be configured with a
183
	  <application>Apache</application> can be configured with a
184
	  wide variety of different built-in options.  By building
184
	  wide variety of different built-in options.  By building
Lines 193-199 Link Here
193
	  whether or not you have installed an X11 server.  This sort
193
	  whether or not you have installed an X11 server.  This sort
194
	  of rough tweaking is possible with packages, but rapidly
194
	  of rough tweaking is possible with packages, but rapidly
195
	  becomes impossible if an application has more than one or
195
	  becomes impossible if an application has more than one or
196
	  two different compile time options.</para>
196
	  two different compile-time options.</para>
197
      </listitem>
197
      </listitem>
198
198
199
      <listitem>
199
      <listitem>
Lines 238-244 Link Here
238
    </warning>
238
    </warning>
239
239
240
    <para>The remainder of this chapter will explain how to use
240
    <para>The remainder of this chapter will explain how to use
241
      packages and ports to install and manage third party software on
241
      packages and ports to install and manage third-party software on
242
      FreeBSD.</para>
242
      FreeBSD.</para>
243
  </sect1>
243
  </sect1>
244
244
Lines 414-421 Link Here
414
      <para>The example above would download the correct package and
414
      <para>The example above would download the correct package and
415
	add it without any further user intervention.
415
	add it without any further user intervention.
416
	If you want to specify an alternative &os; Packages Mirror,
416
	If you want to specify an alternative &os; Packages Mirror,
417
	instead of the main distribution site, you have to set
417
	instead of the main distribution site, you have to set the
418
	<envar>PACKAGESITE</envar> accordingly, to
418
	<envar>PACKAGESITE</envar> environment variable accordingly, to
419
	override the default settings.  &man.pkg.add.1;
419
	override the default settings.  &man.pkg.add.1;
420
	uses &man.fetch.3; to download the files, which honors various
420
	uses &man.fetch.3; to download the files, which honors various
421
	environment variables, including
421
	environment variables, including
Lines 436-443 Link Here
436
	  &os.stable;.  If you run a -RELEASE version, it will grab
436
	  &os.stable;.  If you run a -RELEASE version, it will grab
437
	  the version of the package that was built with your
437
	  the version of the package that was built with your
438
	  release.  It is possible to change this behavior by
438
	  release.  It is possible to change this behavior by
439
	  overriding the <envar>PACKAGESITE</envar> environment
439
	  overriding <envar>PACKAGESITE</envar>.
440
	  variable.  For example, if you run a &os;&nbsp;5.4-RELEASE
440
	  For example, if you run a &os;&nbsp;5.4-RELEASE
441
	  system, by default &man.pkg.add.1; will try to fetch
441
	  system, by default &man.pkg.add.1; will try to fetch
442
	  packages from
442
	  packages from
443
	  <literal>ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-5.4-release/Latest/</literal>.
443
	  <literal>ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-5.4-release/Latest/</literal>.
Lines 553-558 Link Here
553
      </para>
553
      </para>
554
554
555
      <screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen>
555
      <screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen>
556
557
      <para>Note that &man.pkg.delete.1; requires the full package name
558
      and number; the above command would not work if
559
      <literal>xchat</literal> was given instead of
560
      <literal>xchat-1.7.1</literal>.  It is, however, easy to use
561
      &man.pkg.version.1; to find the version of the installed package.
562
      </para>
556
    </sect2>
563
    </sect2>
557
564
558
    <sect2>
565
    <sect2>
Lines 817-825 Link Here
817
	<listitem>
824
	<listitem>
818
	  <para>A <filename>distinfo</filename> file.  This file
825
	  <para>A <filename>distinfo</filename> file.  This file
819
	    contains information about the files that must be
826
	    contains information about the files that must be
820
	    downloaded to build the port and their checksums, to
827
	    downloaded to build the port, and their checksums
828
	    (using &man.md5.1; and &man.sha256.1;), to
821
	    verify that files have not been corrupted during the
829
	    verify that files have not been corrupted during the
822
	    download using &man.md5.1;.</para>
830
	    download.</para>
823
	</listitem>
831
	</listitem>
824
	
832
	
825
	<listitem>
833
	<listitem>
Lines 985-991 Link Here
985
	    documentation for your shell for more information.</para>
993
	    documentation for your shell for more information.</para>
986
	</note>
994
	</note>
987
995
988
	<para>Some third party DVD-ROM products such as the FreeBSD Toolkit
996
	<para>Some third-party DVD-ROM products such as the FreeBSD Toolkit
989
	  from the <ulink url="http://www.freebsdmall.com/">FreeBSD
997
	  from the <ulink url="http://www.freebsdmall.com/">FreeBSD
990
	  Mall</ulink> contain distfiles.  They can be used with the Ports
998
	  Mall</ulink> contain distfiles.  They can be used with the Ports
991
	  Collection.  Mount the DVD-ROM on <filename>/cdrom</filename>.  If
999
	  Collection.  Mount the DVD-ROM on <filename>/cdrom</filename>.  If

Return to bug 114272