nixos: nixos/doc/manual/administration/maintenance-mode.xml to CommonMark

nixos/doc/manual/administration/maintenance-mode.section.md

@@ -0,0 +1,11 @@
+# Maintenance Mode {#sec-maintenance-mode}
+
+You can enter rescue mode by running:
+
+```ShellSession
+# systemctl rescue
+```
+
+This will eventually give you a single-user root shell. Systemd will
+stop (almost) all system services. To get out of maintenance mode, just
+exit from the rescue shell.

nixos/doc/manual/administration/maintenance-mode.xml

@@ -1,16 +0,0 @@
-<section xmlns="http://docbook.org/ns/docbook"
-        xmlns:xlink="http://www.w3.org/1999/xlink"
-        xmlns:xi="http://www.w3.org/2001/XInclude"
-        version="5.0"
-        xml:id="sec-maintenance-mode">
- <title>Maintenance Mode</title>
-
- <para>
-  You can enter rescue mode by running:
-<screen>
-<prompt># </prompt>systemctl rescue</screen>
-  This will eventually give you a single-user root shell. Systemd will stop
-  (almost) all system services. To get out of maintenance mode, just exit from
-  the rescue shell.
- </para>
-</section>

nixos/doc/manual/administration/troubleshooting.xml

@@ -9,7 +9,7 @@
   you manage your NixOS system.
  </para>
  <xi:include href="../from_md/administration/boot-problems.section.xml" />
- <xi:include href="maintenance-mode.xml" />
+ <xi:include href="../from_md/administration/maintenance-mode.section.xml" />
  <xi:include href="rollback.xml" />
  <xi:include href="store-corruption.xml" />
  <xi:include href="network-problems.xml" />

nixos/doc/manual/from_md/administration/maintenance-mode.section.xml

@@ -0,0 +1,14 @@
+<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-maintenance-mode">
+  <title>Maintenance Mode</title>
+  <para>
+    You can enter rescue mode by running:
+  </para>
+  <programlisting>
+# systemctl rescue
+</programlisting>
+  <para>
+    This will eventually give you a single-user root shell. Systemd will
+    stop (almost) all system services. To get out of maintenance mode,
+    just exit from the rescue shell.
+  </para>
+</section>