build: Better Build System

1 files changed, 122 insertions, 0 deletions

diff --git a/static/plan9-4e/man1/yesterday.1 b/static/plan9-4e/man1/yesterday.1
new file mode 100644
index 00000000..123366b7
--- /dev/null
+++ b/static/plan9-4e/man1/yesterday.1
@@ -0,0 +1,122 @@
+.TH YESTERDAY 1
+.SH NAME
+yesterday \- print file names from the dump
+.SH SYNOPSIS
+.B yesterday
+[
+.B -abcCdD
+] [
+.B -n
+.I daysago
+] [
+.I \-date
+]
+.I files ...
+.SH DESCRIPTION
+.I Yesterday
+prints the names of the
+.I files
+from the most recent dump.
+Since dumps are done early in the morning,
+yesterday's files are really in today's dump.
+For example, if today is March 17, 1992,
+.IP
+.EX
+yesterday /adm/users
+.EE
+.PP
+prints
+.IP
+.EX
+/n/dump/1992/0317/adm/users
+.EE
+.PP
+In fact, the implementation is to select the most recent dump in
+the current year, so the dump selected may not be from today.
+.PP
+By default, 
+.I yesterday
+prints the names of the dump files corresponding to the named files.
+The first set of options changes this behavior.
+.TP
+.B -a
+Run
+.IR acme (1)'s
+.I adiff
+to compare the dump files with the named files.
+.TP
+.B -b
+Bind the dump files over the named files.
+.TP
+.B -c
+Copy the dump files over the named files.
+.TP
+.B -C
+Copy the dump files over the named files only when
+they differ.
+.TP
+.B -d
+Run 
+.B diff
+to compare the dump files with the named files.
+.TP
+.B -D
+Run 
+.B diff
+.B -n
+to compare the dump files with the named files.
+.PP
+The
+.I date
+option selects other day's dumps, with a format of
+1, 2, 4, 6, or 8 digits of the form
+.IR d,
+.IR dd ,
+.IR mmdd ,
+.IR yymmdd ,
+or
+.IR yyyymmdd .
+.PP
+The
+.B -n
+option selects the dump
+.I daysago
+prior to the current day.
+.PP
+.I Yesterday
+does not guarantee that the string it prints represents an existing file.
+.SH EXAMPLES
+.PP
+Back up to yesterday's MIPS binary of
+.BR vc :
+.IP
+.EX
+yesterday -c /mips/bin/vc
+.EE
+.PP
+Temporarily back up to March 1's MIPS C library to see if a program
+runs correctly when loaded with it:
+.IP
+.EX
+yesterday -b -0301 /mips/lib/libc.a
+rm v.out
+mk
+v.out
+.EE
+.PP
+Find what has changed in the C library since March 1:
+.IP
+.EX
+yesterday -d -0301 /sys/src/libc/port/*.c
+.EE
+.SH FILES
+.B /n/dump
+.SH SOURCE
+.B /rc/bin/yesterday
+.SH SEE ALSO
+.IR history (1),
+.IR bind (1),
+.IR diff (1),
+.IR fs (4).
+.SH BUGS
+It's hard to use this command without singing.