home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / nuweb087.zip / README.os2 < prev    next >
Text File  |  1996-03-08  |  6KB  |  124 lines
  1. I have uploaded nuweb087.zip including sources by Preson Briggs and
  2. the os/2 binary to :
  3.  
  4. hobbes (ftp-os2.nmsu.edu), 
  5. now: /incoming
  6. suggested: /os2/unix/tex
  7.  
  8. cdrom (ftp-os2.cdrom.com), 
  9. now: /os2/incoming
  10. suggested: /os2/tex
  11.  
  12. and CTAN (ftp.shsu.edu):
  13. now: /incoming
  14. suggested: tex-archive/web/nuweb/os2/  (needs to be created).
  15.  
  16. Replaces: Nothing really, except hopefully DOS versions of nuweb,
  17.           running on some OS/2 machines.
  18.  
  19.  
  20. Brief description:
  21. ===================
  22.  
  23.  
  24. I was looking in news groups for a tool for literate programming (web)
  25. that'd allow me to use Fortran. (Extended) Pascal, and C and was portable
  26. to or available for OS/2. I came accross an interesting FAQ for the
  27. comp.literate.programming, and I got his personal reply:
  28.  
  29. ------------------------------------------------------------------------
  30. Preston Briggs (preston@cs.rice.edu) wrote:
  31. : >Also, my desire to have a version that (i) runs on OS/2 and (ii)
  32. : >possibly incorporates Extended ANSI Pasal, while (iii) being based on
  33. : >fweb to allow also g77 and gcc codes, made me think the -- for me very
  34. : >unusual -- cross posting would enlarge my cross section and hence the
  35. : >chance for an event ...
  36.  
  37. : Lots of us have given up on the idea of pretty printing all our code,
  38. : and use language-independent tools.  For OS/2, you might check out
  39. : nuweb and funnelweb.  I wrote nuweb and unsurprisingly prefer it.  I
  40. : use it with C, C++, Fortran, Scheme, and Makefiles.  Others have used
  41. : it with Perl and such, but since it's language independent, you won't
  42. : have any trouble with any flavor of Pascal, etc.
  43.  
  44. : You can grab a copy via anonymous ftp from cs.rice.edu, in the
  45. : directory public/preston.
  46. ------------------------------------------------------------------------
  47.  
  48.  
  49. I wanted to try it, so I had to compile it.  So, I tried that. The
  50. original source files are in a shell archive (nuweb.shar0.87). To get
  51. them you have to use ftp and binary mode. I first tried lynx, but it
  52. downloads it as text and clobbers it to a point where it gives errors
  53. when unsharing the archive, messing up the tabs in the makefile and ---
  54. the thing doesn't compile. When you get them in binary mode, they do.
  55. However, I have repackaged the sources (with the executable and the
  56. patches to one source file and to the makefile) in this zip archive, so
  57. you don't *have* to go there.
  58.  
  59. First nuweb would compile fine but die with a segmentation fault at the
  60. end of it's run. That was a nice occasion to learn gdb, and that was
  61. rewarded with finding the problem: A call to tempnam() that was
  62. obviousely not to the liking of OS/2 on Intel (386, 486), but accepted
  63. by Solaris on a SPARC erver 1000E (both using gcc).  Anyway, I found a
  64. patch, it still runs fine on Solaris, but it now also runs on OS/2. I
  65. compiled it with emx09a, fixpack 06. To get you going or allow you to
  66. look at the docs before you have nuweb installed I include LaTeXed
  67. versions of the file, ready to print on a PostScript printer or with any
  68. dvi driver.
  69.  
  70. All you need to use it is:
  71. a) LaTeX installed on your system (2.09 or 2e are fine)
  72. b) print the nuwebman.dvi or nuwebman.ps files, read them
  73. c) an editor
  74. d) the emx runtime system (emxrt.zip, from ftp-os2.cdrom.com, or
  75.    ftp-os2.nmsu.edu, for instance), version 0.9a fix pack 06 or 
  76.    later installed. If you don't have it already installed
  77.    fetch the index of one of these sites, and search (grep) for
  78.    the pattern "emxrt.zip", or, if you can use regular expressions,
  79.    "^emxrt.zip". Then download and istall it. It contains the runtime
  80.    system in a dynamic link library which is shared by many other 
  81.    programmes (say, gnu file utils, vi, emacs, less, probably even
  82.    emTeX programmes). This allows the executables to stay small and lean
  83.    but they won't run without it.
  84. e) put nuweb.exe in your path.
  85.  
  86. It seems that this is the right tool for cs people who don't crave nice,
  87. mathematical pretty print stuff (like some physicists prefer), and for
  88. projects that involve mixing of languages, or involve languages that
  89. other webs don't know about. (I like fweb, too, but fweb can't do
  90. Extended Pascal, as an example, and so nuweb seems to be it for
  91. that case.) Anyway.
  92. read the docs, and stroll through the news groups, and have fun.
  93.  
  94. Preston approved my uploadig of code and executables, so here you are.
  95.  
  96. ------------------------------------------------------------------------
  97.  
  98. Message 2/8  From Preston Briggs
  99. Return-Path: <preston@tera.com>
  100. Date: Thu, 29 Feb 96 13:30:54 PST
  101. To: sad@utkux.utcc.utk.edu
  102. Subject: Re: (fwd) Re: [Q] Fortran Web for OS/2, Pascal extensions ?
  103.  
  104. [snip]
  105.  
  106. I don't mind your putting sources and executables anywhere.
  107. Feel free.  I won't change the distribution though.  I haben't touched
  108. it for a couple of years.  Just don't have time to get into it now.
  109. Someday though, I'll get back to it, and tempname is going away
  110. (along with about 75K other changes I've imagined).
  111.  
  112. Preston
  113. ------------------------------------------------------------------------
  114.  
  115.  
  116. ===============================================================================
  117. Stefan A. Deutscher   8-Mar-1996        |  (+1-423-)   voice      fax
  118. The University of Tennessee, Knoxville  |  UTK  :     974-7838  974-7843
  119. Department of Physics and Astronomy     |  ORNL :     574-5897  574-1118
  120. 401, A. H. Nielsen Building             |  home :     522-7845  522-7845
  121. Knoxville, T.N. 37996-1200, USA         |  email:     sad@utk.edu
  122.  ... in Germany:                        |    stefand@elphy.irz.hu-berlin.de
  123. ===============================================================================
  124.