Welcome! Please read this information.

NOTE: This package requires i-Installer v2 2.87.0 or later to install.

NOTE: This i-Package is maintained by me for personal use. Bug reports are welcome. However, e-mail (or otherwise) help requests will not be answered as of Jan 1, 2007. A bug is considered a bug if I can reproduce it on my system (if you send a bug report, include enough stuff for me to reproduce, or I wil not be able to spend time on it.

NOTE: When this i-Package mentions TeX Live 2006 it is in fact TeX Live 2007. TeX Live 2006 was never released but released as TeX Live 2007 instead.

This is Gerben Wierda's binary distribution of TeX  for Mac OS X which is a repackaged distribution of TeX Live  with all the programs and a subset of the TeX Live texmf tree and a small additional tree maintained by me (e.g with the GTAMacfonts stuff that is a way of using some Apple-supplied fonts with PDF-TeX)

TeX is a professional typesetting system. Please go to http://www.rna.nl/tex.html for more information.

For information on i-Installer.app packages, see the i-Installer.app Help function. Especially read about the risks of installing software from the net and how you can inspect the contents of your package.

The TeX package has three installation modes:
1. 	Basic (default)
2. 	Full
3.	Expert

Basic Installation Mode

If you are new at TeX and want a minimum download, choose this one. It gives you a comfortable install, everything you need to run pdfTeX (which is the preferred engine on Mac OS X) and a minimal download.

This choice will minimize interaction with you. Most of it (in some cases depending on the configuration of your computer) everything will install by itself, the only thing for you to do is that you may have to enter your password a couple of times. Maybe you get a question to enter your preferred paper size if the package is unable to find this out from your settings.

Full Installation Mode

TeX is a large software distribution. To use it, the basic installation mode is enough. But if you want access to the documentation, you need the full install. The interactivity is the same as with the Basic Installation Mode. A Full Install also installs binaries for both Mac hardware architectures: Intel and PowerPC.

Expert Installation Mode

This install will give you total control over what parts of the distribution will be installed. It is for experts. Note that this will also give you finegrained control over configuration.

If you only run configuration (and not install & configure) you will always get expert configuration with all the user choices.

The rest of this Readme is for people who know what TeX is and how it works. If you are new, just forget about it, and go ahead and install. Information about what TeX is, how it works, etc. can be found on the web and this installer wll not try to explain it to you. Go to http://www.rna.nl/tex.html for information.

Simple mode will install a basic TeX, consisting of TeX Programs and a TeX Foundation. Configuration enables the following TeX formats: tex, etex, pdftex, pdfetex, latex, pdflatex, cont-en, mf, mpost, metafun, omega, lambda. It enables the following hyphenation patterns: american, german, ngerman, french, italian, spanish, dutch. These choices will enable you to typeset most TeX documents out there.

For paper size, the configuration phase tries to find out if you have set a generic paper size in the Print&Fax panel of System Preferences. This only works on Mac OS X 10.3 or higher. If the configuration phase cannot discover your personal setting, it will offer you a choice of a4 or letter.

The use of TeX from the command line will also be activated.

Table of Contents
On installing TeX using i-Installer v2 Expert Install (you are here)
On Configuration
On the contents
	On the sizes of the sets you can choose to install
	On the Latin Modern fonts
On possible problems while installing
On the layout of my TeX distribtion (foundation) (important when you want to add files yourself):

On installing TeX using i-Installer v2 Expert Install

You will be presented with a choice of software sets to install. You can choose for which hardware architecture you want to install TeX (intel, powerpc or both, the one for your local architecture should always be installed), if you want developer extras (the kpathsea library and include files, these can be used by programmers to get TeX path searching in their own programs), the main texmf tree (should always be installed), the gwTeX additions and the documentation of the main texmf tree or the gwTeX additions.

On configuration, you will be presented with choices in formats, languages, etc. These make sense if you know TeX. Note, if you run the configuration phase separately, you will always get expert mode.
• 	Recommended: install the Ghostscript 8 i-Package if you want dvips support
•	Optionally: Install the Freetype2, libwmf and ImageMagick i-Packages if you want full support for TeX4ht TeX->HTML conversion as well as behind-the-scenes graphics file conversion in your TeX jobs using the 'convert' tool from ImageMagick.

On Configuration

Configuration in Expert mode or when running the configure stage separately offers you a choice to configure either system-wide settings or settings for an individual user (if the TeX version installed supports it: TL2005 or later)). Any configuration done for an individual user will take precedence for that user above the system-wide settings. Therefore, if you create system-wide configuration settings they will only apply for a user if that user does not have an individual setting. If you configure the system-wide settings you will therefore be given the option to remove individual user settings. If an individual has private settings and thus private compiled formats, an update of the TeX programs may render them unusable. In most cases it is best to stick to one system-wide setup. A setup with both system-wide and per-user settings can be very difficult to maintain and use.

