From a0c773d4a4ad855e8e0e5bb19039cea3ed05965b Mon Sep 17 00:00:00 2001
From: Jonas DOREL <jonas@dorel.me>
Date: Sat, 15 Feb 2020 15:00:45 +0100
Subject: [PATCH] Move gui-troubleshooting to
 gui-configuration-and-troubleshooting

---
 external/troubleshooting/gui-not-working.md   | 33 ------------------
 .../gui-configuration.md                      | 34 ++++++++++++++++---
 2 files changed, 29 insertions(+), 38 deletions(-)
 delete mode 100644 external/troubleshooting/gui-not-working.md

diff --git a/external/troubleshooting/gui-not-working.md b/external/troubleshooting/gui-not-working.md
deleted file mode 100644
index 769db6fb..00000000
--- a/external/troubleshooting/gui-not-working.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: doc
-title: GUI Troubleshooting
-  permalink: /doc/gui-troubleshooting/
-redirect_from:
-- /en/doc/gui-troubleshooting/
-- /doc/GuiTroubleshooting/
-- /wiki/GuiTroubleshooting/
----
-
-# GUI Troubleshooting
-
-If you can start your VM, but can't launch any applications, then you need to fix the issues from the `VM console`, accessible from xen through:
-
-~~~
-qvm-start <VMname> # Make sure the VM is started
-sudo xl console <VMname>
-~~~
-
-## Tips
-
-### Disable auditd messages
-
-To disable auditd messages, you need to edit your VM kernel parameters:
-
-~~~
-previous_kernel_parameters=$(qvm-prefs --get <VMname> kernelopts) # Get current kernel parameters
-qvm-prefs --set <VMname> kernelopts "<previous_kernel_parameters> audit=0"
-~~~
-
-Then, restart your VM.
-
-Once your troubleshooting is done, don't forget to remove this kernel parameters, it makes troubleshooting VMs not starting easier.
diff --git a/user/advanced-configuration/gui-configuration.md b/user/advanced-configuration/gui-configuration.md
index f8dd096b..37a71cdf 100644
--- a/user/advanced-configuration/gui-configuration.md
+++ b/user/advanced-configuration/gui-configuration.md
@@ -1,14 +1,14 @@
 ---
 layout: doc
 title: GUI Configuration and Troubleshooting
-permalink: /doc/gui-configuration/
+permalink: /doc/gui-configuration-and-troubleshooting/
+redirect_from:
+  - /doc/gui-configuration/
 ---
 
-GUI Configuration and Troubleshooting
-=====================================
+# GUI Configuration and Troubleshooting
 
-Video RAM adjustment for high-resolution displays
--------------------------------------------------
+## Video RAM adjustment for high-resolution displays
 
 **Problem:** You have a 4K external display, and when you connect it, you can't click on anything but a small area in the upper-right corner.
 
@@ -50,3 +50,27 @@ Section "Device"
         Option "TearFree" "true"
 EndSection
 ```
+
+## GUI Troubleshooting
+
+If you can start your VM, but can't launch any applications, then you need to fix the issues from the `VM console`, accessible from xen through:
+
+```sh
+qvm-start <VMname> # Make sure the VM is started
+sudo xl console <VMname>
+```
+
+### Tips
+
+#### Disable auditd messages
+
+To disable auditd messages, you need to edit your VM kernel parameters:
+
+```sh
+previous_kernel_parameters=$(qvm-prefs --get <VMname> kernelopts) # Get current kernel parameters
+qvm-prefs --set <VMname> kernelopts "<previous_kernel_parameters> audit=0"
+```
+
+Then, restart your VM.
+
+Once your troubleshooting is done, don't forget to remove this kernel parameters, it makes troubleshooting VMs not starting easier.