1.  
2. Official XLibre PKGBUILDS for Arch Linux
3. ========================================
4.  
5. This repository is part of a set that provides PKGBUILD files for building Xlibre packages on Arch Linux derivative distributions and Arch Linux itself.
6. These repositories are provided by the XLibre project:
7. * xlibre-xserver - contains xlibre-xserver, xlibre-xserver-common, xlibre-xserver-devel, xlibre-xserver-xephyr, xlibre-xserver-xnest, xlibre-xserver
8. * xlibre-xf86-input-elographics
9. * xlibre-xf86-input-evdev
10. * xlibre-xf86-input-libinput
11. * xlibre-xf86-input-void
12. * xlibre-xf86-input-synaptics
13. * xlibre-xf86-input-vmmouse
14. * xlibre-xf86-input-wacom
15. * xlibre-xf86-video-amdgpu
16. * xlibre-xf86-video-ati
17. * xlibre-xf86-video-dummy
18. * xlibre-xf86-video-fbdev
19. * xlibre-xf86-video-intel
20. * xlibre-xf86-video-nouveau
21. * xlibre-xf86-video-nv
22. * xlibre-xf86-video-qxl
23. * xlibre-xf86-video-sisusb
24. * xlibre-xf86-video-vesa
25. * xlibre-xf86-video-vmware
26. * xlibre-xf86-video-voodoo
27.  
28. The procedure to build the xlibre packages is documented here.
29.  
30.  
31. Important notice
32. ----------------
33.  
34. * In the Xorg repository the 'TearFree' option was been enabled by default quite some time ago, but this code was never released.
35. Xlibre did release the code, so it does have the 'TearFree' option enabled by default.
36.  
37.  
38. Repository layout and usage
39. ---------------------------
40.  
41. Each repository directory contains the PKGBUILD and related files to build the installable package as .zst file. This can be done with eg. command makepkg.
42.  
43. The procedure is the same for all packages:
44. * change directory into the one of the package
45. * install the required (make)depends
46. * build the package
47. * install the package or add it to a repository so subsequent package builds can use it
48.  
49.  
50. Conditions related to the order of building xlibre packages
51. -----------------------------------------------------------
52.  
53. Note that an xlibre-xserver update from 25.0.0.x to 26.0.0.x is considered a major version update; an update from 25.0.0.3 to 25.0.0.4 is not as this just a minor version update, also known as hotfix.
54.  
55. * A major update will increase the Module ABI versions in the Xlibre packages.
56. * Before a major updade of xlibre-xserver - and only then - a new version of the xlibre-xf86-input-libinput PKGBUILD file must be downloaded and this package built; this to acommodate for the increased ABI versions while building the xlibre-xserver and xlibre-xf86 packages.
57. * The major update is done by building the new version of the xlibre-xserver base package which builds the 6 xlibre-xserver packages.
58. * After a major updade of xlibre-xserver, all xlibre-xf86 driver packages need to be rebuilt.
59. * Once an Xlibre package has been built it should be used to replace its xorg counterpart, if installed.
60.  
61.  
62. Packages build procedure
63. ------------------------
64.  
65. Note: when asked to remove conflicting xorg and xf86 packages when building, answer with: y
66. When conflicting xf86 packages cannot be removed, use pacman -Rdd to force remove these.
67. Keep a note of all removed xf86 packages and install the corresponding xlibre-xf86 ones during step 4!
68.  
69. # 1. Build package xlibre-xf86-input-libinput v1.5.0.0 - this is only required after a major version update as explained above.
70.     Note this is a placeholder package and will be replaced later in this procedure with a newer version.
71. - change directory into xlibre-xf86-input-libinput
72. - make sure xorg-devel is installed and also other dependencies from the PKGBUILD file
73. - build the package using eg. makepkg
74. - install the package:\
75.    sudo pacman -U xlibre-xf86-input-libinput-1.5.0.0-1-x86_64.pkg.tar.zst
76.  
77. # 2. Build the xlibre-xserver packages
78. - change directory into xlibre-xserver
79. - make sure to install all dependencies from the PKGBUILD file like eg. xtrans, libxaw, xorg-font-util and meson
80. - remove conflicting packages that pacman cannot delete, eg.:\
81.    sudo pacman -Rdd xf86-video-vmware xf86-input-vmmouse xf86-input-elographics xf86-input-evdev xf86-input-void xf86-input-wacom
82. - build the package using eg. makepkg
83. - install these packages:
84.    sudo pacman -U xlibre-xserver-<version number>-x86_64.pkg.tar.zst xlibre-xserver-common-<version number>-x86_64.pkg.tar.zst xlibre-xserver-devel-<version number>-x86_64.pkg.tar.zst
85.  
86. # 3. Build the actual xlibre-xf86-input-libinput package
87. - change directory once more into xlibre-xf86-input-libinput
88. - replace the PKGBUILD file with the final one for this package:
89.    mv PKGBUILD-1.5.0.1 PKGBUILD
90. - build the package using eg. makepkg
91. - install the package:\
92.    sudo pacman -U xlibre-xf86-input-libinput-1.5.0.1-1-x86_64.pkg.tar.zst
93.  
94. # 4. Build and install all xlibre packages of which the corresponding xorg one has been removed
95. This is done with the same procedure as in the previous steps.
96. These packages and others might have to be installed when building:
97. - xlibre-xf86-input-wacom: gobject-introspection
98. - xlibre-xf86-video-qxl: spice-protocol libcacard spice
99. - xlibre-xf86-video-intel: libxvmc
100.  
101.  
102. Perform checks
103. --------------
104.  
105. - check there are no more xorg packages that need to be replaced:
106.    pacman -Q | grep 'xorg-server\|xf86-'
107. - check that all required xlibre packages are installed:
108.    pacman -Q | grep 'xlibre-'
109. - make SURE xlibre-xf86-input-libinput-1.5.0.1 or higher is installed!
110.  
111.  
112. Closed source drivers
113. ---------------------
114.  
115. Closed source drivers might not have an updated ABI version to match that of the updated xlibre-xserver. This can be overcome by creating a file named eg. /etc/X11/xorg.conf.d/xlibre.conf containing:
116.  
117. Section "ServerFlags"
118.         Option "IgnoreABI" "true"
119. EndSection
120.  
121.  
122. Questions and answers
123. ---------------------
124.  
125. * Q. How to check which X server and drivers are installed?\
126. A1. Check the X11 vendor string using:\
127.   sudo Xorg -version\
128. A2. List the installed X packages with:\
129.   pacman -Q | grep 'xlibre-xserver\|xorg-server\|xf86-'
130.  
131.  
132.  
133. artist for Xlibre
134.