home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / DOS_GG / TXT / FUNNEL_S.DAT < prev    next >
Internet Message Format  |  1995-05-20  |  2KB

  1. Date: 13-Dec-92
  2.  
  3. This zip file contains original C source code, "hacker's manual", and
  4. test suite for the literate programming tool "funnelweb", together
  5. with the patches and makefile used to port funnelweb to OS/2 2.0. The
  6. author of funnelweb is Ross Williams (ross@spam.adelaide.edu.au), and
  7. it was ported to OS/2 2.0 by Paul Lyon (plyon@emx.utexas.edu).
  8. Funnelweb is copyright Ross Williams, but he has released it under
  9. Version 2 of the GNU General Public License. The executable and user's
  10. manual are in a file called "funnel-x.zip" which should be available
  11. from the achive site or bbs from whence you acquired this file.
  12.  
  13. I used gcc/2 for the port, and GNU make to run the makefile.  I ran
  14. gcc/2 with full optimization (-O2); the resulting executable passes
  15. all the tests in the test suite Williams provides. Only minor changes
  16. to the source were required. I added a define "OS2" to those files
  17. with system dependencies (environ.h, machin.h, machin.c, and
  18. command.c), and made two modifications to get around some difficulties
  19. in the C library and include files supplied with gcc/2. The first of
  20. these is in the file "misc.c"; I added a couple of "fflush(stdout);"
  21. statements, since the stdio implementation for gcc/2 fully buffers
  22. stdout.  Secondly, the "toupper()" and "tolower()" macros in the
  23. "ctype.h" header file are not ANSI standard; I added a kludge to the
  24. end of the file "style.h" to repair this. Finally, I made one change
  25. to the file texhead.tex to change the characters used to bracket code
  26. sections, to use the TeX characters \lfloor and \lceil instead of
  27. \lbrace and \rbrace, since I find the results more pleasing. I have
  28. prepared a context diff file "patches.os2", which can be fed to
  29. "patch" to incorporate the changes, but have also provided the
  30. modified source files just in case.
  31.  
  32. Enjoy,
  33.  
  34. Paul Lyon (plyon@emx.utexas.edu).
  35.