Include a note on how to change init system during install

4 files changed, 27 insertions, 0 deletions

diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent
index dd3e8d273..6030e042b 100644
--- a/build/templates/docstruct.ent
+++ b/build/templates/docstruct.ent
@@ -126,6 +126,8 @@
   <!ENTITY module-pkgsel.xml             SYSTEM "##SRCPATH##/using-d-i/modules/pkgsel.xml">
   <!ENTITY loading-firmware.xml          SYSTEM "##SRCPATH##/using-d-i/loading-firmware.xml">
 
+  <!ENTITY customization.xml             SYSTEM "##SRCPATH##/using-d-i/customization.xml">
+
   <!-- No longer used; should be removed after translation updates -->
   <!ENTITY module-mips-arcboot-installer.xml  SYSTEM "##SRCPATH##/using-d-i/modules/mips/arcboot-installer.xml">
   <!ENTITY module-mipsel-colo-installer.xml  SYSTEM "##SRCPATH##/using-d-i/modules/mipsel/colo-installer.xml">
diff --git a/debian/changelog b/debian/changelog
index a91fb8369..779eb1c77 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,7 @@
 installation-guide (20210805) UNRELEASED; urgency=medium
 
   * Update supported devices in Bullseye for armel.
+  * Include a note on how to change init system during install. Closes: #992034
 
   [ Updated translations ]
   * Catalan by d
diff --git a/en/using-d-i/customization.xml b/en/using-d-i/customization.xml
new file mode 100644
index 000000000..7bf8e66b2
--- /dev/null
+++ b/en/using-d-i/customization.xml
@@ -0,0 +1,23 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id$ -->
+
+<sect1 id="customization">
+<title>Customization</title>
+<para>
+Using the shell (see <xref linkend="shell"/>), the installation process
+can be carefully customized, to fit exceptional use cases:
+</para>
+
+  <sect2><title>Installing an alternative init system</title>
+<para>
+&debian; uses systemd as its default init system. However, other init
+systems (such as sysvinit and OpenRC) are supported, and the
+easiest time to select an alternative init system is during the
+installation process. For detailed instructions on how to do so,
+please see the <ulink
+url="https://wiki.debian.org/Init#Changing_the_init_system_-_at_installation_time">Init
+page on the Debian wiki</ulink>.
+</para>
+
+  </sect2>
+ </sect1>
diff --git a/en/using-d-i/using-d-i.xml b/en/using-d-i/using-d-i.xml
index 3561ced2d..909fb7b60 100644
--- a/en/using-d-i/using-d-i.xml
+++ b/en/using-d-i/using-d-i.xml
@@ -446,6 +446,7 @@ report installer software problems to &debian; developers later.
 
 &using-d-i-components.xml;
 &loading-firmware.xml;
+&customization.xml;
 
 </chapter>