<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<html><head>
<!-- $Id: index.html,v 1.23 2006/05/28 20:48:08 karl Exp $ -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Yosemite - MacTeX - TeX Users Group</title>
<link rel="stylesheet" href="./tugstylemactex.css">
</head>
<body>
<!--#include virtual="./style.html"-->

<img alt='mactexlion logo OX5' border='0' src='./images/mactexlogoX5.png'>
<h2 align="center">** TeX on Yosemite **</h2>
<hr>
<!--#include virtual="./navigation.html"-->

<br><br>



<br>  
<br>
<a name='multiple'></a>
<h3>Yosemite</h3>

This is a summary of reports about TeX on Yosemite.  The summary will be
maintained over the next month by Herbert Schulz and Richard Koch. TeX basically works, but there are minor problems with some programs.

<h3>What Works</h3>

The MacTeX and BasicTeX install packages work fine on Yosemite, and standard
command line programs in TeX Live work correctly. Front ends like TeXShop, TeXWorks, and  others work fine.

<h3>Ghostscript</h3>

We have reports that TeX + DVI mode in TeXShop fails because links in the Ghostscript
installation are removed. 
The solution is to go to http://pages.uoregon.edu/koch and download and install the 
Ghostscript 9.15 package. This is the latest version of Ghostscript, released a couple of weeks ago, and it fixes bugs in the earlier version that impacted TeX. (Warning: the package may
not be signed, so you'll have to hold down the control key to run it; I'll fix that 
when things calm down next week.)

<h3>X Windows and Quartz</h3>

Some folks use xdvi to display TeX Output on X Windows. There are reports that links
in X Windows are removed and the X11 display fails. The solution is to reinstall Quartz.
To do so, go to http://xquartz.macosforge.org. 

<h3>Installing Yosemite</h3>

We have two reports from users who updated from Mavericks to Yosemite rather than installing Yosemite on a fresh disk partition. Both users report that when the installation was almost complete, there was a long delay with no feedback: one hour in one case and twelve hours in another. During this  delay, the installer's log file reported that it was copying TeX Live files one by one from "/Volumes/Hard Disk/Recovered Items/usr/local/texlive" to "/Volumes/Hard Disk/usr/local/texlive".

<p> (Report by Koch) I did not run into this problem with the developer version of Yosemite, but I installed on a fresh partition and then used MacTeX to install TeX. When Yosemite was released on October 16, I installed again on Apple's 2012 Macbook Pro with Retina Display, this
time updating a copy of Mountain Lion to Yosemite. This portable has a solid state drive.
Sure enough, there was a long delay when the installer stated "About 2 minutes remaining," with the predicted messages in the log file. This machine had TeX Live 2013, TeX Live 2014, and Basic TeX 2014 installed. 

<p>In my case, the full installation of Yosemite took one hour and 56 minutes. Initially the
installer reported that installation would require 18 minutes. It later updated this to 55 minutes, but by the 18 minute mark it was predicting completion in another 2 minutes. At that
point there was a long delay, and the predicted 18 minute install took 1 hour and 50 minutes.
After that the machine rebooted twice, and then a second installation began. The computer reported that this installation would take 7 additional minutes, but the final stage only took 6 minutes.

<p> The earlier user and I let the installation proceed to completion and ran into no problems. But canceling the installation could produce an unworkable TeX Live.

<h3>Avoiding the Problem</h3>

Ross Moore sent an extremely useful method of avoiding the problem. He writes

<p> "A colleague tells me that the way to update to Yosemite, with
one or more TeX installations installed, is to first
<dd>
<dl> mv /usr/local/texlive ~
<dl> do the install, then 
<dl> mv ~/texlive /usr/local
</dd>

<p> "This avoids the installer archiving then re-installing that
hierarchy *file-by-file*. This kind of approach may be useful with other subdirectories
of  /usr/local  as well."

This solution moves the texlive directory to the User's home directory, installs Yosemite,
and then moves the texlive directory back to its proper location. In more detail, the
appropriate commands are as follows (spaces in these commands are essential, so copying
the commands may work better than retyping them):
<dd>
<dl> sudo  mv  /usr/local/texlive  ~ 
<dl> install Yosemite
<dl> sudo  mv  ~/texlive  /usr/local
</dd>


