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