Configuration will install a new standard texmf.cnf TeX configuration file in your install location if detects that your file differs from the standard. If you have not edited this file, you can safely ignore this. If you have changed it, you are assumed to know what you are doing and can find your original file with a timestamp attached in the install location so you can edit the new file with your modiications (if still needed). Most users will never modify this file. I might modify this file if needed because of changes in TeX. Note that this may even happen on a fresh install, as the archive in the package is from TeX Live and my configuration may come with updated files that are installed during configuration and are newer than what is in the TeX Live/teTeX versions that I use.

Expert Configuration may ask you to decide on the following (at the start of configuration you may choose what configuration actions you want to perform):
Formats: 		Choose which formats you want to use. If in doubt. choose the default set. You will get the default list again. Then choose Cancel or Set to keep that setting. Your previous fmtutil.cf file will be saved on your Desktop if you want to. NB: All the ConTeXt formats are removed from the fmtutil setup as fmtutil and ConTeXt have a naming conflict.
Languages:		Choose which languages you want to use. If in doubt. choose the default set (Choose Reset and then Cancel). 
		This setting  only influences the formats that use the language.dat file. These formats are displayed in the sheet that informs you of your choices.
Paper Size:		Choose your favourite size. A4 is the default for new installs if you do not choose this configuration action.
Create Formats:	Choose Yes. If you select no, changes (like languages) may not be activated. ConTeXt formats are created by the texexec command, others are created with the fmtutil command.
		The texexec-generated formats cont-en, cont-nl and mptopdf
Mac Fonts:		This create TTF files from certain Mac fonts which are supported by the GTAMacfonts package (PDF-TeX only) and installs OTF versions of TeX fonts in /Library/Fonts for GUI app use.
TeX Owner Selection:	Choose the owner. If in doubt, choose root (default). Note, any action you do is performed as root (System Administration) because this is a package that runs under authentication. This means that ownership will be re-set every time you perform something that changes the installation.
Update Font Mappings:	Enable or disable maps. The updmap program will be run only if you enable or disable a map. Choose cancel if in doubt. Choosing Select will force a recompilation of your mapping even if nothing has changed.
CLI Use:		Choose Yes if you want to run TeX from the command line.

Apart from these selectable items, several configuration steps are executed independent from the choices you make. Amongst those:
	• Updating the index when files have been added (takes time)
	• Offering to (re)install the Latin Modern fonts for GUI use
	• Repairing ownership to install location owner when files have been installed

On the contents

This package is a distribution of the 'make install' part of TeX Live and a subset of TeX Live's texmf-dist and texmf trees, to which I have added several packages and other files in a separate gwTeX tree. You can inspect the ChangeLog files in the package contents view to see what has changed between releases in gwTeX. To find out what is in the subset, try to use it and if it does not work it is not there ;-)

On the sizes of the sets you can choose to install

The Download sizes are approximately:
				TL2006
