''' !!! WORK IN PROGRESS    !!! '''\\
Last Update 03.2017, Authors: Jens Henrik Göbbert, ...

= X.Org - Build Instructions for JURECA
[[PageOutline]]


'''X.Org''' is free, open-source software. It provides an open source implementation of the X Window System. The development work is being done in conjunction with the freedesktop.org community.

* [https://www.x.org X.Org]
* [https://www.freedesktop.org FreeDesktop.org]

The best place to get X is from your operating system or distribution vendor. X.Org currently provides no binaries.
But if one wants to profit from recent updates and new features it makes sense to build X.Org from source.

There are two maintained build processes you can use. One is based on a simple Bourne script (build.sh) and one is a customization of the Gnome JHBuild process.
'''We use the Gnome JHBuild process here.'''

== 1. Preliminaries ==
* General build instructions can be found here:
  * https://www.x.org/wiki/Building_the_X_Window_System
  * https://www.x.org/wiki/JhBuildInstructions

{{{ #!sh
# set a build directory for X.org
export BASE=$(pwd)

# load module environment for compiler
module load gcc/5.4.0
}}}

=== JHBuild ===

JHBuild allows you to automatically download and compile modules for a complete rebuild of GNOME - this includes X.Org.
* https://wiki.gnome.org/action/show/Projects/Jhbuild

{{{ #!sh
## build jhbuild and install in ~/.local/bin
cd ${BASE}
git clone https://git.gnome.org/browse/jhbuild
cd jhbuild
./autogen.sh --simple-install
make
make install
}}}

=== Third-Party libs

Some of the !ThirdParty packages need to be built first. These third party sources are required, but are not bundled.
* [https://www.gnu.org/software/gperf gperf] - version 3.1 works.
* [https://www.freetype.org FreeType] - version 2.4.0 works.

{{{ #!sh
export PATH=${GPERF_ROOT}/bin:$PATH
export PKG_CONFIG_PATH=${FREETYPE_ROOT}/lib/pkgconfig:$PKG_CONFIG_PATH
}}}

== 2. Setup X.Org Build Process ==
Source packages are downloaded by JHBuild automatically. What is required is a 
* xorg.modules file -> examples: https://cgit.freedesktop.org/xorg/util/modular/plain/xorg.modules
* xorg.jhbuildrc file -> example: https://cgit.freedesktop.org/xorg/util/modular/plain/jhbuildrc