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.