home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / fweb153.zip / fweb-1.53 / announ.os2 next >
Text File  |  1996-03-06  |  5KB  |  109 lines
  1.  
  2. I have uploaded the os/2 port(let) of the tool for literate programming, 
  3. fweb-1.53, to hobbes (ftp-os2.nmsu.com) and cdrom (ftp-os2.cdrom.com).
  4. The files sit in incoming and should move to 
  5.  
  6. Suggested directory: os2/tex
  7.  
  8. I append a part of the readme I wrote for the OS/2 port.
  9.  
  10.  
  11. %file: READ_ME.os2
  12. %date: 27-Feb-1996 .. 6-Mar-1996
  13. %Author: Stefan A. Deutscher (sad@utk.edu; stefand@elphy.irz.hu-berlin.de)
  14.  
  15.  
  16. This is the OS/2 re-compile of J. A. Krommes' fweb-1.53, a tool for 
  17. literate programming in c, f77, f90, ratfor, and so on. It also allows
  18. verbatim input for languages it doesn't know (I hope to use it with
  19. Extended ANSI-ISO Pascal).
  20.  
  21. It contains the original sources and the following files in the
  22. new subdirectory boot/ibm/os2:
  23.  
  24. wrw-a--    19563 Mar 06 14:39 Makefile.os2
  25. -rw-a--     9040 Mar 06 15:50 READ_ME.os2
  26. -rw-a--   140526 Mar 06 14:44 common.c.os2
  27. -rw-a--   207673 Mar 06 14:44 common.web.os2
  28. -rw-a--     2034 Mar 06 14:45 config.h.os2
  29. -rw-a--    14721 Mar 06 14:36 custom.h.os2
  30. -rw-a--     4665 Mar 06 14:42 defaults.mk.os2
  31. -rwxa--   253956 Mar 06 14:33 ftangle.exe*
  32. -rwxa--   229380 Mar 06 14:33 fweave.exe*
  33. -rw-a--     2287 Mar 06 15:31 fweb-1.53.patch
  34.  
  35. The original sources are up for ftp on: 
  36.                               ftp://ftp.pppl.gov/pub/fweb/
  37.  
  38.  
  39. The executables as well as the patched sources and the makefiles and
  40. other custom files are in fweb-1.53/boot/ibm/os2. You will need 
  41. HPFS for the long file names; I couldn't be bothered to change it
  42. all to 8.3 FAT names. Fweb alone is worth going to HPFS, in case you
  43. aren't there yet.
  44.  
  45. You need to have the emx runtime library (emxrt.zip) version 0.9a or
  46. later installed. It can be found on ftp-os2.cdrom.com (cdrom),
  47. ftp-os2.nmsu.edu (hobbes), for example.
  48.  
  49. To use it you will also need (besides an editor and a compiler)
  50. LaTeX2e. The emTeX distribution as found on CTAN and the normal
  51. os/2 sites (or the December '95 Hobbes OS/2 CD-ROM) are fine.
  52. You will also need the LaTeX packages multicol and indentfirst,
  53. also on CTAN. I don't include them here because it is a much better
  54. idea to fetch them from there, where they are maintained and updated.
  55. Get the whole tools subdirectory, and run LaTeX2e on the file tools.ins
  56. to install the packages. That was faster for me than trying to
  57. install just these two packages by hand ... Now:
  58.  
  59.  
  60. You can simply put the executables in your path (ftangle.exe,
  61. fweave.exe) and the style and macro files 
  62.  
  63. manual/fwebmac.sty
  64. manual/fwebnum.sty
  65.  
  66. in your TEXINPUT, TEXINPUTS directory, print the docs (and read them)
  67. and install the *.info files and such, in case you have GNU info
  68. installed. In case you like UNIXish man pages and have gnu man
  69. installed, you can also visit
  70.  
  71. fweb-1.53/manual 
  72.  
  73. and move fweb.1 in your manpage path, and you can print fweb.ps for a
  74. nice hand book. In fact, if you have not much experience with literate
  75. programming, I even recommend you get a hold of the old version 1.30 of
  76. fweb (on CTAN, Comprehensive TeX Archive Network, for instance:
  77. ftp.shsu.edu) and print its postscrip manual. Of course things have
  78. changed since then, but it is a very detailed treatment of the subject
  79. at hand.
  80.  
  81.  
  82. You're free to go now. You can also recompile thw whole thing and make 
  83. a port that integrates more smoothly with the distribution of fweb-1.53,
  84. for instance by fiddeling with the configure script and all that.
  85.  
  86. Here are some notes about my port.
  87.  
  88. {well, read the real thing for that} ....
  89.  
  90. For more information look at the docs that come with the original
  91. distribution, at the mailing lists they mention, and check out the
  92. usenet news group comp.programming.literate.  
  93.  
  94. Anyway. Like with the original source code: No warranties of any form
  95. implied. You use it at your own risk, if your toaster explodes -- too
  96. bad.  Chocolates and such to D. Knuth, S. Levy, J. A. Krommes, Ralph
  97. Smith, E. Matthes, well -- if there is some left I'll take a bite.
  98.  
  99. Have fun!     Stefan A. Deutscher  (27-Feb-1996)  
  100.               sad@utk.edu; stefand@elphy.irz.hu-berlin.de
  101.  
  102. =============================================================================
  103. Stefan A. Deutscher                     |  (+1-423-)   voice      fax
  104. The University of Tennessee, Knoxville  |  UTK  :     974-7838  974-7843
  105. Department of Physics and Astronomy     |  ORNL :     574-5897  574-1118
  106. 401, A. H. Nielsen Building             |  home :     522-7845  522-7845
  107. Knoxville, T.N. 37996-1200, USA         |  email:     sad@utk.edu
  108. =============================================================================
  109.