CWEB(1)                     General Commands Manual                    CWEB(1)

<?><?><?> (NAME)
       ctangle, cweave - <?><?><?><?><?> CWEB <?><?> C/C++ <?>/<?><?> TeX

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ctangle [options] webfile[.w] [{changefile[.ch]|-} [outfile[.c]]]
       cweave [options] webfile[.w] [{changefile[.ch]|-} [outfile[.tex]]]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> ctangle <?><?> <?><?><?> <?><?><?><?> CWEB <?><?>
       <?><?> <?><?> <?><?><?><?><?><?> C/C++ <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> #line <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> CWEB <?><?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?><?> cweave <?><?><?><?> <?><?><?><?> CWEB <?><?> <?><?>
       <?><?> <?><?><?><?> TeX <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?> <?><?><?>.  <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?> CWEB <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       C/C++ <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?> CWEB <?><?><?><?> <?><?> <?><?> C/C++ <?> <?><?> <?><?>
       TeX <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?> (USAGE)
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> CWEB <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> .w <?><?><?><?><?>
       <?><?><?><?><?><?>).  <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> (<?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> .ch <?><?><?><?><?><?> <?><?><?><?><?><?>).
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> CWEB <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> (<?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?>) <?><?> <?><?><?><?><?> .tex <?><?><?>.  <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <<->>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?> CWEB <?><?><?><?> (DIFFERENCES TO ORIGINAL
       CWEB)
       <?><?><?><?><?> CWEBbin <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       CWEB <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>:

       o <?><?><?><?><?><?><?><?><?> --help<?> --quiet<?> --verbose<?>
         --version<?> <?> <?><?><?><?><?><?><?><?> +c<?> -i<?> -o<?> +u <?>
         +lX <?><?> CWEBbin <?> TeX Live <?><?><?><?> <?><?><?><?><?>.

       o <?><?><?><?><?> +lX <?><?> <?><?><?><?><?> <?><?><?><?>
         <?><?><?><?><?> <?><?><?><?> cwebmac.tex <?><?><?><?><?> <?><?><?>
         <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
         <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (+ld)<?>
         <?><?><?><?><?><?><?> (+lf) <?> <?><?><?><?><?><?><?><?><?> (+li)
         <?><?><?>.

       o <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?><?><?> CWEBINPUTS <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
         <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>
         <<<?><?><?><?> (ENVIRONMENT)>> <?><?> <?><?><?> <?><?>
         <?><?><?><?><?><?>.

       o <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> ctangle <?> cweave <?><?>
         "GNU gettext utilities" <?><?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <<->> <?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>) <?><?> <?><?> <<+>> <?><?><?><?>
       <?><?><?><?><?> (<?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>).  <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> --verbose -h <?><?><?><?>
       <?><?> <?><?><?><?><?> (+b) <?> <?><?><?><?><?> <?><?><?><?><?><?> (+p)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (-h)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> ctangle <?> cweave <?><?><?><?><?>
       <?><?><?><?><?>:

       o +b: <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>

       o +h: <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?> <?><?><?>

       o +p: <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
         <?><?><?><?><?><?>

       o +q/-q: <?><?><?><?><?><?><?> <?><?><?><?> -bhp<?> <?><?><?><?><?><?>
         --quiet

       o +v/-v: <?><?><?><?><?><?><?> <?><?><?><?> +bhp<?> <?><?><?><?><?><?>
         --verbose (<?><?><?><?><?><?><?>)

       o +c: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?>

       o +s: <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>

       o --help: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
         <?><?><?><?>

       o --version: <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?>
         <?><?><?><?>

       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> ctangle <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

       o +k: <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
         <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>

       o +u: <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
         UTF-8 <?><?> <?><?> C

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> cweave <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

       o -e: <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> C/C++ <?><?>
         <?><?><?><?> \PB{...}

       o -f: <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
         <?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
         C/C++ <?><?> <?><?><?><?><?>

       o -F: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
         <?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>

       o -i: <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
         <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>

       o -o: <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>

       o -x: <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
         <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>

       o +lX/-lX: <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
         <?><?><?><?> <?><?><?><?> X <?><?><?><?><?> <?><?> Xcwebmac.tex

       o +t: <?><?><?><?><?> <?><?> typename <?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?> typedef

<?><?><?><?> (ENVIRONMENT)
       <?><?><?><?><?> <?><?><?><?><?> CWEBINPUTS <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> CWEBINPUTS <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> tex(1)
       <?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       CWEBINPUTS <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?> <?><?> CWEBINPUTS_cweb <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> CWEB
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> NLS<?> <?><?><?><?><?><?><?><?><?><?>
       ctangle <?> cweave <?><?> <?><?><?><?><?> <?><?><?><?><?>
       TEXMFLOCALEDIR <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> "GNU
       gettext utilities" <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> texmf.cnf
       <?><?><?><?><?> <?><?> TeX Live <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.  <?><?> <?><?><?><?><?> kpsewhich
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

       o cwebmac.tex: <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
         TeX <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
         cweave <?><?><?><?><?><?><?> \input <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?>.

       o cwebman.tex: <?><?><?><?><?><?> <?><?><?><?><?><?><?>
         <?><?><?><?><?><?> CWEB<?> <?><?><?><?><?> <?><?> <?><?><?><?> PDF
         <?><?> CTAN <https://ctan.org/pkg/cweb>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       o The CWEB System of Structured Documentation: <?><?><?><?><?> Donald
         E. Knuth <?> Silvio Levy (<?><?><?><?> <?><?><?><?> cwebman.tex <?>
         <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> common.w<?> ctangle.w
         <?> cweave.w).

       o Literate Programming: <?><?><?><?><?> D. E. Knuth.

       o Weaving a Program: <?><?><?><?><?> Wayne Sewell.

       cweb(1), tex(1), cc(1)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Don Knuth <?><?><?><?><?> WEB <?><?> <?><?><?><?> TeX <?> Pascal
       <?><?><?><?>.
       Silvio Levy <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       WEB <?><?> C <?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       CWEB<?> <?><?><?><?><?> CWEB <?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?>.  Knuth <?><?><?><?><?><?><?> <?><?> CWEB <?><?> <?><?><?><?>
       <?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> CWEB <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       https://github.com/ascherer/cweb <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?>.

Web2c 2026                      April 30, 2025.                        CWEB(1)