More re-wording of "dinit as init" Linux documentation
authorDavin McCall <davmac@davmac.org>
Sat, 10 Aug 2019 04:09:31 +0000 (14:09 +1000)
committerDavin McCall <davmac@davmac.org>
Wed, 11 Sep 2019 10:30:04 +0000 (20:30 +1000)
doc/linux/DINIT-AS-INIT.md

index ff791f2aefcd00f29941b78fb76fbede5ec164f1..716b68e8e89720b02d2fa337b17eb2e802e0bec0 100644 (file)
@@ -2,22 +2,22 @@
 
 You can use Dinit, in conjunction with other software, to boot your system and
 replace your current init system (which on most main distributions is now
 
 You can use Dinit, in conjunction with other software, to boot your system and
 replace your current init system (which on most main distributions is now
-Systemd, Sys V init, or OpenRC). Be warned that a modern Linux system is
-complex and changing your init system will require some effort and
-preparation.
-
-Be warned that it is not a trivial task to take a system based on a typical
-Linux distribution and make it instead boot with Dinit. You need to set up
-suitable service description files for your system; at present there are no
-automated conversion tools for converting service descriptions or startup
-scripts from other systems. For example service files, please check the
-`services` subdirectory.
-
-Once you have service descriptions ready, to have Dinit run as your system
-init, replace your system's `/sbin/init` with a link to the `dinit`
-executable. For testing, it's a good idea to leave your existing init in
-place, and use Dinit by adding "init=/sbin/dinit" (for example) to the kernel
-command line when booting.
+Systemd, Sys V init, or OpenRC).
+
+Be warned that a modern Linux system is complex and changing your init system
+will require some effort and preparation. It is not a trivial task to take a
+system based on a typical Linux distribution that uses some particular init
+system and make it instead boot with Dinit. You need to set up suitable
+service description files for your system; at present there are no automated
+conversion tools for converting service descriptions or startup scripts from
+other systems. For example service files, please check the `services`
+subdirectory.
+
+Once you have service descriptions ready, you can test Dinit by adding
+"init=/sbin/dinit" (for example) to the kernel command line when booting. 
+To have Dinit run as your system init (once you are satisfied that the service
+descriptions are correct and that the system is bootable via Dinit), replace
+your system's `/sbin/init` with a link to the `dinit` executable. 
 
 *Note*: if your system boots via an "initrd" (initial ramdisk image), you
 might need to either adjust the ramdisk image to include `dinit` or switch
 
 *Note*: if your system boots via an "initrd" (initial ramdisk image), you
 might need to either adjust the ramdisk image to include `dinit` or switch
@@ -145,7 +145,7 @@ https://github.com/lxc/cgmanager
 
 (However, I believe that cgmanager works with the old v1 cgroups interface.
 I expect that v2 cgroups together with cgroup namespaces as found in newer
 
 (However, I believe that cgmanager works with the old v1 cgroups interface.
 I expect that v2 cgroups together with cgroup namespaces as found in newer
-kernels will render it obselete).
+kernels will render it obsolete).
 
 The above use **Dbus**:
 https://dbus.freedesktop.org/
 
 The above use **Dbus**:
 https://dbus.freedesktop.org/