diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/perltex | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/perltex')
-rw-r--r-- | Master/texmf-dist/doc/latex/perltex/README | 53 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/perltex/perltex.pdf | bin | 0 -> 300425 bytes |
2 files changed, 53 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/perltex/README b/Master/texmf-dist/doc/latex/perltex/README new file mode 100644 index 00000000000..6bccfbebe32 --- /dev/null +++ b/Master/texmf-dist/doc/latex/perltex/README @@ -0,0 +1,53 @@ + + +---------------------------------------------+ + | PERLTEX | + | Defining LaTeX macros in terms of Perl code | + | 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) 2004 by Scott Pakin + +These files may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.2 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.2 or later is +part of all distributions of LaTeX version 1999/12/01 or later. diff --git a/Master/texmf-dist/doc/latex/perltex/perltex.pdf b/Master/texmf-dist/doc/latex/perltex/perltex.pdf Binary files differnew file mode 100644 index 00000000000..f4fe25c5812 --- /dev/null +++ b/Master/texmf-dist/doc/latex/perltex/perltex.pdf |