1 files changed, 81 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/history.1 b/static/plan9-4e/man1/history.1
new file mode 100644
index 00000000..7c8d9643
--- /dev/null
+++ b/static/plan9-4e/man1/history.1
@@ -0,0 +1,81 @@
+.TH HISTORY 1
+.SH NAME
+history \- print file names from the dump
+.SH SYNOPSIS
+.B history
+[
+.B -vDu
+] [
+.B -d
+.I dumpfilesystem
+] [
+.B -s
+.I yyyymmdd
+]
+.I files ...
+.SH DESCRIPTION
+.I History
+prints the names, dates, and sizes, and modifier of all versions of the named
+.IR files ,
+looking backwards in time,
+stored in the dump file system.
+If the file exists in the main tree, the first line of output will be its current state.
+For example,
+.IP
+.EX
+history /adm/users
+.EE
+.PP
+produces
+.IP
+.EX
+May 14 15:29:18 EDT 2001 /adm/users 10083 [adm]
+May 14 15:29:18 EDT 2001 /n/dump/2001/0515/adm/users 10083 [adm]
+May 11 17:26:24 EDT 2001 /n/dump/2001/0514/adm/users 10481 [adm]
+May 10 16:40:51 EDT 2001 /n/dump/2001/0511/adm/users 10476 [adm]
+	...
+.EE
+.PP
+The
+.B -v
+option enables verbose debugging printout.
+.PP
+The 
+.B -D
+option causes
+.IR diff (1)
+.B -n
+to be run for each adjacent pair of dump files, while
+.B -b
+runs
+.IR diff
+.BR -nb .
+.PP
+The
+.B -u
+option causes times to be printed in GMT (UT) rather than local time.
+.PP
+The
+.B -d
+option selects some other dump filesystem such as
+.IR /n/bootesdump .
+.PP
+Finally, the
+.B -s
+option
+sets the starting (most recent) date for the output.
+.SH EXAMPLES
+.PP
+Check how often a user has been logged in.
+.IP
+.EX
+history /usr/ches/tmp
+.EE
+.SH FILES
+.B /n/dump
+.SH SOURCE
+.B /sys/src/cmd/history.c
+.SH SEE ALSO
+.IR fs (4)
+.br
+.IR yesterday (1)