home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / dev / c / cweb / cweb32p10.readme < prev    next >
Encoding:
Text File  |  1994-08-12  |  3.7 KB  |  70 lines

  1. Short: Literate programming discipline for C/C++.
  2. Type: dev/c
  3. Files: cweb32p10.lha, cweb32p10.readme
  4. Uploader: Andreas Scherer
  5. Authors: Silvio Levy and Donald Knuth
  6.  
  7. This  is  the  portability  implementation  of  Silvio Levy's and Donald E.
  8. Knuths's  CWEB  system,  version  3.2 of August 1994, compiled and provided
  9. with  changefiles  for  ANSI-C,  TURBO-C,  and  SAS/C 6.x and makefiles for
  10. UNIX-make,  TURBO-make and SAS-make by Andreas Scherer.  It is based on the
  11. CWEB  3.1  port by Tomas Willis and the CWEB 2.8 port by Carsten Steger and
  12. the  CWEB-p  3.0  distribution  by  Hans-Hermann Bode and Klaus Guntermann,
  13. including  all features of the original UNIX implementation like ANSI-C and
  14. C++  support,  full ASCII input capability, and more, plus all enhancements
  15. made in these AMIGA, MSDOS, and UNIX ports plus some special features like:
  16.  
  17.    - The complete source code is capable of being recompiled with SAS/C for
  18.      AMIGADOS, with  GCC and TURBOC for  MSDOS, and with  CC, C89, and  GCC
  19.      for UNIX without the need for further changes.
  20.  
  21.    - The `gcwebmac.tex' macro package  activated by setting the `+g' option
  22.      includes support for  special characters like  German umlauts and some
  23.      frequently  used  specials  according  to  ISO 8859-1/ECMA-94, IBM  PC
  24.      International Codepage 850, Macintosh 8-bit font table and HP Roman 8.
  25.      All captions used by CWEB are translated to German in this macro file.
  26.  
  27.    - There  are  TeX macro  files `ecma94.tex', `hp8.tex', `mac8.tex',  and
  28.      `pc850.tex' for  support  of  extended  code  tables.   Also  included
  29.      are  `ecma94.w',  `hp8.w',  `mac8.w',  and  `pc850.w' with appropriate
  30.      transliteration tables.
  31.  
  32.    - Two  AREXX  scripts for use with the CygnusEd Professional Editor were
  33.      added to this package, one for CTANGLE and CWEAVE, localized in German
  34.      and English under AMIGADOS version 2.1 or 3.0,  the other for use with
  35.      the SAS/C 6.x compiler in connection with CED version 3.5.
  36.  
  37.    - Both  CTANGLE and  CWEAVE are localized in German and English with the
  38.      help of the `locale.library' of AMIGADOS 2.1/3.0.  Catalogs  for other
  39.      languages can easily be added.  A set of German strings is provided.
  40.  
  41.    - An algorithm for recursive `@i'nclude file search was adapted from the
  42.      TeX and METAFONT implementation.
  43.  
  44.    - The `o' option  as described in `cwebman.tex' was added  in connection
  45.      with the `i' option by Steger.
  46.  
  47.    - Five additional CWEB example programs are included as examples for the
  48.      portability between PASCAL-WEB and C-CWEB and for the usage of the C++
  49.      features of version 3.1.  The  fifth  example program is a simple text
  50.      converter  for  files  with  extended  character codes of ISO-Latin-1,
  51.      PC-850, MAC 8-bit font, and HP 8-bit font.
  52.  
  53.    - All three system programs support the `version' information command.
  54.  
  55.    - Both CTANGLE and CWEAVE are compiled in the NEAR  data segment and can
  56.      be made resident.
  57.  
  58.    - The `m' option enables ARexx communication between  CWEB and the SAS/C
  59.      message browser SCMSG.  Any warnings or error messages are transferred
  60.      to its list  window.  The behaviour of  this feature can be controlled
  61.      via  the  external  environment variable SCMSGOPT, which may be set to
  62.      any legal option string as described in the documentation of the SAS/C
  63.      development system by SAS Institute.
  64.  
  65. This port was done and completely tested with SAS/C version 6.3 and SAS/C++
  66. version  6.51  on the AMIGA.  After completion the package was re-ported to
  67. various  UNIX systems (HP 9000, HP-PA, Sun, SGI) with CC, C89, and GCC, and
  68. ported  to  MSDOS  with  TURBO-C++ 3.1.  Provided that all these ports work
  69. successfully, I am quite sure that all bugs have been found and fixed.
  70.