[hackers] [sinit] Update manpage || sin

From: <git_AT_suckless.org>
Date: Thu, 04 Dec 2014 15:20:55 +0100

commit f8536ea0d905993652caf1950d6aae1fca881e0f
Author: sin <sin_AT_2f30.org>
Date: Thu Dec 4 14:07:35 2014 +0000

    Update manpage

diff --git a/sinit.8 b/sinit.8
index 75600a3..0e40fc4 100644
--- a/sinit.8
+++ b/sinit.8
_AT_@ -1,30 +1,62 @@
-.TH SINIT 8 sinit-VERSION
-.SH NAME
-sinit \- The suckless init
-.SH DESCRIPTION
-sinit is a simple init. It is configured by modifying `config.h'
+.Dd December 4, 2014
+.Dt SINIT 8 sinit\-VERSION
+.Os
+.Sh NAME
+.Nm sinit
+.Nd simple init
+.Sh DESCRIPTION
+.Nm
+is a simple init. It is configured by modifying
+.Dq config.h
 and recompiling the code.
-.SS Init sequence
-sinit will by default execute `/bin/rc.init'. You can chain
-your init scripts together at that point to allow for single-user
-and multi-user mode.
-.SS Signal handling
-sinit will respond to the following set of signals:
-.IP USR1
+.Ss Init sequence
+By default
+.Nm
+will execute
+.Dq /bin/rc.init .
+You can chain your init scripts together at that point to allow for
+single-user and multi-user operation.
+.Ss Signal handling
+.Nm
+will respond to the following signals:
+.Bl -tag -width xxxxxxxx
+.It USR1
 Default action is to initiate the shutdown sequence by
-executing `/bin/rc.shutdown poweroff'.
-.IP INT
+executing
+.Dq /bin/rc.shutdown poweroff .
+.It INT
 Default action is to initiate the reboot sequence by
-executing `/bin/rc.shutdown reboot'.
-.IP CHLD
+executing
+.Dq /bin/rc.shutdown reboot .
+.It CHLD
 Reap children.
-.SS General considerations
-Running the rc.shutdown script directly is not recommended. If any
+.El
+.Ss General considerations
+Running the
+.Dq rc.shutdown
+script directly is not recommended. If any
 process in your session has stale filesystem references then it is
 likely your init scripts will fail to unmount the filesystem cleanly.
-It is recommended to signal sinit via a wrapper script.
-Similarly, sinit does not clear utmp records. The version of getty(8)
+It is recommended to signal
+.Nm
+via a wrapper script.
+.Pp
+.Nm
+does not clear utmp records. The version of
+.Xr getty 8
 in ubase clears the utmp entries on the specified tty before it
-spawns the given program, usually login(1).
-.SH SEE ALSO
-killall5(8), getty(8)
+spawns the given program, usually
+.Xr login 1 .
+.Pp
+.Nm
+does not restart
+.Xr getty 8
+or interact with it in any way. You will need an external
+respawning mechanism to restart it.
+.Sh SEE ALSO
+.Xr killall5 8 ,
+.Xr getty 8
+.Sh AUTHORS
+The
+.Nm
+program was written by Dimitris Papastamos <sin_AT_2f30.org>.
Received on Thu Dec 04 2014 - 15:20:55 CET