TeX Live Programs powerpc		6.5 MB
TeX Live Programs intel		10 MB
TeX Live Foundation (subset)	49.5 MB
gwTeX Foundation additions		0.6 MB
Basic Install Total		67 MB

TeX Live Developer support (universal)	0.2 MB
TeX Live Documentation		101 MB
gwTeX Documentation		4.9 MB
Grand total			173 MB

*) Figures given are for both PowerPC and Intel hardware. If you install a full package, you get both. The extra's are universal (PowerPC and Intel) anyway.

So, the total size of the i-Package when fully downloaded is approximately 200MB. The minimum to download for install is 34.5 MB (for TeX Live 2003 without gwTeX) or 47.5 MB (for TeX Live 2004 without gwTeX), which gives you a basic TeX. The big space saver is the documentation, which is why it is not installed by default. Simple Install installs what is in one of the Basic Installs in the table above. Note: sizes above are compressed size so they are indications for download only. Decompressed, TeX takes up:

The installed sizes are approximately:
				TL2006
TeX Live Programs powerpc		20 MB
TeX Live Programs intel		28 MB
TeX Live Foundation (subset)	188 MB
gwTeX Foundation additions		3 MB
Basic Install Total		239 MB

TeX Live Developer support (universal)	1 MB
TeX Live Documentation		161 MB
gwTeX Documentation		5 MB
Grand total			167 MB

Which is a minimum, as there is also room required for the compiled formats.

On using Mac fonts with pdfTeX (LaTeX and ConTeXt)

The gwTeX part of this distribution contains all the setup files you need to use a couple of fonts from your Mac. The setup has been created by Thomas A. Schmitz (he did the main work) and Adam Lindsay, hence the naming: gtamacfonts.

To use these fonts with LaTeX, put e.g. the following in your file:

	\usepackage[T1]{fontenc}
	\usepackage{gtamachoefler}

Such a style file will make Hoefler Text the serif (roman) text font and Gill Sans the sans serif font. The following basic styles are available:
	gtamacbaskerville.sty
	gtamacdidot.sty
	gtamacgeorgia.sty
	gtamachoefler.sty

There are  more. See the manual for details. For the same effect using ConTeXt, enter e.g.:

	\usetypescriptfile[type-gtamacfonts]
	\usetypescript[Hoefler][ec]
	\setupbodyfont[Hoefler,12pt]

Example documents and a manual can be found in the texmf.gwtex/doc/fonts/gtamacfonts subdirectory. To get the manual you can type "texdoc gtamacfonts" in a Terminal window.

Note: The TeX i-Package configuration phase will only perform the necessary step of unpacking the Mac fonts into the TeX tree if it finds the fondu program in /usr/local/bin. It will also produce AFM files if /usr/local/bin/fontforge is available, this is useful for experts who want to mess around with their fonts.

On the Latin Modern fonts

Note: The Open Type versions of the Latin Modern fonts still produce problems in Mac OS X, especially where interline space is concerned. Nothing damaging, but ugly.

ConTeXt uses Latin Modern by default.

To use Latin Modern fonts in your LaTeX document, put this in the preamble:
	\usepackage[T1]{fontenc}
	\usepackage{lmodern}

The Latin Modern fonts inside TeX come in various formats, amongst which Open Type, which can be used directly by Mac OS X GUI applications. On install, these fonts are copied to the directory "/Library/Fonts/Latin Modern" and from there you can copy them to any machine you like, you do not need TeX on those machines. Latin Modern is in the public domain.

Note: You need to log out and log in before all applications are aware of the newly converted fonts. When configuring in Expert mode, you wiill be given the opportunity to do a reinstall of the fonts even if they already exist, otherwise, the creation phase will be skipped.

On possible problems while installing

Go to http://www.rna.nl/tex.html for some tips and tricks. Problems on clean systems (out of the box) have not been reported yet, except when people have decided to remove the BSD subset from the standard installation. Conflicts between this distribution and others are possible, though during installation and configuration the TeX i-Package protects the current actions as much as possible against these.

