Deleted Added
sdiff udiff text old ( 81327 ) new ( 81339 )
full compact
article.xml (81327) article.xml (81339)
1<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
2<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
3%man;
4<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
5%authors;
6<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN">
7%mlists;
8<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
9%release;
10]>
11
12<article>
13<articleinfo>
14 <title>&os; &release.current; README</title>
15
16 <corpauthor>The &os; Project</corpauthor>
1<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
2<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
3%man;
4<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
5%authors;
6<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN">
7%mlists;
8<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
9%release;
10]>
11
12<article>
13<articleinfo>
14 <title>&os; &release.current; README</title>
15
16 <corpauthor>The &os; Project</corpauthor>
17 <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/readme/article.sgml 81327 2001-08-09 00:35:04Z bmah $</pubdate>
17 <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/readme/article.sgml 81339 2001-08-09 04:27:11Z bmah $</pubdate>
18
19 <copyright>
20 <year>2000</year>
21 <year>2001</year>
22 <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
23 </copyright>
24</articleinfo>
25<abstract>

--- 4 unchanged lines hidden (view full) ---

30</abstract>
31<sect1>
32 <title>Introduction</title>
33
34 <para>This distribution is a &release.type; of &os; &release.current;, the
35 latest point along the &release.branch; branch.</para>
36
37 <sect2>
18
19 <copyright>
20 <year>2000</year>
21 <year>2001</year>
22 <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
23 </copyright>
24</articleinfo>
25<abstract>

--- 4 unchanged lines hidden (view full) ---

30</abstract>
31<sect1>
32 <title>Introduction</title>
33
34 <para>This distribution is a &release.type; of &os; &release.current;, the
35 latest point along the &release.branch; branch.</para>
36
37 <sect2>
38 <title>Target Audience</title>
39
40<![ %release.type.snapshot; [
41 <para>This &release.type; is aimed primarily at early adopters and
42 various other users who want to get involved with the ongoing
43 development of &os;. While the &os; development team tries its
44 best to ensure that each &release.type; works as
45 advertised, &release.branch; is very much a work-in-progress.</para>
46
47 <para>The basic requirements for using this &release.type are
48 technical proficiency with &os; and an understanding of the ongoing
49 development process of &os; &release.current;
50 (as discussed on the &a.current;).</para>
51
52 <para>For those more interested
53 in doing business with &os; than in experimenting with new &os;
54 technology, formal releases (such as &release.prev;) are frequently more
55 appropriate. Releases undergo a period of testing and quality
56 assurance checking to ensure high reliability and dependability.</para>
57]]>
58
59<![ %release.type.release; [
60 <para>This &release.type; of &os; is suitable for all users. It has
61 undergone a period of testing and quality assurance
62 checking to ensure the highest reliability and dependability.</para>
63]]>
64
65 </sect2>
66
67 <sect2 id="release-docs">
68 <title>Release Documentation</title>
69
70 <para>A number of other files provide more specific information
71 about this &release.type; distribution. These files are provided
72 in various formats. Most distributions will include both ASCII
73 text (<filename>.TXT</filename>) and HTML
74 (<filename>.HTM</filename>) renditions. Some distributions may
75 also include other formats such as PostScript
76 (<filename>.PS</filename>) or Portable Document Format
77 (<filename>.PDF</filename>).
78
79 <itemizedlist>
80 <listitem>
81 <para><filename>README.TXT</filename>: This file, which
82 gives some general information about &os; as well as some
83 cursory notes about obtaining a distribution.</para>
84 </listitem>
85 <listitem>
86 <para><filename>RELNOTES.TXT</filename>: The release notes,
87 showing what's new and different in &os; &release.current;
88 compared to &os; &release.prev;.</para>
89 </listitem>
90 <listitem>
91 <para><filename>HARDWARE.TXT</filename>: The hardware
92 compatability list, showing devices with which &os; has been
93 tested and is known to work.</para>
94 </listitem>
95 <listitem>
96 <para><filename>INSTALL.TXT</filename>: Installation
97 instructions for installing &os; from its distribution
98 media.</para>
99 </listitem>
100 <listitem>
101 <para><filename>ERRATA.TXT</filename>: Release errata.
102 Late-breaking, post-release information can be found in this
103 file, which is principally applicable to releases (as opposed to
104 snapshots). It is important to consult this file before
105 installing a release of &os;, as it contains
106 the latest information on problems which have been found and
107 fixed since the release was created.</para>
108 </listitem>
109 </itemizedlist>
110
111 </para>
112
113 <para>Most information is also available from the
114 Documentation menu during installation.</para>
115
116 </sect2>
117
118</sect1>
119<sect1>
120 <title>About &os;</title>
121
122 <para>&os; is an operating system based on 4.4 BSD
123 Lite for Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC
124 hardware and Compaq (formerly DEC) Alpha computers. Versions for
125 the IA64 and PowerPC architectures are currently under
126 development as well. &os; works with a
127 wide variety of peripherals and configurations and can be

--- 14 unchanged lines hidden (view full) ---

