Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PAGE(1)			    General Commands Manual		       PAGE(1)

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

SYNOPSIS
       page [ -abirPRvVw ] [ -p	ppi ] [	file...	 ]

DESCRIPTION
       Page is a general purpose document viewer.  It can be used  to  display
       the  individual pages of	a PostScript, PDF, or or Unix's	tex(1) device-
       independent output file.	 Troff or tex 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  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.	If being used to display multipage  documents,
       only one	file may be specified on the command line.

       The -p option sets the resolution for PostScript	and PDF	files, in pix-
       els per inch.  The default is 100 ppi.  The -r option reverses the  or-
       der in which pages are displayed.

       When  viewing a document, page will try to guess	the true bounding box,
       usually rounding	up from	the file's bounding  box  to  8A1/2A11	or  A4
       size.  The -b option causes it to respect the bounding box given	in the
       file.  As a more	general	problem, some PostScript files claim  to  con-
       form  to	 Adobe's  Document Structuring Conventions but do not.	The -P
       option enables a	slightly slower	and slightly more skeptical version of
       the  PostScript	processing  code.  Unfortunately, there	are PostScript
       documents that can only be viewed with the -P  option,  and  there  are
       PostScript documents that can only be viewed without it.

       When viewing images with	page, it listens to the	image plumbing channel
       (see 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 -v option turns on extra debugging output, and the -V option	 turns
       on  even	 more  debugging  output.   The	 -a option causes page to call
       Unix's abort(3) rather than exit	cleanly	on errors, to  facilitate  de-
       bugging.

       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   Prompts the user to sweep	a rectangle on the image which is  ex-
	      panded proportionally to the rectangle.

       Fit window
	      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.

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

       Reverse
	      Reverses the order in which pages	are displayed.

       Write  Writes the image to file.

       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.  Typing a u toggles whether
       images are displayed upside-down.  (This	is useful in the  common  case
       of mistransmitted upside-down faxes).  Typing a r reverses the order in
       which pages are displayed.  Typing a w will write the currently	viewed
       page  to	 a new file as a compressed file.  When	possible, the filename
       is of the form basename.pagenum.bit.  Typing a d	removes	an image  from
       the working set.

       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 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.

       Page  calls Unix's gs(1)	to draw	each page of PostScript	and PDF	files.
       It also calls a variety of conversion programs, such as those described
       in  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.

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

SEE ALSO
SOURCE
       /src/cmd/page

DIAGNOSTICS
       The mouse cursor	changes	to an arrow and	ellipsis when page is  reading
       or writing a file.

BUGS
       Page supports reading of	only one document file at a time, and the user
       interface is clumsy when	viewing	very large documents.

       When viewing multipage PostScript files that do not contain  ``%%Page''
       comments,  the  button  3  menu	only contains ``this page'' and	``next
       page'': correctly determining page boundaries in	Postscript code	is not
       computable in the general case.

       If  page	has trouble viewing a Postscript file, it might	not be exactly
       conforming: try viewing it with the -P option.

       The interface to	the plumber is unsatisfactory.	In  particular,	 docu-
       ment references cannot be sent via plumbing messages.

       There are too many keyboard commands and	menu items.

       Displaying  a PostScript	or PDF file depends both on having GhostScript
       (see installed and on the underlying operating system providing a  file
       descriptor device tree at /dev/fd.

       Some FreeBSD installations do not provide file descriptors greater than
       2 in /dev/fd.  To fix this, add

	      /fdescfs	  /dev/fd    fdescfs	rw    0	   0

       to /etc/fstab, and then mount /dev/fd.  (Adding the line	to  fstab  en-
       sures  causes  FreeBSD  to  mount the file system automatically at boot
       time.)

								       PAGE(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | SOURCE | DIAGNOSTICS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=page&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help