Updated the FAQ with some LInux issues and made FAQ entries available from other places

docs/en/en.json

@@ -507,6 +507,10 @@
                         "path": "/manuals/ios",
                         "name": "iOS"
                     },
+                    {
+                        "path": "/manuals/linux",
+                        "name": "Linux"
+                    },
                     {
                         "path": "/manuals/html5",
                         "name": "HTML5"

docs/en/faq/faq.md

@@ -150,52 +150,11 @@ Why am I getting a java exception when I try to start Defold?
 
   See [this link](https://github.com/defold/editor2-issues/blob/master/faq/pkixpathbuilding.md) for details on this error.
 
-## Linux issues
+## Linux
+:[Linux FAQ](../shared/linux-faq.md)
 
-When I try to create a new project, or open an existing one, the editor crashes.
-: On certain distributions (like Ubuntu 18) there is an issue with the version of jogamp/jogl Defold uses vs. the version of Mesa on the system.
-
-  See the following reports for more information:
-
-  - https://github.com/defold/editor2-issues/issues/1905
-  - https://github.com/defold/editor2-issues/issues/1886
-
-  If this is your problem try the following workaround:
-
-  ```
-  $ export MESA_GL_VERSION_OVERRIDE=3.1
-  $ ./Defold
-  ```
-
-I can't create a new branch for my project on Linux.
-
-: Make sure that you have *libssl 0.9.8* installed on your machine. Some distributions come with a later version, but Defold needs version *0.9.8*.
-
-When I try to run my game on Linux, the engine doesn't start.
-
-: Check the console output in the editor. If you get the following message:
-
-  ```
-  dmengine: error while loading shared libraries: libopenal.so.1: cannot open shared object file: No such file or directory
-  ```
-
-  then you need to install *libopenal1*. The package name varies between distributions, and in some cases you might have to install the *openal* and *openal-dev* or *openal-devel* packages.
-
-I'm running on Linux and the editor won't start.
-
-: This applies to the old editor 1 only. Make sure that you start the editor with the supplied shell script:
-
-  ```sh
-  $ ./Defold-linux.sh
-  ```
-
-  Do *not* execute *Defold* directly.
-
-## Android issues
-
-Is it possible to hide the navigation and status bars on Android?
-
-: Yes, set the *immersive_mode* setting in the *Android* section of your *game.project* file. This lets your app take over the whole screen and capture all touch events on the screen.
+## Android
+:[Android FAQ](../shared/android-faq.md)
 
 ## Game content
 

docs/en/manuals/android.md

@@ -128,16 +128,5 @@ D/defold  ( 6210): DEBUG:SCRIPT: Hello there, log!
 ...
 ```
 
-## Troubleshooting
-
-I'm getting "Failure [INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES]" when installing
-: Android detects that you try to install the app with a new certificate. When bundling debug builds, each build will be signed with a temporary certificate. Uninstall the old app before installing the new version:
-
-  ```
-  $ adb uninstall com.defold.examples
-  Success
-  $ adb install Defold\ examples.apk
-  4826 KB/s (18774344 bytes in 3.798s)
-          pkg: /data/local/tmp/Defold examples.apk
-  Success
-  ```
+## FAQ
+:[Android FAQ](../shared/android-faq.md)

docs/en/manuals/linux.md

@@ -0,0 +1,15 @@
+---
+title: Defold development for the Linux platform
+brief: This manual describes how to build and run Defold applications on Linux
+---
+
+# Linux development
+
+Developing Defold applications for the Linux platform is a straight forward process with very few considerations to make.
+
+## Project settings
+
+Linux specific application configuration is done from the [Linux section](/manuals/project-settings/#linux) of the *game.project* settings file.
+
+## FAQ
+:[Linux FAQ](../shared/linux-faq.md)

docs/en/shared/android-faq.md

@@ -0,0 +1,14 @@
+Is it possible to hide the navigation and status bars on Android?
+: Yes, set the *immersive_mode* setting in the *Android* section of your *game.project* file. This lets your app take over the whole screen and capture all touch events on the screen.
+
+I'm getting "Failure [INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES]" when installing
+: Android detects that you try to install the app with a new certificate. When bundling debug builds, each build will be signed with a temporary certificate. Uninstall the old app before installing the new version:
+
+  ```
+  $ adb uninstall com.defold.examples
+  Success
+  $ adb install Defold\ examples.apk
+  4826 KB/s (18774344 bytes in 3.798s)
+          pkg: /data/local/tmp/Defold examples.apk
+  Success
+  ```

docs/en/shared/linux-faq.md

@@ -0,0 +1,37 @@
+EDITOR - Mouse clicks on Elementary OS go through the editor onto whatever is below.
+
+: Start the editor like this:
+
+```
+$ GTK_CSD=0 ./Defold
+```
+
+EDITOR - When I try to create a new project, or open an existing one, the editor crashes.
+
+: On certain distributions (like Ubuntu 18) there is an issue with the version of jogamp/jogl Defold uses vs. the version of Mesa on the system.
+
+  See the following reports for more information:
+
+  - https://github.com/defold/editor2-issues/issues/1905
+  - https://github.com/defold/editor2-issues/issues/1886
+
+  If this is your problem try the following workaround:
+
+  ```
+  $ export MESA_GL_VERSION_OVERRIDE=3.1
+  $ ./Defold
+  ```
+
+EDITOR - I can't create a new branch for my project on Linux.
+
+: Make sure that you have *libssl 0.9.8* installed on your machine. Some distributions come with a later version, but Defold needs version *0.9.8*.
+
+ENGINE - When I try to run my game on Linux, the engine doesn't start.
+
+: Check the console output in the editor. If you get the following message:
+
+  ```
+  dmengine: error while loading shared libraries: libopenal.so.1: cannot open shared object file: No such file or directory
+  ```
+
+  then you need to install *libopenal1*. The package name varies between distributions, and in some cases you might have to install the *openal* and *openal-dev* or *openal-devel* packages.