142 <quote>port</quote> consists of a set of scripts to retrieve,
143 configure, build, and install a piece of software, with a single
144 command. Over 5000 ports, from editors to programming
145 languages to graphical applications, make &os; a powerful and
146 comprehensive operating environment that extends far beyond what's
147 provided by many commercial versions of UNIX. Most ports are also
148 available as pre-compiled <quote>packages</quote>, which can be
149 quickly installed from the installation program.</para>
38 <title>About &os;</title>
39
40 <para>&os; is an operating system based on 4.4 BSD
41 Lite for Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC
42 hardware and Compaq (formerly DEC) Alpha computers. Versions for
43 the IA64 and PowerPC architectures are currently under
44 development as well. &os; works with a
45 wide variety of peripherals and configurations and can be

--- 14 unchanged lines hidden (view full) ---

60 <quote>port</quote> consists of a set of scripts to retrieve,
61 configure, build, and install a piece of software, with a single
62 command. Over 5000 ports, from editors to programming
63 languages to graphical applications, make &os; a powerful and
64 comprehensive operating environment that extends far beyond what's
65 provided by many commercial versions of UNIX. Most ports are also
66 available as pre-compiled <quote>packages</quote>, which can be
67 quickly installed from the installation program.</para>
68 </sect2>
150
69
151 <para>Pointers to more documentation on &os; can be found in the
152 <ulink
153 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books
154 &amp; Magazines Specific to FreeBSD</ulink> section of the &os; Handbook.
155 Because of &os;'s strong UNIX heritage, many other articles and books written
156 for UNIX systems are applicable as well. A selection of these documents
157 can be found in the Handbook's <ulink
158 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>.
159 </para>
70 <sect2>
71 <title>Target Audience</title>
160
72
161 <para>If you're new to &os; then you should also read
162 all of the documentation files listed in <xref linkend="release-docs">,
163 all of which are available from the Documentation menu in the
164 installation program.
165 It may seem
166 like a lot to read, but it's important to at least acquaint yourself with
167 the types of information available, should you run into problems later. Once
168 the system is installed, you can also revisit this menu by running
169 the &man.sysinstall.8; utility.</para>
73<![ %release.type.snapshot; [
74 <para>This &release.type; is aimed primarily at early adopters and
75 various other users who want to get involved with the ongoing
76 development of &os;. While the &os; development team tries its
77 best to ensure that each &release.type; works as
78 advertised, &release.branch; is very much a work-in-progress.</para>
170
79
171 <para>On-line
172 versions of the <ulink
173 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
174 (Frequently Asked Questions document) and <ulink
175 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> are always
176 available from the <ulink
177 url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
178 page</ulink> or its mirrors.
179 If you install the
180 <filename>doc</filename> distribution set, you can use a
181 Web browser to read the FAQ and Handbook locally.</para>
80 <para>The basic requirements for using this &release.type are
81 technical proficiency with &os; and an understanding of the ongoing
82 development process of &os; &release.current;
83 (as discussed on the &a.current;).</para>
182
84
183 <note>
184 <para>It is extremely important to read the errata for any given
185 release before installing it, to learn about any
186 <quote>late-breaking news</quote> or post-release problems.
187 The
188 errata file accompanying each release
189 (most likely right next to this file) is already out of
190 date by definition, but other copies are kept updated on the Internet
191 and should be consulted as the <quote>current errata</quote> for
192 this release. These
193 other copies of the errata are located at
194 <ulink url="http://www.FreeBSD.org/releases/"></ulink>
195 (as well as any sites which keep up-to-date mirrors of this
196 location).</para>
197 </note>
198</sect1>
85 <para>For those more interested
86 in doing business with &os; than in experimenting with new &os;
87 technology, formal releases (such as &release.prev;) are frequently more
88 appropriate. Releases undergo a period of testing and quality
89 assurance checking to ensure high reliability and dependability.</para>
90]]>
91
92<![ %release.type.release; [
93 <para>This &release.type; of &os; is suitable for all users. It has
94 undergone a period of testing and quality assurance
95 checking to ensure the highest reliability and dependability.</para>
96]]>
97
98 </sect2>
99
199<sect1>
200 <title>Obtaining &os;</title>
201
202 <para>&os; may be obtained in a variety of ways. This section
203 focuses on those ways that are primarily of use for obtaining a
204 complete &os; distribution, rather than updating an existing
205 installation.</para>
206

--- 113 unchanged lines hidden (view full) ---

320
321 <para>In any case, before submitting a PR,
322 please try to determine whether the problem might have already been
323 fixed since.</para>
324
325 </sect2>
326
327</sect1>
100<sect1>
101 <title>Obtaining &os;</title>
102
103 <para>&os; may be obtained in a variety of ways. This section
104 focuses on those ways that are primarily of use for obtaining a
105 complete &os; distribution, rather than updating an existing
106 installation.</para>
107

--- 113 unchanged lines hidden (view full) ---

