delim $$ l2x -- conversion from LaTeX to other formats Version 1.4 Henning Schulzrinne GMD Fokus Berlin, Germany hgs@fokus.gmd.de 1 Description l2x is a general-purpose LaTeX converter. It consists of a parser written in C, which then calls Tcl functions for each LaTeX func- tion. The Tcl functions return the translated value. 2 Installation The newest version of this package is available by anon. ftp. It is a gzip'ed tar file. You must have the Tcl libraries installed, for example obtained by anonymous ftp. Edit the Makefile for the correct location of the Tcl library and include files and type make 3 Usage To translate the LaTeX file input.tex using the translator foo.tcl : l2x foo.tcl < paper.tex The application lf is a filter that removes blank lines and, with the -b flag specified, initial blank space on lines. It is intended for nroff conversion. The application pgstrip removes extra blank lines from the beginning of a page and is due to Jon Postel. The script fix.sh processes an RFC or Internet Draft, including the necessary strip- ping of backspaces and the conversion of FORMFEED to real formfeeds (control-L). Currently, the following example translators are provided: l2html.tcl Convert input to a single HTML file. ms.tcl Convert to nroff/troff -ms macros. Currently converts to a format suitable for FAQs and READMEs (no page breaks or page numbers), but that is readily changed. 4 Limitations Currently, only a subset of LaTeX commands is supported. Many are easy to add, but the following might require more work, albeit mostly limited to writing new Tcl functions: o For conversion to HTML, math mode is supported by calling LaTeX and including the GIF image. o The \newenvironment command is not supported. o Table of contents, etc. are not supported in nroff. 5 Examples To convert nroff output to plain ASCII, without underscores, use l2x ms.tcl < foo.tex | nroff -ms | ul -tdumb > foo.txt 6 Copyright Copyright (c) 1994 Henning Schulzrinne All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistribution for direct commercial gain requires prior permission. 2. Redistributions of source code must retain the above copyright notice, this list of conditions and the follow- ing disclaimer. 3. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the follow- ing disclaimer in the documentation and/or other materi- als provided with the distribution. 4. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by Henning Schulzrinne. This software is provided by the author(s) "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the contributors be liable for any direct, indirect, incidental, special, exemplary, or consequen- tial damages (including, but not limited to, procurement of substi- tute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negli- gence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.