Brought up to asciidoctor standard.

src/docs/asciidoc/sdk/troubleshooting.adoc

@@ -5,6 +5,7 @@
 :keywords: documentation, tool, sdk, faq
 :relfileprefix: ../
 :imagesdir: ..
+:experimental:
 ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 
@@ -19,19 +20,19 @@ ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 === Stability / Graphics issues
 
-On some Linux and Windows systems, the SDK might perform unstable and quit with native VM crashes or “x errors. There are a few things one can try to remedy those issues.
+On some Linux and Windows systems, the SDK might perform unstable and quit with native VM crashes or "`x`" errors. There are a few things one can try to remedy those issues.
 
 
 ==== Heavyweight Canvas
 
-First of all theres the new “OpenGL” settings page in the SDK global settings where you can enable the “heavyweight canvas, which solved some issues for some people. The settings panel can be found under Tools→Options on Windows and Linux and in the main menu (or by pressing Apple-Comma) for MacOSX.
+First of all theres the new "`OpenGL`" settings page in the SDK global settings where you can enable the "`Heavyweight Canvas`", which solved some issues for some people. The settings panel can be found under `menu:Tools[Options]` on Windows and Linux and in the main menu (or by pressing Apple-Comma) for MacOSX.
 
 If you cannot start the SDK, edit the file `config/Preferences/com/jme3/gde/core.properties` in the SDK settings folder (see above). If it doesn't exist, create the file including all folders. Add the line `use_lwjgl_canvas=true`. To try OpenGL1 compatibility mode (works for both canvas settings) add `use_opengl_1=true`.
 
 
 ==== Look and Feel
 
-The +++<abbr title="Operating System">OS</abbr>+++-built-in look and feel might cause issues, you can change the LAF by using the appropriate command line switch (or add it to the [app folder]/etc/jmonkeyplatform.conf file, without the “- - prefix).
+The +++<abbr title="Operating System">OS</abbr>+++-built-in look and feel might cause issues, you can change the LAF by using the appropriate command line switch (or add it to the [app folder]/etc/jmonkeyplatform.conf file, without the "`- -`" prefix).
 
 [source]
 ----
@@ -52,8 +53,9 @@ or alternatively
 
 ==== Compiz
 
-Compiz on Linux might cause issues, if you set its rendering quality to “medium these should go away.
-* Appearance→Set Special effects to → “Medium”
+Compiz on Linux might cause issues, if you set its rendering quality to "`Medium`" these should go away.
+
+* `menu:Appearance[Set Special effects to > "`Medium`"]`
 
 
 === Updating problems
@@ -70,17 +72,17 @@ If the SDK starts to become sluggish and / or slow or you get unexpected freezes
 
 === Preferences and Settings
 
-To completely remove and/or reinstall the SDK it is vital that the settings folder is deleted too. The location can be seen through the “about menu and is as following for the different +++<abbr title="Operating System">OS</abbr>+++'s:
+To completely remove and/or reinstall the SDK it is vital that the settings folder is deleted too. The location can be seen through the "`about`" menu and is as following for the different +++<abbr title="Operating System">OS</abbr>+++'s:
 
-*  Windows: `C:\Users\&lt;username&gt;\AppData\Roaming\.jmonkeyplatform`
-*  Windows (alt): `C:\Users\&lt;username&gt;\.jmonkeyplatform\`
+*  Windows: `C:\Userspass\<username>\AppData\Roaming\.jmonkeyplatform`
+*  Windows (alt): `C:\Users\<username>\.jmonkeyplatform\`
 *  MacOSX: `/Users/&lt;username&gt;/Library/Application Support/jmonkeyplatform`
 *  Ubuntu:  `/home/&lt;username&gt;/.jmonkeyplatform`
 
 
 === Log
 
-To see or post the error output of the SDK in the forum, you can find the log of the application in the settings folder above too, the file is called `var/log/messages.log`
+To see or post the error output of the SDK in the forum, you can find the log of the application in the settings folder above too, the file is called `var/log/messages.log`.
 
 
 === Getting error messages and reporting issues
@@ -93,7 +95,7 @@ When an exception happens in the SDK, a small warning sign appears in the lower
 You can install another JDK for use with the jMonkey SDK. You then have to specify the location manually.
 
 .  Go to your jMonkeyEngine SDK installation directory. +
-Mac users right-click jMonkeyApplication.app (which actually is a directory) in the Finder and select “Show package contents. 
+Mac users right-click jMonkeyApplication.app (which actually is a directory) in the Finder and select "`Show package contents`". 
 .  Navigate to the `etc` directory. +
 Mac users navigate to `Contents/Resources/jmonkeyplatform/etc/`.
 .  Open the file `jmonkeyplatform.conf` in a text editor.
@@ -109,12 +111,10 @@ jdkhome="/path/to/jdk"
 
 If you're behind a proxy or special network settings, try :
 
-....
-1. disable your network connection
-2. launch jme sdk (may wait 30s/1min for timeout)
-3. go into tools->options->general
-4. setup “manual proxy settings” (for some reason the “Use System Proxy Settings” option doesn't work on some Linux distributions)
-....
+. Disable your network connection.
+. Launch jme sdk (may wait 30s/1min for timeout).
+. Go into `menu:Tools[Options > General]`.
+. Setup "`manual proxy settings`" (for some reason the "`Use System Proxy Settings`" option doesn't work on some Linux distributions)
 
 link:https://hub.jmonkeyengine.org/t/jme-sdk-stalls-on-startup/30555[Discussion] of the problem.