home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_300 / 304_01 / readme2.old < prev    next >
Text File  |  1990-02-14  |  4KB  |  88 lines
  1. ..try running this through roff4:
  2. ..A> roff4 readme2
  3. ..    or (for hardcopy):
  4. ..A> roff4 readme2 }prn
  5. ..
  6. ..
  7. .fo /README2//page #/
  8.  
  9.                     December 4, 1988
  10.  
  11. This is some further comments about ROFF4, v1.62 for MS-DOS:
  12.  
  13. This version is identical to the files submitted into the public
  14. domain in September, 1984 except for this file and the inclusion of
  15. the file, WSROFF4.PAS.
  16.  
  17. The version of ROFF4 v1.61 for the CP/M-80 operating system has been
  18. in the public domain for a considerable length of time and I have
  19. used it regulary in that environment.  It appears to be free of bugs
  20. (it does not disagree in its behavior with my intentions nor with
  21. the documentation).  The MS-DOS version has not been excercised by
  22. me until recently, as I am now using MS-DOS regularly.
  23.  
  24. One bug that I have found in the MS-DOS version, but I can work
  25. around, is: If the software needs to send to the output a control-Z,
  26. the MS-DOS operating system will treat it as an end-of-file and
  27. close the output stream!  One should avoid printer requests that use
  28. this character!
  29.  
  30. To drive the printer one can use the redirection: "}prn".  Do NOT
  31. use the ">" symbol for redirection because MS-DOS will perform the
  32. redirection instead of ROFF4.  When ROFF4 does the redirection it
  33. will provide a running commentary to the console while the "real
  34. output" will be redirected.  If one uses MS-DOS, the commentary will
  35. be redirected!
  36.  
  37. A common "bug report" I have received but is just as was designed is
  38. that the .rm command will not take values larger than the currently
  39. set "output width" (set by .ow).  Thus, if you want to set margins
  40. at, say, 10 and 70, you should first extend the output width:
  41.  
  42.     .ow 70
  43.     .in 10
  44.     .rm 70
  45.  
  46. A lot has happened since I developed ROFF4 version 1.61.  I am in
  47. the process of doing a major revision.  Since this is being done in
  48. my "spare time", it be ready about mid-1989.  I am regularly using
  49. MS-DOS now instead of CP/M.  The C compiler that will be used is
  50. Turbo C, version 2.0, which is tracking the ANSI C proposed
  51. standard.  I hope and expect that the standardization of C will
  52. reduce the difficulties that I have experienced in porting C source
  53. code in the past.  As I do not have the DeSmet C compiler, I am not
  54. tempted to just continue with these C files.
  55.  
  56. I am using as "models" for the revision WordStar(TM) version 5.0 and
  57. nroff and troff.  The user interface is often better with WS and the
  58. powerful macro capability is better in the UNIX(R) formatters.  It is a
  59. delicate matter what to name the various dot commands.  The command,
  60. ".rm" in WordStar sets the right margin but in nroff "removes" a
  61. definition.  I expect that I shall end up with changing the names of
  62. some of the commands in the next version (ROFF4, version 2).  In all
  63. probability I shall settle on mostly a subset of the nroff command names
  64. but with the "nifty" command, ".rr" from the recent versions of WS
  65. which make a "picture" of the line layout and the specialized
  66. commands I developed to define characteristics of printers.  I shall
  67. maintain the use of longer names (identifiers) used in definitions
  68. then the mere 2 symbols allowed in nroff and troff.  Anyway, time
  69. will tell.
  70.  
  71. I look forward to receiving comments, concerns, bug reports, etc.
  72. To minimize confusion and to take into account that this diskette
  73. contains this recent documentation and the WSROFF4.PAS file, this
  74. distribution is "ROFF4, version 1.62"
  75.  
  76. Please note that my address is:
  77.  
  78.     Ernest E. Bergmann
  79.     730 Seneca Street
  80.     Bethlehem, PA 18015
  81.  
  82. (I am no longer at Lehigh University).
  83.  
  84.                     Enjoy,
  85.  
  86.  
  87.                     Ernest Bergmann
  88.