The TeXFILT program is a filter for TeX/LaTeX log files. The filter converts the log files into "standard" error messages of the form: [Error|Warning] [FileReference] [Line No]: [Standardized Message] Context Reference Sample: Error yourfile.tex 18: Undefined control sequence a representative line of text from yourfile \hfffill Once error files of this form are created, most modern programmer's editors can automatically snap to the `next' and `previous' errors in the error log file and the source code. I've tested the program on some large LaTeX and plain TeX files, which consist of many input files. The system will snap directly to the source file line, containing the error, with the editor I use. I've tested the code under DOS, OS/2 and Linux (aka UNIX). Also, the source code for the program was developed using NOWEB, the literate programming tool developed by Norman Ramsey and ported to DOS by Lee Wittenberg. People interested in literate programming might find the documentation helpful. The files included in TeXFILT3.ZIP file include: 607 Mar 9 19:45 execrev.tex graphics screen 656 Mar 9 17:36 execset.tex graphics screen 1740 Mar 8 22:18 getty1.tex file containing errors 6918 Mar 8 22:18 getty2.tex file containing errors 10472 Mar 6 22:12 getty3.tex file containing errors 1861 Mar 10 10:40 getty4.tex file containing errors 254 Mar 9 18:25 makefile 9 Mar 10 19:16 t.aux 30528 Mar 10 19:16 t.dvi 152 Feb 20 19:24 t.err 5587 Mar 10 19:16 t.log 1503 Mar 10 10:04 t.tex master error file 7817 Mar 11 08:23 texfilt.aux 3289 Mar 10 22:53 texfilt.awk NoWeB output file 36796 Mar 11 08:23 texfilt.dvi WeB documentation file 64485 Mar 10 23:04 texfilt.exe DOS Compiled version of texfilt.awk 2636 Mar 11 08:23 texfilt.log 21587 Mar 11 08:27 texfilt.nw NoWeB Source 31655 Mar 11 08:23 texfilt.tex NoWeB output file 2451 Mar 11 08:23 texfilt.toc 1220 Mar 10 23:01 x.err error file produced by T.TEX /fonts: 62956 Mar 9 19:47 execreva.pk bm2font pixel file 160 Mar 9 19:47 execreva.tfm bm2font tfm file 35116 Mar 9 19:47 execrevb.pk 160 Mar 9 19:47 execrevb.tfm 61300 Mar 9 17:36 execseta.pk 156 Mar 9 17:36 execseta.tfm 61112 Mar 9 17:36 execsetb.pk 160 Mar 9 17:36 execsetb.tfm 6356 Mar 9 17:36 execsetc.pk 148 Mar 9 17:36 execsetc.tfm /styles: 957 Jul 28 10:34 ejbbox.sty Style files used in texfilt.tex 27344 Jul 27 13:09 fancybox.sty courtesy of Tim Van Zandt 26676 Jan 18 16:26 noweb.sty courtesy of Norm Ramsey and Lee Wittenberg Installation and Usage: DOS Users: Create a seperate directory for TeXFILT, if you wish. Copy TeXFILT3.ZIP to that directory. Use "pkunzip -d texfilt3" to extract the subdirectories correctly. If you plan to use the compiled version of the program, place "texfilt.exe" in a directory searched by you path. Use the following command with an awk interpreter to convert a TeX log file: awk -f texfilt.awk YOURFILE.LOG > x.err The compiled version can be executed with: texfilt YOURFILE.LOG > x.err Unix Users: Create a seperate directory for TeXFILT, if you wish. Copy TeXFILT3.ZIP to that directory. Use "unzip -d texfilt3" to extract the subdirectories correctly. A compiled version does not exist for UNIX. The only file you actually need to keep is "texfilt.awk". All of the other files are there for documentation and demonstration purposes. Use the following command with an awk interpreter to convert a TeX log file: awk -f texfilt.awk YOURFILE.LOG > x.err Printing the DVI File: If you want to print the texfilt.dvi file at your site you'll have to take a couple of extra steps. 1. Copy the `tfm' files in the fonts sub-directory to your local directory for tfm files. 2. Copy the `pk' files in the fonts sub-directory to your local location for 300dpi pixel files. More info on NoWeb: If you want to get into literate programming, and I highly recommend you do, further information on NoWeB can be found by anonymous ftp at: bellcore.com directory /pub/norman/noweb.shar.Z DOSNOWEB can be found at: bart.kean.edu directory /pub/leew
texfilt – A (La)TeX log filter
Works under DOS, OS/2 and Linux. Code written in noweb, so documented source available.
|License||Unknown Status, No Information Available|
analyse or otherwise manipulate logs|