initial plasma mobile instructions (#104)

* initial plasma mobile instructions

* CAF

Author: doniks

README.rst

@@ -7,3 +7,5 @@ Install and build::
    $ source env/bin/activate
    $ pip install -r requirements.txt
    $ make html
+
+Afterwards open `_build/html/index.html` in your browser.

porting/install-build/index.rst

@@ -7,16 +7,13 @@ At this point, you've set up your build device, downloaded all of the sources fo
 Fully halium-integrated distributions
 -------------------------------------
 
-You may choose any of the following distributions to install with the scripts and sources provided by Halium. We recommend you start with the reference rootfs for testing.
+You may choose any of the following distributions to install with the scripts and sources provided by Halium. We recommend you start with the Halium reference rootfs for testing.
 
 .. toctree::
    :maxdepth: 1
-   
-   reference-rootfs
-
-.. todo::
-   Add instructions for installing Plasma Mobile
 
+   reference-rootfs
+   plasma-mobile
 
 Halium-modified distributions
 -----------------------------

porting/install-build/plasma-mobile.rst

@@ -0,0 +1,33 @@
+
+Plasma mobile
+=============
+
+In order to install `Plasma mobile <https://www.plasma-mobile.org>`_ you perform basically the same steps as for the :doc:`reference-rootfs`. This section only highlights the relevant differences.
+
+Install rootfs and system.img
+-----------------------------
+
+Use the plasma mobile rootfs. Download the latest version from here: `<https://images.plasma-mobile.org/rootfs/>`_.
+
+If you have a "CAF" device (Code Aurora Forum), then you must use the rootfs from here: `<https://images.plasma-mobile.org/caf-rootfs/>`_. Generally speaking, if it is a Qualcomm device and it is not a Nexus, then it is CAF.
+
+
+Debugging
+---------
+
+Instead of connecting with `root` you use `phablet`::
+
+   ssh [email protected]
+
+.. todo::
+   Make sure phablet password is set either by using chroot from recovery or halium-install from `JBBgameich <https://github.com/JBBgameich/halium-install>`_.
+
+For general debugging tips refer back to reference rootfs instructions. Some plasma mobile specific tips are below.
+
+.. todo::
+   Document PM specific debug instructions. Some lose notes copied from irc log:
+
+   * run test_XYZ with sudo
+   * pgrep kwin_wayland
+   * journalctl | grep simplelogin
+