From 7b561044a9f27cbc3791fe5e1156346ee7c068f1 Mon Sep 17 00:00:00 2001
From: Joachim Wiberg <troglobit@gmail.com>
Date: Fri, 19 Feb 2021 19:03:00 +0100
Subject: [PATCH] doc: slight refactor of signals document

---
 doc/signals.md | 69 ++++++++++++++++++++++++++++++++------------------
 1 file changed, 44 insertions(+), 25 deletions(-)

diff --git a/doc/signals.md b/doc/signals.md
index 2c84dca9..c90d88a1 100644
--- a/doc/signals.md
+++ b/doc/signals.md
@@ -6,31 +6,50 @@ Though Finit comes with its own tools for (poweroff, halt, reboot), for
 compatibility with the existing BusyBox toolset the following signals
 have been adopted:
 
-* `SIGHUP`  
-  Same effect as `finit q`, `init q`, or `initctl reload`, reloads all
-  *.conf files in `/etc/finit.d/`
-* `SIGUSR1`  
-  Calls shutdown hooks, including `HOOK_SHUTDOWN`, stopping all running
-  processes, and unmounts all file systems.  Then tells kernel to halt.
-  Most people these days want `SIGUSR2` though.
+`SIGHUP`
+--------
 
-  SysV init and systemd use this to re-open their FIFO/D-Bus.
-* `SIGUSR2`  
-  Like SIGUSR1, but tell kernel to power-off the system, if ACPI
-  or similar exists to actually do this.  If the kernel fails
-  power-off, Finit falls back to halt.
+Same effect as `finit q`, `init q`, or `initctl reload`, reloads all
+*.conf files in `/etc/finit.d/`
+
+`SIGUSR1`
+---------
+
+Calls shutdown hooks, including `HOOK_SHUTDOWN`, stopping all running
+processes, and unmounts all file systems.  Then tells kernel to halt.
+Most people these days want `SIGUSR2` though.
+
+SysV init and systemd use this to re-open their FIFO/D-Bus.
+
+`SIGUSR2`
+---------
+
+Like SIGUSR1, but tell kernel to power-off the system, if ACPI or
+similar exists to actually do this.  If the kernel fails power-off,
+Finit falls back to halt.
  
-  SysV init N/A, systemd dumps its internal state to log.
-* `SIGTERM`  
-  Like `SIGUSR1`, but tell kernel to reboot the system when done.
+SysV init N/A, systemd dumps its internal state to log.
+
+`SIGTERM`
+---------
+
+Like `SIGUSR1`, but tell kernel to reboot the system when done.
  
-  SysV init N/A, systemd rexecutes itself.
-* `SIGINT`  
-  Sent from kernel when the CTRL-ALT-DEL key combo is pressed.
-  SysV init and systemd default to reboot with `shutdown -r`.  
-  Finit currently forwards this to `SIGTERM`.
-* `SIGPWR`  
-  Sent from a power daemon, like `powstatd(8)`, on changes to the
-  UPS status.  Traditionally SysV init read /etc/powerstatus and
-  acted on "OK", "FAIL", or "LOW" and then removed the file.  
-  Finit currently forwards this to `SIGUSR2`.
+SysV init N/A, systemd rexecutes itself.
+
+`SIGINT`
+--------
+
+Sent from kernel when the CTRL-ALT-DEL key combo is pressed.  SysV init
+and systemd default to reboot with `shutdown -r`.
+
+Finit currently forwards this to `SIGTERM`.
+
+`SIGPWR`
+--------
+
+Sent from a power daemon, like `powstatd(8)`, on changes to the
+UPS status.  Traditionally SysV init read /etc/powerstatus and
+acted on "OK", "FAIL", or "LOW" and then removed the file.  
+Finit currently forwards this to `SIGUSR2`.
+