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.