%!TEX TS-program = xelatex 
%!TEX encoding = UTF-8 Unicode samples, and choose one of the font names 


\documentclass[12pt, oneside]{amsart}
\usepackage{geometry}                % See geometry.pdf to learn the layout options. There are lots.
\geometry{letterpaper}                   % ... or a4paper or a5paper or ... 
%\geometry{landscape}                % Activate for for rotated page geometry
\usepackage[parfill]{parskip}    % Activate to begin paragraphs with an empty line rather than an indent
\usepackage{graphicx}
\usepackage{amssymb}
\usepackage{epstopdf}
\DeclareGraphicsRule{.tif}{png}{.png}{`convert #1 `dirname #1`/`basename #1 .tif`.png}
\usepackage[colorlinks=true, pdfstartview=FitV, linkcolor=blue, 
            citecolor=blue, urlcolor=blue]{hyperref}
            
\usepackage{fontspec,xltxtra,xunicode} 
\defaultfontfeatures{Mapping=tex-text} 
%\setromanfont{Hoefler Text} 
%\setromanfont{Optima}
\setromanfont{Baskerville} 
\setsansfont[Scale=MatchLowercase] {Gill Sans} 
\setmonofont[Scale=MatchLowercase] {Andale Mono} 

            
\title{What Is Installed}
%\author{The Author}
%\date{}                                           % Activate to display a given date or no date

\begin{document}
%\twocolumn[\maketitle]
 \maketitle
%\section{}
%\subsection{}


\section {The Package}


The Mac\TeX{}-2013 install package contains six subpackages: 
\begin{itemize}
\item TeXLive-2013
 \item GUI-Applications 
 \item Ghostscript-9.07
  \item ImageMagick-Convert-6.8.3
   \item Latin-Modern-Fonts 
    \item TeX-Gyre-Fonts
\end {itemize}
 In the default installation, all except the two font packages are installed. Use the ``Custom Install'' option to select which packages to install.


\section{\TeX{} Live}

The most important package is TeXLive-2013, which installs the full \TeX{} Live 2013 distribution in \path{/usr/local/texlive/2013}. \TeX{} Live is the reference \TeX\ distribution produced by \TeX\ user groups across the world; it runs on almost all computer architectures including OS X, Windows, GNU/Linux, and other Unix systems. The distribution is the same on all of these platforms; nothing has been added or removed to customize it for OS X.

You can find a complete list of files and install locations by double clicking on the Mac\TeX{}-2013 package and then choosing the menu item ``Show Files''. The important fact is that everything in \TeX{} Live is put in the ``2013'' folder.

When you want to add files to \TeX{} Live which are visible for all users on your machine, the files should be installed in \path{/usr/local/texlive/texmf-local}. This tree is not inside the 2013 folder so it can be used with future versions of \TeX{} Live as well. If the texmf-local directory exists when Mac\TeX{}-2013 is installed, then it is not touched by the installer. But if there is no such tree, then Mac\TeX{}-2013 installs an empty tree waiting to be used. This is exactly what would happen if you installed \TeX{} Live using its native install script.

Incidentally, if you want to add files to \TeX{} Live for one particular user, install them in a similar tree 
 \path{~/Library/texmf} where \path{~/Library} is the Library folder in that user's home directory. The folder \path{texmf} and other folders for the tree will have to be created. For instance, \TeX\ will find any file in \path{~/Library/texmf/tex} or a subfolder of this location, \LaTeX\ will find any file in
 \path{~/Library/texmf/tex/latex} or a subfolder of this location, and Bib\TeX\ will find any .bib file in \path{~/Library/texmf/bibtex/bib} or a subfolder of this location, and any .bst file in \path{~/Library/texmf/bibtex/bst} or a subfolder of this location. It is not necessary to use texhash when adding files to this local tree.
 
 In Apple's new operating system Lion, the \path{~/Library} folder is present but not visible in the Finder. Use the ``Go To Folder'' command in the Go menu to show this Folder. 

In addition, Mac\TeX{} installs a few items customized for OS X and not available from the \TeX{} Live install script. These items are not in the  \path{2013} folder or the \path{texmf-local} folder; they are support items which can be used or ignored. The support items make it possible to add GUI front ends and utilities to \TeX\ without any configuration whatever; these applications are automatically configured for your current \TeX\ distribution. The support items also allow you to have more than one \TeX\ distribution on your machine and trivially switch between them. For example, if you already installed \TeX{} Live 2012 last year, that distribution remains after you install \TeX{} Live 2013; if you are in the middle of an important project and find that something in \TeX{} Live 2013 doesn't work correctly, you can switch back to \TeX{} Live 2012 with a single button push.

All of this is made possible by the \TeX\ Distribution Data Structure designed by J\'{e}r\^{o}me Laurens and Gerben Wierda. The structure contains a small folder of symbolic links for each \TeX\ distribution installed on your machine. The structure is in  \path{/Library/TeX} and contains four subfolders: \path{.scripts}, \path{Documentation}, \path{Distributions}, and \path{Root}. The data structure is very small, only about 332 KB.

A user can ignore \path{/Library/TeX} entirely because the data is controlled from a ``\TeX\ Distribution'' preference pane installed in \path{/Library/PreferencePanes}. To use it, open Apple's System Preferences and find the \TeX\ Distribution pane at the bottom. Open it to see a list of \TeX\ distributions installed on your machine. The active distribution will be indicated by a radio button. Push a different button to change distributions; automatically all of your GUI front ends and utilities will reference the new distribution, and PATH and MANPATH will point to the new distribution in Terminal.

Currently everything in the folder \path{TeX} inside \path{/Library} was installed by Mac\TeX{}, but in the future developers may install other things in this location. It isn't necessary to discuss the full contents of \path{TeX}, but two items will be of interest.

\path{Root} is just a symbolic link to the active distribution, and so in our case to \path{/usr/local/texlive/2013}. It is visible in the Finder, so to inspect \TeX{} Live 2013 without using tricks, click on \path{Root} and navigate to any portion of the \TeX{} Live 2013 tree you'd like to study.

The \path{Distributions} folder contains one ``.texdist'' folder for each distribution on your machine. Four such folders are installed by Mac\TeX:
\begin{itemize}
\item  \path{Fink-teTeX}
\item  \path{MacPorts-teTeX}
\item \path{MacPorts-TeXLive}
\item \path{TeXLive-2013}
\end{itemize}
but you may have others if you installed earlier distributions like gw\TeX\ or \TeX\ Live-2012. The Fink and MacPorts structures are provided because these distributions do not install such structures themselves. Note that ``.texdist'' folders may exist for distributions you don't have; this causes no trouble because the \TeX\ Distribution preference pane is intelligent and checks to make sure the .texdist folder points to active data. So if you later remove \TeX{} Live 2013, it is not necessary to modify \path{/Library/TeX}.

Our package also installs two symbolic links: \path{/usr/texbin} is a link pointing to the executables directory of the active distribution, and \path{/usr/local/bin/texdist} is a symbolic link to a script in \path{/Library/TeX} which can manipulate the \TeX\ Distribution Data Structure. Most GUI front ends and utilities use \path{/usr/texbin} as the location of the \TeX\ executables, although this can be changed in their preferences. For that reason, such applications require no configuration for new \TeX\ distributions.

Finally, our package modifies your PATH and MANPATH so command line utilities also work automatically with the active distribution. This modification is particularly straightforward if you are running a new installation of Leopard or higher. On these systems, the directory \path{/etc/paths.d} contains a file for each addition of a new location to the default PATH on the system. As shipped by Apple, this folder has only one file: \path{X11}. Our install package adds a second file, \path{TeX}, which contains the single line \path{/usr/texbin}. Similarly the directory \path{/etc/manpaths.d} contains a file for each addition of a new location to the default MANPATH. As shipped by Apple, it contains only one file: \path{X11}. We add a second file: \path{TeX}.

If you upgraded Leopard from an older system and you modified \path{/etc/csh.login} or \path{/etc/profile}, we modify \path{/etc/profile}, \path{/etc/csh.login}, and either \path{/etc/manpath.config} or \path{/usr/share/misc/man.conf}. We use exactly the modification introduced by Gerben Wierda in his distributions of te\TeX\ and \TeX{} Live; indeed we use his scripts to make the modification. Gerben's modifications are enclosed in easily visible comments, so they can be directly inspected and removed if desired.

On Snow Leopard and higher, the man command uses heuristics starting with PATH to find man pages. This technique works for TeX Live 2013 because the TeX Live 2013 bin directory contains a link named ``man'' which points to the related TeX Live man pages. 




\section{Latin Modern Fonts and TeX Gyre Fonts}

As you probably know, \TeX\ fonts are separate from standard system fonts and reside inside the \TeX{} Live tree. \TeX\ and \LaTeX\ use these \TeX\ fonts rather than ordinary system fonts. The program \XeTeX\ is an exception and can use any ordinary system font. 

\TeX{} Live contains a vast array of fonts. See \url{http://tug.org/fonts} to begin exploring the possibilities. The most commonly used are the Computer Modern Fonts of Donald Knuth, and extended versions of these called the Latin Modern Fonts which add European accented characters and additional characters to Knuth's classics. The \TeX\ Gyre Fonts give \TeX\ versions of standard Adobe Fonts.

One difficulty is that Macintosh programs like Adobe Illustrator do not have access to the \TeX\ fonts. Mac\TeX{} has a custom installation mode which installs the Latin Modern and TeX Gyre Fonts in system font libraries, so these fonts can also be used in Adobe Illustrator and other standard programs.

The two packages are not installed by default; ``custom install'' must be used to obtain them. The first package installs a folder named \path{Latin Modern} to \path{/Library/Fonts}; this folder contains 72 fonts. The second package installs a folder named \path{TeX Gyre} to \path{/Library/Fonts}; this folder contains 33 fonts. To uninstall, simply drag the two folders out of \path{/Library/Fonts}, assuming you have proper permission.


\section{GUI Applications}

This package installs BibDesk, LaTeXiT, TeXShop, TeXworks, TeX Live Utility, FixMacTeX2013, and Excalibur in \path{/Applications/TeX}. Note that many other editors, front ends, and utilities are available for \TeX\ on the Internet; you may want to experiment with a variety of such programs. The package also installs one  README file and the ``What Is Installed'' document which you are currently reading.
All of these items can be removed by dragging them to the trash.

%The package installs Gerben Wierda's i-Installer to \path{/Applications/Utilities}. This utility can install several independent packages over the internet which are useful in conjunction with \TeX, including a full version of ImageMagick, FontForge, a \LaTeX\ to RTF Converter,  XFig, and various other utilities. Wierda's program is not used to maintain \TeX{} Live.
%
TeXShop and TeXworks is front ends for TeX. Each contains an editor and previewer for TeX. If you are new to TeX, you can begin learning it by running TeXShop or TeXworks and following the instructions in the README file in \path{/Applications/TeX}. Experienced users may want to switch to their own favorite editor.


TeX Live Utility is a program which can update TeX Live 2013 packages over the network, and can configure paper size in TeX. The program is self explanatory. When it starts, TeX Live Utility lists packages in TeX Live 2013 for which updates are available. Select the ``Update All Packages'' item in the Actions menu to update these packages. TeX Live Utility calls a command line utility named tlmgr in TeX Live 2013 to perform the updates; it is possible to directly run tlmgr in Terminal.

FixMacTeX2013 is a small install package which can fix problems which occasionally occur when a system containing MacTeX is upgraded to a later
version of the operating system.

\section{Ghostscript 9.07}

The Macintosh comes with a distiller which converts postscript to pdf: \path{/usr/bin/pstopdf}. For this reason, it is not essential to install Ghostscript when installing \TeX. However some \TeX\ style files assume the existence of Ghostscript and many people prefer to distill using it. Any Ghostscript installation will do, and some users have the Fink or MacPorts distributions, or the distribution from i-Installer, which all work well with \TeX. For others we provide the latest version of Ghostscript in this package.

You can find a complete list of files installed by double clicking on the Mac\TeX{}-2013 package and then choosing the menu item ``Show Files''. 

Ghostscript executables are placed in \path{/usr/local/bin}, support files are placed in \path{/usr/local/share/ghostscript/9.07}, man pages are in \path{/usr/local/share/man}, and fonts are installed in \path{/usr/local/share/ghostscript/fonts}. Most Ghostscript executables are just shell scripts. There are only two binaries containing code, gs-X11 and gs-noX11; the first is compiled with X11 support and the second without X11 support. The symbolic link gs points to one of the two versions depending on whether the installer found X11 on your system at install time. Both are universal binaries with code for both Intel and PPC.


\section{Convert from ImageMagick 6.8.3}

ImageMagick is a program used to process image files; it comes with a large number of support utilities.
The ``convert'' utility in ImageMagick is used by a small number of programs in \TeX{} Live to convert between graphic formats.  In particular, the \TeX 4ht package in \TeX{} Live typesets a \TeX\ source file to an HTML file for the web, and requires ``convert''.  Also, ``convert'' is useful in other contexts; it understands pdf, ps, png, jpeg, tiff, and many other formats. For example, to convert a tiff file to png, issue the command
\begin{verbatim}
     convert myfile.tiff myfile.png
\end{verbatim}

The full ImageMagick can be obtained in several ways: via Fink, MacPorts, or i-Installer. We provide a very small package which contains only ``convert'', compiled with static libraries so no unexpected libraries are installed on the system. (Indeed, nothing in Mac\TeX{}-2013 installs library files on the system).  The package installs ``convert'' in \path{/usr/local/bin}, thirteen xml  files in \path{/usr/local/etc/ImageMagick}, one configuration xml file in \path{/usr/local/lib/ImageMagick-6.8.3/config}, and one man page in \path{/usr/local/share/man/man1}.

\end{document}
  