add HISTORY to various man pages

[plan9front.git] / sys / man / 1 / page

diff --git a/sys/man/1/page b/sys/man/1/page
index fee6cab773278a0c26f418c2f4610b9df9f87dde..c86c3f5416b4b8f62e5a559b324e92059db0a7b2 100644 (file)
--- a/sys/man/1/page
+++ b/sys/man/1/page
@@ -9,12 +9,13 @@ files
 .B page
 [
 .B -abirPRvVw
-]
-[
+] [
 .B -p
 .I ppi
-]
-[
+] [
+.B -j
+.I addr
+] [
 .IR file ...
 ]
 .SH DESCRIPTION
@@ -96,6 +97,12 @@ to not load any graphics files nor to read
 from standard input but rather to listen
 for ones to load from the plumbing channel.
 .PP
+The
+.B -j
+option with a page address
+.I addr
+jumps to the specified page on startup.
+.PP
 Pressing and holding button 1 permits panning about the page.
 .PP
 Button 2 raises a menu of operations on the current image or the
@@ -126,6 +133,9 @@ Displays the next page.
 .B Prev
 Displays the previous page.
 .TP
+.B Snarf
+Writes the current page address to the snarf buffer.
+.TP
 .B Zerox
 Displays the current image in a new page window. 
 Useful for selecting important pages from large documents.
@@ -137,7 +147,7 @@ Plan 9 bitmap.
 .B Ext
 Shows the current image using external
 .IR jpg (1)
-program in a separate window. This is mostly usefull for
+program in a separate window. This is mostly useful for
 animated gifs. 
 .PD
 .PP
@@ -179,6 +189,10 @@ page /usr/inferno/icons/*.bit
 Browse the Inferno bitmap library.
 .TP
 .L
+page -j /sys/doc/troff.pdf!7 /sys/doc/troff.pdf
+Jump to page 7 in the troff manual.
+.TP
+.L
 man -t page | page -w
 Preview this manual in a new window.
 .SH "SEE ALSO
@@ -189,6 +203,8 @@ Preview this manual in a new window.
 .SH SOURCE
 .B /sys/src/cmd/page.c
 .SH BUGS
-The interface to the plumber is unsatisfactory.  In particular,
-document references cannot be sent 
-via plumbing messages.
+The interface to the plumber is experimental.
+.SH HISTORY
+.I Page
+first appeared in Plan 9 from Bell Labs. It was rewritten from
+scratch for 9front (September, 2011).