TWG | MacTeX | Donate | FAQ | Fonts | Help | References | Support | Acknowledgments | TUG
If users installed other programs in /Applications/TeX, they will remain, of course. Old documents installed in /Applications/TeX by MacTeX will be removed because they now live in the Docs and Spell Utilities folder. But the Excalibur spell checker is a special case. It used to live in /Applications/TeX/Excalibur, but is now installed in Docs and Spell Utilities. Some users installed extra dictionaries in the old /Applications/TeX/Excalibur. If such dictionaries are found, then the old folder will also remain and users can leave it alone or merge it into the new folder as desired.
The four GUI programs we install are TeX Live Utility, a program to update and maintain TeX Live, BibDesk, a program to create reference databases, LaTeXiT, a program to create mathematical formulas to be dragged into applications like KeyNote and Pages, and TeXShop, a front end to TeX and LaTeX. New users should open the folder Docs and Spell Utilities and read the short document READ ME FIRST. This document explains how to create and typeset a short document using TeXShop, and then lists many ways to learn more about TeX and begin serious work.
Many front ends are available on the Macintosh for TeX. Some are commercial and some are free. A number of free alternatives are available in the MacTextras portion of MacTeX.
Because some countries have legal restrictions on encryption software, gpg is not provided by TeX Live. Tlmgr will operate without security enhancements if gpg is absent.
Most Macintosh users don't directly access tlmgr, but instead use it indirectly through TeX Live Utility, which is installed in /Applications/TeX. TeX Live Utility has been upgraded to support the new tlmgr. When it first runs after TeX Live 2018 is installed, it displays a dialog titled ``Enable security validation of packages.". If the user clicks "Enable," gpg is downloaded from a third party site and installed inside TeX Live.
In 2017, the functionality of the Preference Pane was moved to TeX Live Utility and the Preference Pane is no longer provided. To see a list of TeX distributions on your machine, run TeX Live Utility and select the item "Change Default TeX Live Version" from the Configure menu. A list of distributions will appear. Select the distribution you want to activate.
MacTeX does not remove old Preference Panes. To remove the pane, go to /Library/PreferencePanes and move TeXDistPrefPane.prefPane to the trash.
Many users know that /Library/TeX/texbin is a symbolic link to the binaries of the active distribution, replacing /usr/texbin in older systems. However, neither link is changed by TeX Live Utility or the Preference Pane when switching distributions. So please avoid the temptation to "do the job yourself by rewriting /Library/TeX/texbin."
Both MacTeX and BasicTeX install ``TeX Distribution Data Structures'' in /Library/TeX/Distributions containing links to various parts of the distribution. This data is used by TeX Live Utility, by Ghostscript, and by others. Data structures from other distributions remain untouched. Our philosophy is that each distribution should control its own data.
Ghostscript-9.23 was extensively customized to support typesetting in the Far East. We were initially contacted by Munehiro Yamamoto about revisions for Japan. Then work was done by Kuroki Yusuke, Bruno Voisin, and Norbert Preining to perfect the configuration.
Ghostscript installs resources in /usr/local/share/ghostscript/9.23/Resource. By adding material to this location, Ghostscript can be enhanced without recompiling. Ghostscript comes with the "base 35" fonts required for Postscript, and this is enough for standard TeX applications like converting postscript files to pdf files, or converting eps illustrations to png illustrations. But sometimes, Ghostscript requires access to additional fonts. Two years ago, Bruno Voisin extended our Ghostscript package to give it access to many pfb font files in TeX Live.
In China, Japan, and Korea, more much extensive knowledge of CJK fonts is often required, depending on the typesetting engine used. Yusuke, Voisin, and Preining provide this knowledge for Japanese. Preliminary work has also been done for Chinese and Korean. In addition, Preining wrote a script which can search a user's machine for other fonts and add appropriate configuration files to Ghostscript. All of this is described in more detail in a document MacTeX installs in /Applications/TeX, and in a READ ME file for users in Japan by Yusuke Terada, also installed in /Applications/TeX.
MacTeX installs a completely unmodified copy of the full TeX Live 2018 distribution. This is exactly the same distribution that runs on OS X, Windows, GNU/Linux, various BSD Unix systems, and other systems.
For new features in TeX Live 2018, see The TeX Live Guide for TeX Live 2018.
\usepackage[latin9]{inputenc}
UTF-8 is an encoding standard for full unicode, which can simultaneously encode most scripts used across the world: Roman, Arabic, Chinese, Hebrew, Hieroglyphics, Japanese, etc. Until now, Latex sources using this encoding required the header line
\usepackage[utf8]{inputenc}
but this line is now optional because UTF-8 is the default.
The second issue may or may not be noticeable. Synctex is an addition to TeX by Jérôme Laurens; when it is activated, LaTeX and other typesetting engines output an extra ".synctex" file during typesetting, which is then used by front ends to move rapidly from text in the source to the corresponding typeset text, and visa versa. The Synctex package includes parser code by Laurens that front ends can use to implement this syncing.
In 2017, SyncTeX was rewritten by Laurens, and then the parser code was substantially rewritten, changing some of the function calls and data structures. This parser code was released in July, 2017, about a month after the release of TeX Live 2017. The new parser code was almost immediately adopted by TeXShop, but perhaps not by other front ends, particularly those for systems other than the Macintosh.
This parser code is now in TeX Live 2018. During the pretest period, it is causing some concern for front end authors, although the scope of that concern is unclear. TeXShop works fine with the 2018 sync code, and will soon contain additional changes made by Laurens later in 2017-2018; these changes have already been tested locally and work fine. A few front ends could experience short-lived problems at release time.
We'd like to call attention to three changes in TeX Live 2010 which remain important today: