NAME

       deweb - strips away C & CWEB commands from CWEB sources

SYNOPSIS

       deweb [ file1 file2 ...  ]

DESCRIPTION

       deweb  filters  away all C & CWEB commands from a CWEB source code. This leaves only the LaTeX code. This
       stripped code, in turn, may then be passed to a suitable  syntax  checker  for  LaTeX,  like  ChkTeX  and
       lacheck, or spell-checkers like ispell.

       The chkweb tool, included in the ChkTeX distribution will do just this; writing similar scripts should be
       trivial.

       When  deweb  strips  away the C code from your CWEB source, it tries to preserve line breaks.  This means
       that the error reports  from <your favorite tool> will be correct regarding  to  line  numbers.  In  most
       cases,  the column position will also be correct. This significantly simplifies finding the errors in the
       LaTeX source (in contrast to the output from cweave, which output is truly difficult to  figure  anything
       out from).

       deweb  accepts  a  list  of  filenames  on  the argument line, and will send its output to stdout.  If no
       filenames are given, it will read from stdin, acting as a filter. No options are currently accepted.

       Macho users may try to pipe the output from deweb directly into LaTeX, theoretically, this  should  work.
       This  would  ease  the  debugging  of  the  LaTeX code significantly, as when LaTeX complains about wrong
       syntax, you'll be able to find the erroneous line much more easily. Don't expect that  the  output  looks
       very much like the final one, though.

       deweb  should  now understand all correct CWEB opcodes. If it complains about not understanding a correct
       opcode, please inform the author.

DISTRIBUTION

       Copyright (C) 1996 Jens T. Berger Thielemann

       This program is free software; you can redistribute it and/or modify  it  under  the  terms  of  the  GNU
       General  Public License as published by the Free Software Foundation; either version 2 of the License, or
       (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;  without  even
       the  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

       You should have received a copy of the GNU General Public License along with this program; if not,  write
       to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

ENVIRONMENT

       No environment variables are used.

FILES

       None.

AUTHOR

       Jens T. Berger Thielemann, <jensthi@ifi.uio.no>

SEE ALSO

       cweave(1), perl(1), chktex, lacheck(1), ispell(1)

BUGS

       Doesn't  even  compile  under  Perl versions before perl v5. Unfortunately, this means that we can't even
       tell the user why we failed; Perl will just complain about not being able to compile the regexps.

       The program will try to swallow the whole input file at once, instead of processing it on a  line-by-line
       basis.

7th Edition                                       June 8, 1996                                          deweb(1)