home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol126 / abstract.126 < prev    next >
Text File  |  1984-04-29  |  5KB  |  156 lines
  1. /********************************************************/
  2. /*                            */
  3. /*            ROFF4, Version 1.50            */
  4. /*                            */
  5. /* (C) 1983 by    Ernest E. Bergmann            */
  6. /*        Physics, Building #16            */
  7. /*        Lehigh Univerisity            */
  8. /*        Bethlehem, Pa. 18015            */
  9. /*                            */
  10. /* Permission is hereby granted for all commercial and    */
  11. /* non-commercial reproduction and distribution of this    */
  12. /* material provided this notice is included.        */
  13. /*                            */
  14. /********************************************************/
  15.  
  16.             ROFF4, version 1.50
  17.  
  18.                  by
  19.              Ernest E. Bergmann
  20.              Physics, Bldg #16
  21.              Lehigh University
  22.             Bethlehem, Pa. 18015
  23.               (215-) 861-3932
  24.  
  25.  
  26.     ROFF4, v1.50 is being provided  essentially in the
  27. public domain, not because it isn't good, but to provide a
  28. means to create and transport technical documentation
  29. between users with different hardware.  This is not possible
  30. with commercial formatters because they are often not
  31. powerful enough to handle special symbols, equations, and
  32. the like.  Equally importantly, there is not much
  33. standardization and commercial formatters cannot be "given
  34. away";  the sender and receiver are not as likely to own the
  35. same commercial formatters.
  36.  
  37.     I am a practicing scientist and I need to format
  38. manuscripts which are sometimes long, contain equations,
  39. special symbols, footnotes, and illustrations.  I needed a
  40. formatter that was easy to use, flexible, and available to
  41. others.  It takes me less time to type a manuscript for this
  42. formatter and rework it, including special characters, than
  43. to have it typed and retyped by a typist only to have me
  44. proof read it ad nauseum.
  45.  
  46.     ROFF4 is table driven; it is relatively easy to
  47. configure for different output devices.  I have used it with
  48. the MX-80 and Graftrax printer combination; It is able to
  49. create special symbols where needed.  I Also can get special
  50. symbols on my CRT screen because of my computer hardware
  51. (the Exidy Sorcerer has user definable characters).
  52. However, the characteristics of my CRT device and of my
  53. printer are very different.  My design philosophy was to be
  54. able to drive either from the same input files so that I
  55. could "preview" my output before going to hardcopy.  You may
  56. have a variety of output devices; use your imagination.
  57.  
  58.     Your comments, criticisms, and possible bug reports
  59. will be most useful.
  60.  
  61.     I hope to extend ROFF4 so that it will be able to
  62. better utilize specialty printers (it presently assumes that
  63. the printer does NOT know how to backspace, nor reverse
  64. scroll).  I will have to learn how to support printers that
  65. do proportional spacing and variable pitch.
  66.  
  67.     I would also like to write a translater that
  68. automatically converts WORDSTAR(tm MicroPro) files,
  69. including control-P and dot commands into input files for
  70. ROFF4.  ROFF4 ignores the parity bit on input files.  It may
  71. get confused by inputting control-codes (it should only get
  72. the <CR><LF> and <TAB> of standard CP/M text files).
  73.  
  74.  
  75.                   FILES ON THIS DISK            
  76.  
  77. BPTEST.        page test
  78. DIO.H        directed i/o (FYI)
  79. EQN.        demo of equation numbering
  80. EXY1.        for graphics on Exidy screen
  81. EXYDEMO.SUB    to show them
  82. FOOT.        footnote example
  83. FORM.        form letter example
  84. L2.COM        for completeness
  85. LIST.        file lister
  86. MATRIX.        demo for print motions
  87. MX.        set-up for MX-80 & Graftrax
  88. NDIO.C        directed i/o (FYI)
  89. NEST.        nested macros and strings
  90. PAGES.        demo
  91. ROFF4.C        main source module
  92. ROFF4.COM    executable text formatter
  93. ROFF4.CRL
  94. ROFF4.DOC
  95. ROFF4.H
  96. ROFF4.SUB
  97. ROFF41.C
  98. ROFF41.CRL
  99. ROFF42.C
  100. ROFF42.CRL
  101. ROFF43.C
  102. ROFF43.CRL
  103. ROFF44.C
  104. ROFF44.CRL
  105. ROFF45.C
  106. ROFF45.CRL
  107. ROFF46.C
  108. ROFF46.CRL
  109. ROFF47.C
  110. ROFF47.CRL
  111. SCI.ASM        initialize Exidy Graphics
  112. SCI.COM        (scientific symbols)
  113. STACKTST.    test stacking of variables
  114.  
  115.  
  116.                     
  117.                 HARDWARE REQUIREMENTS
  118.  
  119.     ROFF4, version 1.50 was developed with the BDS C
  120. compiler, version 1.44 and the Mark of the Unicorn L2 linker
  121. version 2.2 on an Exidy Sorcerer personal Computer with the
  122. S-100 expansion box. The Thinker Toys 2D dual 8" disk sub-
  123. system was used and total contiguous ram was 52K.
  124. Statistics from the BDS compiler indicated at least 14K left
  125. over at every stage. Thus it may be possible to recompile
  126. this in a 40K system.  Tthe linkage statistics are that we
  127. have 127 functions, code ends at 75CEH, and that externals
  128. are from 7800H-91E8H.
  129.  
  130.     To run ROFF4.COM I believe the TPA should be 44K or
  131. more because the alloc() function must allocate slightly
  132. more than 1K for each simultaneously open file and I have
  133. reserved (quite conservatively) 2K for the stack.
  134.  
  135.     I/O requirements are minimal.  A dumb terminal (video
  136. or printing) and the CP/M disk interface are sufficient.
  137. Although a list device seems like a practical necessity (do
  138. you want to format only to a glass terminal?)
  139.  
  140.     By all means, read the file, ROFF4.DOC ("when all
  141. else fails, read the manual!")  Try out the sample input
  142. files, they are probably better illustration of points where
  143. my writing isn't clear.
  144.  
  145.  
  146.     Enjoy... (leave the debugging to us).
  147.  
  148.                 July 5, 1983
  149.  
  150.                 Ernest E. Bergmann
  151.                 Physics, Building #16
  152.                 Lehigh University
  153.                 Bethlehem, Pa. 18015
  154.                 
  155.                 (215-) 861-3932(at above)
  156.