plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

proof.1 (2265B)


      1 .TH PROOF 1
      2 .SH NAME
      3 proof \- troff output interpreter
      4 .SH SYNOPSIS
      5 .B proof
      6 [
      7 .BI -m mag
      8 ]
      9 [
     10 .BI -/ nview
     11 ]
     12 [
     13 .B -F
     14 .I dir
     15 ]
     16 [
     17 .B -d
     18 ]
     19 [
     20 .I file
     21 ]
     22 .SH DESCRIPTION
     23 .I Proof
     24 reads
     25 .MR troff (1)
     26 intermediate language from
     27 .I file
     28 or standard input
     29 and simulates the resulting pages on the screen.
     30 .PP
     31 After a page of text is displayed,
     32 .I proof
     33 pauses for a command from the keyboard.
     34 The typed commands are:
     35 .TP \w'newline\ \ \ 'u
     36 newline
     37 Go on to next page of text.
     38 .TP
     39 .B -
     40 Go back to the previous page.
     41 .TP
     42 .B q
     43 Quit.
     44 .TP
     45 .BI p n
     46 Print page
     47 .IR n .
     48 An out-of-bounds page number means the end nearer to that number;
     49 a missing number means the current page;
     50 a signed number means an offset to the current page.
     51 .TP
     52 .I n
     53 Same as
     54 .BI p n\f1.
     55 .TP
     56 .B c
     57 Clear the screen, then wait for another command.
     58 .TP
     59 .BI m mag
     60 Change the magnification at which the output is printed.
     61 Normally it is printed with magnification .9;
     62 .IR mag "=.5"
     63 shrinks it to half size;
     64 .IR mag "=2"
     65 doubles the size.
     66 .TP
     67 .BI x val
     68 Move everything
     69 .I val
     70 screen pixels to the right (left, if
     71 .I val
     72 is negative).
     73 .TP
     74 .BI y val
     75 Move everything
     76 .I val
     77 screen pixels down (up, if
     78 .I val
     79 is negative).
     80 .TP
     81 .BI / nview
     82 Split the window into
     83 .I nview
     84 pieces.  The current page goes into the rightmost, bottommost piece,
     85 and previous pages are shown in the other pieces.
     86 .TP
     87 .BI "-F " dir
     88 Use
     89 .I dir
     90 for fonts instead of
     91 .BR /lib/font/bit .
     92 .TP
     93 .B d
     94 Toggle the debug flag.
     95 .PD
     96 .PP
     97 These commands are also available, under slightly different form,
     98 from a menu on button 3.  The
     99 .B pan
    100 menu item allows arbitrary positioning of the page:
    101 after selecting
    102 .BR pan ,
    103 press the mouse button again and hold it down while moving
    104 the page to the desired location.  The page will be redisplayed
    105 in its entirety when the button is released.
    106 Mouse button 1 also pans, without the need for selecting from a menu.
    107 .PP
    108 The
    109 .BR m ,
    110 .BR x ,
    111 .BR y ,
    112 .BR F ,
    113 .BR / ,
    114 and
    115 .B d
    116 commands are also available as command line options.
    117 .SH FILES
    118 .TP
    119 .B \*9/font/*
    120 fonts
    121 .TP
    122 .B \*9/font/MAP
    123 how to convert troff output fonts and character names
    124 into screen fonts and character numbers
    125 .SH SOURCE
    126 .B \*9/src/cmd/proof
    127 .SH SEE ALSO
    128 .IR lp (1), 
    129 .MR gs (1) ,
    130 .MR page (1)
    131 .br
    132 J. F. Ossanna and B. W. Kernighan,
    133 ``Troff User's Manual''