1deweb(1) General Commands Manual deweb(1)
2
3
4
6 deweb - strips away C & CWEB commands from CWEB sources
7
9 deweb [ file1 file2 ... ]
10
12 deweb filters away all C & CWEB commands from a CWEB source code. This
13 leaves only the LaTeX code. This stripped code, in turn, may then be
14 passed to a suitable syntax checker for LaTeX, like ChkTeX and lacheck,
15 or spell-checkers like ispell.
16
17 The chkweb tool, included in the ChkTeX distribution will do just this;
18 writing similar scripts should be trivial.
19
20 When deweb strips away the C code from your CWEB source, it tries to
21 preserve line breaks. This means that the error reports from <your
22 favorite tool> will be correct regarding to line numbers. In most
23 cases, the column position will also be correct. This significantly
24 simplifies finding the errors in the LaTeX source (in contrast to the
25 output from cweave, which output is truly difficult to figure anything
26 out from).
27
28 deweb accepts a list of filenames on the argument line, and will send
29 its output to stdout. If no filenames are given, it will read from
30 stdin, acting as a filter. No options are currently accepted.
31
32 Macho users may try to pipe the output from deweb directly into LaTeX,
33 theoretically, this should work. This would ease the debugging of the
34 LaTeX code significantly, as when LaTeX complains about wrong syntax,
35 you'll be able to find the erroneous line much more easily. Don't
36 expect that the output looks very much like the final one, though.
37
38 deweb should now understand all correct CWEB opcodes. If it complains
39 about not understanding a correct opcode, please inform the author.
40
42 Copyright (C) 1996 Jens T. Berger Thielemann
43
44 This program is free software; you can redistribute it and/or modify it
45 under the terms of the GNU General Public License as published by the
46 Free Software Foundation; either version 2 of the License, or (at your
47 option) any later version.
48
49 This program is distributed in the hope that it will be useful, but
50 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
51 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
52 Public License for more details.
53
54 You should have received a copy of the GNU General Public License along
55 with this program; if not, write to the Free Software Foundation, Inc.,
56 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
57
59 No environment variables are used.
60
62 None.
63
65 Jens T. Berger Thielemann, <jensthi@ifi.uio.no>
66
68 cweave(1), perl(1), chktex, lacheck(1), ispell(1)
69
71 Doesn't even compile under Perl versions before perl v5. Unfortunately,
72 this means that we can't even tell the user why we failed; Perl will
73 just complain about not being able to compile the regexps.
74
75 The program will try to swallow the whole input file at once, instead
76 of processing it on a line-by-line basis.
77
78
79
807th Edition June 8, 1996 deweb(1)