summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorbmah <bmah@FreeBSD.org>2001-08-09 00:35:04 +0000
committerbmah <bmah@FreeBSD.org>2001-08-09 00:35:04 +0000
commita906539d9eb092ad225bc3491a19811fc201fb2a (patch)
tree7879e94ad7cef6af37a834892b77da32415d943e
parentc9f4f4bb728a501c7b5581cb2ff2e7c53f570b85 (diff)
downloadFreeBSD-src-a906539d9eb092ad225bc3491a19811fc201fb2a.zip
FreeBSD-src-a906539d9eb092ad225bc3491a19811fc201fb2a.tar.gz
Collapse the seven *.sgml files containing the content of the README
document into article.sgml. Move the $FreeBSD$ tag from a comment to a <pubdate></pubdate> entry, but no other content or whitespace changes. The two reasons for doing this are to: 1) Get rid of a bunch of itty-bitty files and 2) help with a reorganization of the README that will be much simpler if all the content is in a single file.
-rw-r--r--release/doc/en_US.ISO8859-1/readme/Makefile7
-rw-r--r--release/doc/en_US.ISO8859-1/readme/about.sgml91
-rw-r--r--release/doc/en_US.ISO8859-1/readme/abstract.sgml14
-rw-r--r--release/doc/en_US.ISO8859-1/readme/ack.sgml26
-rw-r--r--release/doc/en_US.ISO8859-1/readme/artheader.sgml13
-rw-r--r--release/doc/en_US.ISO8859-1/readme/article.sgml341
-rw-r--r--release/doc/en_US.ISO8859-1/readme/intro.sgml99
-rw-r--r--release/doc/en_US.ISO8859-1/readme/obtaining.sgml66
-rw-r--r--release/doc/en_US.ISO8859-1/readme/problems.sgml86
-rw-r--r--release/doc/en_US.ISO8859-1/readme/readme.ent15
10 files changed, 331 insertions, 427 deletions
diff --git a/release/doc/en_US.ISO8859-1/readme/Makefile b/release/doc/en_US.ISO8859-1/readme/Makefile
index 6ba0d47..c093acd 100644
--- a/release/doc/en_US.ISO8859-1/readme/Makefile
+++ b/release/doc/en_US.ISO8859-1/readme/Makefile
@@ -15,13 +15,6 @@ INSTALL_ONLY_COMPRESSED?=
# SGML content
SRCS+= article.sgml
-SRCS+= artheader.sgml
-SRCS+= abstract.sgml
-SRCS+= intro.sgml
-SRCS+= about.sgml
-SRCS+= obtaining.sgml
-SRCS+= problems.sgml
-SRCS+= ack.sgml
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/release/doc/en_US.ISO8859-1/readme/about.sgml b/release/doc/en_US.ISO8859-1/readme/about.sgml
deleted file mode 100644
index 7f201c5..0000000
--- a/release/doc/en_US.ISO8859-1/readme/about.sgml
+++ /dev/null
@@ -1,91 +0,0 @@
-<!--
-
-$FreeBSD$
-
-about.sgml
-
-General information about FreeBSD. Most contents of this file
-come from the old ABOUT.TXT.
-
--->
-
-<sect1>
- <title>About &os;</title>
-
- <para>&os; is an operating system based on 4.4 BSD
- Lite for Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC
- hardware and Compaq (formerly DEC) Alpha computers. Versions for
- the IA64 and PowerPC architectures are currently under
- development as well. &os; works with a
- wide variety of peripherals and configurations and can be
- used for everything from software development to games to Internet Service
- Provision.</para>
-
- <para>This release of &os; contains everything you need to run
- such a system, including full source code for the kernel and all
- utilities in the base distribution. With the
- source distribution installed, you can literally recompile the entire
- system from scratch with one command, making it ideal for students,
- researchers, or users who simply want to see how it all works.</para>
-
- <para>A large collection of third-party ported software (the
- <quote>Ports Collection</quote>) is also provided to make it easy
- to obtain and install all your favorite traditional UNIX
- utilities for &os;. Each
- <quote>port</quote> consists of a set of scripts to retrieve,
- configure, build, and install a piece of software, with a single
- command. Over 5000 ports, from editors to programming
- languages to graphical applications, make &os; a powerful and
- comprehensive operating environment that extends far beyond what's
- provided by many commercial versions of UNIX. Most ports are also
- available as pre-compiled <quote>packages</quote>, which can be
- quickly installed from the installation program.</para>
-
- <para>Pointers to more documentation on &os; can be found in the
- <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books
- &amp; Magazines Specific to FreeBSD</ulink> section of the &os; Handbook.
- Because of &os;'s strong UNIX heritage, many other articles and books written
- for UNIX systems are applicable as well. A selection of these documents
- can be found in the Handbook's <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>.
- </para>
-
- <para>If you're new to &os; then you should also read
- all of the documentation files listed in <xref linkend="release-docs">,
- all of which are available from the Documentation menu in the
- installation program.
- It may seem
- like a lot to read, but it's important to at least acquaint yourself with
- the types of information available, should you run into problems later. Once
- the system is installed, you can also revisit this menu by running
- the &man.sysinstall.8; utility.</para>
-
- <para>On-line
- versions of the <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
- (Frequently Asked Questions document) and <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> are always
- available from the <ulink
- url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
- page</ulink> or its mirrors.
- If you install the
- <filename>doc</filename> distribution set, you can use a
- Web browser to read the FAQ and Handbook locally.</para>
-
- <note>
- <para>It is extremely important to read the errata for any given
- release before installing it, to learn about any
- <quote>late-breaking news</quote> or post-release problems.
- The
- errata file accompanying each release
- (most likely right next to this file) is already out of
- date by definition, but other copies are kept updated on the Internet
- and should be consulted as the <quote>current errata</quote> for
- this release. These
- other copies of the errata are located at
- <ulink url="http://www.FreeBSD.org/releases/"></ulink>
- (as well as any sites which keep up-to-date mirrors of this
- location).</para>
- </note>
-</sect1>
diff --git a/release/doc/en_US.ISO8859-1/readme/abstract.sgml b/release/doc/en_US.ISO8859-1/readme/abstract.sgml
deleted file mode 100644
index 9fe1fea..0000000
--- a/release/doc/en_US.ISO8859-1/readme/abstract.sgml
+++ /dev/null
@@ -1,14 +0,0 @@
-<!--
-
-$FreeBSD$
-
-Abstract for the README file.
-
--->
-
-<abstract>
- <para>This document gives a brief introduction to &os;
- &release.current;. It includes a roadmap to the other release
- documentation files, as well as some pointers on obtaining &os; and
- contacting the &os; development team.</para>
-</abstract>
diff --git a/release/doc/en_US.ISO8859-1/readme/ack.sgml b/release/doc/en_US.ISO8859-1/readme/ack.sgml
deleted file mode 100644
index 166f33d..0000000
--- a/release/doc/en_US.ISO8859-1/readme/ack.sgml
+++ /dev/null
@@ -1,26 +0,0 @@
-<!--
-
-$FreeBSD$
-
-ack.sgml
-
-This file is the Acknowledgments section of the old RELNOTES.TXT.
-
--->
-
-<sect1>
- <title>Acknowledgments</title>
-
- <para>&os; represents the cumulative work of many hundreds, if not
- thousands, of individuals from around the world who have worked
- countless hours to bring about this &release.type;.
- For a complete list of &os; developers and contributors, please see
- <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/">Contributors
- to FreeBSD</ulink> on the &os; Web site or any of its mirrors.</para>
-
- <para>Special thanks also go to the many thousands of &os; users and
- testers all over the world, without whom this &release.type; simply would
- not have been possible.</para>
-
-</sect1>
diff --git a/release/doc/en_US.ISO8859-1/readme/artheader.sgml b/release/doc/en_US.ISO8859-1/readme/artheader.sgml
deleted file mode 100644
index a167f56..0000000
--- a/release/doc/en_US.ISO8859-1/readme/artheader.sgml
+++ /dev/null
@@ -1,13 +0,0 @@
-<!-- $FreeBSD$ -->
-
-<articleinfo>
- <title>&os; &release.current; README</title>
-
- <corpauthor>The &os; Project</corpauthor>
-
- <copyright>
- <year>2000</year>
- <year>2001</year>
- <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
- </copyright>
-</articleinfo>
diff --git a/release/doc/en_US.ISO8859-1/readme/article.sgml b/release/doc/en_US.ISO8859-1/readme/article.sgml
index a5161f2..676abad 100644
--- a/release/doc/en_US.ISO8859-1/readme/article.sgml
+++ b/release/doc/en_US.ISO8859-1/readme/article.sgml
@@ -1,5 +1,3 @@
-<!-- $FreeBSD$ -->
-
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;
@@ -9,15 +7,338 @@
%mlists;
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN">
%release;
-<!ENTITY % sections SYSTEM "readme.ent"> %sections;
]>
<article>
-&artheader;
-&abstract;
-&sect.intro;
-&sect.about;
-&sect.obtaining;
-&sect.problems;
-&sect.ack;
+<articleinfo>
+ <title>&os; &release.current; README</title>
+
+ <corpauthor>The &os; Project</corpauthor>
+ <pubdate>$FreeBSD$</pubdate>
+
+ <copyright>
+ <year>2000</year>
+ <year>2001</year>
+ <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder>
+ </copyright>
+</articleinfo>
+<abstract>
+ <para>This document gives a brief introduction to &os;
+ &release.current;. It includes a roadmap to the other release
+ documentation files, as well as some pointers on obtaining &os; and
+ contacting the &os; development team.</para>
+</abstract>
+<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>
+<sect1>
+ <title>About &os;</title>
+
+ <para>&os; is an operating system based on 4.4 BSD
+ Lite for Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC
+ hardware and Compaq (formerly DEC) Alpha computers. Versions for
+ the IA64 and PowerPC architectures are currently under
+ development as well. &os; works with a
+ wide variety of peripherals and configurations and can be
+ used for everything from software development to games to Internet Service
+ Provision.</para>
+
+ <para>This release of &os; contains everything you need to run
+ such a system, including full source code for the kernel and all
+ utilities in the base distribution. With the
+ source distribution installed, you can literally recompile the entire
+ system from scratch with one command, making it ideal for students,
+ researchers, or users who simply want to see how it all works.</para>
+
+ <para>A large collection of third-party ported software (the
+ <quote>Ports Collection</quote>) is also provided to make it easy
+ to obtain and install all your favorite traditional UNIX
+ utilities for &os;. Each
+ <quote>port</quote> consists of a set of scripts to retrieve,
+ configure, build, and install a piece of software, with a single
+ command. Over 5000 ports, from editors to programming
+ languages to graphical applications, make &os; a powerful and
+ comprehensive operating environment that extends far beyond what's
+ provided by many commercial versions of UNIX. Most ports are also
+ available as pre-compiled <quote>packages</quote>, which can be
+ quickly installed from the installation program.</para>
+
+ <para>Pointers to more documentation on &os; can be found in the
+ <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books
+ &amp; Magazines Specific to FreeBSD</ulink> section of the &os; Handbook.
+ Because of &os;'s strong UNIX heritage, many other articles and books written
+ for UNIX systems are applicable as well. A selection of these documents
+ can be found in the Handbook's <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>.
+ </para>
+
+ <para>If you're new to &os; then you should also read
+ all of the documentation files listed in <xref linkend="release-docs">,
+ all of which are available from the Documentation menu in the
+ installation program.
+ It may seem
+ like a lot to read, but it's important to at least acquaint yourself with
+ the types of information available, should you run into problems later. Once
+ the system is installed, you can also revisit this menu by running
+ the &man.sysinstall.8; utility.</para>
+
+ <para>On-line
+ versions of the <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink>
+ (Frequently Asked Questions document) and <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> are always
+ available from the <ulink
+ url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation
+ page</ulink> or its mirrors.
+ If you install the
+ <filename>doc</filename> distribution set, you can use a
+ Web browser to read the FAQ and Handbook locally.</para>
+
+ <note>
+ <para>It is extremely important to read the errata for any given
+ release before installing it, to learn about any
+ <quote>late-breaking news</quote> or post-release problems.
+ The
+ errata file accompanying each release
+ (most likely right next to this file) is already out of
+ date by definition, but other copies are kept updated on the Internet
+ and should be consulted as the <quote>current errata</quote> for
+ this release. These
+ other copies of the errata are located at
+ <ulink url="http://www.FreeBSD.org/releases/"></ulink>
+ (as well as any sites which keep up-to-date mirrors of this
+ location).</para>
+ </note>
+</sect1>
+<sect1>
+ <title>Obtaining &os;</title>
+
+ <para>&os; may be obtained in a variety of ways. This section
+ focuses on those ways that are primarily of use for obtaining a
+ complete &os; distribution, rather than updating an existing
+ installation.</para>
+
+ <sect2>
+ <title>CDROM and DVD</title>
+
+ <para>&os; -RELEASE distributions (for example, 4.3-RELEASE) may
+ be ordered on CDROM or DVD from several publishers. This is
+ frequently the most convenient way to obtain &os; for new
+ installations, as it provides a convenient way to quickly
+ reinstall the system if necessary. Some distributions include
+ some of the optional, precompiled <quote>packages</quote> from the
+ &os; Ports Collection.</para>
+
+ <para>A list of the CDROM and DVD
+ publishers known to the project are listed in the <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining
+ FreeBSD</quote></ulink> appendix to the Handbook.</para>
+ </sect2>
+
+ <sect2>
+ <title>FTP</title>
+
+ <para>You can use FTP to retrieve &os; and any or all of its
+ optional packages from <ulink
+ url="ftp://ftp.FreeBSD.org/"></ulink>, which
+ is the
+ official &os; release site, or any of its <quote>mirrors</quote>.</para>
+
+ <para>Lists of locations that mirror &os;
+ can be found in the <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">FTP
+ Sites</ulink> section of the Handbook, or on the
+ <ulink url="http://www.freebsdmirrors.org/"></ulink> Web pages.
+ Finding a close (in networking terms) mirror from which to
+ download the distribution is highly recommended.</para>
+
+ <para>Additional mirror sites are
+ always welcome.
+ Contact <email>freebsd-admin@FreeBSD.org</email> for more
+ details on becoming an official mirror site.</para>
+
+ <para>Mirrors generally contain the floppy disk images necessary
+ to begin an installation, as well as the distribution files needed
+ for the install process itself. Some mirrors also contain some of
+ the ISO images necessary to create a CDROM of a &os; release.</para>
+
+ </sect2>
+</sect1>
+<sect1 id="contacting">
+ <title>Contacting the &os; Project</title>
+
+ <sect2>
+ <title>Email and Mailing Lists</title>
+ <para>For any questions or general technical support issues, please send
+ mail to the &a.questions;.</para>
+
+ <para>If you're tracking the -current development efforts, you
+ <emphasis>must</emphasis> join the &a.current;, in order to keep
+ abreast of recent developments and changes that may affect the way
+ you use and maintain the system.
+
+ <para>Additionally, being a largely-volunteer effort, the &os;
+ Project is always happy to
+ have extra hands willing to help &mdash; there are already far more
+ desired enhancements than there is time to implement them.
+ To contact the developers on technical matters, or with offers of help, please
+ send mail to the &a.hackers;.</para>
+
+ <para>Please note that these mailing lists can experience
+ <emphasis>significant</emphasis> amounts of traffic and if you have
+ slow or expensive mail access and are only interested in keeping up
+ with significant &os; events, you may find it preferable to
+ subscribe instead to the &a.announce;.</para>
+
+ <para>All of the mailing lists can be freely joined by anyone
+ wishing to do so. Send mail to &a.majordomo;
+ and include the keyword <literal>help</literal> on a line by itself
+ somewhere in the body of the message. This will give you more
+ information on joining the various lists, accessing archives, etc.
+ There are a number of mailing lists targeted at special interest
+ groups not mentioned here; more information can be obtained either
+ through majordomo or the <ulink
+ url="http://www.FreeBSD.org/support.html#mailing-list">mailing lists
+ section</ulink> of the &os; Web site.</para>
+
+ <important>
+ <para>Do <emphasis>not</emphasis> send email to the lists asking to
+ be subscribed. Use the &a.majordomo; address
+ instead.</para>
+ </important>
+ </sect2>
+
+ <sect2>
+ <title>Submitting Problem Reports</title>
+
+ <para>Suggestions, bug reports and contributions of code are
+ always valued &mdash; please do not hesitate to report any problems you
+ may find. Bug reports with attached fixes are of course even more
+ welcome.</para>
+
+ <para>The preferred method to submit bug reports from a machine with
+ Internet mail connectivity is to use the &man.send-pr.1; command or
+ use the Web form at <ulink
+ url="http://www.FreeBSD.org/send-pr.html">http://www.FreeBSD.org/send-pr.html</ulink>.
+ <quote>Problem Reports</quote> (PRs) submitted in this way will be filed and
+ their progress tracked; the &os; developers will do their best to respond to all
+ reported bugs as soon as possible. <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list of all active PRs</ulink> is
+ available on the &os; Web site; this list is useful to see what
+ potential problems other users have encountered.</para>
+
+ <para>Note that &man.send-pr.1; itself is a shell script that should
+ be easy to move even onto a non-&os; system. Using this interface
+ is highly preferred.
+ If, for some reason, you are unable to use &man.send-pr.1; to
+ submit a bug report, you can try to send it to the &a.bugs;.</para>
+
+ <para>In any case, before submitting a PR,
+ please try to determine whether the problem might have already been
+ fixed since.</para>
+
+ </sect2>
+
+</sect1>
+<sect1>
+ <title>Acknowledgments</title>
+
+ <para>&os; represents the cumulative work of many hundreds, if not
+ thousands, of individuals from around the world who have worked
+ countless hours to bring about this &release.type;.
+ For a complete list of &os; developers and contributors, please see
+ <ulink
+ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/">Contributors
+ to FreeBSD</ulink> on the &os; Web site or any of its mirrors.</para>
+
+ <para>Special thanks also go to the many thousands of &os; users and
+ testers all over the world, without whom this &release.type; simply would
+ not have been possible.</para>
+
+</sect1>
</article>
diff --git a/release/doc/en_US.ISO8859-1/readme/intro.sgml b/release/doc/en_US.ISO8859-1/readme/intro.sgml
deleted file mode 100644
index 6e9a398..0000000
--- a/release/doc/en_US.ISO8859-1/readme/intro.sgml
+++ /dev/null
@@ -1,99 +0,0 @@
-<!--
-
-$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>
diff --git a/release/doc/en_US.ISO8859-1/readme/obtaining.sgml b/release/doc/en_US.ISO8859-1/readme/obtaining.sgml
deleted file mode 100644
index 7af1b30..0000000
--- a/release/doc/en_US.ISO8859-1/readme/obtaining.sgml
+++ /dev/null
@@ -1,66 +0,0 @@
-<!--
-
-$FreeBSD$
-
-obtaining.sgml
-
-Information on getting a copy of FreeBSD. This text used to
-be the "Obtaining FreeBSD" section of RELNOTES.TXT.
--->
-
-<sect1>
- <title>Obtaining &os;</title>
-
- <para>&os; may be obtained in a variety of ways. This section
- focuses on those ways that are primarily of use for obtaining a
- complete &os; distribution, rather than updating an existing
- installation.</para>
-
- <sect2>
- <title>CDROM and DVD</title>
-
- <para>&os; -RELEASE distributions (for example, 4.3-RELEASE) may
- be ordered on CDROM or DVD from several publishers. This is
- frequently the most convenient way to obtain &os; for new
- installations, as it provides a convenient way to quickly
- reinstall the system if necessary. Some distributions include
- some of the optional, precompiled <quote>packages</quote> from the
- &os; Ports Collection.</para>
-
- <para>A list of the CDROM and DVD
- publishers known to the project are listed in the <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining
- FreeBSD</quote></ulink> appendix to the Handbook.</para>
- </sect2>
-
- <sect2>
- <title>FTP</title>
-
- <para>You can use FTP to retrieve &os; and any or all of its
- optional packages from <ulink
- url="ftp://ftp.FreeBSD.org/"></ulink>, which
- is the
- official &os; release site, or any of its <quote>mirrors</quote>.</para>
-
- <para>Lists of locations that mirror &os;
- can be found in the <ulink
- url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">FTP
- Sites</ulink> section of the Handbook, or on the
- <ulink url="http://www.freebsdmirrors.org/"></ulink> Web pages.
- Finding a close (in networking terms) mirror from which to
- download the distribution is highly recommended.</para>
-
- <para>Additional mirror sites are
- always welcome.
- Contact <email>freebsd-admin@FreeBSD.org</email> for more
- details on becoming an official mirror site.</para>
-
- <para>Mirrors generally contain the floppy disk images necessary
- to begin an installation, as well as the distribution files needed
- for the install process itself. Some mirrors also contain some of
- the ISO images necessary to create a CDROM of a &os; release.</para>
-
- </sect2>
-</sect1>
-
-
diff --git a/release/doc/en_US.ISO8859-1/readme/problems.sgml b/release/doc/en_US.ISO8859-1/readme/problems.sgml
deleted file mode 100644
index 39755ed..0000000
--- a/release/doc/en_US.ISO8859-1/readme/problems.sgml
+++ /dev/null
@@ -1,86 +0,0 @@
-<!--
-
-$FreeBSD$
-
-problems.sgml
-
-Information on contacting the FreeBSD project, originally from
-RELNOTES.TXT.
-
--->
-
-<sect1 id="contacting">
- <title>Contacting the &os; Project</title>
-
- <sect2>
- <title>Email and Mailing Lists</title>
- <para>For any questions or general technical support issues, please send
- mail to the &a.questions;.</para>
-
- <para>If you're tracking the -current development efforts, you
- <emphasis>must</emphasis> join the &a.current;, in order to keep
- abreast of recent developments and changes that may affect the way
- you use and maintain the system.
-
- <para>Additionally, being a largely-volunteer effort, the &os;
- Project is always happy to
- have extra hands willing to help &mdash; there are already far more
- desired enhancements than there is time to implement them.
- To contact the developers on technical matters, or with offers of help, please
- send mail to the &a.hackers;.</para>
-
- <para>Please note that these mailing lists can experience
- <emphasis>significant</emphasis> amounts of traffic and if you have
- slow or expensive mail access and are only interested in keeping up
- with significant &os; events, you may find it preferable to
- subscribe instead to the &a.announce;.</para>
-
- <para>All of the mailing lists can be freely joined by anyone
- wishing to do so. Send mail to &a.majordomo;
- and include the keyword <literal>help</literal> on a line by itself
- somewhere in the body of the message. This will give you more
- information on joining the various lists, accessing archives, etc.
- There are a number of mailing lists targeted at special interest
- groups not mentioned here; more information can be obtained either
- through majordomo or the <ulink
- url="http://www.FreeBSD.org/support.html#mailing-list">mailing lists
- section</ulink> of the &os; Web site.</para>
-
- <important>
- <para>Do <emphasis>not</emphasis> send email to the lists asking to
- be subscribed. Use the &a.majordomo; address
- instead.</para>
- </important>
- </sect2>
-
- <sect2>
- <title>Submitting Problem Reports</title>
-
- <para>Suggestions, bug reports and contributions of code are
- always valued &mdash; please do not hesitate to report any problems you
- may find. Bug reports with attached fixes are of course even more
- welcome.</para>
-
- <para>The preferred method to submit bug reports from a machine with
- Internet mail connectivity is to use the &man.send-pr.1; command or
- use the Web form at <ulink
- url="http://www.FreeBSD.org/send-pr.html">http://www.FreeBSD.org/send-pr.html</ulink>.
- <quote>Problem Reports</quote> (PRs) submitted in this way will be filed and
- their progress tracked; the &os; developers will do their best to respond to all
- reported bugs as soon as possible. <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list of all active PRs</ulink> is
- available on the &os; Web site; this list is useful to see what
- potential problems other users have encountered.</para>
-
- <para>Note that &man.send-pr.1; itself is a shell script that should
- be easy to move even onto a non-&os; system. Using this interface
- is highly preferred.
- If, for some reason, you are unable to use &man.send-pr.1; to
- submit a bug report, you can try to send it to the &a.bugs;.</para>
-
- <para>In any case, before submitting a PR,
- please try to determine whether the problem might have already been
- fixed since.</para>
-
- </sect2>
-
-</sect1>
diff --git a/release/doc/en_US.ISO8859-1/readme/readme.ent b/release/doc/en_US.ISO8859-1/readme/readme.ent
deleted file mode 100644
index 2eef9f2..0000000
--- a/release/doc/en_US.ISO8859-1/readme/readme.ent
+++ /dev/null
@@ -1,15 +0,0 @@
-<!-- -*- sgml -*- -->
-<!-- $FreeBSD$ -->
-
-<!-- Text constants which probably don't need to be changed.-->
-
-<!-- Files to be included -->
-
-<!ENTITY artheader SYSTEM "artheader.sgml">
-<!ENTITY abstract SYSTEM "abstract.sgml">
-<!ENTITY sect.intro SYSTEM "intro.sgml">
-<!ENTITY sect.about SYSTEM "about.sgml">
-<!ENTITY sect.obtaining SYSTEM "obtaining.sgml">
-<!ENTITY sect.problems SYSTEM "problems.sgml">
-<!ENTITY sect.ack SYSTEM "ack.sgml">
-
OpenPOWER on IntegriCloud