[xorg-commit-diffs] xc BUILD, NONE, 1.1.2.1 README, NONE,
1.1.2.1 ChangeLog, 1.1.2.3, 1.1.2.4 RELNOTES, 1.1.4.2.2.3,
1.1.4.2.2.4
Keith Packard
xorg-commit at pdx.freedesktop.org
Tue Apr 6 14:16:10 PDT 2004
Committed by: keithp
Update of /cvs/xorg/xc
In directory pdx:/tmp/cvs-serv24688
Modified Files:
Tag: XORG-RELEASE-1
ChangeLog RELNOTES
Added Files:
Tag: XORG-RELEASE-1
BUILD README
Log Message:
2004-04-06 Keith Packard <keithp at keithp.com>
* BUILD:
* README:
* RELNOTES:
* config/cf/lnxdoc.rules:
* config/cf/lnxdoc.tmpl:
* programs/Xserver/hw/xfree86/doc/BUILD:
* programs/Xserver/hw/xfree86/doc/DESIGN:
* programs/Xserver/hw/xfree86/doc/Install:
* programs/Xserver/hw/xfree86/doc/LICENSE:
* programs/Xserver/hw/xfree86/doc/OS2.Notes:
* programs/Xserver/hw/xfree86/doc/README:
* programs/Xserver/hw/xfree86/doc/README.DECtga:
* programs/Xserver/hw/xfree86/doc/README.Darwin:
* programs/Xserver/hw/xfree86/doc/README.I128:
* programs/Xserver/hw/xfree86/doc/README.LynxOS:
* programs/Xserver/hw/xfree86/doc/README.NetBSD:
* programs/Xserver/hw/xfree86/doc/README.OpenBSD:
* programs/Xserver/hw/xfree86/doc/README.SCO:
* programs/Xserver/hw/xfree86/doc/README.SiS:
* programs/Xserver/hw/xfree86/doc/README.Solaris:
* programs/Xserver/hw/xfree86/doc/README.XKB-Config:
* programs/Xserver/hw/xfree86/doc/README.XKB-Enhancing:
* programs/Xserver/hw/xfree86/doc/README.apm:
* programs/Xserver/hw/xfree86/doc/README.ati:
* programs/Xserver/hw/xfree86/doc/README.chips:
* programs/Xserver/hw/xfree86/doc/README.cyrix:
* programs/Xserver/hw/xfree86/doc/README.dps:
* programs/Xserver/hw/xfree86/doc/README.fonts:
* programs/Xserver/hw/xfree86/doc/README.i740:
* programs/Xserver/hw/xfree86/doc/README.mouse:
* programs/Xserver/hw/xfree86/doc/README.newport:
* programs/Xserver/hw/xfree86/doc/README.r128:
* programs/Xserver/hw/xfree86/doc/README.rendition:
* programs/Xserver/hw/xfree86/doc/README.s3virge:
* programs/Xserver/hw/xfree86/doc/RELNOTES:
* programs/Xserver/hw/xfree86/doc/Versions:
* programs/Xserver/hw/xfree86/doc/sgml/BUILD.sgml:
Add 'BUILD' and 'README' to top level.
Fix Id lines in generated documentation to reference
source document.
--- NEW FILE: BUILD ---
Building the X Window System from the X.org Source Distribution
Jim Gettys and Keith Packard (for X11R6.7)
David Dawes and Matthieu Herrb (for XFree86 4.4 RC2)
6 April 2004
Abstract
This document describes how to build the X Window System from the
X.org monolithic source distribution and is designed to be used in
conjunction with the operating system (OS) specific README files.
NOTE: Refer to the appropriate OS-specific README file before
attempting to build the X distribution. These files often contain
additional information that you need to successfully build for your
OS.
We highly recommend using gcc to build the X distribution, but X also gener-
ally builds with the native compiler for each OS platform; The build tools
known to be required include: gcc, make, C library development package, bi-
son, flex, zlib (development package), ncurses (development package), font-
config (development package), expat (development package), and Perl.
1. How to get the X11R6.7.0 distribution source
One way of getting the X11R6.7.0 source is to obtain it directly from the
X.Org CVS repository. There are several ways of doing that, and they are
described in the CVS section of our wiki <URL:http://wiki.x.org> The CVS tag
for this release is "xo-6.7_0". The tag for the maintenance branch for this
release is "xo-6.7-branch".
Another method of getting the X11R6.7.0 source is to either download the
6.7.0 source tarballs sites from freedesktop.org using either ftp or http.
The procedure for this is as follows:
o The X11R6.7.0 source is contained in the files:
X116.7.0-src1.tar.gz
X116.7.0-src2.tar.gz
X116.7.0-src3.tar.gz
X116.7.0-src4.tar.gz
X116.7.0-src5.tar.gz
X116.7.0-src6.tar.gz
X116.7.0-src7.tar.gz
These can be found at ftp://ftp.freedesktop.org/xorg/X11R6.7.0/src/ or
http://freedesktop.org/~xorg/X11R6.7.0/src/ and similar locations on
X.org mirror sites. X116.7.0-src4.tgz and X116.7.0-src5.tar.gz contains
the fonts. X116.7.0-src6.tar.gz contains the documentation source.
X116.7.0-src7.tar.gz contains the hardcopy documentation.
X116.7.0-src1.tar.gz, X116.7.0-src2.tar.gz and X116.7.0-src3.tar.gz con-
tains everything else. If you don't need the docs or fonts you can get
by with only X116.7.0-src1.tar.gz, X116.7.0-src2.tar.gz and
X116.7.0-src3.tar.gz.
o Extract each of these files by running the following from a directory on
a filesystem containing enough space (the full source requires around
305MB, and a similar amount is required in addition to this for the com-
piled binaries):
gzip -d < X116.7.0-src1.tar.gz | tar vxf -
gzip -d < X116.7.0-src2.tar.gz | tar vxf -
gzip -d < X116.7.0-src3.tar.gz | tar vxf -
gzip -d < X116.7.0-src4.tar.gz | tar vxf -
gzip -d < X116.7.0-src5.tar.gz | tar vxf -
gzip -d < X116.7.0-src6.tar.gz | tar vxf -
gzip -d < X116.7.0-src7.tar.gz | tar vxf -
All methods will produce one main source directory called xc.
2. Configuring the source before building
In most cases it shouldn't be necessary to configure anything before build-
ing.
If you do want to make configuration changes, it is recommended that you
start by going to the xc/config/cf directory, and copying the file
xorgsite.def to host.def. Then read through the host.def file (which is
heavily commented), and set your configuration parameters. Usually you can
find the default settings by checking the .cf file(s) relevant to your OS.
A good rule to follow is only to change things that you understand as it's
easy to create build problems by changing the default configuration. Check
the configuration parameters specified in the xc/config/cf/README.
If you are using just the X116.7.0-src1.tar.gz, X116.7.0-src2.tar.gz and
X116.7.0-src3.tar.gz parts of the source dist, you will need to define Build-
Fonts to NO.
3. Using a shadow directory of symbolic links for the build
A recommended practice is to use a shadow directory of symbolic links to do
the build of X11R6.7.0 as this allows you to keep the source directory unmod-
ified during the build. It has the following benefits:
o When you are using CVS to maintain your source tree, the update process
is not disturbed by foreign files not under CVS's control.
o It is possible to build X11R6.7.0 for several different Operating System
or architectures from the same sources, shared by read-only NFS mounts.
o It is possible to build X11R6.7.0 with different configuration options,
by putting a real copy of the host.def file in each build tree and by
customizing it separately in each build tree.
To make a shadow directory of symbolic links, use the following steps:
o create the directory at the top of the build tree. It is often created
at the same level that the xc directory, but this is not mandatory.
cd the directory containing the xcdirectory
mkdir build
o use the "lndir" command to make the shadow tree:
lndir ../xc
Note that you can refer to the xc directory with an absolute path if
needed.
See the lndir(1) manual page for details.
If lndir is not already installed on your system, you can build it manually
from the X11R6.7.0 sources by running the following commands:
cd xc/config/util
make -f Makefile.ini lndir
cp lndir some directory in your PATH
Occasionally there may be stale links in the build tree, like when files in
the source tree are removed or renamed. These can be cleaned up by running
the "cleanlinks" script from the build directory (see the cleanlinks(1) man-
ual page). Rarely there will be changes that will require the build tree to
be re-created from scratch. A symptom of this can be mysterious build prob-
lems. The best solution for this is to remove the build tree, and then re-
create it using the steps outlined above.
4. Building and installing the distribution
Before building the distribution, read through the OS-specific README file in
xc/programs/Xserver/hw/xfree86/doc that is relevant to you. Once you have
addressed the OS-specific details, go your build directory (either the xc
directory or the shadow tree created before) and run "make World" with the
BOOTSTRAPCFLAGS set as described in the OS-specific README (if necessary, but
most systems supported by X11R6.7.0 don't need BOOTSTRAPCFLAGS). It is
advisable to redirect stdout and stderr to World.Log so that you can track
down problems that might occur during the build.
With Bourne-like shells (Bash, the Korn shell, zsh, etc.) use a command like:
make World > World.log 2>&1
Witch C-shell variants (csh, tcsh, etc), use:
make World >& World.log
You can follow the progress of the build by running:
tail -f World.log
in a terminal.
When the build is finished, you should check the World.Log file to see if
there were any problems. If there weren't any then you can install the bina-
ries. By default the "make World" process will ignore errors and build as
much as possible. If there were problems and they are not corrected at this
stage, the installation process will fail. To restart the build process
after correcting the problems, just run 'make'. If Imakefiles or part of the
build configuration was changed as part of correcting the problem, either re-
run "make World", or run "make Everything".
If you would prefer "make World" to exit at the first error, run it in the
following way instead of the way described above:
for Bourne-like shells:
make WORLDOPTS= World > World.log 2>&1
for C-shell variants:
make WORLDOPTS= World >& World.log
To do the install, run "make install" and "make install.man". Make sure you
have enough space in /usr/X11R6 for the install to succeed. If you want to
install on a filesystem other than /usr, make a symbolic link to /usr/X11R6
before installing.
5. Reconfiguring the server (source distribution)
To build a different set of servers or servers with a different set of
drivers installed:
1. Make sure the source for any new drivers is in the correct place (e.g.,
driver source should be in a subdirectory of xc/pro-
grams/Xserver/hw/xfree86/drivers).
2. Change the settings of the server defines in host.def to specify which
servers you wish to build. Also, change the driver lists to suit your
needs.
3. From xc/programs/Xserver, run:
make Makefile
make Makefiles
make includes
make depend
make
6. Other useful make targets
There are some other useful targets defined in the top level Makefile of
X11R6.7.0:
o Everything after a make World, make Everything does everything a make
World does, except the cleaning of the tree. It is a way to quickly
rebuild the tree after a source patch, but it is not 100% bullet proof.
There are cases were it is better to force a full build by using make
World.
o clean does a partial cleaning of the source tree. Removes object files
and generated manual pages, but leaves the Makefiles and the generated
dependencies files in place. After a make clean you need to re-run
make includes
make depend
make
to rebuild the X11R6.7.0.
o distclean does a full cleaning of the source tree, removing all gener-
ated files. After a make distclean, make World is the only option to
rebuild X11R6.7.0.
o includes generates all generated header files and in-tree symbolic links
needed by the build. These files are removed by a make clean.
o depend recomputes the dependencies for the various targets in all Make-
files. Depending on the operating system, the dependencies are stored in
the Makefile, or as a separate file, called .depend. This target needs
the generated include files produced by make includes.
o VerifyOS displays the detected operating system version. If the numbers
shown do not match your system, you probably need to set them manually
in host.def and report the problem to <xorg at freedesktop.org>.
Generated from Id: BUILD.sgml,v 1.1.4.3.4.2 eich Exp $
--- NEW FILE: README ---
README for X11R6.7.0
The X.Org Foundation
25 March 2004
Abstract
X11R6.7.0 is an Open Source version of the X Window System that
supports many UNIX(R) and UNIX-like operating systems (such as
Linux, FreeBSD, NetBSD, OpenBSD and Solaris x86) on Intel and other
platforms. This version is compatible with X11R6.6, and is based
on the XFree86 4.4.0RC2 code base, which, in turn was based on the
X Consortium X11R6.6 and earlier sample implementations.
1. What is X11R6.7.0?
X11R6.7.0 is the seventh full release in the X11R6.7 series.
X11R6.7 is the current X.Org Foundation release series, based on the XFree86
4.x code base. The first release in the XFree86 4.x series was in early
2000. The core of X11R6.7 is a modular X server. The 6.7.0 version is a new
release that includes additional hardware support, functional enhancements
and bug fixes. Specific release enhancements can be viewed in the Release
Notes.
Most modern PC video hardware is supported in X11R6.7.0, and most PC video
hardware that isn't supported explicitly can be used with the "vesa" driver.
The Release Notes has a table showing the drivers provided with X11R6.7.0,
and links to related documentation.
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 oper-
ate as a scientific charity under IRS code 501(c)(3) to 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 membership application
<URL:http://www.x.org/XOrg_Foundation_Membership.html>. The X11R6.7.0 code-
base is based on the codebase found in XFree86[tm] 4.4RC2, which in turn was
based on the original X Window System sample implementation from the X Con-
sortium and it's successors. This release is dedicated to the greater X com-
munity, developers and users alike.
XFree86[tm] is produced by The XFree86 Project, Inc through the work of a
group of volunteer independent developers. The XFree86 Project is a non-com-
mercial organisation and XFree86 would not exist without the invaluable
development contributions of volunteers from around the world.
2. Licensing
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 condi-
tions on the modification or redistribution or either source code or binaries
beyond requiring one or more of the following:
1. Copyright and/or license notices are left intact.
2. Copyright and/or license notices are reproduced verbatim in documenta-
tion accompanying binary distributions.
3. Attributions are included with documentation accompanying binaries.
Most of these licenses are based on the MIT, X Consortium, or BSD (original
and revised) licenses. All of them are consistent with the Open Source Defi-
nition, and most are consistent with the Free Software Foundation's Free
Software Definition.
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 License Document. If
you find any omissions in that document, please contact us with details at
<xf_board at x.org>. 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 Debian
Free Software Guidelines.
3. Pointers to additional information
The documentation for this release can be found online at the X.Org web site
<URL:http://wiki.x.org/>. Information about binary distributions and the
attendant installation instructions can be found in the Installation Docu-
ment.
The X11 version numbering system (including historical information) can be
found in the Versions Document.
Additional information may be available at the X.Org Foundation Wiki
<URL:http://wiki.x.org/>.
4. The Public Mailing Lists
Current information about the X.Org Foundation public mailing lists is avail-
able on the X.Org mailing list page <URL:http://www.x.org/XOrg_Founda-
tion_Join_OpenLists.html> and related desktop technology mailing lists can be
found on Freedesktop.org's mailing list page <URL:http://freedesk-
top.org/mailman/listinfo>.
5. Contributing to the X.Org Foundation's X efforts.
If you have any new work or enhancements/bug fixes for existing work, please
send them to <xorg at freedesktop.org> or to our bug tracking system
<URL:http://bugzilla.freedesktop.org/> using the xorg component. This will
ensure that they are included in future releases.
6. How to get X11R6.7.0
X11R6.7.0 can be found from the X.Org Foundation wiki at
<URL:http://wiki.x.org>, and at mirrors of this server. Information about
obtaining and installing binary distributions of this release can be found in
the Installation Document. Information about obtaining the release in source
form is given below.
The source for version 6.7.0 is split into seven tarballs:
xorg-6.7.0-1.tgz
xorg-6.7.0-2.tgz
xorg-6.7.0-3.tgz
xorg-6.7.0-4.tgz
xorg-6.7.0-5.tgz
xorg-6.7.0-6.tgz
xorg-6.7.0-7.tgz
The first three contain everything except the fonts and general X11 documen-
tation. Those three are sufficient for building X11R6.7.0 if you already
have a set of fonts. The fourth and fifth contain the fonts. The sixth con-
tains the source for the general X11 documentation. The seventh contains the
general X11 documentation in hardcopy format.
A source patch relative to version 6.6.0 is also available. Because of its
size, it is split into four parts. The patch files are:
X11R6.7.0-6.6.0-6.7.0.diff1.gz
X11R6.7.0-6.6.0-6.7.0.diff2.gz
X11R6.7.0-6.6.0-6.7.0.diff3.gz
X11R6.7.0-6.6.0-6.7.0.diff4.gz
There is also a tarball and a cleanup script that handle files that have com-
ponents that can't be included in a diff. These are:
X11R6.7.0-6.6.0-6.7.0-diff0.tgz
X11R6.7.0-6.6.0-6.7.0-cleanup.sh
These patches should be applied to a clean 6.6.0 source tree, working from
the directory containing the xc/ directory. The patches should be applied by
running:
gzip -d < X11R6.7.0-6.6.0-6.7.0.diff1.gz | patch -p0 -E
gzip -d < X11R6.7.0-6.6.0-6.7.0.diff2.gz | patch -p0 -E
gzip -d < X11R6.7.0-6.6.0-6.7.0.diff3.gz | patch -p0 -E
gzip -d < X11R6.7.0-6.6.0-6.7.0.diff4.gz | patch -p0 -E
sh X11R6.7.0-6.6.0-6.7.0-cleanup.sh
gzip -d < X11R6.7.0-6.6.0-6.7.0-diff0.tgz | tar vxf -
To format the X11R6.7.0 documentation use the latest version of our doctools
package available from the Xorg CVS repository's "doctools" module.
The X source code for this and all releases/snapshots as well as development
versions can also be accessed via the Freedesktop.org CVS repository. It's
also possible to browse the freedesktop CVS repository
<URL:http://cvs.freedesktop.org/>. The CVS tag for this version is
"xo-6.7_0". The CVS tag for the stable branch for this release is
"xo-6.7-branch". To check out the latest development version, don't specify
any tag.
7. Reporting Bugs
Bugs should be reported to bug tracking system <URL:http://bugzilla.freedesk-
top.org/> using the xorg compoent. Before reporting bugs, please check the
server log file, which can be found at /var/log/Xorg.0.log 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.
Generated from Id: README.sgml,v 1.1.4.5.2.2 eich Exp $.
Index: ChangeLog
===================================================================
RCS file: /cvs/xorg/xc/Attic/ChangeLog,v
retrieving revision 1.1.2.3
retrieving revision 1.1.2.4
diff -u -d -r1.1.2.3 -r1.1.2.4
--- a/ChangeLog 6 Apr 2004 20:47:38 -0000 1.1.2.3
+++ b/ChangeLog 6 Apr 2004 21:16:07 -0000 1.1.2.4
@@ -1,3 +1,46 @@
+2004-04-06 Keith Packard <keithp at keithp.com>
+
+ * BUILD:
+ * README:
+ * RELNOTES:
+ * config/cf/lnxdoc.rules:
+ * config/cf/lnxdoc.tmpl:
+ * programs/Xserver/hw/xfree86/doc/BUILD:
+ * programs/Xserver/hw/xfree86/doc/DESIGN:
+ * programs/Xserver/hw/xfree86/doc/Install:
+ * programs/Xserver/hw/xfree86/doc/LICENSE:
+ * programs/Xserver/hw/xfree86/doc/OS2.Notes:
+ * programs/Xserver/hw/xfree86/doc/README:
+ * programs/Xserver/hw/xfree86/doc/README.DECtga:
+ * programs/Xserver/hw/xfree86/doc/README.Darwin:
+ * programs/Xserver/hw/xfree86/doc/README.I128:
+ * programs/Xserver/hw/xfree86/doc/README.LynxOS:
+ * programs/Xserver/hw/xfree86/doc/README.NetBSD:
+ * programs/Xserver/hw/xfree86/doc/README.OpenBSD:
+ * programs/Xserver/hw/xfree86/doc/README.SCO:
+ * programs/Xserver/hw/xfree86/doc/README.SiS:
+ * programs/Xserver/hw/xfree86/doc/README.Solaris:
+ * programs/Xserver/hw/xfree86/doc/README.XKB-Config:
+ * programs/Xserver/hw/xfree86/doc/README.XKB-Enhancing:
+ * programs/Xserver/hw/xfree86/doc/README.apm:
+ * programs/Xserver/hw/xfree86/doc/README.ati:
+ * programs/Xserver/hw/xfree86/doc/README.chips:
+ * programs/Xserver/hw/xfree86/doc/README.cyrix:
+ * programs/Xserver/hw/xfree86/doc/README.dps:
+ * programs/Xserver/hw/xfree86/doc/README.fonts:
+ * programs/Xserver/hw/xfree86/doc/README.i740:
+ * programs/Xserver/hw/xfree86/doc/README.mouse:
+ * programs/Xserver/hw/xfree86/doc/README.newport:
+ * programs/Xserver/hw/xfree86/doc/README.r128:
+ * programs/Xserver/hw/xfree86/doc/README.rendition:
+ * programs/Xserver/hw/xfree86/doc/README.s3virge:
+ * programs/Xserver/hw/xfree86/doc/RELNOTES:
+ * programs/Xserver/hw/xfree86/doc/Versions:
+ * programs/Xserver/hw/xfree86/doc/sgml/BUILD.sgml:
+ Add 'BUILD' and 'README' to top level.
+ Fix Id lines in generated documentation to reference
+ source document.
+
2004-04-06 Egbert Eich <eich at freedesktop.org>
* Fixed version number glitches in modules.
Index: RELNOTES
===================================================================
RCS file: /cvs/xorg/xc/RELNOTES,v
retrieving revision 1.1.4.2.2.3
retrieving revision 1.1.4.2.2.4
diff -u -d -r1.1.4.2.2.3 -r1.1.4.2.2.4
--- a/RELNOTES 3 Apr 2004 17:28:10 -0000 1.1.4.2.2.3
+++ b/RELNOTES 6 Apr 2004 21:16:07 -0000 1.1.4.2.2.4
@@ -1377,8 +1377,8 @@
UNIX System Laboratories Inc., URW++ GmbH, VA Linux Systems, VIA
Technologies Inc., Video Electronics Standard, VMware Inc., Vrije
Universiteit, Wittawat Yamwong, Wyse Technology Inc., X Consor-
- tium, Xi Graphics Inc., X-Oz Technologies, X-TrueType Server Pro-
- ject, and their contributors.
+ tium, Xi Graphics Inc., X-Oz Technologies, X-TrueType Server
+ Project, and their contributors.
This product includes software developed by The XFree86 Project,
Inc (http://www.xfree86.org/) and its contributors.
More information about the xorg-commit-diffs
mailing list