221
222 <para>In any case, before submitting a PR,
223 please try to determine whether the problem might have already been
224 fixed since.</para>
225
226 </sect2>
227
228</sect1>
229
328<sect1>
230<sect1>
231 <title>Further Reading</title>
232
233 <sect2 id="release-docs">
234 <title>Release Documentation</title>
235
236 <para>A number of other files provide more specific information
237 about this &release.type; distribution. These files are provided
238 in various formats. Most distributions will include both ASCII
239 text (<filename>.TXT</filename>) and HTML
240 (<filename>.HTM</filename>) renditions. Some distributions may
241 also include other formats such as PostScript
242 (<filename>.PS</filename>) or Portable Document Format
243 (<filename>.PDF</filename>).
244
245 <itemizedlist>
246 <listitem>
247 <para><filename>README.TXT</filename>: This file, which
248 gives some general information about &os; as well as some
249 cursory notes about obtaining a distribution.</para>
250 </listitem>
251 <listitem>
252 <para><filename>RELNOTES.TXT</filename>: The release notes,
253 showing what's new and different in &os; &release.current;
254 compared to &os; &release.prev;.</para>
255 </listitem>
256 <listitem>
257 <para><filename>HARDWARE.TXT</filename>: The hardware
258 compatability list, showing devices with which &os; has been
259 tested and is known to work.</para>
260 </listitem>
261 <listitem>
262 <para><filename>INSTALL.TXT</filename>: Installation
263 instructions for installing &os; from its distribution
264 media.</para>
265 </listitem>
266 <listitem>
267 <para><filename>ERRATA.TXT</filename>: Release errata.
268 Late-breaking, post-release information can be found in this
269 file, which is principally applicable to releases (as opposed to
270 snapshots). It is important to consult this file before
271 installing a release of &os;, as it contains
272 the latest information on problems which have been found and
273 fixed since the release was created.</para>
274 </listitem>
275 </itemizedlist>
276
277 </para>
278
279 <para>Most information is also available from the
280 Documentation menu during installation.</para>
281
282 </sect2>
283
284 <sect2>
285
286 <title>Books and Articles</title>
287
288 <para>Pointers to more documentation on &os; can be found in the
289 <ulink
290 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books
291 &amp; Magazines Specific to FreeBSD</ulink> section of the &os; Handbook.
292 Because of &os;'s strong UNIX heritage, many other articles and books written
293 for UNIX systems are applicable as well. A selection of these documents
294 can be found in the Handbook's <ulink
295 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>.
296 </para>
297
298 <para>If you're new to &os; then you should also read
299 all of the documentation files listed in <xref linkend="release-docs">,
300 all of which are available from the Documentation menu in the
301 installation program.
302 It may seem
303 like a lot to read, but it's important to at least acquaint yourself with
304 the types of information available, should you run into problems later. Once
305 the system is installed, you can also revisit this menu by running
306 the &man.sysinstall.8; utility.</para>
307
308 <para>On-line
309 versions of the <ulink
310 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
311 (Frequently Asked Questions document) and <ulink
312 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> are always
313 available from the <ulink
314 url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
315 page</ulink> or its mirrors.
316 If you install the
317 <filename>doc</filename> distribution set, you can use a
318 Web browser to read the FAQ and Handbook locally.</para>
319
320 <note>
321 <para>It is extremely important to read the errata for any given
322 release before installing it, to learn about any
323 <quote>late-breaking news</quote> or post-release problems.
324 The
325 errata file accompanying each release
326 (most likely right next to this file) is already out of
327 date by definition, but other copies are kept updated on the Internet
328 and should be consulted as the <quote>current errata</quote> for
329 this release. These
330 other copies of the errata are located at
331 <ulink url="http://www.FreeBSD.org/releases/"></ulink>
332 (as well as any sites which keep up-to-date mirrors of this
333 location).</para>
334 </note>
335 </sect2>
336</sect1>
337
338<sect1>
329 <title>Acknowledgments</title>
330
331 <para>&os; represents the cumulative work of many hundreds, if not
332 thousands, of individuals from around the world who have worked
333 countless hours to bring about this &release.type;.
334 For a complete list of &os; developers and contributors, please see
335 <ulink
336 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/">Contributors
337 to FreeBSD</ulink> on the &os; Web site or any of its mirrors.</para>
338
339 <para>Special thanks also go to the many thousands of &os; users and
340 testers all over the world, without whom this &release.type; simply would
341 not have been possible.</para>
342
343</sect1>
344</article>
339 <title>Acknowledgments</title>
340
341 <para>&os; represents the cumulative work of many hundreds, if not
342 thousands, of individuals from around the world who have worked
343 countless hours to bring about this &release.type;.
344 For a complete list of &os; developers and contributors, please see
345 <ulink
346 url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/">Contributors
347 to FreeBSD</ulink> on the &os; Web site or any of its mirrors.</para>
348
349 <para>Special thanks also go to the many thousands of &os; users and
350 testers all over the world, without whom this &release.type; simply would
351 not have been possible.</para>
352
353</sect1>
354</article>