winwatch: l allows label changes

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

diff --git a/sys/man/1/page b/sys/man/1/page
index fee6cab773278a0c26f418c2f4610b9df9f87dde..1c3d5f54dccd15e2612d02e129baa94fdbf2495a 100644 (file)
--- a/sys/man/1/page
+++ b/sys/man/1/page
@@ -8,13 +8,14 @@ files
 .SH SYNOPSIS
 .B page
 [
-.B -abirPRvVw
-]
-[
+.B -iRw
+] [
 .B -p
 .I ppi
-]
-[
+] [
+.B -j
+.I addr
+] [
 .IR file ...
 ]
 .SH DESCRIPTION
@@ -67,18 +68,12 @@ to create a new window for itself.
 The newly created window will grow as under the
 .B -R
 option.
-If being used to display 
-multipage documents,
-only one file may be specified on the command line.
 .PP
 The 
 .B -p 
 option sets the resolution for PostScript and PDF
 files, in pixels per inch.
 The default is 100 ppi.
-The
-.B -r
-option reverses the order in which pages are displayed.
 .PP
 When viewing images with 
 .IR page ,
@@ -96,6 +91,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 +127,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 +141,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
@@ -151,7 +155,7 @@ or
 control-D exits the program.
 .PP
 To go to a specific page, one can type its number followed by enter.
-Typing left arrow, backspace, or minus displays the previous page.
+Typing left arrow or backspace displays the previous page.
 Typing right arrow, space, or enter displays the next page.
 The up and down arrow pan up and down one half screen height,
 changing pages when panning off the top or bottom of the page.
@@ -179,6 +183,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 +197,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).