diff options
| -rw-r--r-- | Build/source/utils/tpic2pdftex/README | 53 | ||||
| -rwxr-xr-x | Build/source/utils/tpic2pdftex/tpic2pdftex | 11 | ||||
| -rw-r--r-- | Build/source/utils/tpic2pdftex/tpic2pdftex.1 | 4 |
3 files changed, 38 insertions, 30 deletions
diff --git a/Build/source/utils/tpic2pdftex/README b/Build/source/utils/tpic2pdftex/README index f69e904ccd4..91657365198 100644 --- a/Build/source/utils/tpic2pdftex/README +++ b/Build/source/utils/tpic2pdftex/README @@ -1,25 +1,25 @@ Converting tpic \special's into \pdfliteral's by awk ==================================================== -The experimental awk-script tpic2pdftex.awk builds one bridge between the +The experimental awk-script tpic2pdftex builds one bridge between the "pic" graphics language and pdfTeX. -What tpic2pdftex.awk does: +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 +(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. +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 | awk -f tpic2pdftex.awk > somefile.tex + $ export LANG="C" + $ pic -t somefile.pic | tpic2pdftex > somefile.tex Process somefile.tex by pdftex or pdflatex. @@ -27,9 +27,12 @@ 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. +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. @@ -42,6 +45,9 @@ 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. @@ -54,11 +60,11 @@ Portability ----------- This awk-script should be useable on all systems on which a working awk -program (e. g. awk, gawk, mawk) is installed. +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. +1.19.3, and pdftex, versions 1.40.9 and 1.50.0 on a debian lenny (5.0) +x86_64 PC. Remarks @@ -66,22 +72,21 @@ 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: +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 + .so somefile.pic The process call then could look like e. g.: -$ soelim -t somefile.pic | pic -t | awk -f tpic2pdftex.awk > somefile.tex + $ 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.awk at -the begin of the run. If you get an ERROR message, set LANG="C", so that +(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. @@ -100,4 +105,4 @@ Comments welcome. Have fun! Hartmut -$Id: README,v 1.7 2004/04/09 20:28:49 hahe Exp hahe $ +$Id: README,v 1.11 2010/01/16 12:38:21 hahe Exp hahe $ diff --git a/Build/source/utils/tpic2pdftex/tpic2pdftex b/Build/source/utils/tpic2pdftex/tpic2pdftex index 26549dbd578..8277e0d3c7b 100755 --- a/Build/source/utils/tpic2pdftex/tpic2pdftex +++ b/Build/source/utils/tpic2pdftex/tpic2pdftex @@ -1,6 +1,6 @@ #!/bin/sh - # -# $Id: tpic2pdftex,v 1.94 2007/01/14 19:05:32 hahe Exp $ +# $Id: tpic2pdftex,v 1.97 2010/01/16 11:51:43 hahe Exp $ # # Experimental awk-script for conversion of tpic \specials as produced # by (groff-)pic into pdfTeX \pdfliteral sections for further processing @@ -20,7 +20,7 @@ # Bounding box does not care for line thickness (groff pic feature). # Splines might be outside bounding box. # -# Copyright (C) 2002--2004, 2009 by Hartmut Henkel +# Copyright (C) 2002--2010 by Hartmut Henkel # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -40,7 +40,8 @@ # hartmut_henkel@gmx.de # # NEWS: -# 24 Dec. 2009 - use gawk for default awk only if it exists. +# 24 Dec. 2009 - use gawk for default awk only if it exists +# (patch by Karl Berry). # 14 Jan. 2007 - make it executable shell script, calling awk # 16 Dec. 2004 - Replaced // {print} by {print} (some AWKs did choke) # 09 Apr. 2004 - Locale check: Decimal point in float numbers? @@ -70,6 +71,7 @@ # Systems which define $COMSPEC or $ComSpec use semicolons to separate # directories in TEXINPUTS -- except for Cygwin et al., where COMSPEC # might be inherited, but : is used. + if test -n "$COMSPEC$ComSpec" \ && uname | $EGREP -iv 'cygwin|mingw|djgpp' >/dev/null; then path_sep=";" @@ -80,6 +82,7 @@ fi # findprog PROG # ------------- # Return true if PROG is somewhere in PATH, else false. + findprog () { local saveIFS="$IFS" @@ -110,7 +113,7 @@ if test -z "$AWK"; then # if set by user, leave it. AWK=awk fi fi - + export LANG="C" AWKPROG=' diff --git a/Build/source/utils/tpic2pdftex/tpic2pdftex.1 b/Build/source/utils/tpic2pdftex/tpic2pdftex.1 index d71dfca11bd..2be7c0737e1 100644 --- a/Build/source/utils/tpic2pdftex/tpic2pdftex.1 +++ b/Build/source/utils/tpic2pdftex/tpic2pdftex.1 @@ -1,6 +1,6 @@ .TH TPIC2PDFTEX 1 2008-08-01 GNU "Tex Live Manpage" -.\"$Id: tpic2pdftex.1,v 1.14 2008/08/08 20:30:38 hahe Exp $ +.\"$Id: tpic2pdftex.1,v 1.15 2010/01/16 12:13:17 hahe Exp hahe $ .\" .\" Copyright (C) 2002--2008 by Hartmut Henkel .\" @@ -51,7 +51,7 @@ by .B pdftex. .SH NOTES -Current version: 1.94. +Current version: 1.97. .B tpic \\special |