about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2020-05-03 20:10:29 +0000
committerJune McEnroe <june@causal.agency>2020-05-03 20:10:29 +0000
commit59dc00c7f7741bc811d17769bf545209188621a9 (patch)
tree0dda689ac8dea1933df02a5fc4b6b9a992b590bd
parentAdd install, uninstall targets (diff)
downloadexman-59dc00c7f7741bc811d17769bf545209188621a9.tar.gz
exman-59dc00c7f7741bc811d17769bf545209188621a9.zip
Add exman(1) page
-rw-r--r--Makefile11
-rw-r--r--exman.151
2 files changed, 58 insertions, 4 deletions
diff --git a/Makefile b/Makefile
index 2614ff2..20f9e81 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,6 @@
 PREFIX = /usr/local
+SHAREDIR = ${PREFIX}/share
+MANDIR = ${SHAREDIR}/man
 
 CURL ?= curl
 TAR ?= tar
@@ -38,10 +40,11 @@ STRIP.posix = 1
 clean:
 	rm -fr ${SYSTEMS} *.tar
 
-install: exman ${SYSTEMS}
-	install -d ${PREFIX}/bin ${PREFIX}/share/exman
+install: exman exman.1 ${SYSTEMS}
+	install -d ${PREFIX}/bin ${MANDIR}/man1 ${SHAREDIR}/exman
 	install exman ${PREFIX}/bin
-	${TAR} -c -f - ${SYSTEMS} | ${TAR} -xo -f - -C ${PREFIX}/share/exman
+	gzip -c exman.1 > ${MANDIR}/man1/exman.1.gz
+	${TAR} -c -f - ${SYSTEMS} | ${TAR} -xo -f - -C ${SHAREDIR}/exman
 
 uninstall:
-	rm -fr ${PREFIX}/bin/exman ${PREFIX}/share/exman
+	rm -fr ${PREFIX}/bin/exman ${MANDIR}/man1/exman.1.gz ${SHAREDIR}/exman
diff --git a/exman.1 b/exman.1
new file mode 100644
index 0000000..8ab6976
--- /dev/null
+++ b/exman.1
@@ -0,0 +1,51 @@
+.Dd May  3, 2020
+.Dt EXMAN 1
+.Os
+.
+.Sh NAME
+.Nm exman
+.Nd display manuals for other systems
+.
+.Sh SYNOPSIS
+.Nm
+.Ar system
+.Op Ar options ...
+.Op Ar mansect
+.Ar page ...
+.
+.Sh DESCRIPTION
+The
+.Nm
+utility finds and displays online manual documentation pages
+for other systems.
+All arguments following
+.Ar system
+are passed to
+.Xr man 1 .
+.
+.Pp
+The available systems are as follows:
+.Bl -tag -width "freebsd"
+.It Sy freebsd
+.Fx 12.1-RELEASE
+.It Sy linux
+The Linux man-pages project 5.06
+.It Sy netbsd
+.Nx 9.0
+.It Sy openbsd
+.Ox 6.6
+.It Sy posix
+The Linux man-pages-posix project 2013-a
+.El
+.
+.Sh EXAMPLES
+.Bd -literal
+exman freebsd 4 unix
+exman linux 7 unix
+.Ed
+.
+.Sh SEE ALSO
+.Xr man 1
+.
+.Sh AUTHORS
+.An June Bug Aq Mt june@causal.agency