glenda.party
term% ls -F
term% pwd
$home/manuals/9front/1/page
term% cat index.txt
PAGE(1)                     General Commands Manual                    PAGE(1)



NAME
       page - view FAX, image, graphic, PostScript, PDF, and typesetter output
       files

SYNOPSIS
       page [ -iRw ] [ -p ppi ] [ -j addr ] [ file...  ]

DESCRIPTION
       Page is a general purpose document viewer.  It can be used  to  display
       the individual pages of a PostScript, PDF, or tex(1) or troff(1) device
       independent output file.  Tex or troff output is  simply  converted  to
       PostScript in order to be viewed.  It can also be used to view any num‐
       ber of graphics files (such as a FAX page, a Plan 9 image(6)  file,  an
       Inferno  bitmap  file, or other common format).  Page displays these in
       sequence.  In the absence of named files, page reads one from  standard
       input.

       By  default,  page runs in the window in which it is started and leaves
       the window unchanged.  The -R option causes page to grow the window  if
       necessary  to display the page being viewed.  The -w option causes page
       to create a new window for itself.  The newly created window will  grow
       as under the -R option.

       The -p option sets the resolution for PostScript and PDF files, in pix‐
       els per inch.  The default is 100 ppi.

       When viewing images with page, it listens to the image plumbing channel
       (see plumber(4)) for more images to display.  The -i option causes page
       to not load any graphics files nor to  read  from  standard  input  but
       rather to listen for ones to load from the plumbing channel.

       The  -j  option with a page address addr jumps to the specified page on
       startup.

       Pressing and holding button 1 permits panning about the page.

       Button 2 raises a menu of operations on the current image or the entire
       set.   The image transformations are non-destructive and are valid only
       for the currently displayed image.  They are lost as  soon  as  another
       image is displayed.  The button 2 menu operations are:

       Orig size
              Restores the image to the original. All modifications are lost.

       Zoom   controls magnification.

       Fit    Resizes the image so that it fits in the current window.

       Rotate 90
              Rotates the image 90 degrees clockwise

       Upside down
              Toggles whether images are displayed upside-down.

       Next   Displays the next page.

       Prev   Displays the previous page.

       Snarf  Writes the current page address to the snarf buffer.

       Zerox  Displays the current image in a new page window.  Useful for se‐
              lecting important pages from large documents.

       Write  Asks for a filename and writes the current image as Plan 9  bit‐
              map.

       Ext    Shows the current image using external jpg(1) program in a sepa‐
              rate window. This is mostly useful for animated gifs.

       Button 3 raises a menu of the pages to be selected for viewing  in  any
       order.

       Typing a q or control-D exits the program.

       To  go  to  a specific page, one can type its number followed by enter.
       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  pan‐
       ning off the top or bottom of the page.

       Page  calls  gs(1)  to  draw each page of PostScript and PDF files.  It
       also calls a variety of conversion programs, such as those described in
       jpg(1),  to  convert  the  various raster graphics formats into Inferno
       bitmap files.  Pages are converted ``on the fly,'' as needed.

EXAMPLES
       page /sys/src/cmd/gs/examples/tiger.eps
              Display a color PostScript file.

       page /usr/inferno/icons/*.bit
              Browse the Inferno bitmap library.

       page -j /sys/doc/troff.pdf!7 /sys/doc/troff.pdf
              Jump to page 7 in the troff manual.

       man -t page | page -w
              Preview this manual in a new window.

SEE ALSO
       gs(1), jpg(1), tex(1), troff(1)

SOURCE
       /sys/src/cmd/page.c

BUGS
       The interface to the plumber is experimental.

HISTORY
       Page first appeared in Plan 9 from Bell Labs.  It  was  rewritten  from
       scratch for 9front (September, 2011).



                                                                       PAGE(1)