<h3>The TeX Dist Preference Pane</h3>

<p>MacTeX does not remove old distributions when installing a new version of TeX Live. Instead it installs a TeX Dist Preference Pane for Apple's System Preferences. This pane lists all TeX distributions and allows the user to activate one of them with a single click. This click automatically reconfigures all TeX GUI programs and  also command line use of TeX by a shell. If a user runs into problems with a new distribution, they can easily retreat to the previous year's distribution.

<p>Currently the TeX Dist Pane does not work in Yosemite. The author has been notified and is working on a fix.

<p> If you don't use the Preference Pane, then this won't be a problem.
When a new distribution is installed, the install package automatically makes that distribution active. So if you install MacTeX from scratch, then the TeX Live portion of that package will be selected automatically.

<p>If you need to switch distributions, it is possible to do the job using the command line.  The location /Library/TeX/Distributions contains
a hidden folder named .DefaultTeX and various visible folders with information on TeX Distributions: TeXLive-2014.texdist, TeXLive-2014-Basic.texdist, TeXLive-2013.texdist, etc.
The hidden folder and each texdist folder contains a folder named Contents;
these folders are actually all symbolic links.
To activate, say,  TeXLive-2014, the Contents link in .DefaultTeX is set to
<dd>
<dl> Contents --> ../TeXLive-2014.texdist/Contents
</dd>
Changing this one link is the only thing necessary to activate a new
distribution.

<p> For instance, the following commands in Terminal would activate TeXLive-2013:
<dd>
<dl> cd /Library/TeX/Distributions/.DefaultTeX
<dl> sudo rm Contents
<dl> sudo ln -s ../TeXLive-2013.texdist/Contents Contents
</dd>

<h3>An Alternate Preference Pane</h3>

An alternate Preference Pane which works on Yosemite is available from
<dd>
<dl>      http://pages.uoregon.edu/koch/LocalTeX.zip
</dd>
This Preference Pane does not alter any data created by the original Pref Pane, and can be used along with it, or independently of it. The new
pane has certain advantages: it can  switch to distributions on external disks or distributions installed in a user's home directory.
The disadvantage is that the link to active binaries is in
~/Library/TeX/LocalTeX/texbin rather than /usr/texbin, so applications must be reconfigured.
On the other hand, this location is safe from Apple interference, while
Apple sometimes removes /usr/texbin during upgrades.

<p> The zip file provides the new Pane, complete instructions about installation and use, and the complete source code. The new Pane only works on Mavericks, Yosemite,
and higher.

<h3>TeX Live Utility</h3>
MacTeX installs TeX Live Utility in /Applications/TeX; it is an application by Adam Maxwell with an OS X interface to upgrade and customize TeX Live. This utility can update TeX Live in Yosemite,
but it runs into trouble when reconfiguring TeX using the script 
updmap-sys. Adam Maxwell is well aware of this problem and has been
in correspondence with Apple about it. 

The TeX Live Utility log file reports the bug as follows:
<dd>
<dl> /usr/texbin/updmap-sys: line 30: exec: updmap: not found
</dd>

<p>
Adam Maxwell recommends avoiding the use of TeX Live Utility until he can find a workaround for
this Apple Bug. If you really, really need to update TeX, use the command line tlmgr which is built into TeX Live.


<h3>CocoAspell</h3>

CocoAspell runs fine on Yosemite, but the installer runs into trouble
installing dictionaries on a fresh copy of Yosemite, and the Spelling
Pref Pane installed by CocoAspell does not initially run. The author has been notified of the trouble.

<p>
In the release version of Yosemite, it is possible to resurrect cocoAspell
as follows. From an installation of CocoAspell on Mavericks, go to
/usr/local/lib and find a folder named aspell-0.60 and several libraries whose names start with libaspell or libpsell. Copy this folder and these libraries to Yosemite, and move them into /usr/local/lib, creating this folder if necessary. Using sudo, change the owner of the files to root.

<p>
Again on Mavericks, go to "/Library/Application Support" and find the
folder named cocoAspell. Copy this folder to Yosemite and place it in "/Library/Application Support" there.

<p>
After these steps, the cocoAspell Preference Pane will run and the spell checker can be used as usual.

 
</body>
</html>