Update inline documentation for Debian finit.conf

Signed-off-by: Joachim Nilsson <troglobit@gmail.com>

contrib/debian/finit.conf

@@ -1,6 +1,8 @@
 # /etc/finit.conf: Example for Debian GNU/Linux 8.5
+# Here we use one big (?) finit.conf, but all non-bootstrap services
+# can just as easily be listed in a separate /etc/finit.d/*.conf
 
-# The host directive is a fallback/alternative if /etc/hostname is missing
+# The host directive is a fallback if /etc/hostname is missing
 host jessie
 
 # The user directive is only for the startx directive, which in turn is
@@ -14,14 +16,14 @@ module evdev
 module loop
 module psmouse
 
-# Runlevel to start after bootstrap, runlevel 'S'.  Change this to
+# Runlevel to start after bootstrap, runlevel 'S'.
-# 3 to start XDM at boot.  Reminds you a bit of /etc/inittab huh?
+# Change this to 3 to start XDM at boot.
 runlevel 2
 
 # Some services may need to start very early, e.g. a watchdog daemon.
-# Runlevel [S] (bootStrap) is useful for that, it cannot be restarted
+# Runlevel [S] (bootStrap) is useful for that.  It cannot be switched
-# either, so tasks and run directives usually live here.  Please note,
+# to at runtime either, so tasks and run directives usually live here.
-# te run directive is blocking, so be careful!
+# Please note, the run directive is blocking, so be careful!
 #service [S12345] /sbin/watchdogd -n				-- Watchdog daemon
 #run [S] /sbin/probe						-- system probe
 #run [S] /sbin/setupd --bootstrap				-- system bootstrap
@@ -30,7 +32,10 @@ service [S12345] /usr/sbin/rsyslogd -n				-- Syslog daemon
 # Network bringup script not needed if /etc/network/interfaces is used
 #network service networking start
 
-# Regular services to be monitored and respawned as needed
+# Regular services to be monitored and respawned as needed.  Here we use
+# a (svc) condition, the listed service must be started (waits for the
+# PID file to be created in /run/*.pid) before starting either service,
+# (net) conditions are also available.
 service [2345] <svc/usr/sbin/rsyslogd> log /usr/sbin/acpid -f	-- ACPI daemon
 service [2345] <svc/usr/sbin/rsyslogd> /usr/sbin/sshd -D	-- SSH daemon
 
@@ -47,18 +52,9 @@ runparts /etc/start.d
 #          |-- S17kbd
 #           `- S18console-setup
 
-# Alternative using tasks instead of runparts.  Tasks are one-shot per
-# runlevel, so will run once, in parallel when switching to an allowed
-# runlevel.  The following commented out example default to runlevels
-# [2345].  Another approach for keyboard-setup & C:o that only need to
-# run once per boot, is to run them in [S] or put them in /etc/rc.local
-#task log /etc/init.d/keyboard-setup start			-- Setting up preliminary keymap
-#task log /etc/init.d/kbd start					-- Preparing console
-
 # Virtual consoles to start getty on.  Runlevels, speed & $TERM optional
 # TTYs are also services, sort of, but they are guaranteed to start at
-# the very end of the boot sequence.
+# the very end of the boot sequence.  Finit comes with a built-in getty.
 tty [12345] /dev/tty1 115200 vt100
 tty [2345]  /dev/tty2  38400 linux
 tty [2345]  /dev/tty3  38400 linux
-