🚀 go-pugleaf

Archive-name: www/resources/literate-programming
Last-modified: 25 September 1994
Posting-Frequency: monthly

-----------------------------------------------------------------------------
* Recent Changes 
-----------------------------------------------------------------------------
- The FWEB FAQ has been updated for FWEB v1.30 - only as plain text for
   now - HTML version to come soon). 
-----------------------------------------------------------------------------
* Literate Programming on the World Wide Web
-----------------------------------------------------------------------------
   FYI, there is a wealth of information on Literate Programming,
   the art of structured programming and documentation [like WEB-like systems 
   with (La)TeX formatting] available on the World Wide Web [WWW], a 
   distributed HyperText system, a network of documents connected by links
   which can be activated electronically. 
   Examples for LitProg environments are WEB for Pascal (DEK), CWEB for C/C++
   (Levy/Knuth), FWEB for C/C++/Fortran/ratfor/TeX (Krommes), various 
   language independent tools...and many more. The WWW resource can be
   searched for keywords. The latest version of this resource info sheet is 
   available via anonymous FTP to rtfm.mit.edu in file
   /pub/usenet/news-answers/www/resources/literate-programming.
-----------------------------------------------------------------------------
* How to get to the Web
-----------------------------------------------------------------------------
   If you have a WWW browser up and running, try going to

	   http://info.desy.de/general/users.html

   and look for "Literate Programming" in the panel which appears.
   The precise URL is

	   http://info.desy.de/user/projects/LitProg.html

   If you have no clue what WWW is, you can go over the Internet with

        	telnet info.cern.ch

   which brings you to the WWW Home Page at CERN. You are now using the
   simple line mode browser. To move around the Web, enter the numbers
   given after an item. To go to the Literate Programming documents, enter

	   go http://info.desy.de/user/projects/LitProg.html

   This is what you should see now:
-----------------------------------------------------------------------------
* What you will see here
-----------------------------------------------------------------------------
			LITERATE PROGRAMMING LIBRARY

   Recent Changes[1] -- Mail additions to this list to <marcus@x4u.desy.de>
   You can also search for keyword on this server.[2](Here is help on
   searching[3].)
   ___________________________________
   
   Getting Start(l)ed[4]   A first look into Literate Programming with WEB
                         
   Virtual Course[5]      Planned GNA[6] Internet course on Literate
                         Programming
                         
   Editing[7]             GNU Emacs mode for WEB programming
                         
   Tools[8]               Common, freely available Literate Programming
                         environments
                         
   Examples[9]            Literate Programming archives and selected examples
                         
   Discussion[10]         Discussion on LitProg takes place on a mailing list
                         and a newsgroup
                         
   Program Library[11]    George D. Greenwade's Literate Programming Library at
                         Niord.shsu.edu. Experimental service: Archive
                         Search[12]
                         
   FAQs[13]               Lists of Frequently Asked Questions: General and FWEB
                         
   Further Reading        Nelson Beebe's Literate Programming bibliography at
                         ftp.math.utah.edu in directory /pub/tex/bib[14](files
                         litprog.*)
                         
   HyperLitProg[15]       Literate Programming using HyperText[16] Techniques
                         
   OO-LitProg[17]         Opinions and examples on Object-Oriented[18] Literate
                         Programming
                         
 [[Now you can continue climbing down the documentation tree by
   entering numbers 1-18 and follow your own interests]]
-----------------------------------------------------------------------------
* More on Browsing the Web
-----------------------------------------------------------------------------
   A very nice way of "browsing" through WWW uses X-based tools like "tkWWW" 
   or "NCSA Mosaic". For the latter, binaries for many platforms (ready for 
   use) and sources are available via anonymous FTP from ftp.ncsa.uiuc.edu in 
   directory Web/Mosaic-binaries. For vt100 terminals there is a much-used 
   browser called "Lynx" which can be obtained by FTP from ftp2.cc.ukans.edu 
   in the pub/lynx directory. Emacs users will like the "W3" browser, FTP to 
   cs.indiana.edu:/pub/elisp/w3.
     There is a FTP repository for browser software at info.cern.ch
   (including a hypertext browser/editor for NeXTStep 3.0 and tkWWW).
     If you cannot go through TELNET, you can still retrieve WWW
   documents by e-mail: send Email to test-list@info.cern.ch with one or
   more lines of the form

	     send [http-address]
   e.g. 
	     send http://info.desy.de/user/projects/LitProg.html

   at the bottom of the page you'll find all links of that document listed.   
   Your mail system must have a mail gateway to internet mail.
-----------------------------------------------------------------------------
* Contact for Further Information
-----------------------------------------------------------------------------
   Please feel free to contact me for questions, suggestions and further
   contributions, or just to tell me whether you found this information
   useful in any way. 
     For questions related to WWW, consult the WWW-FAQ: available via
   anonymous FTP from rtfm.mit.edu in directory 
   pub/usenet/news.answers/www/faq, or on WWW at URL
   http://sunsite.unc.edu/boutell/faq/www_faq.html

   Enjoy!                           Marcus Speh <marcus@x4u.desy.de> for GNA. 

*****************************************************************************
   Copyright 1993-94 Globewide Network Academy, Inc. Distributed under the
   terms of the GNU Public License. Permission is granted to copy this 
   document for free distribution so long as it remains intact and unmodified.
   See more on WWW at http://uu-gna.mit.edu:8001/uu-gna/index.html or get 
   the GNA FAQ via anonymous FTP to rtfm.mit.edu as file 
   pub/usenet/news.answers/globewide-network-academy-faq
------------------------------------------------------------------------- END
--
Marcus Speh, DESY Theory & Computing, Notkestr.85, D-22603 Hamburg,Germany
Phone: +49-40 8998 3753, Fax: +49-40 8994 4429, Private: +49-40 4203206 --
Email: marcus@x4u.desy.de --- WWW: http://info.desy.de/www/marcus.html ---