summaryrefslogtreecommitdiff
path: root/graphics/tpic2pdftex/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /graphics/tpic2pdftex/README
Initial commit
Diffstat (limited to 'graphics/tpic2pdftex/README')
-rw-r--r--graphics/tpic2pdftex/README136
1 files changed, 136 insertions, 0 deletions
diff --git a/graphics/tpic2pdftex/README b/graphics/tpic2pdftex/README
new file mode 100644
index 0000000000..d6bb21d3dc
--- /dev/null
+++ b/graphics/tpic2pdftex/README
@@ -0,0 +1,136 @@
+Converting tpic \special's into \pdfliteral's by awk
+====================================================
+
+The experimental awk-script tpic2pdftex builds one bridge between the
+"pic" graphics language and pdfTeX.
+
+What tpic2pdftex 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 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 | tpic2pdftex > somefile.tex
+
+Process somefile.tex by pdftex or pdflatex.
+
+
+Files
+-----
+
+tpic2pdftex
+ The executable awk-script for converting tpic specials into pdfliterals
+ for further processing by pdftex. For usage see head of this file.
+
+tpic2pdftex.1
+ The man-page for tpic2pdftex.
+
+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.
+
+beamerexample.pdf
+ The resulting PDF file from beamerexample.pic.
+
+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.3, and pdftex, versions 1.40.9 and 1.50.0 on a debian lenny (5.0)
+x86_64 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 | tpic2pdftex 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 | tpic2pdftex > 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 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.11 2010/01/16 12:38:21 hahe Exp hahe $
+
+======================================================================
+
+
+CTAN SOURCE TREE INFORMATION
+
+
+This CTAN source tree has been automatically extracted from the TeXLive
+Subversion repository at svn://tug.org/texlive/trunk/Build/source/utils/.
+
+It is not possible to use the supplied configure script.
+In fact, if you call it; you will be told as such.
+
+This source can only be compiled in a texk build environment.
+You will need to download the whole environment, please refer to
+http://www.tug.org/texlive/svn/.
+
+It all boils down to a Subversion checkout of
+svn://tug.org/texlive/trunk/Build/source
+This will be the source tree that you can use for compilation. The
+CTAN directory is there for archival and informational purpose.
+
+For your convenience, the original configure script from the source
+tree is available in this directory as configure.texk.
+
+For the CTAN team,
+
+ Joachim Schrod <jschrod@acm.org>