Files in this directory

Name	Date	Size		Description
README	2009-03-27	2 Kbyte	download	Shown below
perltex.1	2009-11-24	9 Kbyte	download
perltex.dtx	2009-11-24	116 Kbyte	download
perltex.ins	2009-03-27	2 Kbyte	download
perltex.pdf	2009-11-24	325 Kbyte	download

---

Contents of the README file

                +------------------------------------+
                |              PERLTEX               |
                | By Scott Pakin, scott+pt@pakin.org |
                +------------------------------------+


Description
===========

PerlTeX is a combination Perl script (perltex.pl) and LaTeX2e style
file (perltex.sty) that, together, give the user the ability to define
LaTeX macros in terms of Perl code.  Once defined, a Perl macro becomes
indistinguishable from any other LaTeX macro.  PerlTeX thereby combines
LaTeX's typesetting power with Perl's programmability.


Installation
============

In case it's not obvious, you'll need a Perl installation.  Perl is
freely available and runs on dozens of platforms.  See the list of Perl
binary distributions on CPAN (http://www.cpan.org/ports/index.html).

Execute "latex perltex.ins" to generate perltex.sty and perltex.pl.
Install perltex.sty in an appropriate directory (e.g.,
/usr/local/share/texmf/tex/latex/misc or C:\localtexmf\tex\latex\misc).
perltex.pl is a Perl script.  On Unix, you may want to rename it to
just "perltex" and set execute permissions ("chmod +x perltex").  On
Windows, you may want to create a batch-file wrapper for it ("pl2bat
perltex.pl").  In either case, perltex should be installed somewhere in
your executable path (e.g., /usr/local/bin).

It's not necessary to produce the documentation as PerlTeX comes with
prebuilt documentation in PDF format (perltex.pdf).  However, if you
want to build the documentation yourself (e.g., to use A4 paper instead
of U.S. Letter), run "latex perltex.dtx" twice, then "makeindex -s
gind.ist perltex.idx" and "makeindex -s gglo.ist perltex.glo -o
perltex.gls", then "latex perltex.dtx" again, then "dvips perltex.dvi
-o perltex.ps" if you want to produce PostScript.


License
=======

Copyright (C) 2009 Scott Pakin

These files may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c of this license or
(at your option) any later version.  The latest version of this license
is in:

    http://www.latex-project.org/lppl.txt

and version 1.3c or later is part of all distributions of LaTeX version
2006/05/20 or later.

Small print: This listing is regenerated periodically so there is a small chance that the directory has changed from what is shown here; to be sure, check the FTP listing.