source/texk/web2c/man/ctie.man

   1 .TH CTIE 1 "7 April 2010" "Web2C @VERSION@"
   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 .\"=====================================================================
  49 .SH "SEE ALSO"
  50 .BR cweb (1),
  51 .IR ctiedoc.tex ,
  52 .BR tie (1),
  53 .BR web (1).
  54 .\"=====================================================================
  55 .SH "AUTHOR"
  56 Julian Gilbey, jdg@debian.org.  The original TIE program was by Klaus
  57 Guntermann, TH Darmstadt, Institut f. Theoretische Informatik.  The
  58 TIE man page was by Joachim Schnitter, TH Darmstadt, Phys. Chemie I,
  59 and was modified for CTIE by Julian Gilbey.