diff options
author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2011-04-24 10:30:45 +0000 |
---|---|---|
committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2011-04-24 10:30:45 +0000 |
commit | bc3f869925ec95f2fa431f6cf9b687a5349e14bb (patch) | |
tree | c12133262a77d99d1e50dad03811d6a4c9d568b8 /doc/xorg-docs/general/README.xml | |
parent | e92849244470e2aa75e76bbf7cb5066f986b229d (diff) |
Update to xorg-docs 1.6.
As with previous version, only manual pages in section 7 are
installed for now.
More work is needed to be able to format and install the docs
that have been converted to docbook xml.
Diffstat (limited to 'doc/xorg-docs/general/README.xml')
-rw-r--r-- | doc/xorg-docs/general/README.xml | 345 |
1 files changed, 345 insertions, 0 deletions
diff --git a/doc/xorg-docs/general/README.xml b/doc/xorg-docs/general/README.xml new file mode 100644 index 000000000..7c11e2739 --- /dev/null +++ b/doc/xorg-docs/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> |