Mir

Merge lp:~robert-ancell/mir/mesa-xorg-docs into lp:~mir-team/mir/trunk

Proposed by Robert Ancell
Status: Merged
Approved by: Robert Ancell
Approved revision: no longer in the source branch.
Merged at revision: 838
Proposed branch: lp:~robert-ancell/mir/mesa-xorg-docs
Merge into: lp:~mir-team/mir/trunk
Diff against target: 100 lines (+54/-12)
1 file modified
doc/building_source_for_pc.md (+54/-12)
To merge this branch: bzr merge lp:~robert-ancell/mir/mesa-xorg-docs
Reviewer Review Type Date Requested Status
Chris Halse Rogers Approve
kevin gunn (community) Approve
PS Jenkins bot (community) continuous-integration Approve
Review via email: mp+174073@code.launchpad.net

Commit message

Add instructions on how to compile Mesa and X.Org with Mir support

To post a comment you must log in.
Revision history for this message
kevin gunn (kgunn72) wrote :

should include unity-system-compositor also

review: Needs Fixing
Revision history for this message
PS Jenkins bot (ps-jenkins) wrote :
review: Approve (continuous-integration)
Revision history for this message
kevin gunn (kgunn72) wrote :

approve, w/ caveat to update if needed.
are you saying that lightdm should work as long as its v 1.7.4 ? that is to say, the required patches have made it to trunk & have found their way into saucy releases

review: Approve
Revision history for this message
Robert Ancell (robert-ancell) wrote :

> are you saying that lightdm should work as long as its v 1.7.4 ? that is to
> say, the required patches have made it to trunk & have found their way into
> saucy releases

Yes, except for some packaging and bug fixes. But for a third party they should be considered to be available (though still a work in progress as is everything else)

Revision history for this message
Chris Halse Rogers (raof) wrote :

Good, but we should suggest at least --with-egl-platforms=mir,drm because Mir requires the DRM plaftorm to run.

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'doc/building_source_for_pc.md'
2--- doc/building_source_for_pc.md 2013-06-13 02:49:54 +0000
3+++ doc/building_source_for_pc.md 2013-07-11 00:11:29 +0000
4@@ -1,7 +1,7 @@
5 Building the source for a PC {#building_source_for_pc}
6 ============================
7
8-Getting mir
9+Getting Mir
10 -----------
11
12 Mir is a project on Launchpad (https://launchpad.net/mir). To grab a copy use
13@@ -20,17 +20,17 @@
14 $ sudo mk-build-deps --install --tool "apt-get -y" --build-dep debian/control
15
16
17-Building mir
18+Building Mir
19 ------------
20
21-Mir is built using cmake. You first need to create the build directory and
22+Mir is built using CMake. You first need to create the build directory and
23 configure the build:
24
25 $ mkdir build
26 $ cd build
27- $ cmake .. (possibly passing configuration options to cmake)
28+ $ cmake .. (possibly passing configuration options to CMake)
29
30-There are many configuration options for the mir project. The default options
31+There are many configuration options for the Mir project. The default options
32 will work fine, but you may want to customize the build depending on your
33 needs. The best way to get an overview and set them is to use the cmake-gui
34 tool:
35@@ -42,16 +42,58 @@
36 $ make (-j8)
37 $ ctest
38
39-Installing mir
40---------------
41-
42-To install mir just use the normal make install command:
43+To install Mir just use the normal make install command:
44
45 $ make install
46
47-This will install the mir libraries, executable, example clients and header
48+This will install the Mir libraries, executable, example clients and header
49 files to the configured installation location (/usr/local by default). If you
50 install to a non-standard location, keep in mind that you will probably need to
51 properly set the PKG_CONFIG_PATH environment variable to allow other
52-applications to build against mir, and LD_LIBRARY_PATH to allow applications to
53-find the mir libraries at runtime.
54+applications to build against Mir, and LD_LIBRARY_PATH to allow applications to
55+find the Mir libraries at runtime.
56+
57+Building Mesa
58+-------------
59+
60+For GL accelerated clients to use Mir they need to use a patched version of Mesa
61+that supports Mir.
62+
63+The patch is hosted on GitHub:
64+
65+ $ git clone https://github.com/RAOF/mesa.git
66+
67+Compile as per normal instructions and pass --with-egl-platforms="mir,drm" to
68+the configure options. You will need libmirclient installed as shown above.
69+
70+Building X.Org
71+--------------
72+
73+To run an X server inside Mir you need to build a patched version of the X.Org
74+X server.
75+
76+The patch is hosted on GitHub:
77+
78+ $ git clone https://github.com/RAOF/xserver.git
79+
80+Compile as per normal instructions and pass --enable-xmir to the configure
81+options. You will need libmirclient installed as shown above.
82+
83+Building Unity System Compositor
84+--------------------------------
85+
86+If you want to run a full system using XMir then you need to use a system
87+compositor. For Ubuntu we have a system compositor project on Launchpad
88+(https://launchpad.net/unity-system-compositor). Compile with the following:
89+
90+ $ bzr branch lp:unity-system-compositor
91+ $ cd unity-system-compositor
92+ $ mkdir build
93+ $ cd build
94+ $ cmake ..
95+
96+You will need libmirserver installed as shown above.
97+
98+To use the system compositor you need a display manager that supports it. At the
99+time of writing LightDM is the only display manager with support and has been
100+available since version 1.7.4.

Subscribers

People subscribed via source and target branches