Short: Literate programming discipline for C.
Type: dev/misc
Uploader: Andreas Scherer
Authors: Silvio Levy and Donald Knuth

This  is  the  AMIGA/SASC  implementation  of  Silvio  Levy's and Donald E.
Knuths's  CWEB  system, version 3.1 of November 1993, compiled and provided
with  changefiles  for  ANSI-C  and  SAS/C  6.x and a makefile for SMake by
Andreas  Scherer.  It is based on the CWEB 3.1 port by Tomas Willis and the
CWEB  2.8  port  by  Carsten Steger, including all features of the original
UNIX   implementation  like  ANSI-C  and  C++  support,  full  ASCII  input
capability,  and more, plus all enhancements made in these AMIGA ports plus
some special features like:

   - The complete source code is capable of being recompiled with SAS/C 6.x
     for  AMIGADOS, with  GNUC for  MSDOS, and with  C89 (and possibly with
     CC as well) for  UNIX without the need  for further changes.  Features
     for TURBOC are implemented but have not been tested for real.

   - The `gcwebmac.tex' macro package  activated by setting the `+g' option
     includes support for ISO 8859-1/ECMA-94 special characters like German
     umlauts and some frequently used specials.  All captions used by  CWEB
     are translated to German in this macro file.

   - Two  AREXX scripts for use with the  CygnusEd Professional Editor were
     added to this package, one for CTANGLE and CWEAVE, localized in German
     and English under AMIGADOS version 2.1 or 3.0,  the other for use with
     the SAS/C 6.x compiler in connection with CED version 3.5.

   - Both  CTANGLE and  CWEAVE are localized in German and English with the
     help of the `locale.library' of AMIGADOS 2.1/3.0.  Catalogs  for other
     languages can easily be added.

   - An algorithm for recursive `@i'nclude file search was adapted from the
     TeX and METAFONT implementation.

   - The `o'-Option  as described in `cwebman.tex' was added  in connection
     with the `i'-Option by Steger.

   - Four additional CWEB example programs are included as examples for the
     portability between PASCAL-WEB and C-CWEB and for the usage of the C++
     features of version 3.1.

This port was done and completely tested with SAS/C version 6.3 and SAS/C++
6.50.  A non-localized version was recently ported to UNIX with C89, and to
MSDOS with GNUC (but not with TURBOC, this I don't support!), so I am quite
sure that all bugs have been found.