On the layout of my TeX distribtion (foundation) (important when you want to add files yourself):

I use five (six) trees where files are stored:
	1. The first is /usr/local/gwTeX/texmf; this is where program-related stuff is stored and it is upgraded when the TeX programs are updated. This tree is created by "make install" of TeX Live.
	2. The second is /usr/local/gwTeX/texmf.texlive; this is a subset of the TeX Live Master/texmf-dist tree with a few items that are kept in Master/texmf in TeX Live.
	3. The third tree is in /usr/local/gwTeX/texmf.gwtex and contains Mac OS X specific settings and additional packages not in TeXLive's foundation distribution. This tree is maintained by me.
	4. The fourth tree is in /usr/local/gwTeX/texmf.pkgs and is for other i-Packages (e.g. the CM-Super or MusixTeX i-Package) or installers to write in. Here you can for instance install a new ConTeXt which hides the one in texmf.texlive but as it is in a separate tree, it can be removed restoring the previous situation. This tree fulfills partly the same role as texmf-local in TeX Live
	5. The fifth tree is in /usr/local/gwTeX/texmf.local and is for the local TeX administrator (normally, you) to store system-wide additional files. To store in that area, you need System Administrator rights. This tree is also used by the command line management tools (like updmap) to store results and as such fulfills the same role as texmf-var in TeX Live.
	6. In addition, individual users can store their own files in ~/Library/texmf.
When you reinstall the TeX i-Package, files in the first three trees are overwritten. The fourth is left alone. Files in /usr/local/gwTeX/texmf.local and in user's home directories are normally left left alone (the exception being setup files created there by automated setup programs, which would break an upgrade if they remained in place). See http://www.rna.nl/tex.html for more information on adding files.

On the TeXDist structure

The i-Package installs a structure in /Library/TeX called the TeXDist Structure. This structure is used to provide abstracted entry points to possible installed TeX Distributions (e.g. TeX Live, gwTeX, MacTeX) on your system. You can have multiple distributions concurrently on your system.

A command line tool "texdist" is provided to set the current system wide default TeX, to list the distributions in various ways or to make sure a command is run with a certain distribution. E.g.

	texdist --texdist=gwTeX "pdflatex foo"

will run "pdflatex foo" with the gwTeX distribution while

	texdist --texdist=TeXLive-2005 "pdflatex foo"

will do the same with the TeX Live 2005 distribution. See /Library/TeX/Distributions/TeXDist-description.rtf for a complete description if you are interested and see "texdist --usage" for an extended help from the tool itself.

The TeXDist structure has been created together with Jérôme Laurens (of iTeXMac fame) with the cooperation of Dick Koch (of TeXShop fame) and Bruno Voisin (of Mac OS X TeX mailing list fame). I would  like to stress that the best parts (imnsho) of the setup (both ideas and code) have been brought into this by Jérôme, who I'd like to thank for his efforts. Jérôme has also provided a PreferencePane that this i-Package installs during configuration (unless there is a newer version already available) and more.

After configuration, switching the system-wide default TeX is as easy as using the Preferences application and selecting the TeX Distributions Preference Pane. If frontends use /usr/texbin as their path to the TeX distribution binaries, they will use the current default.

TeX i-Package release notes

2007/05/18:
• Updated TeXDist stuff from Jérôme Laurens (real bug fix). Removed source .zip as it is out of date and no new one has been publicly released.
• Updated epstopdf with a windows-compatible version and simplified code. No functional differences.
2007/05/07:
• Updated simpdftex with support for dvipdfm and dvipdfmx with backward compatibility with simpdftex_dpmx. To use dvipdfm as DVI to PDF translator type (e.g.)
		simpdftex latex --mode dvipdfm foo.tex
  Type simpdftex --help for documentation.
