Rewrite bin.7 and render to plaintext README

4 files changed, 83 insertions, 43 deletions

diff --git a/bin/Makefile b/bin/Makefile
index 821e91d0..7e21d39d 100644
--- a/bin/Makefile
+++ b/bin/Makefile
@@ -39,6 +39,9 @@ atch: dtch
 open pbcopy pbpaste: pbd
 	ln -f pbd $@
 
+README: bin.7
+	mandoc bin.7 | sed $$'s/.\b//g' > README
+
 scheme.png: scheme
 	./scheme -t -g > scheme.png
 
diff --git a/bin/README b/bin/README
new file mode 100644
index 00000000..33505b8c
--- /dev/null
+++ b/bin/README
@@ -0,0 +1,24 @@
+bin(7)                 Miscellaneous Information Manual                 bin(7)
+
+NAME
+     bin – various utilities
+
+DESCRIPTION
+     Various tools primarily targeting Darwin, FreeBSD and NetBSD.  Some tools
+     target Linux.
+
+     bri(1)      backlight brightness control
+     dtch(1)     detached sessions
+     fbatt(1)    framebuffer battery indicator
+     fbclock(1)  framebuffer clock
+     glitch(1)   PNG glitcher
+     hnel(1)     PTY input remapper
+     klon(6)     Klondike solitaire
+     modem(1)    fixed baud rate wrapper
+     pbd(1)      macOS pasteboard daemon
+     pngo(1)     PNG optimizer
+     wake(1)     wake-on-LAN
+     watch(1)    watch files
+     xx(1)       hexdump
+
+Causal Agency                 September 11, 2018                 Causal Agency
diff --git a/bin/README.7 b/bin/README.7
deleted file mode 100644
index b8b272b0..00000000
--- a/bin/README.7
+++ /dev/null
@@ -1,43 +0,0 @@
-.Dd September 7, 2018
-.Dt README 7
-.Os "Causal Agency"
-.
-.Sh NAME
-.Nm bin
-.Nd various utilities
-.
-.Sh DESCRIPTION
-Various tools primarily targeting
-Darwin,
-FreeBSD
-and NetBSD.
-Some tools also target Linux.
-.
-.Pp
-To build common tools, run:
-.Dl make
-.
-.Pp
-To build BSD tools, run:
-.Dl make bsd
-.
-.Pp
-To build Linux tools, run:
-.Dl make linux
-.
-.Sh SEE ALSO
-.Xr atch 1 ,
-.Xr bri 1 ,
-.Xr dtch 1 ,
-.Xr fbatt 1 ,
-.Xr fbclock 1 ,
-.Xr glitch 1 ,
-.Xr hnel 1 ,
-.Xr klon 6 ,
-.Xr modem 1 ,
-.Xr pbd 1 ,
-.Xr pngo 1 ,
-.Xr scheme 1 ,
-.Xr wake 1 ,
-.Xr watch 1 ,
-.Xr xx 1
diff --git a/bin/bin.7 b/bin/bin.7
new file mode 100644
index 00000000..aab8b82e
--- /dev/null
+++ b/bin/bin.7
@@ -0,0 +1,56 @@
+.Dd September 11, 2018
+.Dt bin 7
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm bin
+.Nd various utilities
+.
+.Sh DESCRIPTION
+Various tools primarily targeting
+Darwin,
+FreeBSD
+and NetBSD.
+Some tools target Linux.
+.
+.Pp
+.Bl -tag -width "fbclock(1)" -compact
+.It Xr bri 1
+backlight brightness control
+.
+.It Xr dtch 1
+detached sessions
+.
+.It Xr fbatt 1
+framebuffer battery indicator
+.
+.It Xr fbclock 1
+framebuffer clock
+.
+.It Xr glitch 1
+PNG glitcher
+.
+.It Xr hnel 1
+PTY input remapper
+.
+.It Xr klon 6
+Klondike solitaire
+.
+.It Xr modem 1
+fixed baud rate wrapper
+.
+.It Xr pbd 1
+macOS pasteboard daemon
+.
+.It Xr pngo 1
+PNG optimizer
+.
+.It Xr wake 1
+wake-on-LAN
+.
+.It Xr watch 1
+watch files
+.
+.It Xr xx 1
+hexdump
+.El