1deweb(1)                    General Commands Manual                   deweb(1)
2
3
4

NAME

6       deweb - strips away C & CWEB commands from CWEB sources
7

SYNOPSIS

9       deweb [ file1 file2 ...  ]
10

DESCRIPTION

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

DISTRIBUTION

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

ENVIRONMENT

59       No environment variables are used.
60

FILES

62       None.
63

AUTHOR

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

SEE ALSO

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

BUGS

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)
Impressum