• [technical] Removed 'optional' item from set descriptions in TOC as it is not used by i-Installer
• Updated TeXDist stuff from Jérôme Laurens (bug fix)
2007/03/17:
• Updated TeX Live texmf tree to one based on revision 4042 (with new beamer)
• Added fmtcount and datetime
2007/03/08:
• Applied temporary fix for beamer.
2007/02/11:
• Fixed default updmap.cfg (new copy form TL), the old one had qcs.map and mflogo.map missing.
2007/02/10:
• TL SVN revision 3967 with updated natbib (8.0)
2007/02/06:
• Removed fourier and utopia.sty from texmf.gwtex as it is available in texmg.texlive
2007/02/05:
• Remove some traces of the old teTeX which had been preserved to ease transition from TL+teTeX to a TL-subset.
• TeXLive SVN revision 3918 with pdfTeX 3.141592-1.40.3-2.2
• Better detection of pre and post TL2004 setups (foo vs foo-sys)
2007/02/02:
• TeX Live SVN revision 3860
2007/01/23:
• Changed Latin Modern map configuration
2007/01/23:
• Added europecv LaTeX class
2007/01/22:
• New RC TL2006 based on TL SVN revision 3680
2007/01/21:
• New RC TL2006 based on TL SVN revision 3653
• Added powerdot
2007/01/17:
• New RC TL2006 based on TL SVN revision 3544
• Added tl2007 texdist structure creation
2007/01/12:
• New RC TL2006 based on TL SVN revision 3344
2007/01/09:
• Fixed Latin Modern font install for GUI apps
2007/01/08:
• Improved fmtutil.cnf checking
• TL SVN revision 3244, binaries rebuilt
• pdfTeX 3.141592-1.40.1-2.2 (Web2C 7.5.6)
2007/01/07:
• Removed TeX Gyre (which was only partly available) from texmf.texlive. Is is available as a separate gwTex Support i-package.
• ConTeXt formats are ignored in fmtutil and created via texexec
• ps2eps version 1.61
2007/01/04:
• Home TeX activation only performed when selected during Expert configuration
• Fix for empty languages selection on simple (full/basic) install
2007/01/03:
• i-Package requires i-Installer 2.87
• Fixed bug in texdist which occurred when your current dist was not usable (e.g. dist with only x86 binaries installed used on a ppc machine).
• Fixed wrong powerpc entries in TeX Live .texdist structures
• MANPATH on 10.3 issues fixed
• Added Jérôme's Resources to the .texdist structures
2006/12/30:
• The powerpc binaries had files instead of symlinks (this is because `strip' in 10.3.9 is broken), this has been fixed.
• Added missing T1Wrap (powerpc)
2006/12/28:
• Added missing documentation check to subset build procedure.
• Includes pdfTeX 3.141592-1.40.0-rc4-2.2 (pdfTeX 1.40)
• TL SVN revision 2991
2006/12/27:
• Removed the use of the which program when checking for existing install
2006/12/25:
• Updated texmf trees with TL SVN revision 2901 and included all XeTeX stuff.
2006/12/23:
• Removed "sudo -H -u foo" from non-admin commands
2006/12/22:
• Improved Hoefler GTAMacfonts support (LaTeX \emph{\emph{}} bug)
• Fixed a small bug in the creation of the TeXDist structure
2006/12/21:
• Remove old style links in /Library (use TeXDist in /Library/TeX instead)
• Updated GTAMacfonts. The LaTeX sty files now include loading the map file. As a result, the gtamacfonts.map file does not need to be loaded TeX-wide and the configure phase makes sure the map file is disabled.
• Promoted XeLaTeX to a format that is always enabled.
• TeXDist finalized before release, Preference Pane and TeXDistTool.app by Jérôme Laurens added to i-Package. These are installed during configuration and only if they do not already exist or exist in an older version that the i-Package carries.
• Release into the wild. This version is a release candidate for the official 1/1/2007 release.
2006/12/18:
• Changed Latin Modern from conversion with FontForge to installing (copying) the official OTF's to "/Library/Fonts/Latin Modern". This is because some change  (OS X update? FontForge?) has stopped producing usable fonts via conversion.
2006/12/17:
• Added esvect
2006/12/14:
• TL2006REVISION=2712, binaries and trees rebuilt
• New TeX Dist setup.
2006/12/10:
• Added texdist command (symlinked in /usr/local/bin). See "texdist --usage".
2006/12/10:
• TL2006REVISION=2656# 2006/12/09 20:00
• Binaries not rebuilt, texmf trees rebuilt
• Fixed missing pdftex.def (latex/pdftex-def subdirectory added) 
• GIven lack of time and sleep: uploaded untested
2006/12/09:
• Release without the /Library/TeX (re)creation until the design has been fixed.
2006/12/08:
• EXPERIMENTAL
• Adapted /Library/TeX (re)creation. No more /Library/TeX/Documentation link until the problem has been resolved.
• TeXDist-description.rtf added to configure phase dependencies.
• Fixed error in setloginpath, older PATHs are now identified and removed correctly
2006/12/07:
• EXPERIMENTAL
• TL2006REVISION=2572# 2006/12/01 22:00
• Missing tex4ht support files added to the main texmf tree (texmf.texlive)
• Added doc/latex/{graphics,base} to the main texmf tree (texmf.texlive)
• Support for /Library/TeX/Distributions setup. From now on using /usr/texbin for your path to the TeX binaries is stable. The same is true for /Library/TeX/Distrbutions/Default/Man for man pages, /Library/TeX/Documentation for all the documentation in your texmf.trees. Switching between different TeX distribution is easy: only the /Library/TeX/Distributions/Default needs to be set to an existing .texdist bundle which contains information on the TeX distribution and where it resides. See /Library/TeX/TeXDist-description.rtf for details.
• i-Package contains new setloginpath and setmanpath scripts with a new interface.
• Fixed a buglet where changed languages did not force a recompile of formats
2006/11/29:
• Changed default install location to /usr/local/gwTeX. Automatic migration is performed if possible.
2006/11/22:
• TeX Live Adobe fonts were completed, they have been removed from texmf.gwtex again.
2006/11/21:
• Added xelatex link to ppc bin tree
2006/11/21:
• Added utopia back to texmf.gwtex
2006/11/20:
• Added missing support files for XeTeX
2006/11/18:
• Added PPC XeTeX directly from binaries in TeX Live.
• Binaries based on SVN Revision 2448 (2006/11/17 11:00), texlive.tetex recreated
2006/11/07:
• Repaired broken installation of new language.dat during language selction in configure.phase 
2006/11/03:
• Re-added foiltex and fourier to texmf.gwtex as they were in the TeX i-Package
2006/11/02:
• Added some more missing maps and documentation (based on feedback from users)
2006/10/31:
• Added cm, latex-fonts and rsfs maps
2006/10/30:
• Added mktex.cnf
• Added some more stuff from TL, esp. XeTeX support.
2006/10/30:
• Solved issue of missing ls-R databases and checking of availability of stuff when not strictly necessary
2006/10/29:
• Extended environment checking (e.g. protect against junk like TEXMF variables in ~/.MacOSX/environment.plist)
• Extended checking of TeX install at start of configuration: check for availability of the kpsewhich program and of language.dat
• Really stop converting LM fonts when lmr10.pfb is not found. This does not solve the underlying issue why lmr10.pfb is not found on some user's systems
2006/10/28:
• Set PATH earlier in scripts.
2006/10/27:
• Added TL Master/texmf/dvips (which contains config.ps) to texmf.texlive.
2006/10/27:
• Initial experimental release.
• Based on TeX Live revision 2372 (2006/10/25 21:00)
• XeTeX is included but currently not available on ppc, only on intel