proof 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134
  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. .IR 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. .TF \fL/lib/font/bit/MAP
  119. .TP
  120. .B /lib/font/bit/*
  121. fonts
  122. .TP
  123. .B /lib/font/bit/MAP
  124. how to convert troff output fonts and character names
  125. into screen fonts and character numbers
  126. .SH SOURCE
  127. .B /sys/src/cmd/proof
  128. .SH SEE ALSO
  129. .IR lp (1),
  130. .IR gs (1),
  131. .IR page (1)
  132. .br
  133. J. F. Ossanna and B. W. Kernighan,
  134. ``Troff User's Manual''