This directory contains pdftex-0.12o-6 with TIFF inclusion support. This version is not approved by pdfTeX's primary author (Han The Thanh) so we have different naming scheme. Any suggestions to pdftug@tug.org or Pavel.Janik@inet.cz. Warning: ~~~~~~~~ This version is a very alpha testing one, and there will be a lot of changes before this version becomes stable. There is no documentation too. Please be patient on its author. If you are new to pdftex, please join pdftex mailing list to get help on troubles. Send a mail saying `subscribe pdftex' to to subscribe. Also have a look at section "Common problems" in this file before reporting problems with getting pdftex started. Copyright: ~~~~~~~~~~ pdfTeX-0.12 -- the TeX variant with direct PDF output Copyright (C) 1998 Han The Thanh 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 the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Directory contents: ~~~~~~~~~~~~~~~~~~~ README - this file COPYING - a copy of the GNU General Public License pdftexlib-0.12.zip - platform-indenpendent files required for running pdfTeX: pdftex config file (pdftex.cfg), encoding vectors (*.enc), map files (*.map), macros (*.tex). pdftex.tgz - sources to build pdfTeX Makefile.in - modified Makefile.in for pdfTeX compilation configure.in - modified configure.in for pdfTeX compilation Install - install script that I'm using Quick start: ~~~~~~~~~~~~ 1) Download and unpack binary archive pdftex.zip for your platform and pdftexlib-0.12.zip in some temporary directory (when using pkunzip don't forget -d option). 2) Place the binaries somewhere in your PATH (also make a copy of pdftex and name it as pdflatex if you want to use pdfLaTeX). Place texmf.cnf, pdftex.pool and directory texmf/ (created by unpacking pdftexlib-0.12.zip) to appropriate place. 3) Set your enviroment variable TEXMFCNF to directory containing texmf.cnf. Edit texmf.cnf so pdftex can find all needed files. Usually you need to edit TEXMF and maybe some next. Make sure that the following variables are set properly: VFFONTS -- where pdftex looks for virtual fonts T1FONTS -- where pdftex looks for Type1 (*.pfa,*pfb) fonts TTFONTS -- where pdftex looks for to TrueType (*.ttf) fonts TEXPSHEADERS -- where pdftex looks for pdftex config file (pdftex.cfg), map files (*.map), encoding vectors (*.enc) and PNG images. 4) Create formats: pdftex -ini -fmt=pdftex plain \\dump pdftex -ini -fmt=pdflatex latex.ltx 5) Test the installation: pdftex example 6) For more details have a look at an example of pdftex primitives in pdftexmf.zip:texmf/pdftex/plain/misc/example.tex 7) The best place to look/edit where pdftex complains that something cannot be found is texmf.cnf. Also setting KPATHSEA_DEBUG=255 before running pdftex will cause pdftex writes a lot of debugging information, which may be useful to find out the troubles. Also be warned that variables in texmf.cnf can be overwritten by enviroment variables with identical names. Common problems: ~~~~~~~~~~~~~~~~ 1) "! I can't read tex.pool; bad path?" Probably TEXMFCNF is not set correctly, or TEXPOOL (in texmf.cnf) doens't contain path to pool file (pdftex.pool). 2) "! You have to increase POOLSIZE." Increase value of pool_size in texmf.cnf. If pool_size is not specified in texmf.cnf then say something like "pool_size = 500000" 3) "I can't find the format file `pdftex.fmt'!" or "I can't find the format file `pdflatex.fmt'!" Format is not created (see above how to do that) or is not properly placed. Make sure that TEXFORMATS in texmf.cnf contains path to pdftex.fmt or pdflatex.fmt. 4) pdftex cannot find: config file (pdftex.cfg), map files (*.map), encoding vectors (*.enc), virtual fonts, Type1 fonts, TrueType fonts or image files. Make sure that the required file exists and the correspoding variable in texmf.cnf contains path to the file. See above which variables pdftex needs apart from the ones TeX uses. Compiling pdftex: Step by step introduction to compiling pdfTeX is in file Install. Han The Thanh & Pavel Janík ml. &