Convert README doc from DocBook SGML to DocBook XML

Uses newer tools for formatting, better matching other new docs
Moved from sgml/README.sgml to general/README.xml

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>

2 files changed, 346 insertions, 0 deletions

diff --git a/general/Makefile.am b/general/Makefile.am
index dc5bdf3..57a13d9 100644
--- a/general/Makefile.am
+++ b/general/Makefile.am
@@ -4,6 +4,7 @@ SUBDIRS = fonts input graphics
 
 doc_sources = \
 	License.xml \
+	README.xml \
 	ReleaseNotes.xml
 
 xmldir = $(docdir)
diff --git a/general/README.xml b/general/README.xml
new file mode 100644
index 0000000..7c11e27
--- /dev/null
+++ b/general/README.xml
@@ -0,0 +1,345 @@
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "/xorg-sgml-doctools/X11/defs.ent"> %defs;
+]>
+
+<article>
+
+<articleinfo>
+
+<title>README for X11R&relvers;</title>
+
+<corpauthor><ulink url="http://www.x.org/wiki/XorgFoundation">
+The X.Org Foundation
+</ulink></corpauthor>
+
+<pubdate>&reldate;</pubdate>
+
+<abstract>
+
+<para>
+X11R&relvers; is an Open Source version of the X Window System that
+supports many <trademark class="registered">UNIX</trademark> and UNIX-like
+operating systems (such as Linux, FreeBSD, NetBSD, OpenBSD, and Solaris)
+on a variety of platforms.  This version is compatible with
+X11R&prevrelvers; and other X Window System implementations which support
+the X11 standard.
+</para>
+
+</abstract>
+
+</articleinfo>
+
+<sect1>
+<title>What is X11R&relvers;?</title>
+
+<!-- We only do release notes for full releases now.
+<![ %updaterel [
+<para>
+X11R&relvers; is the &whichupdaterel; update to X11R&majorvers;, the
+&whichfullrel; full release in the <![ %earlyrel; [new]]> X11R&relvers;
+series.
+</para>
+<para>
+Update releases are taken from a stable/maintenance branch. They are
+designed to be installed on top of the full release that they are updating.
+They contain fixes for serious problems, most commonly fixes for security
+issues, fixes for driver bugs, and fixes that improve stability.
+</para>
+]]>
+
+<![ %minorrel [
+-->
+<para>
+X11R&relvers; is the &whichfullrel; release in the X11R&majorvers; series.
+Tarballs for packages that have had updates since the &prevrelvers; release
+are included in this release. To build this release, you will first need to
+get the packages from X11R&prevrelvers; and then add the new packages from
+X11R&relvers; to them.
+</para>
+<!--
+]]>
+
+<![ %snapshot [
+<para>
+X11R&relvers; is a pre-release snapshot of X11R&fullrelvers;.
+<![ %relcandidate [
+This snapshot is a release candidate &rcnum; for version &fullrelvers;.
+]]>
+Pre-release snapshots are provided for beta testing. You should only
+install snapshots if you're comfortable dealing with possibly unstable
+beta-level software. If you find problems with this snapshot, you are
+encouraged to report your findings to the public X.Org server mailing list:
+<email>xorg@lists.freedesktop.org</email>.
+</para>
+]]>
+ -->
+
+<para>
+<!--
+<![ %majorrel [
+X11R&relvers; is the first release in the new X11R&majorvers; series.
+The &relvers; version is a new major release that includes additional
+hardware support, functional enhancements and bug fixes.
+]]>
+<![ %minorrel [
+The &relvers; version is a new minor release that includes additional
+hardware support, functional enhancements and bug fixes.
+]]>
+<![ %haverelnotes [
+ -->
+Specific release enhancements can be viewed in the <ulink
+url="ReleaseNotes.html">Release Notes</ulink>.
+<!--
+]]>
+ -->
+</para>
+
+<para>
+Most modern PC video hardware is supported in this release, and most PC
+video hardware that isn't supported explicitly can be used with the
+"vesa" driver.  The <ulink
+url="ReleaseNotes.html">Release Notes</ulink>
+has a table showing the drivers provided with X11R&relvers;, and links to
+related documentation.
+</para>
+
+<para>
+The X.Org Foundation X releases are produced by the X.Org Foundation.
+The X.Org Foundation has been formed as a Delaware corporation organized
+to operate as a scientific charity under IRS code 501(c)(3) chartered
+to develop and execute effective strategies which provide world-wide
+stewardship of the X Window System technology and standards. Membership
+in the X.Org Foundation is free to all participants. Applications for
+Membership are now being accepted, and active participants in the
+further development of the X Window Technology are invited to complete a
+<ulink
+url="http://www.x.org/wiki/Membership"
+>membership application</ulink>.  The X11R&relvers; release has been
+produced by the many contributors to the X.Org community and members of
+the X.Org Foundation and includes code from the X Consortium, the Open
+Group and the <trademark class="registered">XFree86</trademark> Project.
+This release is dedicated to the greater X community, developers and
+users alike.
+</para>
+
+</sect1>
+
+<!--
+<![ %snapshot [
+<sect1>
+<title>Redistribution of Snapshots</title>
+<para>
+While the X.Org Foundation <ulink
+url="LICENSE.html">License</ulink>
+doesn't
+prohibit vendors and others redistributing binaries of this snapshot
+release, we don't recommend including them in production releases.
+</para>
+</sect1>
+]]>
+ -->
+
+<sect1>
+<title>Licensing</title>
+
+<para>
+X Window System source code is covered by many licenses.  All of these
+licenses have in common the fact that they do not impose significant
+conditions on the modification or redistribution or either source code
+or binaries beyond requiring one or more of the following:
+</para>
+
+<para>
+
+<orderedlist>
+<listitem>
+
+<para>
+Copyright and/or license notices are left intact.
+</para>
+</listitem>
+<listitem>
+
+<para>
+Copyright and/or license notices are reproduced verbatim in
+documentation accompanying binary distributions.
+</para>
+</listitem>
+<listitem>
+
+<para>
+Attributions are included with documentation accompanying binaries.
+</para>
+</listitem>
+
+</orderedlist>
+
+</para>
+
+<para>
+Most of these licenses are based on the MIT, X Consortium, or BSD
+(original and revised) licenses.  All of them are consistent with the
+<ulink
+url="http://www.opensource.org/docs/definition.php"
+>Open Source Definition</ulink
+>, and most are
+consistent with the Free Software Foundation's <ulink
+url="http://www.fsf.org/philosophy/free-sw.html"
+>Free Software Definition</ulink
+>.
+</para>
+
+<para>
+Copyright and Licensing information for X, including the reproduction
+of copyright and/or license notices and attributions required by some
+of the licenses for binary distributions, can be found in the <ulink
+url="License.html">License Document</ulink>.  If you find any omissions
+in that document, please contact us with details at
+<email>xorg@lists.freedesktop.org</email>.
+While the current licenses are all open source licenses, the
+X.Org Foundation is attempting, with time, to bring as much as
+possible of the code's licenses in the distribution into compliance with the
+<ulink url="http://www.debian.org/social_contract#guidelines"
+>Debian Free Software Guidelines</ulink>.
+</para>
+
+</sect1>
+
+<sect1>
+<title>Pointers to additional information</title>
+
+<para>
+The documentation for this release can be found online at the <ulink
+url="http://www.x.org/">X.Org web site</ulink>.
+</para>
+
+<para>
+The X11 version numbering system (including historical information)
+can be found in the <ulink url="Versions.html">Versions Document</ulink>.
+</para>
+
+<para>
+Additional information may be available at the <ulink url="http://wiki.x.org/"
+>X.Org Foundation Wiki</ulink>.
+</para>
+
+</sect1>
+
+<sect1>
+<title>The Public Mailing Lists</title>
+
+<para>
+Current information about the X.Org Foundation public mailing lists is
+available on <ulink url="http://www.x.org/wiki/XorgMailingLists">the X.Org
+mailing list page</ulink> and related desktop
+technology mailing lists can be found on <ulink
+url="http://freedesktop.org/mailman/listinfo">Freedesktop.org's mailing list
+page</ulink>.
+</para>
+
+</sect1>
+
+<sect1>
+<title>Contributing to the X.Org Foundation's X efforts.</title>
+
+<para>
+If you have any new work or enhancements/bug fixes for existing work,
+please send them as git format patches to
+<email>xorg-devel@lists.freedesktop.org</email> or to our
+<ulink url="https://bugs.freedesktop.org/">bug tracking system</ulink>
+using the xorg component.  This will help ensure that they are included
+in future releases.   More details on patch submission and review
+process are available on the
+<ulink url="http://www.x.org/wiki/Development/Documentation/SubmittingPatches">
+SubmittingPatches</ulink> page of the X.Org wiki.
+</para>
+
+</sect1>
+
+<sect1>
+<title>How to get the release</title>
+
+<!--
+<![ %snapshot; [
+<para>
+X11R&relvers; can be found from the <ulink url="http://wiki.x.org">X.Org
+Foundation wiki</ulink>, and at mirrors of this server.
+</para>
+]]>
+
+<![ %release; [
+-->
+<para>
+Information about X11R&relvers; can be found from the
+<ulink
+url="http://wiki.x.org"
+>X.Org Foundation wiki</ulink>, and at
+mirrors of this server.
+</para>
+<!--
+]]>
+ -->
+
+<sect2>
+<title>X11R&relvers;</title>
+
+<para>
+This is the &whichfullrel; release of the new modular source code tree.  The
+source code has been split into nine logical modules: app, data, doc,
+driver, font, lib. proto, util and xserver.  Each of these modules
+contain one or more packages that can be configured, built and installed
+separately.  Please see an X11R&relvers; release site for a complete
+list of the tarballs.
+</para>
+
+<para>
+For information on how to build the modular tree packages see the <ulink
+url="http://wiki.x.org/wiki/ModularDevelopersGuide"
+>Modular Developer's Guide</ulink
+>.  This guide also
+contains information for developers who want to help improve the modular
+build system and modular code base.
+</para>
+
+</sect2>
+
+<sect2>
+<title>The current development tree</title>
+
+<para>
+The X source code for this and all releases/snapshots as well as
+development versions can also be accessed via the Freedesktop.org git
+repository.  It's also possible to browse the <ulink
+url="http://cgit.freedesktop.org/xorg/"
+>freedesktop git repository</ulink
+>.
+</para>
+
+<para>
+To check out the latest development version, don't specify any tag.
+</para>
+
+</sect2>
+
+</sect1>
+
+<sect1>
+<title>Reporting Bugs</title>
+
+<para>
+Bugs should be reported to freedesktop.org's <ulink
+url="https://bugs.freedesktop.org/">bug tracking system</ulink>
+using the xorg component.  Before
+reporting bugs, please check the server log file, which can be found at
+<filename>/var/log/Xorg.0.log</filename> on most platforms.  If you can't
+resolve the problem yourself, send the entire log file with your bug report but
+not the operating system core dump.  Do not edit the log file as our
+developers use it to reproduce and debug your problem.  Please attach it
+to your bug report.
+</para>
+
+</sect1>
+
+</article>