List recognized polkit agents and remove old issues.

1 files changed, 48 insertions, 14 deletions

diff --git a/docs/client/known-issues.md b/docs/client/known-issues.md
index 04b8070..e1507d7 100644
--- a/docs/client/known-issues.md
+++ b/docs/client/known-issues.md
@@ -3,28 +3,62 @@
 @summary = 'Known issues in Bitmask.'
 @toc = true
 
-Here you can find documentation about known issues and potential work-arounds in the current Leap Platform release.
+Here you can find documentation about known issues and potential work-arounds
+in the current Leap Platform release.
 
-0.5
-===
+No polkit agent available
+-------------------------
 
-In this release the following issues are known, work-arounds are noted when available.
+To run Bitmask and the services correctly you need to have a running polkit
+agent. If you don't have one you will get an error and won't be able to start
+Bitmask.
 
-General Issues
---------------
+The currently recognized polkit agents are:
 
-- If you have received a big ammount of mails (tested with more than 400), you may experience that Thunderbird won't respond.
+| process name                          | Who uses it?                      |
+|---------------------------------------|-----------------------------------|
+| `polkit-gnome-authentication-agent-1` | Gnome                             |
+| `polkit-kde-authentication-agent-1`   | KDE                               |
+| `polkit-mate-authentication-agent-1`  | Mate                              |
+| `lxpolkit`                            | LXDE                              |
+| `gnome-shell`                         | Gnome shell                       |
+| `fingerprint-polkit-agent`            | the `fingerprint-gui` package     |
 
-That problem does not happen if you have the client open and Thunderbird loading mails while are reaching your inbox.
 
-- You may get the error: "Unable to connect: Problem with provider" in situations when the problem is the network instead of the provider. (see: https://leap.se/code/issues/4023)
+If you have a different polkit agent running that it's not in theat list,
+please report a bug so we can include in our checks.
 
-- Opening the same account from more than one box at the same time will possibly break your account.
+You can get the list of running processes that match polkit with the following
+command: `ps aux | grep -i polkit`.
+Here is an example on my KDE desktop:
 
-- Managing a huge ammount of mails (e.g.: moving mails to a folder) will block the UI (see https://leap.se/code/issues/4837)
+    ➜ ps aux | grep polkit
+    root      1392  0.0  0.0 298972  6120 ?        Sl   Sep22   0:02 /usr/lib/policykit-1/polkitd --no-debug
+    user      1702  0.0  0.0  12972   920 pts/16   S+   16:42   0:00 grep polkit
+    user      3259  0.0  0.4 559764 38464 ?        Sl   Sep22   0:05 /usr/lib/kde4/libexec/polkit-kde-authentication-agent-1
 
-Special Environments
---------------------
 
-- You may experience problems related to an Unavailable polkit agent in gnome3. (see https://leap.se/code/issues/4144)
+Other Issues
+------------
 
+- You may get the error: "Unable to connect: Problem with provider" in
+  situations when the problem is the network instead of the provider.
+  See: https://leap.se/code/issues/4023
+
+Mail issues
+-----------
+
+Note that email is not stable yet so this list may not be accurate.
+
+- If you have received a big ammount of mails (tested with more than 400), you
+  may experience that Thunderbird won't respond.
+
+That problem does not happen if you have the client open and Thunderbird
+loading mails while are reaching your inbox.
+
+
+- Opening the same account from more than one box at the same time will
+  possibly break your account.
+
+- Managing a huge ammount of mails (e.g.: moving mails to a folder) will block
+  the UI (see https://leap.se/code/issues/4837)