1 058b0118 2005-01-03 devnull .TH PAGE 1
3 c0cc7cc4 2009-08-21 t.lainson page \- view
5 058b0118 2005-01-03 devnull image, graphic, PostScript, PDF, and
6 058b0118 2005-01-03 devnull typesetter output
8 058b0118 2005-01-03 devnull .SH SYNOPSIS
11 c0cc7cc4 2009-08-21 t.lainson .B -abirPRvVw
18 058b0118 2005-01-03 devnull .IR file ...
20 c0cc7cc4 2009-08-21 t.lainson .SH DESCRIPTION
21 c0cc7cc4 2009-08-21 t.lainson .I Page
22 c0cc7cc4 2009-08-21 t.lainson is a general purpose document viewer.
23 c0cc7cc4 2009-08-21 t.lainson It can be used to display the individual pages
25 c0cc7cc4 2009-08-21 t.lainson PostScript,
28 c0cc7cc4 2009-08-21 t.lainson .IR troff (1)
30 c0cc7cc4 2009-08-21 t.lainson Unix's \fItex\fR(1)
31 c0cc7cc4 2009-08-21 t.lainson device-independent output
33 c0cc7cc4 2009-08-21 t.lainson .I Troff
36 c0cc7cc4 2009-08-21 t.lainson output is simply converted to PostScript in order to be viewed.
37 c0cc7cc4 2009-08-21 t.lainson It can also be used to view any number of
38 c0cc7cc4 2009-08-21 t.lainson graphics files
39 c0cc7cc4 2009-08-21 t.lainson (such as a
42 c0cc7cc4 2009-08-21 t.lainson a Plan 9
43 c0cc7cc4 2009-08-21 t.lainson .IR image (7)
44 c0cc7cc4 2009-08-21 t.lainson file, an Inferno bitmap file, or other common format).
45 c0cc7cc4 2009-08-21 t.lainson .I Page
46 c0cc7cc4 2009-08-21 t.lainson displays these
47 c0cc7cc4 2009-08-21 t.lainson in sequence.
48 c0cc7cc4 2009-08-21 t.lainson In the absence of named files,
49 c0cc7cc4 2009-08-21 t.lainson .I page
50 c0cc7cc4 2009-08-21 t.lainson reads one from standard input.
52 c0cc7cc4 2009-08-21 t.lainson By default,
53 c0cc7cc4 2009-08-21 t.lainson .I page
54 c0cc7cc4 2009-08-21 t.lainson runs in the window in which it is started
55 c0cc7cc4 2009-08-21 t.lainson and leaves the window unchanged.
58 c0cc7cc4 2009-08-21 t.lainson option causes
59 c0cc7cc4 2009-08-21 t.lainson .I page
60 c0cc7cc4 2009-08-21 t.lainson to grow the window if necessary
61 c0cc7cc4 2009-08-21 t.lainson to display the page being viewed.
64 c0cc7cc4 2009-08-21 t.lainson option causes
65 c0cc7cc4 2009-08-21 t.lainson .I page
66 c0cc7cc4 2009-08-21 t.lainson to create a new window for itself.
67 c0cc7cc4 2009-08-21 t.lainson The newly created window will grow as under the
69 c0cc7cc4 2009-08-21 t.lainson option.
70 c0cc7cc4 2009-08-21 t.lainson If being used to display
71 c0cc7cc4 2009-08-21 t.lainson multipage documents,
72 c0cc7cc4 2009-08-21 t.lainson only one file may be specified on the command line.
76 c0cc7cc4 2009-08-21 t.lainson option sets the resolution for PostScript and PDF
77 c0cc7cc4 2009-08-21 t.lainson files, in pixels per inch.
78 c0cc7cc4 2009-08-21 t.lainson The default is 100 ppi.
81 c0cc7cc4 2009-08-21 t.lainson option reverses the order in which pages are displayed.
83 c0cc7cc4 2009-08-21 t.lainson When viewing a document,
85 c0cc7cc4 2009-08-21 t.lainson will try to guess the true bounding box, usually rounding up from
86 c0cc7cc4 2009-08-21 t.lainson the file's bounding box to
87 c0cc7cc4 2009-08-21 t.lainson 8½×11 or A4 size.
90 c0cc7cc4 2009-08-21 t.lainson option causes it to respect the bounding box given in the file.
91 c0cc7cc4 2009-08-21 t.lainson As a more general problem,
92 c0cc7cc4 2009-08-21 t.lainson some PostScript files claim to conform to Adobe's
93 c0cc7cc4 2009-08-21 t.lainson Document Structuring Conventions but do not.
96 c0cc7cc4 2009-08-21 t.lainson option enables a slightly slower and slightly more
97 c0cc7cc4 2009-08-21 t.lainson skeptical version of the PostScript processing code.
98 c0cc7cc4 2009-08-21 t.lainson Unfortunately, there are PostScript documents
99 c0cc7cc4 2009-08-21 t.lainson that can only be viewed with the
101 c0cc7cc4 2009-08-21 t.lainson option, and there are PostScript documents that
102 c0cc7cc4 2009-08-21 t.lainson can only be viewed without it.
104 c0cc7cc4 2009-08-21 t.lainson When viewing images with
105 c0cc7cc4 2009-08-21 t.lainson .IR page ,
106 c0cc7cc4 2009-08-21 t.lainson it listens to the
107 c0cc7cc4 2009-08-21 t.lainson .B image
108 c0cc7cc4 2009-08-21 t.lainson plumbing channel
110 c0cc7cc4 2009-08-21 t.lainson .IR plumber (4))
111 c0cc7cc4 2009-08-21 t.lainson for more images to display.
114 c0cc7cc4 2009-08-21 t.lainson option causes
116 c0cc7cc4 2009-08-21 t.lainson to not load any graphics files nor to read
117 c0cc7cc4 2009-08-21 t.lainson from standard input but rather to listen
118 c0cc7cc4 2009-08-21 t.lainson for ones to load from the plumbing channel.
122 c0cc7cc4 2009-08-21 t.lainson option turns on extra debugging output, and
125 c0cc7cc4 2009-08-21 t.lainson option turns on even more debugging output.
128 c0cc7cc4 2009-08-21 t.lainson option causes
129 c0cc7cc4 2009-08-21 t.lainson .I page
130 c0cc7cc4 2009-08-21 t.lainson to call
131 c0cc7cc4 2009-08-21 t.lainson Unix's \fIabort\fR(3)
132 c0cc7cc4 2009-08-21 t.lainson rather than exit cleanly on errors,
133 c0cc7cc4 2009-08-21 t.lainson to facilitate debugging.
135 c0cc7cc4 2009-08-21 t.lainson Pressing and holding button 1 permits panning about the page.
137 c0cc7cc4 2009-08-21 t.lainson Button 2 raises a menu of operations on the current image or the
138 c0cc7cc4 2009-08-21 t.lainson entire set. The image transformations are non-destructive and are
139 c0cc7cc4 2009-08-21 t.lainson valid only for the currently displayed image. They are lost as soon
140 c0cc7cc4 2009-08-21 t.lainson as another image is displayed.
141 c0cc7cc4 2009-08-21 t.lainson The button 2 menu operations are:
142 c0cc7cc4 2009-08-21 t.lainson .TF Resize
144 c0cc7cc4 2009-08-21 t.lainson .B Orig size
145 c0cc7cc4 2009-08-21 t.lainson Restores the image to the original. All modifications are lost.
147 c0cc7cc4 2009-08-21 t.lainson .B Zoom
148 c0cc7cc4 2009-08-21 t.lainson Prompts the user to sweep a rectangle on the image which is
149 c0cc7cc4 2009-08-21 t.lainson expanded proportionally to the rectangle.
151 c0cc7cc4 2009-08-21 t.lainson .B Fit window
152 c0cc7cc4 2009-08-21 t.lainson Resizes the image so that it fits in the current window.
154 c0cc7cc4 2009-08-21 t.lainson .B Rotate 90
155 c0cc7cc4 2009-08-21 t.lainson Rotates the image 90 degrees clockwise
157 c0cc7cc4 2009-08-21 t.lainson .B Upside down
158 c0cc7cc4 2009-08-21 t.lainson Toggles whether images are displayed upside-down.
160 c0cc7cc4 2009-08-21 t.lainson .B Next
161 c0cc7cc4 2009-08-21 t.lainson Displays the next page.
163 c0cc7cc4 2009-08-21 t.lainson .B Prev
164 c0cc7cc4 2009-08-21 t.lainson Displays the previous page.
166 c0cc7cc4 2009-08-21 t.lainson .B Zerox
167 c0cc7cc4 2009-08-21 t.lainson Displays the current image in a new page window.
168 c0cc7cc4 2009-08-21 t.lainson Useful for selecting important pages from large documents.
170 c0cc7cc4 2009-08-21 t.lainson .B Reverse
171 c0cc7cc4 2009-08-21 t.lainson Reverses the order in which pages are displayed.
173 c0cc7cc4 2009-08-21 t.lainson .B Write
174 c0cc7cc4 2009-08-21 t.lainson Writes the image to file.
177 c0cc7cc4 2009-08-21 t.lainson Button 3 raises a menu of the
179 c0cc7cc4 2009-08-21 t.lainson to be selected for viewing in any order.
181 c0cc7cc4 2009-08-21 t.lainson Typing a
184 c0cc7cc4 2009-08-21 t.lainson control-D exits the program.
185 c0cc7cc4 2009-08-21 t.lainson Typing a
187 c0cc7cc4 2009-08-21 t.lainson toggles whether images are displayed upside-down.
188 c0cc7cc4 2009-08-21 t.lainson (This is useful in the common case of mistransmitted upside-down faxes).
189 c0cc7cc4 2009-08-21 t.lainson Typing a
191 c0cc7cc4 2009-08-21 t.lainson reverses the order in which pages are displayed.
192 c0cc7cc4 2009-08-21 t.lainson Typing a
194 c0cc7cc4 2009-08-21 t.lainson will write the currently viewed page to a new file as a compressed
195 c0cc7cc4 2009-08-21 t.lainson .IR image (7)
197 c0cc7cc4 2009-08-21 t.lainson When possible, the filename is of the form
198 c0cc7cc4 2009-08-21 t.lainson .IR basename . pagenum . bit .
199 c0cc7cc4 2009-08-21 t.lainson Typing a
201 c0cc7cc4 2009-08-21 t.lainson removes an image from the working set.
203 c0cc7cc4 2009-08-21 t.lainson To go to a specific page, one can type its number followed by enter.
204 c0cc7cc4 2009-08-21 t.lainson Typing left arrow, backspace, or minus displays the previous page.
205 c0cc7cc4 2009-08-21 t.lainson Typing right arrow, space, or enter displays the next page.
206 c0cc7cc4 2009-08-21 t.lainson The up and down arrow pan up and down one half screen height,
207 c0cc7cc4 2009-08-21 t.lainson changing pages when panning off the top or bottom of the page.
209 c0cc7cc4 2009-08-21 t.lainson .I Page
211 c0cc7cc4 2009-08-21 t.lainson Unix's \fIgs\fR(1)
212 c0cc7cc4 2009-08-21 t.lainson to draw each page of PostScript
215 c0cc7cc4 2009-08-21 t.lainson .IR files .
216 c0cc7cc4 2009-08-21 t.lainson It also calls a variety of conversion programs, such as those described in
217 c0cc7cc4 2009-08-21 t.lainson .IR jpg (1),
218 c0cc7cc4 2009-08-21 t.lainson to convert the various raster graphics formats
219 c0cc7cc4 2009-08-21 t.lainson into Inferno bitmap files.
220 c0cc7cc4 2009-08-21 t.lainson Pages are converted ``on the fly,'' as needed.
221 c0cc7cc4 2009-08-21 t.lainson .SH EXAMPLES
224 c0cc7cc4 2009-08-21 t.lainson page /sys/src/cmd/gs/examples/tiger.eps
225 c0cc7cc4 2009-08-21 t.lainson Display a color PostScript file.
228 c0cc7cc4 2009-08-21 t.lainson page /usr/inferno/icons/*.bit
229 c0cc7cc4 2009-08-21 t.lainson Browse the Inferno bitmap library.
232 c0cc7cc4 2009-08-21 t.lainson man -t page | page -w
233 c0cc7cc4 2009-08-21 t.lainson Preview this manual in a new window.
234 058b0118 2005-01-03 devnull .SH "SEE ALSO
235 058b0118 2005-01-03 devnull .IR gs (1),
236 058b0118 2005-01-03 devnull .IR jpg (1),
237 058b0118 2005-01-03 devnull .IR proof (1),
238 058b0118 2005-01-03 devnull .IR tex (1),
239 058b0118 2005-01-03 devnull .IR troff (1)
240 058b0118 2005-01-03 devnull .SH SOURCE
241 c0cc7cc4 2009-08-21 t.lainson .B \*9/src/cmd/page
242 c0cc7cc4 2009-08-21 t.lainson .SH DIAGNOSTICS
243 c0cc7cc4 2009-08-21 t.lainson The mouse cursor changes to an arrow and ellipsis
245 c0cc7cc4 2009-08-21 t.lainson .I page
246 c0cc7cc4 2009-08-21 t.lainson is reading or writing a file.
247 f6bc9149 2005-01-11 devnull .SH BUGS
248 c0cc7cc4 2009-08-21 t.lainson .I Page
249 c0cc7cc4 2009-08-21 t.lainson supports reading of only one document
250 c0cc7cc4 2009-08-21 t.lainson file at a time, and
251 c0cc7cc4 2009-08-21 t.lainson the user interface is clumsy when viewing very large documents.
253 c0cc7cc4 2009-08-21 t.lainson When viewing multipage PostScript files that do not contain
254 c0cc7cc4 2009-08-21 t.lainson .RB `` %%Page ''
255 c0cc7cc4 2009-08-21 t.lainson comments, the button 3 menu only contains
256 c0cc7cc4 2009-08-21 t.lainson ``this page'' and ``next page'':
257 c0cc7cc4 2009-08-21 t.lainson correctly determining
258 c0cc7cc4 2009-08-21 t.lainson page boundaries in Postscript code is not computable
259 c0cc7cc4 2009-08-21 t.lainson in the general case.
263 c0cc7cc4 2009-08-21 t.lainson has trouble viewing a Postscript file,
264 c0cc7cc4 2009-08-21 t.lainson it might not be exactly conforming: try viewing it with the
266 c0cc7cc4 2009-08-21 t.lainson option.
268 c0cc7cc4 2009-08-21 t.lainson The interface to the plumber is unsatisfactory. In particular,
269 c0cc7cc4 2009-08-21 t.lainson document references cannot be sent
270 c0cc7cc4 2009-08-21 t.lainson via plumbing messages.
272 c0cc7cc4 2009-08-21 t.lainson There are too many keyboard commands and menu items.
274 b763f1e0 2011-10-31 rsc Displaying a PostScript or PDF file depends both on having
278 b763f1e0 2011-10-31 rsc installed and on the underlying operating system
279 b763f1e0 2011-10-31 rsc providing a file descriptor device tree at
280 b763f1e0 2011-10-31 rsc .BR /dev/fd .
282 b763f1e0 2011-10-31 rsc Some FreeBSD installations
283 b763f1e0 2011-10-31 rsc do not provide file descriptors greater than 2
285 b763f1e0 2011-10-31 rsc .BR /dev/fd .
286 b763f1e0 2011-10-31 rsc To fix this, add
289 b763f1e0 2011-10-31 rsc /fdescfs /dev/fd fdescfs rw 0 0
293 b763f1e0 2011-10-31 rsc .BR /etc/fstab ,
296 b763f1e0 2011-10-31 rsc .BR /dev/fd .
297 b763f1e0 2011-10-31 rsc (Adding the line to
299 b763f1e0 2011-10-31 rsc ensures causes FreeBSD to mount the file system
300 b763f1e0 2011-10-31 rsc automatically at boot time.)