1 | <sect1 id="aa-intro">
|
---|
2 | <title>Introduction</title>
|
---|
3 | <?dbhtml filename="introduction.html" dir="appendixa"?>
|
---|
4 |
|
---|
5 | <para>This appendix describes the following aspects of every package
|
---|
6 | that is installed in this book:</para>
|
---|
7 |
|
---|
8 | <itemizedlist>
|
---|
9 |
|
---|
10 | <listitem><para>The official download location for the
|
---|
11 | package.</para></listitem>
|
---|
12 |
|
---|
13 | <listitem><para>What the package contains.</para></listitem>
|
---|
14 |
|
---|
15 | <listitem><para>What each program from a package does.</para></listitem>
|
---|
16 |
|
---|
17 | <listitem><para>What each package needs to compile.</para></listitem>
|
---|
18 |
|
---|
19 | </itemizedlist>
|
---|
20 |
|
---|
21 | <para>Most information about these packages (especially the descriptions of
|
---|
22 | them) come from the man pages from those packages. We are not going to print
|
---|
23 | the entire man page, just the core elements to make it possible to
|
---|
24 | understand what a program does. To get knowledge of all details on a program,
|
---|
25 | we suggest you start by reading the complete man page in addition to
|
---|
26 | this appendix.</para>
|
---|
27 |
|
---|
28 | <para>Certain packages are documented in more depth
|
---|
29 | than others, because we just happen to know more about certain
|
---|
30 | packages than I know about others. If anything should be added to the
|
---|
31 | following descriptions, please don't hesitate to email the mailing
|
---|
32 | lists. We intend that the list should contain an in-depth description
|
---|
33 | of every package installed, but we can't do it without help.</para>
|
---|
34 |
|
---|
35 | <para>Please note that currently only what a package does is described and not
|
---|
36 | why it needs to be installed. This may be added later.</para>
|
---|
37 |
|
---|
38 | <para>Also listed are all of the installation dependencies for all the
|
---|
39 | packages that are installed in this book. The listings will include
|
---|
40 | which programs from which packages are needed to successfully compile
|
---|
41 | the package to be installed.</para>
|
---|
42 |
|
---|
43 | <para>These are not running dependencies, meaning they don't tell you
|
---|
44 | what programs are needed to use that packages programs. Just the ones
|
---|
45 | needed to compile it.</para>
|
---|
46 |
|
---|
47 | <para>The dependency list can be, from time to time, outdated in regards
|
---|
48 | to the current used package version. Checking dependencies takes quite a
|
---|
49 | bit of work, so they may lag behind a bit on the package update. But
|
---|
50 | often with minor package updates, the installation dependencies hardly
|
---|
51 | change, so they'll be current in most cases. If we upgrade to a major
|
---|
52 | new release, we'll make sure the dependencies are checked too at the
|
---|
53 | same time.</para>
|
---|
54 |
|
---|
55 | </sect1>
|
---|
56 |
|
---|