4 files changed, 51 insertions, 25 deletions
diff --git a/gfx/Makefile b/gfx/Makefile
index 28ade67d..93f04ec0 100644
--- a/gfx/Makefile
+++ b/gfx/Makefile
@@ -27,6 +27,9 @@ brot: brot.o $(GFX).o
 gfxx: gfxx.o $(GFX).o
 	$(CC) $(LDFLAGS) gfxx.o $(GFX).o $(LDLIBS) $(LDLIBS_$(GFX)) -o $@
 
+README: gfx.7
+	mandoc gfx.7 | sed $$'s/.\b//g' > README
+
 clean:
 	rm -f tags *.o $(BINS)
 
diff --git a/gfx/README b/gfx/README
new file mode 100644
index 00000000..206e1a11
--- /dev/null
+++ b/gfx/README
@@ -0,0 +1,18 @@
+gfx(7)                 Miscellaneous Information Manual                 gfx(7)
+
+NAME
+     gfx – graphical utilities
+
+DESCRIPTION
+     Graphial tools targeting Cocoa, X11 and Linux framebuffer.
+
+     brot(1)  Mandelbrot renderer
+     gfxx(1)  graphics data explorer
+
+     To build, run one of:
+
+           make GFX=cocoa
+           make GFX=x11
+           make GFX=fb
+
+Causal Agency                 September 11, 2018                 Causal Agency
diff --git a/gfx/README.7 b/gfx/README.7
deleted file mode 100644
index de29c37f..00000000
--- a/gfx/README.7
+++ /dev/null
@@ -1,25 +0,0 @@
-.Dd September 8, 2018
-.Dt README 7
-.Os "Causal Agency"
-.
-.Sh NAME
-.Nm gfx
-.Nd graphical utilities
-.
-.Sh DESCRIPTION
-Graphial tools targeting
-Cocoa,
-X11
-and Linux framebuffer.
-.
-.Pp
-To build, run one of:
-.Bd -literal -offset indent
-make GFX=cocoa
-make GFX=x11
-make GFX=fb
-.Ed
-.
-.Sh SEE ALSO
-.Xr brot 1 ,
-.Xr gfxx 1
diff --git a/gfx/gfx.7 b/gfx/gfx.7
new file mode 100644
index 00000000..6a7097f1
--- /dev/null
+++ b/gfx/gfx.7
@@ -0,0 +1,30 @@
+.Dd September 11, 2018
+.Dt gfx 7
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm gfx
+.Nd graphical utilities
+.
+.Sh DESCRIPTION
+Graphial tools targeting
+Cocoa,
+X11
+and Linux framebuffer.
+.
+.Pp
+.Bl -tag -width "gfxx(1)" -compact
+.It Xr brot 1
+Mandelbrot renderer
+.
+.It Xr gfxx 1
+graphics data explorer
+.El
+.
+.Pp
+To build,
+run one of:
+.Pp
+.Dl make GFX=cocoa
+.Dl make GFX=x11
+.Dl make GFX=fb