home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume26 / wroff / part01 / README
Encoding:
Text File  |  1991-12-11  |  4.1 KB  |  131 lines
  1. This contains the newest (August, 1991) version of wroff.
  2.  
  3. Wroff is a text formatter, similar to, but not compatible with,
  4. nroff and troff.  It has much the same command structure, but
  5. it is optimized for use with the Hewlett-Packard LaserJet II
  6. printer and the Pacific Data Systems 25-in-One Font Cartridge.
  7.  
  8. Wroff is written in "C" and has been "ported" to
  9.     Altos 5000 (SCO UNIX on 80486)
  10.     Altos 2000 (80386) (UNIX)
  11.     Altos 3068 (68020)  (UNIX)
  12.     Altos 586/986 (Xenix on 8086)
  13.     HP-UX running who knows what on what
  14.     CPM-68K  (honest!)
  15.     MSDOS with Turbo C++
  16.  
  17.  
  18. It does kerning, and a few other nice things.  It is rather fast,
  19. and has had a LOT of text put through it in the past couple of years.
  20.  
  21.  
  22. Here is a list of directories and files:
  23.  
  24. Fonts/         -- width tables for fonts
  25. MACROS/        -- some demonstration macros and test files
  26. MANIFEST     -- list of contents for the shar archive
  27. Makefile     -- a makefile for the whole thing
  28. README         -- this file
  29. TestData/    -- some interesting test data
  30. doc/        -- documentation
  31. source/        -- source code for wroff
  32. *.bat        -- batch files for testing under MSDOS
  33.  
  34.  
  35. To create wroff under UNIX, just type "make" in this directory.  This will 
  36. create a non-stripped executable called "a.out", which is suitable for testing.
  37.  
  38. If you are using HP-UX, you will need to use the HPUX.make file instead.
  39.  
  40. If you are using MSDOS, you must "cd source" and use the file "make.tcc"
  41. instead of the UNIX make. In this case, you must perform the testing
  42. using the "*.bat" files.  Wroff has been tested under Turbo C++, but
  43. under no other MSDOS compiler.  The binaries are available from bw@cs.ecok.edu.
  44.  
  45. The "a.out" version expects to find the font files in a directory
  46. called "./Fonts", so it will only run in this directory.
  47.  
  48. You can test this version by typing
  49.     make install
  50.     make test
  51.     make sampler
  52. Your printer (and serial line!) must be able to handle 8-bit data.
  53. This "make install" will not do anything drastic to your file system,
  54. and it can be run without being super user.
  55.  
  56. You should get about three pages of printing that illustrate
  57. most (but not all) of the fonts available to the Pacific Data
  58. Systems Cartridge.  
  59.  
  60. Once you are convinced that everything is in good order, you should
  61. edit the Makefile to indicate a full path name for the Fonts directory,
  62. and the BINDIR, and then recompile everything.  You will probably have to
  63. say something like:
  64.     rm source/*.o
  65.     make
  66.  
  67. to recompile, and then
  68.     make install
  69. as superuser to install the fonts and the real live wroff.
  70. This will create some files at various places in your filesystem, so
  71. if you are nervous, be sure to examine the Makefile carefully.
  72. It shouldn't have anything in it to bother anyone.
  73.  
  74. After installation,
  75.     make test
  76. or
  77.     make sampler
  78.  
  79. is useful to increase your confidence in wroff.
  80.  
  81. Have fun!
  82.  
  83.  
  84.  
  85.  
  86. *************************************************
  87. August, 1991:
  88.  
  89. At the suggestion of Marc Veeneman (marc@marcal.uucp),
  90. wroff is now more "mailable".  All ESC characters in the font
  91. files have been replaced with a much more mailable "E" character, which
  92. wroff replaces with a real ESC when it reads the font files.
  93.  
  94. Wroff may not accept files with super-long lines, such as those
  95. which are produced by some commercial packages.  Mr. Veeneman
  96. also suggests that in these cases, you can change MAXSTR in defs.h
  97. to something ridiculous, and defeat the miscreants.
  98. (You may also have to make MAXBUF in the same file even more
  99. ridiculous.) 
  100.  
  101.  
  102. **************************************************************
  103. September 4, 1991
  104.  
  105. Student Connie Nabors (cnabors@student.ecok.edu)
  106. modified the original wroff to allow it to be compiled
  107. under Turbo C++ on MSDOS.
  108.  
  109. Also, the ".tm" (transparent mode) command has been modified
  110. to allow the new "wtbl" program to feed wroff directly.
  111.  
  112. **************************************************************
  113.  
  114. Also, note that the distribution of wroff that is archived on
  115. uunet does not contain all of the appropriate files.  New
  116. files may be requested by sending mail to
  117.  
  118.     bw@cs.ecok.edu
  119.  
  120.  
  121.  
  122.     Surface mail, e-mail,  or telephone questions are welcome:
  123.  
  124.     Bill Walker
  125.       (bw@cs.ecok.edu)
  126.     Department of Computer Science
  127.     East Central University
  128.     Ada, Oklahoma  74820
  129.     405 332 8000 x 594
  130.  
  131.