add README and example.pdf from CTAN

git-svn-id: svn://tug.org/texlive/trunk@16505 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 103 insertions, 0 deletions

diff --git a/Build/source/utils/tpic2pdftex/README b/Build/source/utils/tpic2pdftex/README
new file mode 100644
index 00000000000..f69e904ccd4
--- /dev/null
+++ b/Build/source/utils/tpic2pdftex/README
@@ -0,0 +1,103 @@
+Converting tpic \special's into \pdfliteral's by awk
+====================================================
+
+The experimental awk-script tpic2pdftex.awk builds one bridge between the
+"pic" graphics language and pdfTeX.
+
+What tpic2pdftex.awk does:
+
+We start from one or more graphics described by the venerable pic language
+(see e. g. file example.pic), embedded inline within pdfTeX or pdfLaTeX
+code, and limited by classical .PS and .PE markers as known from groff.
+The pic graphics might be annotated by TeX or LaTeX text.  This pic/TeX
+language-mix file is piped through the (groff-)pic preprocessor and
+the tpic2pdftex.awk script.  The result is a TeX file with inline
+\pdfliteral{} sections, for further processing by pdftex or pdflatex.
+
+
+Usage
+-----
+
+$ export LANG="C"
+$ pic -t somefile.pic | awk -f tpic2pdftex.awk > somefile.tex
+
+Process somefile.tex by pdftex or pdflatex.
+
+
+Files
+-----
+
+tpic2pdftex.awk
+  The awk script for converting tpic specials into pdfliterals for
+  further processing by pdftex.  For usage see head of this file.
+
+example.pic
+  A small pic sample file (plain-TeX), as input.
+
+example.pdf
+  The resulting example PDF file (the dotted and dashed ellipses are
+  part of gpic from version 1.19.1 on).
+
+beamerexample.pic
+  Another small pic sample file (pdfLaTeX), which shows that images
+  created by pic can be incrementally built up in the beamer class.
+
+Makefile
+  The Makefile used to produce file example.pdf and beamerexample.pdf
+  from the input files.
+
+README
+  This file.
+
+
+Portability
+-----------
+
+This awk-script should be useable on all systems on which a working awk
+program (e. g. awk, gawk, mawk) is installed.
+
+The script has been tested with GNU pic (groff), versions 1.18.1 and
+1.19.1, and pdftex, versions 1.11b and 1.20a on a debian woody (3.0)
+i686 PC.
+
+
+Remarks
+-------
+
+1. If more than a single .pic file provide the source for the .tex file,
+there are two options: Either separately run all .pic files through the
+pic -t | awk -f tpic2pdftex.awk pipe and combine them by TeX's \input
+statements as usual. Or make one big .pic file by using the soelim
+program from groff (with option -t), and then run the resulting .pic file
+through pic, tpic2pdftex, and TeX. File embedding by soelim is done by
+the request:
+
+.so somefile.pic
+
+The process call then could look like e. g.:
+
+$ soelim -t somefile.pic | pic -t | awk -f tpic2pdftex.awk > somefile.tex
+
+2. Depending on the awk version, "locale" settings might have influence
+on the separator in floating point numbers. PDF requires decimal _dots_
+(e. g. 3.14 rather than 3,14) which is checked by tpic2pdftex.awk at
+the begin of the run. If you get an ERROR message, set LANG="C", so that
+decimal dots are used as float separators.
+
+
+Literature
+----------
+
+Brian W. Kernighan: PIC -- A Graphics Language for Typesetting, User
+Manual, Revised, May, 1991. File cstr116.ps.
+
+Eric S. Raymond: Making Pictures With GNU PIC. File gpic.raymond.ps.
+
+Both files are available online from various places.
+
+
+Comments welcome. Have fun!
+
+Hartmut
+
+$Id: README,v 1.7 2004/04/09 20:28:49 hahe Exp hahe $
diff --git a/Build/source/utils/tpic2pdftex/example.pdf b/Build/source/utils/tpic2pdftex/example.pdf
new file mode 100644
index 00000000000..9736b5bffcb
--- /dev/null
+++ b/Build/source/utils/tpic2pdftex/example.pdf