| 1 |
.TH CTIE 1 "8 June 2020" "Web2C 2026" |
| 2 |
.\"===================================================================== |
| 3 |
.SH NAME |
| 4 |
ctie \- merge or apply CWEB change files |
| 5 |
.\"===================================================================== |
| 6 |
.SH SYNOPSIS |
| 7 |
.B ctie |
| 8 |
.BR \-c | \-m |
| 9 |
.I outputfile masterfile |
| 10 |
.IR changefile .\|.\|. |
| 11 |
.\"===================================================================== |
| 12 |
.SH DESCRIPTION |
| 13 |
The |
| 14 |
.B ctie |
| 15 |
program is used to process multiple change files used with the CWEB |
| 16 |
system for literate programming. The CWEB programs allow one to apply |
| 17 |
patches to a source file (the |
| 18 |
.IR masterfile ) |
| 19 |
by means of a single change file. |
| 20 |
.B ctie |
| 21 |
can be used to either merge up to 32 change files into a single one or |
| 22 |
to apply the changes to the |
| 23 |
.I masterfile |
| 24 |
in order to create a new master file. Output of either the new change |
| 25 |
file or the patched master file goes into |
| 26 |
.IR outputfile . |
| 27 |
Any include files (indicated using the CWEB |
| 28 |
.B @i |
| 29 |
command) are fully expanded during |
| 30 |
.B ctie |
| 31 |
processing, which means that the change files are able to modify the |
| 32 |
contents of any included files. |
| 33 |
.SH OPTIONS |
| 34 |
.TP |
| 35 |
.B \-c |
| 36 |
Create a single change file from the given |
| 37 |
.IR changefile s. |
| 38 |
.TP |
| 39 |
.B \-m |
| 40 |
Create a new master file by applying the given |
| 41 |
.IR changefile s. |
| 42 |
.\"===================================================================== |
| 43 |
.SH ENVIRONMENT |
| 44 |
The environment variable CWEBINPUTS is used to search for the input files, |
| 45 |
or the system default if CWEBINPUTS is not set. See |
| 46 |
.BR tex (1) |
| 47 |
for the details of the searching. |
| 48 |
To avoid conflicts with other programs that also use the CWEBINPUTS |
| 49 |
environment, you can be more specific and use CWEBINPUTS_ctie for |
| 50 |
special requirements in CTIE. |
| 51 |
.\"===================================================================== |
| 52 |
.SH "SEE ALSO" |
| 53 |
.BR cweb (1), |
| 54 |
.IR ctiedoc.tex , |
| 55 |
.BR tie (1), |
| 56 |
.BR web (1). |
| 57 |
.\"===================================================================== |
| 58 |
.SH "AUTHOR" |
| 59 |
Julian Gilbey, [email protected]. The original TIE program was by Klaus |
| 60 |
Guntermann, TH Darmstadt, Institut f. Theoretische Informatik. The |
| 61 |
TIE man page was by Joachim Schnitter, TH Darmstadt, Phys. Chemie I, |
| 62 |
and was modified for CTIE by Julian Gilbey. |