[PATCH wayland-web] raspberrypi: update for the new rpi-backend

[ppaalanen at gmail.com]

From: Pekka Paalanen <pekka.paalanen at collabora.co.uk>

This depends on the rpi-renderer patch series for Weston.

Update the build instructions for the current state of Weston, remove
options that do not exist anymore, add some more troubleshooting issues.

Signed-off-by: Pekka Paalanen <pekka.paalanen at collabora.co.uk>
---
 raspberrypi.html | 42 ++++++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/raspberrypi.html b/raspberrypi.html
index 67b7829..d77a9e1 100644
--- a/raspberrypi.html
+++ b/raspberrypi.html
@@ -47,14 +47,6 @@ old firmware may cause rpi-backend to malfunction on Raspberry Pi.</p>
 	happen off-line into the buffer.</dd>
 </dl>
 
-<p>By default, the rpi-backend is configured for the <tt>dispmanx_offline=1</tt>
-case. Without this setting, it would be better to run Weston with
-<tt>--max-planes=10</tt> command line option.</p>
-
-<p>If you want to use Weston with purely GLESv2 compositing, you can pass
-<tt>--max-planes=0</tt> to Weston. In that case it would be preferrable
-to not set <tt>dispmanx_offline=1</tt> to conserve VideoCore memory.</p>
-
 <h2>Setting up the environment</h2>
 
 <p>Here we will install to the home directory of the pi user.</p>
@@ -67,9 +59,11 @@ export PKG_CONFIG_PATH="$WLD/lib/pkgconfig/:$WLD/share/pkgconfig/"
 export ACLOCAL="aclocal -I $WLD/share/aclocal"
 export XDG_RUNTIME_DIR="/run/shm/wayland"
 export XDG_CONFIG_HOME="$WLD/etc"
+export XORGCONFIG="$WLD/etc/xorg.conf"
 
 mkdir -p "$WLD/share/aclocal"
 mkdir -p "$XDG_RUNTIME_DIR"
+chmod 0700 "$XDG_RUNTIME_DIR"
 </pre>
 </blockquote>
 
@@ -97,11 +91,11 @@ contains similar files for Android, and will not work.</p>
 
 <pre>    $ git clone git://anongit.freedesktop.org/wayland/wayland
     $ cd wayland
-    $ ./autogen.sh --prefix=$WLD
+    $ ./autogen.sh --prefix=$WLD --disable-documentation
     $ make
     $ make install
 </pre>
-
+<p>The <tt>--disable-documentation</tt> makes it not require Doxygen.</p>
 
 <h2>libxkbcommon</h2>
 
@@ -124,9 +118,10 @@ contains similar files for Android, and will not work.</p>
     $ ./autogen.sh --prefix=$WLD \
     --disable-setuid-install --with-cairo-glesv2 \
     --disable-x11-compositor --disable-drm-compositor \
-    --disable-android-compositor --disable-wayland-compositor \
+    --disable-fbdev-compositor --disable-wayland-compositor \
     --disable-weston-launch --disable-simple-egl-clients \
-    --disable-fbdev-compositor \
+    --disable-egl --disable-libunwind --disable-colord \
+    --disable-resize-optimization --disable-xwayland-test \
     WESTON_NATIVE_BACKEND="rpi-backend.so"
 
     $ make
@@ -168,10 +163,25 @@ configure: WARNING: clients will use cairo image, cairo-egl not used</pre>
 
 <h3>Some or all surfaces (graphics) are corrupted</h3>
 
-<p>Too old firmware might cause corrupted graphics. If you don't want to
-update the firmware, a workaround is to add <tt>--max-planes=0</tt> to the
-Weston command line. This forces everything to be composited with
-GLESv2.</p>
+<p>Too old firmware might cause corrupted graphics.
+Try upgrading the firmware, and try the <tt>/boot/config.txt</tt>
+options mentioned above.</p>
+
+<h3>Monitor or TV goes blank, loses signal, etc.</h3>
+
+<p>You probably do not have <tt>dispmanx_offline=1</tt> for the firmware.
+When there are too many things on screen for the on-line compositor to
+handle, the output dies or becomes corrupt without the off-line fallback.</p>
+
+<h3>Some windows or the whole image flickers</h3>
+
+<p>There may be so many things on screen, that even the off-line compositor
+in the firmware cannot keep up. Try to close some windows.</p>
+
+<h3>Programs are dying on SIGBUS</h3>
+
+<p>Most likely you are running out of space in <tt>$XDG_RUNTIME_DIR</tt>.
+This is where Wayland programs allocate their pixel buffers.</p>
 
 </body>
 </html>
-- 
1.8.1.5