This file says how to install Spidery WEB. If you want more information about what it is, look in the doc subdirectory, especially doc/DESCRIPTION. Spidery WEB is not in the public domain, but you are welcome to use it for any purpose. For more details, see the file COPYRIGHT. How to install Spidery WEB: 1) Pick a directory to install the WEB source in. Call it WEBROOT. 2) untar the distribution in WEBROOT (cd WEBROOT; tar xvf spiderweb.tar) 3) change to the master subdirectory and edit WebMakefile. -- Set WEBROOT to the WEBROOT directory -- Set DEST to the name of a directory to hold the executables -- Set MACROS to the name of directory to hold TeX macros Example: WEBROOT=/usr/src/local/spiderweb DEST=/usr/local MACROS=/usr/lib/tex/macros Make sure there are no spaces following the names. 4) If your installation doesn't have a cputype program, make one (a shell script is fine) following the instructions in WebMakefile. Put it somewhere on your path. 5) As defaults, the names of C tangle and weave are ceetangle and ceeweave (to avoid confusion with Silvio Levy's ctangle and cweave). Awk tangle is called awktangle. If you want to change these names, you must change them in WEBROOT/master/WebMakefile, and also on WEBROOT/c/make and WEBROOT/awk/make 6) Make sure . is at the front of your path. For example, csh users could type `set path = (. $path)' or sh users type `path=.:$path'. (I haven't checked these since . is at the front of my path by default.) If you don't like this security hole, you will have to change `make' to `./make' at the appropriate places (found by you). With your path set, go into WEBROOT and type `make boot' Once this is successful you will have executable versions of tangle for C and Awk, which is the minumum needed to make other things. After you've done this, you can afford to `make clean', which will remove the .c and .awk source you used to bootstrap yourself. You can always make them over again using the executable versions (`make source'). In case it isn't clear, once you `make boot' you will never need to do it again. 7) Move webkernel.tex into a place where TeX can find it. Until you do this you won't be able to TeX WEAVE output (or doc/spiderwebman.tex). Spidery WEB comes with the following languages: Directory Description 68k 68000 assembly language, courtesy Izumi Watanabe ada Ada awk old-style AWK, a string processing language c Kernighan and Ritchie C c++ C++, courtesy of Ed Kademan dijkstra Edsger Dijkstra's language of guarded commands (flaky) kelem Algol-like C, courtesy Steve Kelem larch The Larch Shared Language, used for specifying equational theories. nawk new-style AWK penelope Ada, extended with formal comments for verification postscript PostScript, courtesy David Love reduce A Pascal-like lisp, courtesy Marcel Roelofs sml A couple of attempts at Standard ML ssl The language of the Cornell Synthesizer Generator turing,turing+ Two versions of the Turing language, courtesty Kostas N. Oikonomou Each of these directories has a file called 'make'. The settings in that file determine the name that the executable versions of WEAVE and TANGLE have for that particular language. The names of the Spider files are also given. See ../doc/spiderman.tex for details on using Spider. Izumi Watanabe's Japanese translation is in ../doc/spdjman.tex. To make weave or tangle, change to the directory for the chosen language, and type `make weave' or `make tangle'. `make web' will make both weave and tangle. The `latex' subdirectory contains change files and other information to support use of WEB with latex. They may not be up to date with the current version of web. Spidery WEB is available by anonymous ftp from the literate- programming archive at niord.shsu.edu. Spidery WEB is no longer supported; it has been replaced by `noweb', which is available by anonymous ftp from csservices.princeton.edu:pub/noweb.shar.Z. ORA Corp makes some effort to keep Spidery WEB working, and bug reports, fixes, and new language descriptions can be sent to spider-bugs@oracorp.com. Norman Ramsey ORA Corporation 301A Harris B. Dates Drive Ithaca, New York 14850 Internet: spider-bugs@oracorp.com