home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / intercal.zip / doc / READ.ME < prev    next >
Text File  |  1996-06-12  |  1KB  |  37 lines

  1. This directory contains the documentation (such as it is) for INTERCAL.
  2.  
  3. READ.ME
  4.     This file.
  5.  
  6. intercal.ms:
  7.     Masters for the INTERCAL manual (needs pic to render illos)
  8.     This has been carefully proofread against the original paper
  9.     version.
  10.  
  11. THEORY
  12.     Implementation notes on the C-INTERCAL implementation.
  13.  
  14. chip.spec:
  15.     Christian Brunschen's spec sheet for the INTERCAL chip.
  16.  
  17. Note 1: The TeX version we formerly distributed has been dropped.  The
  18. combination of groff and pic does an effective job of rendering the
  19. illustrations and is easier to maintain.
  20.  
  21. Note 2: The supplemental reference manual, ick.txt, has been merged
  22. into the intercal manual. (It is still possible to generate the 
  23. original; see the Makefile.)
  24.  
  25. Note 3: The flat-ASCII directly transcribed from the paper original is
  26. also gone.  You can regenerate something very close to it with \&`make
  27. original.txt'.  The differences will be (a) page breaks may fall in
  28. different places, (b) the circuit diagrams present in the paper
  29. version but absent in the ASCII transcription are instead poorly
  30. approximated with ASCII boxology, (c) every "butchered Roman numeral"
  31. is preceded and followed by a line break, (d) the hanging-indent list
  32. of Princeton compiler options is has all marks above each description,
  33. rather than to its left.
  34.  
  35. The aim of these changes was to reduce to one the number of manual masters that
  36. need to be maintained.
  37.