summaryrefslogtreecommitdiff
path: root/ModularDevelopersGuide.mdwn
diff options
context:
space:
mode:
authorgnadon <gnadon@web>2013-10-08 05:59:32 -0700
committerxorg <iki-xorg@freedesktop.org>2013-10-08 05:59:32 -0700
commite2fc5357abd21debe87cfec005737ca4625e8d07 (patch)
treeff1b36503fda02477a7a335978a3d33bde6912e5 /ModularDevelopersGuide.mdwn
parentb4fd18235b600c24b26b80ae1cfb11edb50363fa (diff)
Required Tools: small refactoring
Diffstat (limited to 'ModularDevelopersGuide.mdwn')
-rw-r--r--ModularDevelopersGuide.mdwn18
1 files changed, 11 insertions, 7 deletions
diff --git a/ModularDevelopersGuide.mdwn b/ModularDevelopersGuide.mdwn
index 55923856..49b84fe3 100644
--- a/ModularDevelopersGuide.mdwn
+++ b/ModularDevelopersGuide.mdwn
@@ -8,17 +8,12 @@
This guide is for developers who wish to build the X Window System from source. If your area of interest is limited to a single package, like a driver or an application, check with your O/S first for development facilities.
<a name="RequiredTools"></a>
-## Required Tools
+## Required Tools and Software Dependencies
-The most common cause of build failures for first time builders is the lack of required tools. There are over 30 tools required to build all of X 200+ packages and half of them are not installed by default on most O/S or Linux distributions. Some tools are only needed by dependent projects:
-
-* [[Mesa|http://www.mesa3d.org/]] &ndash; The Mesa 3D Graphics Library
-* [[Pixman|http://cgit.freedesktop.org/pixmanpixman/]] &ndash; Low Level Pixel Manipulation Library
-* [[XKeyboardConfig|http://www.freedesktop.org/wiki/Software/XKeyboardConfig]] &ndash; X Keyboard Configuration Database
+The most common cause of build failures for first time builders is the lack of required tools. There are over 30 tools required to build all of the X Window System 200+ packages and half of them are not installed by default on most O/S or Linux distributions. The minimum version needed is shown in brackets where applicable.
It is strongly advised you install such packages from your O/S official packaging system. Check the [[RequiredPackages|RequiredPackages]] for your O/S. Some of the tools may not be required to build some areas of X. Some GNU utility, like make, have native O/S equivalent on non GNU systems.
-
### Source Code Version Control
* [[git|http://git-scm.com/]] &ndash; The fast version control system
@@ -76,6 +71,15 @@ These tools are optionals. If they are missing, the documentation will not be ge
* [[Xmlto (0.0.22)|https://fedorahosted.org/xmlto/]] &ndash; XML-to-any converter
* [[Xsltproc (1.1.26)|http://xmlsoft.org/XSLT/xsltproc2.html]] &ndash; XSLT command line processor
+### Freedesktop.org Dependencies
+
+These freedesktop.org projects are required software dependencies to build X. If you use a build process based on the build.sh script or on JHBuild, the source will be obtained for you.
+
+* [[Mesa|http://www.mesa3d.org/]] &ndash; The Mesa 3D Graphics Library
+* [[Pixman|http://cgit.freedesktop.org/pixmanpixman/]] &ndash; Low Level Pixel Manipulation Library
+* [[XKeyboardConfig|http://www.freedesktop.org/wiki/Software/XKeyboardConfig]] &ndash; X Keyboard Configuration Database
+
+
## Selecting a Build Process
We are assuming you have installed the [[required tools|ModularDevelopersGuide]] but nothing else. There are two maintained build processes you can use. One is based on a simple Bourne script and one is a customization of the Gnome JHBuild process.