home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / printer / pcroff.arc / README.SRC < prev    next >
Text File  |  1988-08-28  |  3KB  |  159 lines
  1. .po 7
  2. .tr ~ 
  3. .fo 'PCroff''$'
  4. .ce
  5. .bo
  6. .ul
  7. README FILE FOR PCROFF
  8. .he ''- % -''
  9.  
  10.  
  11. .ul
  12. PCroff
  13. is an adaptation of a public-domain implementation of
  14. .ul
  15. roff,
  16. for the PC and its clones.
  17. .ul
  18. Roff
  19. is the predecessor to nroff,
  20. the text formatter used with the UNIX(tm) operating system.
  21. It is less capable than nroff in its
  22. formatting capabilities,
  23. but in return it is faster and smaller.
  24. It is fast and small enough to be I/O-limited
  25. in performance on a PC;
  26. it's unlikely that would be true of nroff.
  27. In this case, it's also free.
  28.  
  29. Apart from the smaller instruction set
  30. (see the manual in PCroff.doc),
  31. its major limitations with respect to nroff are:
  32. .in +5
  33.  
  34. .ti -2
  35. -~Macros cannot take parameters.
  36. Among other consequences of this property is
  37. the fact that the "mm" macros can't be ported to roff.
  38. Sorry!
  39.  
  40. .ti -2
  41. -~There are no user-settable number registers or strings.
  42.  
  43. .in -5
  44. Any fancier features of nroff are also absent.
  45. What's left is a nice little (and certainly very useful)
  46. text formatter.
  47.  
  48. .ul
  49. PCroff
  50. is roff, ported to the IBM PC and look-alikes,
  51. and enhanced just enough to use the printer's font control.
  52. In addition to roff's
  53. .ul
  54. underlining (.ul),
  55. PCroff supports
  56. .bo
  57. bold (.bo)
  58. and
  59. .it
  60. italic (.it).
  61. It can use them
  62. .bo
  63. .ul
  64. .it
  65. in combination,
  66. too.
  67. For previewing your document,
  68. the fonts are displayable on the PC screen;
  69. underline and bold are screen attributes already,
  70. and italic is represented by blinking.
  71.  
  72. The most common ways to call PCroff are:
  73.  
  74. .in +5
  75. .ti -2
  76. -~To format a file and preview it on the display, call
  77.  
  78. .li
  79.     pcroff -d filename
  80.  
  81. .ti -2
  82. -~To format a file and print it, call
  83.  
  84. .li
  85.    pcroff filename > PRN
  86.  
  87. .ti -2
  88. -~If your printer does not use control sequences for font control
  89. (or if it isn't in the PRINTCAP file and you can't add it),
  90. it may be able to do fonts by backspace-overstrike.
  91. If so, call
  92.  
  93. .li
  94.    pcroff -t filename > PRN
  95.  
  96. (Note that such printers are incapable of italics,
  97. which will come out underlined.)
  98. .bp
  99. .in -5
  100. .ce
  101. .ul
  102. Contents of Disk
  103.  
  104. .in +3
  105. .ti -3
  106. 1.~PCROFF.EXE -
  107. the executable code.
  108.  
  109. .ti -3
  110. 2.~README -
  111. the introductory file you're reading now.
  112.  
  113. .ti -3
  114. 3.~README.SRC -
  115. the PCroff source that created READ.ME,
  116. as an example of roff input.
  117.  
  118. .ti -3
  119. 4.~PCROFF.DOC -
  120. the manual for PCroff,
  121. as a roff source file.
  122. Try displaying and printing it.
  123.  
  124. .ti -3
  125. 5.~PRINTCAP -
  126. a file of printer specifications.
  127. If your printer isn't an Epson or compatible,
  128. change the name of the default printer in PRINTCAP,
  129. and add its font-control specification if necessary.
  130. (The instructions for making a PRINTCAP file are
  131. part of PCROFF.DOC.)
  132. Note that PCroff must be able to find the PRINTCAP file
  133. to use printer-specific font control.
  134.  
  135. .ti -3
  136. 6.~SOURCE.ARC -
  137. the C source files.
  138. It contains some code (clearly marked)
  139. that is specific to DeSmet C.
  140. I haven't bothered porting it to Turbo C,
  141. which is what I use now.
  142. .in -3
  143. .sp 3
  144. My thanks to the pioneers who went before me,
  145. whose code I've adapted here.
  146. The names I know are Col. G. L. Sicherman and Tim Maroney,
  147. but there may well be others.
  148.  
  149. Good luck, and let me know how you do.
  150. By all means, report any bugs that bite you.
  151.  
  152. .nf
  153.                         Dave Tutelman
  154.                         16 Tilton Drive
  155.                         Wayside, NJ 07712
  156.  
  157.                         (201) 922 - 9576
  158. .fi
  159.