source/texk/web2c/ctiedir/README

   1 This is the README file of the `CTIE' distribution, version 1.1
   2 ---------------------------------------------------------------
   3
   4 CTIE is based on the `TIE' program, a program which was first
   5 developed to allow WEB programmers to use more than one change file
   6 with their WEB programs.
   7
   8 CWEB introduced a new command, @i, to handle "include files".  The
   9 original TIE program was not designed to handle this situation, and so
  10 could not be used for all CWEB programs.  CTIE behaves essentially
  11 identically to the original TIE, and identical results will be
  12 generated when TIE is applied to traditional WEB files with changes,
  13 as long as there are no errors.  (Errors may lead to different output,
  14 but then the errors need correcting, anyway.)
  15
  16 CTIE can be used to either create a new version of the (C)WEB file
  17 which incorporates the changes, or to merge multiple change files into
  18 a single change file.  This program does not depend in an essential
  19 way on any special WEB dialect, nor on using WEB at all, as the only
  20 controls to be interpreted are the change requests in the change files
  21 (delimited by @x, @y and @z) and file include commands (indicated by @i).
  22 This makes `CTIE' also usable for any other language, or even
  23 data files.  See the documentation ctiedoc.tex and the example file
  24 ctie.tie for more information.
  25
  26
  27 REQUIREMENTS:
  28
  29 This version of `CTIE' is written in CWEB.  To preprocess and compile
  30 the source you will need a working `ctangle'.  A pretangled ctie.c is
  31 supplied if you do not have a working ctangle available.
  32
  33 Please note, that the CWEB by Silvio Levy and Donald E. Knuth must
  34 probably be at least at version 2.8, to process and compile `ctie'
  35 without problems.
  36
  37 Furthermore, a ctie-k.ch file is provided which links ctie against
  38 Karl Berry's kpathsea library.  A tangled version of this file is
  39 provided as ctie-k.c.  To use this, you will need to link against
  40 version 3.4.5 or higher of the kpathsea library.  This version
  41 searches for files, both from the command line and included (@i) files
  42 using the CWEBINPUTS search path.
  43
  44
  45 DISTRIBUTION:
  46
  47 This package has been uploaded to CTAN, and appears in the directory
  48 web/c_cpp/ctie/.
  49
  50
  51 LICENCE:
  52
  53 This program is based on tie.w and common.w (part of CWEB).  It is
  54 distributed with the following licence.
  55
  56 Copyright (c) 2002,2003 by Julian Gilbey
  57 All rights reserved.
  58
  59 This program is distributed WITHOUT ANY WARRANTY, express or implied.
  60
  61 Permission is granted to make and distribute verbatim copies of this
  62 program provided that the copyright notice and this permission notice
  63 are preserved on all copies.
  64
  65 Permission is granted to copy and distribute modified versions of this
  66 program under the conditions for verbatim copying, provided that the
  67 entire resulting derived work is distributed under the terms of a
  68 permission notice identical to this one.
  69
  70
  71 BUGS/ENHANCEMENTS:
  72
  73 If you detect bugs in the implementation of CTIE or have suggestions
  74 to enhance functionality or improve portability, please send a message
  75 to Julian Gilbey <jdg@debian.org>.