summaryrefslogtreecommitdiffstats
path: root/release/doc/en_US.ISO8859-1/readme/intro.sgml
blob: 6e9a398bc5459a80fc3da18d18d225d38eeca058 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<!--

$FreeBSD$

intro.sgml

Introduction to the README file.  Most text here comes from the
old README.TXT (the file with Chuck in ASCII art).

-->

<sect1>
  <title>Introduction</title>

  <para>This distribution is a &release.type; of &os; &release.current;, the
  latest point along the &release.branch; branch.</para>

  <sect2>
    <title>Target Audience</title>

<![ %release.type.snapshot; [
    <para>This &release.type; is aimed primarily at early adopters and
    various other users who want to get involved with the ongoing
    development of &os;.  While the &os; development team tries its
    best to ensure that each &release.type; works as
    advertised, &release.branch; is very much a work-in-progress.</para>

    <para>The basic requirements for using this &release.type are
    technical proficiency with &os; and an understanding of the ongoing
    development process of &os; &release.current; 
    (as discussed on the &a.current;).</para>

    <para>For those more interested
    in doing business with &os; than in experimenting with new &os; 
    technology, formal releases (such as &release.prev;) are frequently more
    appropriate.  Releases undergo a period of testing and quality
    assurance checking to ensure high reliability and dependability.</para>
]]>

<![ %release.type.release; [
    <para>This &release.type; of &os; is suitable for all users.  It has
    undergone a period of testing and quality assurance
    checking to ensure the highest reliability and dependability.</para>
]]>

  </sect2>

  <sect2 id="release-docs">
    <title>Release Documentation</title>

    <para>A number of other files provide more specific information
    about this &release.type; distribution.  These files are provided
    in various formats.  Most distributions will include both ASCII
    text (<filename>.TXT</filename>) and HTML
    (<filename>.HTM</filename>) renditions.  Some distributions may
    also include other formats such as PostScript
    (<filename>.PS</filename>) or Portable Document Format
    (<filename>.PDF</filename>).

      <itemizedlist>
        <listitem>
	  <para><filename>README.TXT</filename>: This file, which
	  gives some general information about &os; as well as some
	  cursory notes about obtaining a distribution.</para>
        </listitem>
        <listitem>
	  <para><filename>RELNOTES.TXT</filename>: The release notes,
	  showing what's new and different in &os; &release.current;
	  compared to &os; &release.prev;.</para>
        </listitem>
        <listitem>
	  <para><filename>HARDWARE.TXT</filename>: The hardware
	  compatability list, showing devices with which &os; has been
	  tested and is known to work.</para>
        </listitem>
	<listitem>
	  <para><filename>INSTALL.TXT</filename>: Installation
	  instructions for installing &os; from its distribution 
	  media.</para>
	</listitem>
        <listitem>
	  <para><filename>ERRATA.TXT</filename>: Release errata.
	  Late-breaking, post-release information can be found in this
	  file, which is principally applicable to releases (as opposed to
	  snapshots).  It is important to consult this file before
	  installing a release of &os;, as it contains
	  the latest information on problems which have been found and
	  fixed since the release was created.</para>
        </listitem>
      </itemizedlist>

    </para>

    <para>Most information is also available from the
    Documentation menu during installation.</para>

  </sect2>

</sect1>
OpenPOWER on IntegriCloud