[ Direct Download: TeXShop 3 for Lion | Lion Source | TeXShop 2 | Version 2 Source ] [ Contact ]

## TeXShop History

### TeXShop Changes 3.88

Version 3.88 has the following changes:
• In version 3.86, .bbl files were added to the list of files automatically removed by "Trash AUX Files". Two users complained, giving reasons. So these files are no longer automatically removed. Notice that there is a hidden preference to add file types to those removed, so users who want to remove.bbl files can still do so.

• The syntax parser had a bug which could crash TeXShop. This bug was discovered by Yusuke Terada, who provided a fix.

• Masson Thierry suggested three new features, and all are in version 3.88. He suggested adding \frametitle to entries added automatically to the tags menu. This should be helpful when using the Beamer slides package.

• Masson suggested a new "magic line":
% !TEX pdfSinglePage
When this line is added to the top of a source file, the resulting pdf preview will show single pages, even if the default is to show a single scrollable document. This feature is aimed at Beamer authors, who want slides to display one slide at a time, but other documents to scroll.

• Several years ago, Ramon Figueroa-Centeno provided beautiful macros to set the magic lines which determine the typesetting program, the encoding, and the program root. Immediately below these macros, the macro menu now has a menu listing all other possible magic lines as submenus. Selecting such a submenu adds the corresponding magic line at the current position of the cursor in the source editor. Thus users need no longer remember the syntax of these magic lines.

### TeXShop Changes 3.87

The bug fix for Bibtex allowing citation keys with spaces turns out to be a bad idea. Bibtex documentation states that citation keys cannot have spaces, and the fix broke other user's Bibtex interaction. The fix has been removed. There are no other changes.

### TeXShop Changes 3.86

TeXShop 3.86 fixes several minor issues reported by users since the release of 3.85. Most of these issues have been present for a long time.
• The Chinese localization had overlapping text in Preferences; this is fixed.

• Antti Knowles found two bugs and sent the code to fix them. When synctex is used to sync from the Preview window to the Source window, it colors the matching text yellow. After that in earlier versions of TeXShop, if a selection was made using only the keyboard, the selection would still be in yellow. The selection color would change to standard selection color only after a click of the mouse. This is fixed.

• Knowles second fix concerns the autocomplete feature of BibTeX. If a latex label contains a space, the autocomplete feature would show the full label in the list, but selecting this label would only include the label up to the first space. The fix for this is a little iffy. If users of TeXShop and BibTeX run into problems, please write me immediately.

• Tristan Hubsch pointed out that "hyperref tooltips" used with tables of contents and elsewhere could run off the page to the left or right. In that case, they were cut off. This annoying glitch is fixed (unless the page is so narrow that the tooltip could never fit on it).

• Added ".engine" and ".sh" (shell script) as file types that TeXShop can write.

• At the request of Simon Robinson, addd ".bbl" and ".synctex(busy)" as file types which are automatically removed by the Remove AUX File commands.

• The remaining items are all motivated by email sent by Bob Kerstetter. He reported that http://tidbits.com/article/17351 had an article about the language Markdown, listing editors used on the Macintosh to create these sources, and TeXShop was in that list. Markdown is a very simple markup language invented by John Gruber whose files can be easily converted to html, pdf, latex, and other languages. Many conversion programs are available free on the internet, including a program called "pandoc". In the ~/Library/TeXShop/Engines/Inactive program, there is a folder containing pandoc engines.

But I discovered that the information about pandoc was out of date. The pandoc site now contains an open source install package for OS X, making it very easy to install pandoc. So I removed the existing engines, and placed a document called Pandoc.pdf in the pandoc folder, with links to the Gruber article and the pandoc site. Note that the pandoc site contains a large number of possible conversions, and details about how they work.

• I also received email from Alan Munn, who tried to create stationery for Markdown files (.md files) and failed. This caused me to revise the Stationery feature of TeXShop slightly. Originally, users could create two kinds of files and place them in ~/Library/TeXShop/Stationery. First, they could create a piece of stationery, with extension ".tex". Then they could create a comment file with the same name and extension ".comment" describing the stationery. After that, the TeXShop Stationery menu showed available stationery, with descriptions of each possibility.

It turns out that the extension assigned to stationery was irrelevant. So in TeXShop 3.86, stationery files can have any extension except ".comment", or no extension at all. The extension is actually never used.

Stationery is treated just like blank windows in TeXShop, except that stationery pages are marked as "dirty." If you try to close one, or typeset one, or whatever, a dialog will appear asking you to name the file and save it to a location of your choosing. This dialog contains a pull-down menu of file types which TeXShop can write, and that menu is how users actually choose filetype. Markdown stationery can be saved with type ".md" in this way, and stationery for any other file type can be handled the same way.

• The folder ~/Library/TeXShop/Engines/Inactive/pandoc contains two new engines. The first, Md2pdf.engine, converts a Markdown source file to a pdf file and opens the pdf file in TeXShop. The second, Md2HTML.engine, converts a Markdown source file to an HTML file and opens the HTML file in Safari.

Users should note that many other conversion engines for Markdown are available on the internet, and in most cases it is very easy to write engine files which call these conversion engines.

• A few people use TeXShop as a general editor. I'm one of them, but I sort of thought I was alone. If you use TeXShop to edit other things than .tex files, the syntax coloring feature of TeXShop can be annoying. TeXShop 3.86 has a new menu item which turns syntax coloring on or off. This applies to the source window at the top of the stack. Users can have several source windows, some using syntax coloring and some not. The old "Syntax Color" item in TeXShop Preferences is still there, but it now selects the default choice for syntax coloring when a new document is opened. Changing this Preference does not affect syntax coloring in documents already open.

It would, of course, be wonderful if someone would write general syntax coloring code for TeXShop, so users could choose one scheme for Markdown, one for HTML, one for C code, etc. I don't intend to do that, but I'd gratefully accept the code from someone else.

### TeXShop Changes 3.85

TeXShop 3.82 introduced "useTabs", an easy way to add tabs to projects with a root file and chapter files. TeXShop 3.84 added "useTabsWithFiles", a second method of adding tabs requiring a little more work for a lot more flexibility. Unhappily, the code for this second method broke the first method.

Grrr.

TeXShop 3.85 again activates both methods.

In High Sierra, tabs can be given special short names in place of the names of the files they represent. As the number of tabs increases, this becomes more and more useful. The second method of adding tabs has always supported these shorter names. A similar technique is provided in TeXShop 3.85 for the first method.

The magic line containing "useTabs" can be followed by an optional list of short names as in the example below:

% !TEX useTabs (one, two, , short name, five)
This additional parameter must be on the same line as "useTabs", but notice that single lines can wrap in the editor without adding a line feed. The short names are listed inside a pair of round brackets, and are separated by commas. White space at the beginning and end of a short name will be ignored, but a short name can contain more than one word, as in the above example. If the space between two commas is blank, the original name will be used for that file. If the list has fewer names than the number of tabs, original names will be used for the remaining tabs. If the list is longer than the number of tabs, names at the end will be ignored.

Version 3.85 runs on the original list of supported systems, including High Sierra. Tabs require Sierra and higher, and short names require High Sierra and higher. Short names can be input on Sierra, but they will be ignored on that system.

TeXShop 3.85 was compiled by XCode 8.3.3 running on Sierra. It runs fine on High Sierra, but the "short tab names" feature doesn't work there because XCode doesn't have API's for High Sierra. I tried compiling TeXShop on High Sierra using the beta copy of XCode provided for that system. The code worked fine in High Sierra and short tab names worked. But unfortunately, the resulting code had minor problems running on Sierra. The High Sierra version is available at the TeXShop web site at http://pages.uoregon.edu/koch/texshop/texshop.html.

The TeXShop 3.85 source code has one line commented out which must be activated to get short tab names on High Sierra. If you want to compile yourself on High Sierra, search the source file TSDocument.m for "High Sierra" and uncomment the following line of code

windowToTab.tab.title = self.includeFileShortNames[i];

### TeXShop Changes 3.84

When version 3.82 of TeXShop was released, I said that it would be the final version of TeXShop until late fall. But bugs were discovered, so version 3.83 was released.

These versions of TeXShop created only half of the promised support for tabs, and I found that I couldn't stop in the middle. Version 3.84 completes tab support, and should finally be the last release until late fall. Note that tabs require Sierra or higher because Apple first added tab support in that version of macOS.

Tabs are not appropriate for all TeX projects. They work best on books and large articles with from five to fifteen chapters or divisions, each introduced with an \include command. Some authors prefer to divide their project into many more pieces, perhaps one file per section, and then associating a tab with each file would product unmanageably many tabs.

TeXShop has two mechanisms to enhance Sierra tab support. The first is very simple. Within the top 20 lines of the root file, add the line

% !TEX useTabs
When this command is given, TeXShop itself searches for \include files to associate with tabs; the mechanism should cover perhaps 70 percent of cases.

The second mechanism gives the user considerably more control over the tabs. Within the top 20 lines of the root file, add the line

% !TEX useTabsWithFiles
Below that, within the top 50 lines of the root file, add a line for each tab
% !TEX tabbedFile{chapter1/Introduction.tex} (One)
In this command, a path to the file shown in the tab is given in curly brackets. In the example, the path starts from the folder containing the project root file, but see more details below. Notice that the file extension must be included. That is because the second mechanism allows pdf, tiff, jpg, log, aux, and other files as tabs. Authors sometimes give source files long descriptive names, which makes the tab titles very long. The final piece of the above line in round brackets is optional, and gives a shorter tab name.

The optional short name will only be recognized in High Sierra, because it requires additional Apple API first made available there. Feel free to use the term in Sierra; it will cause no harm there, but will be ignored.

Finally, we list some technical details. The first mechanism searches for \include lines after \begin{document} in the body of the root file. It is common to list files without extensions, and in that case TeXShop adds the extension ".tex" when creating the tab. In the second mechanism, however, TeXShop will not change the extension given by the user, or add a missing extension, because tab files can have unusual types so the extensions provide crucial information. Both methods create at most 20 tabs and ignore lines which might create more of them. The "useTabs" mechanism only works if the root file has at most 20,000 characters, to avoid very long searches for \include lines in gigantic root files.

If a window with tabs is left open when TeXShop is closed, then the next time TeXShop is opened, macOS opens the window and recreates the tabs. The new tab mechanism recognizes this behavior and lets macOS do the job without itself creating tabs. However, macOS does not understand tabs made from pdf files, graphic files, and a few others, so some of the tabs may be missing. It is easy to get these tabs back. Close the document and then reopen it. This forces TeXShop to recreate the tabs, and then all tabs come back. Or open the missing files yourself and drag their windows to missing tabs. (This macOS behavior is not a bug; other features of TeXShop depend on it. We cannot have everything.)

Finally, a word about the path information between the curly brackets in the "tabbedFile" magic lines. Three types of path strings are recognized. The first are strings that start in the location of the root file. Examples include {chapter1.tex} and {Chapter1/Introduction.tex}. Longer strings of directories are allowed. When it sees this sort of string, TeXShop prepends the full path to the folder containing the root file.

Another possibility is a path starting at your home directory, like {~/Galois/Equations.tex}. Here ~ denotes the home directory, so this file is probably not in the project directory.

Finally, TeXShop recognizes full paths like {/Users/koch/Galois/Equations.tex}.

If you use still more Unix conventions, they may or may not work. No guarantees. Tests suggest that spaces are allowed in both directory names and file names, but I'm loathe to recommend them.

There are a few tricky points. The Finder often lists TeX source files without the ".tex" extension, but this extension is just hidden, not absent. It must be written as part of the tab file path. (During testing, I was confused by this point several times).

When TeXShop is asked to create a tab, it opens the file exactly as if a user had dragged the file icon to TeXShop and dropped it there. Then the window described in the tab is "tabbed." This creates a few surprising cases that look like bugs but aren't. For example, then TeXShop opens a dvi file, it actually converts the file to pdf using dvips and Ghostscript, and then opens the pdf file. So tabbing a dvi file will give a pdf file as a tab.

Here is another surprising case. Suppose that you are working on a project named "Galois.tex" and you earlier created a project named "Abel.tex". When you open Galois.tex, you want Abel.tex as a tab so you can refer to that source file as you write Galois. But if you drop the icon for Galois.tex on TeXShop, both Galois.tex and Galois.pdf will open in separate windows. Similarly dropping the icon for Abel.tex on TeXShop will open Abel.tex and Abel.pdf. After tabbing occurs, you'll have a tabbed window containing Galois.tex and Abel.tex, and you'll have Galois.pdf in a separate window. But you'll also have Abel.pdf in another window. The existence of this extra pdf file looks like a bug, but isn't.

This release of TeXShop was compiled by XCode 8.3.3 running on Sierra. It runs fine on High Sierra, but the "short tab names" feature doesn't work there because XCode doesn't have API's for High Sierra. I tried compiling TeXShop on High Sierra using the beta copy of XCode provided for that system. The code worked fine in High Sierra and short tab names worked. But unfortunately, the resulting code had minor problems running on Sierra. No doubt these will be fixed before the release of High Sierra.

Consequently, if you are beta testing High Sierra and want to use short tab names, you'll need to search the source file TSDocument.m for "High Sierra" and uncomment the following line of code

windowToTab.tab.title = self.includeFileShortNames[i];
Then compile on High Sierra.

### TeXShop Changes 3.83

Murray Eisenberg discovered problems with the new "useTabs" feature and sent me his full source code to debug. This proved extremely useful! The problems I foresaw with this feature have not materialized, but Eisenberg's source revealed more elementary and embarrassing bugs, now fixed.

The only files which receive tabs are those loaded by \include{myfile} statements after \begin{document} in the root file. Here "myfile" can be a file name, partial path, or full path. Murray's document loaded chapters in a more complicated way, but was easily modified to meet this condition. It would be easy to extend TeXShop so an alternate method could also be used, in which the user lists files to be tabbed using "% !TEX fileForTab = " statements. This technique could assign files to tabs even if they aren't part of the source (for instances, tables of symbols), and could specifiy which chapters are tabbed for books with enormously many chapters. Write if you want this feature, which however will not appear until fall.

It is slightly possible that version 3.82 broke UTF-8 encoding in Japan and other far Eastern countries; the evidence is iffy at the moment. But if that happened, it is fixed in 3.83.

### TeXShop Changes 3.82

After the release of MacTeX-2017 in May, I have been spending time on TeXShop dealing with bugs by other programmers which crashed TeXShop --- and TeXShop bugs which were my fault. Now I want to turn to new summer projects, so this should be the last TeXShop update until late fall. I'll return earlier only if significant new bugs are discovered.

This final summer release contains two features, one available only on Sierra and High Sierra, and the other only on High Sierra. We start with the High Sierra feature, which comes automatically to Cocoa applications without any new code by me.

• Some time ago, TeXShop was revised to support Apple's Sharing toolbar item. For instance, if the source window is active and you select "Mail" in the item, a mail window opens containing the TeX source as an enclosure. If the preview window is active, this mail window contains the pdf output as an enclosure.

Another sharing option is "Airdrop". I think of this as an option for graduate students relaxing in Starbucks. If such a student notices someone interesting drinking coffee, they can use Airdrop to share a selected portion of TeX source code, or a selected region of Preview output. I keep hoping to be invited to a Wedding due to this feature, but not yet.

I have never actually used any of the features in the sharing tool.

In High Sierra, the sharing tool is also available from a new "Share" menu in the File menu. This menu has an extra item called "Add People." To use it, save a TeX document in iCloud. Then in Add People, send an email message or other sharing notification to a friend offering to share this document. After that, you and your sharing partner can simultaneously edit the document. You can write the first line of a proof and your colleague can immediately add the next sentence. When the document is being shared with someone else, a gray "Share" message is displayed just right of the file title on the edit window header.

• The other new feature is available in both Sierra and High Sierra. Recall that TeXShop allows large projects to be organized as a root document and various chapter files. The root contains header items and \include statements just after \begin{document}. These include statements input the source files for various chapters into the document. Chapter files include a header pointing back at the root document
% !TEX root = ../MyRoot.tex
but the root file has no such header. When a chapter file is typeset, this magic line tells TeX to typeset the root and thus the entire document. The magic line also helps sync and "goto error" locate the correct chapter source, including opening it if it is not yet open.

In Sierra, users can use the new "tabs" feature to manually move the chapter windows into the root source window as tab entries. But this is messy work which has to be done every time the project is reopened. The new feature automates this procedure.

To activate this feature, first turn off two TeXShop preferences under the Misc tab: "Open root file automatically on opening. a child" and "Miniaturize the opened root window." Both of these items probably represent bad ideas in the design of TeXShop, so the features might be removed in a later version of TeXShop.

Then add a magic line to the top of the root file source:

% !TEX useTabs
When a project with this line is opened, the various chapter files are opened as tabs in the main window. Thus just two windows appear, the source under various chapter tabs, and the single output pdf file.

Sierra already has the ability to recreate tabs in a window if the window is left open when TeXShop quits. But once such a window is closed, the tabs have to be recreated from scratch. The new header creates them automatically.

If the source code has the magic line and its window is left open when TeXShop quits, then Sierra is allowed to recreate the tabs itself when the program reopens. The new code will only run if the user quits a document, and then later opens it again.

This tab feature is somewhat experimental. It works fine for me now, but a number of tricky edge cases make me a little nervous. If you are going to try it, I suggest that you duplicate your project and work using the duplicate. In case of problems, carefully analyze exactly what you did that caused an error, and then send me a note. If possible, send me full source when a problem occurs. Once the tabs are active, I would expect everything to work without problems. It is only the step that creates the tabs that is slightly worrisome. But not enough to hold back this release.

### TeXShop Changes 3.81

Version 3.81 fixes a small number of bugs in version 3.80:
• E. Lazard reported that inserting a single space in the search field in the preview window drawer causes a crash. This bug has existed for a long time, and is fixed.

• The "Open for Preview" menu item broke in 3.80. This is fixed. Many users reporting this problem were not aware of the Preference item "Configure for External Editor," which is the more natural way to use an external editor.

• In High Sierra, the list of user-defined engines in the popup engine menu was not sorted; although it was sorted in Sierra. This is fixed.

• The French localization contains a translation by Rene Fritz of the latest version of Herbert Schulz's TeXShop Tips and Tricks, available in the Help menu.

• After typesetting, the page number of the current page in the Preview window was set to 1, even when a later page was displayed. This is fixed. (The actual bug was that the page number was set to the current page of the lower half of the split window, even when that half was invisible.)

• TeXShop's selection of the dictionary to be used when checking spelling is improved. This is a very minor matter for most users, but it requires an extensive discussion.

The basic TeXShop design is that users may have several projects open on the screen at once. Using toolbar and menu items, each can be independently configured. One project may typeset using pdflatex, while a second may use LuaTeX. One source window may have magnified text while a second has regular text in a different font.

The purpose of the TeXShop Preference Pane is to set default values for projects when they are first opened. Changing a default value usually does not affect files already open.

On the Macintosh, the "Spelling & Grammar" pane is used to pick the spelling dictionary. Originally, TeXShop did not interact with this pane, so the pane worked via the default Apple method. This changed when cocoAspell appeared, because many TeXShop users wanted a dictionary that didn't mark TeX keywords as misspelled. These users didn't necessarily want to use that dictionary in other applications. So interaction with the spelling dictionary was implemented, but the implementation had a baroque, difficult to understand, structure. Version 3.81 of TeXShop finally treats selecting a dictionary on a par with other similar choices.

A new Dictionary field in TeXShop Preferences under the Source tab has a pop-up menu which can be used to select the default dictionary. Many users will use this menu to select a cocoAspell dictionary, and then ignore everything else about spelling dictionaries. The one unexpected feature is that dictionaries are listed using the ISO 639-1 and ISO 639-2 standards rather than the localized names shown in the Spelling & Grammar pane. These are easy to decipher.

When a new file is opened in TeXShop, it will be set to use the default dictionary. But this dictionary can be changed for that file by opening Spelling & Grammar and selecting a new dictionary. A user who writes in English but corresponds with a French relative can easily do that when writing a note to that relative.

A more unusual situation occurs if a user has several files open at once, some written in one language and some in another. Activate each source file by clicking on the text, and then select the dictionary for that file using Spelling & Grammer. Then with Spelling & Grammar still open, click randomly on these source files and notice that the dictionary field changes to the correct dictionary for each file.

Finally, if you intend to work on a file for an extended period of time and it does not use your default dictionary, the default dictionary for that file can be set with an instruction at the top similar to

% !TEX spellcheck = de-DE

This particular document will then open with spelling set to German. But the Spelling & Grammar panel can later be used to switch dictionaries temporarily, in case a German letter contains an English quotation which needs to be spell checked.

After working on these changes, I mentioned them to a user who told me in a disappointed tone that he really just wanted to return to the days when TeXShop entirely ignored the Spelling & Grammar panel and let it "do its thing." There is a special hidden preference for that user:

defaults write TeXShop OriginalSpelling YES

### TeXShop Changes 3.78 - 3.80

Versions 3.78 and 3.79 were never released. Version 3.80 has the following changes:
• SyncTeX, which makes it possible to easily move back and forth between a spot in the source and the corresponding spot in the output, was written by Jérôme Laurens. This software consists of two pieces. One piece adds code to the various TeX engines, causing the creation of appropriate sync information and output of this information to the file myfile.synctex.gz during typesetting. The second piece can be used by authors of front ends; it opens the myfile.synctex.gz file, parses its contents, and deduces sync positions from the parsed data. TeXShop uses Jérôme's front end parsing code.

By the way, I use SyncTeX every day and offer Jérôme a mighty thanks for creating it.

In 2017, Synctex was revised by Jérôme; among other changes, syncing now works between code to input graphics in the source and the resulting image in the output. But when TeXLive 2017 was released, the revised code for front end authors was not yet ready. Luckily the old code continued to work with ordinary tex, latex, pdftex, and pdflatex.

Unfortunately, this code did not work with LuaTeX and LuaLaTeX, so users working with these engines usually could not sync. Even worse, TeXShop often crashed when using these engines because the initial parsing of the file myfile.synctex.gz itself crashed.

The new front end code is now available, and is used by TeXShop 3.80. The crashes of LuaTeX and LuaLaTeX have ceased, and synchronization works again, more accurately than in earlier years. Some new features require setting the flag which turns synctex on to 2 or higher. Thus users may want to write "--synctex=2" rather than "--synctex=1". This change can be made in TeXShop Preferences under the Engine tab, and in individual engines the user may have activated.

• A new engine called "filltex" was written by David Gerosa, and is available in ~/Library/TeXShop/Engines/Inactive/filltex. This spectacular engine is very easy to install; here's what it does. Two databases are commonly used in the astronomy and theoretical physics scientific communities: ADS and INSPIRE. These databases list preprints and published papers, referencing each with a citation index like 2016PhRvL.116f1102A. Suppose you have written a scientific paper in one of these fields, and suppose you citations use the standard forms for ADS and INSPIRE. For instance, your paper might have many citations, like "for more details consult \cite{2016PhRvL.116f1102A}." When the paper is done, typeset it using filltex. The engine will scrape bibliographic data from ADS and INSPIRE using the web, construct a bibliography, add the bibliography to the article, and rewrite the citations appropriately. All of this happens in one run of the engine. To see an example, typeset the example in the Inactive/filltex folder.

Many additional databases exist for other fields, and Gerosa tells me that using these databases with filltex is just a matter of revising the python code appropriately for these databases. He recommends that users interesting in doing this consult his git hub, as listed in the documents in TeXShop/Engines/Inactive/filltex.

• A modified SageTeX engine is now in Engines/Inactive/sage, together with new instructions for setting it up. These changes are required because the latest release, SageMath-7.6, has new requirements and a new internal structure.

• In some versions of macOS, opening a TeXShop Preview document in multipage mode scrolled down to the middle of the first page, rather than starting at the top. This is fixed.

• Some users noticed a slight creep of the Preview Window with each typesetting job. This is fixed or at least improved.

• TeXShop now contains latexmk 4.53a.

• Herbert Schulz made changes in "TeXShop Tips & Tricks", available in the TeXShop Help menu.

In addition to these changes, a small number of users ran into other issues running on macOS Sierra. Most users have had no trouble with Sierra, and find that it fixes a number of problems in the previous two or three systems, so these problems are rare:

First, a few users included the pstricks package in the header of their document, but used no features of this package and typeset with pdflatex. Usually pstricks requires TeX + DVI mode, so including it in the header of a pdflatex document is an error. But in Sierra, typesetting such a document with pdflatex created a pdf file that crashed PDFKit, Apple's pdf rendering code, and thus crashed TeXShop. This bug is fixed in High Sierra.

Second, some users writing beamer documents would typeset and scroll their document in TeXShop. A particular image in the middle of the document would create a glitch, and some following pages would be blank. Scrolling back up would give additional blank pages, even though they were correctly rendered earlier in the game. Eventually the document could crash TeXShop. This problem is caused by a PDFKit bug, and is fixed by Apple in High Sierra.

But in the meantime, we discovered that typesetting the same source with LuaLaTeX or XeLaTeX produces pdf files without problems. In addition, opening a defective pdf file with Adobe Acrobat Reader, and then saving that pdf file in Reader, produces a pdf file without problems.

One final problem occasionally occurs in Sierra. Many people use DropBox with TeXShop with no problems. A few of these users store their source files in the DropBox folder. A few of these folks report regular TeXShop crashes. In every case known to me, these crashes end when the TeX source files are removed from DropBox.

What is the explanation? I don't know, but I have suspicions. Recall that TeXShop uses Apple's Automatic Saving code, introduced in Lion. Thus the system can save the source at random times. A source file in DropBox can also be moved to the cloud at random times. What if both the Mac and DropBox want to make changes at the same time?

The Automatic Saving code is buried deep in Cocoa and isn't by me. The only piece of TeXShop code by me related to automatic saving says "turn automatic saving on."

• I have never heard of problems from users of iCloud with TeXShop. This is not surprising since Apple wrote both iCloud and Automatic Saving.

• Users with this crashing problem report that crashes are fixed by creating symbolic links in DropBox to sources, rather than putting the sources there directly. I don't know why.

• Other users with this crashing problem report that crashes are fixed by turning off DropBox syncing during typesetting sessions.

• And all users report success moving their sources out of DropBox, and then dragging copies to DropBox at the end of typesetting sessions.

But to repeat, many report no problems.

### TeXShop Changes 3.76 - 3.77

Version 3.76 was never released. Version 3.77 has the following changes:
• Items in the Tags menu are indented to make entries easier to find.

• A bug in Apple's search routines broke the search tool in the Preview Window's Drawer. This bug was fixed by Apple and search now works as before. It is conceivable that it is broken on Sierra 10.12.0 and 10.12.1; I no longer have such systems to test. Users who run into a problem on these systems should update the operating system to 10.12.2 or higher.

If a user clicks in a search result at the bottom of the Drawer, the corresponding item in the pdf Preview is highlighted. The up and down arrows can be used to rapidly scan various search results. This ability temporarily broke in 3.76, but works again in 3.77.

• At the suggestion of a user, the TeXShop Edit menu has an entry "Paste As Comment." This works essentially like "Paste" except that the newly pasted lines are marked as comments. This makes it possible to copy and paste a large selection from another document, and then carefully activate portions of the material.

• The Sage engine in the "Inactive" portion of ~/Library/TeXShop/Engines was improved by Markus Baldauf. Thanks!

• The latexmk file was updated to version 4.52c.

• Updated the TeXShop Help Menu document "First Steps with TeXShop" and the document "Quickstart Guide for Command Completion" in /LibraryTeXShop/Documents.

• At the request of Br. Samuel, OSB, the types gabc, gtex, glog, and gaux are now recognized by TeXShop; these types are used by the Gregario software. The files gabc and gtex are added to the types which receive syntax coloring and other "tex file" privileges, and gaux, glog, and gtex are added to file types deleted by Trash Aux Files.

• TeX users on Unix platforms often define an environment variable named TEXINPUTS, which lists folder which TeX should search for input files, style files, and the like. Using this variable is actively discouraged in TeX Live and MacTeX, and these systems are configured to make the variable unnecessary. For instance, files used by an individual user can be placed in ~/Library/texmf.

People who answer user questions about MacTeX sometimes run into problems associated with TEXINPUTS, since mistakes defining the variable can bring TeX crashing to a halt. And often users don't mention that they have set TEXINPUTS, leading to hours of useless debugging.

With these warnings, we now confess that TeXShop has a new facility for those few users with a legitimate need to set TEXINPUTS. A user recently described such a case. This user belonged to a group whose members used common input files stored on a server. The members of this group worked on a variety of tasks which all used the same basic template, but then input different files depending on the task. These input files were given the same name, but stored in different folders on the server. To pick a task, a member of the group selected a particular server folder using TEXINPUTS, and proceeded.

The user in charge of this group wanted a simple way to switch TEXINPUTS so the remaining members of the group could use the system without really understanding how it worked.

To help this user, TeXShop 3.77 recognizes a new command to be added to the first twenty lines at the header of a source file. If a project has a root file and several input chapter files, the command should be in the root file. There are four entirely equivalent forms of this command:

% !TEX TS-parameter =
%!TEX TS-parameter =
% !TEX parameter =
%!TEX parameter =
Each space is mandatory, and the final equal sign must be followed by one space and then a word or sequence of symbols without spaces. For example, the following command might be issued by someone adding ~/MyTeXFiles to the standard TeX search locations:
% !TEX TS-parameter = ~/MyTeXFiles//:

The parameter defined by this command need not be connected to TEXINPUTS. It can be used for other purposes. So --- what does TeXShop do with this parameter?

The parameter is ignored unless typesetting is done by a user-defined Engine file. For example, it is ignored if the user types with TeX, LaTeX, pdfTeX, or pdfLaTeX. But it is used with the XeLaTeX Engine, and all other Engines.

An Engine file is just a shell script, which TeXShop runs to typeset. This shell script is called with two parameters, "$0" and "$1". The parameter "$0" contains a full path to the engine file run by the typesetting command, The parameter "$1" contains the name of the file to be typeset. The parameter command adds a third parameter, "$2", containing the word on the right side of the command. The engine script can do anything it wants with this parameter, including just ignoring it. It is instructive to look at the XeLaTeX Engine file, which is very simple. The file begins with "#!/bin/tcsh", which says that it is a shell script for the tcsh shell. (There are many different shells, and each of their shell files has a different syntax.) Next comes a command setting the path, and then a final command runs xelatex: xelatex -file-line-error -synctrex=1 "$1"
We can add MyTeXFiles, defined above, to TEXINPUTS by adding the following line before the call to xelatex:
setenv TEXINPUTS "$2" At this point, several warnings are important. The command to define TEXINPUTS is different in different shells, so copying the above line with another shell will fail. Turn back to the TEXINPUTS setting "~/MyTeXFiles//:" given earlier. The symbol // tells TeX to recursively search subfolders of MyTeXFiles, and the all-important semicolon at the end says to add this to the existing TEXINPUTS from TeX Live. Omit the senicolor and TeX will completely fail. It is easy to define engines which duplicate the built-in typesetting engines. For example, to obtain an object which typesets using pdflatex, just duplicate and rename for xelatex engine, and replace xelatex by pdflatex in the engine script. Therefore, this mechanism can be used to determine TEXINPUTS with any typesetting method. ### TeXShop Changes 3.75 There is only one change. In TeXShop 3.74 on Sierra 10.12.1, scrolling in the pdf window was jerky. This is fixed. ### TeXShop Changes 3.74 TeXShop 3.74 fixes a small number of minor issues. • In Version 3.72, when the mouse hovers over a hyperref link, a popup window shows the linked portion of the document. This did not work well for equations with an equation number on the right side of the page. Now if the link is in the right half of the page, the linked portion is selected further left. • TeXShop uses five files by Jerome Laurens to interpret the contents of synctex files. These files are occasionally updated with TeX Live updates. Previous versions of TeXShop used version 1.9 of the files; this version of TeXShop uses version 1.18. Users may notice small changes in sync due to this update. • The edit menu contains an item labeled "Experiment...". Selecting this item brings up a small source window; text can be copied from the main source window to this window, and then edited there. A "Typeset" button on the small window typesets the experiment and shows it in a second small window. Both windows can be enlarged and their contents can also be enlarged using the standard keyboard shortcuts to change font size or pdf size. This facility, suggested by Wendy McKay, is particularly useful when editing complicated equations or tables. Recently this feature was mentioned on the web site tex.stackexchange.com, and Denis Bitouzé suggested an improvement. Following his suggestion, if a selection of source is made first and then the menu is chosen, the selection is automatically copied into the experiment window. If no selection is made and instead the cursor is simply positioned by clicking at a point, then the Experiment window opens with its previous contents. Thus if a user carefully edits an equation, closes the experiment window, and then decides on a final change, the contents can be brought back for another edit. • A TeXShop preference allows users to set the background color of the preview window, but that preference was ignored by the initial Sierra release. It is working again in a developer update beta. So users will want to install that update when it is released by Apple. • CocoAspell is a spell checker by Anton Leuski which understands LaTeX and thus does not mark control words as misspelled. It is an extension of Apple's Spell Check system, controlled by a Spelling Preference Pane. Users get all the benefits of Apple's integration of spell checking with document source editors, but with a dictionary that is LaTeX aware. The preference pane associated with this Spell Checker broke in El Capitan, and the entire spell checker broke in Sierra. But luckily, Anton Leuski released a new version for El Capitan and Sierra on November 8, and converted the project to open source. See "http://people.ict.usc.edu/~leuski/cocoaspell/". Users need to download the spell checker at Anton's site because he makes many dictionaries available there depending on the language(s) needed. Highly recommended. ### TeXShop Changes 3.72 and 3.73 TeXShop 3.72 finishes the task of preparing for macOS 10.12, Sierra. It also contains the changes listed below. The only change in TeXShop 3.73 is to improve the responsiveness of popUps when mousing over links. • The LaTeX hyperref package adds active links and url's to pdf documents. Many are under author control, but the package automatically links table of contents items to the starts of chapters and sections, and links reference items to the corresponding bibliography entries. TeXShop 3.72 makes it easy to understand these links at a glance. If the mouse hovers over a link, a popup window appears for several seconds showing the linked portion of the document. This is particularly useful when checking references in the document. Normally the popup is on screen for four seconds and then disappears. If the option key is down at the end of these four seconds, the popup will remain on the screen until the mouse moves. There is one cosmetic flaw. When the mouse hovers over a link, a small popup from Apple also appears giving the page where the link points. I don't know how to eliminate their popup. It does not appear in Sierra, so if you find it bothersome, upgrade to Sierra. This feature was requested by Mark M. Wilde, who noticed that it is already present in Skim. Indeed Skim has a somewhat more elegant version. • TeXShop has a hidden preference setting to control the "ColorIndex" tool, as requested by Murray Eisenburg. Type the following command in Terminal to turn this item on by default for each new document: defaults write TeXShop IndexColorStart YES • The TeXShop magnifying glass has been enhanced, as requested by Steffen Wolfrum, but the enhancements are only available in El Capitan and higher. When either magnifying glass is being used, temporarily pushing the Command, Option, or Control keys will increase the amount of magnification, and temporarily pushing Shift-Command, Shift-Option, Shift-Control will decrease the magnification. • Herbert Schulz updated the Tips & Tricks Help File. • Following a request by Markus Gail, the Help commands "ShowHelpForPackage" and "openStyleFile" remove hidden white space, making them more robust. • TeXShop is now explicitly released under the GPLv2, and a copy of this license is available in the TeXShop menu. ### TeXShop Changes 3.71 This version differs from 3.70 only in the German and Dutch localizations: • In both German and Dutch, the pdf search field in the toolbar was not connected to the rest of the program. • Some German translations were improved by Michael Rößner. • The German source window had horizontal slack, and scrolled horizontally about half an inch. This was due to a bug in XCode 7.3.1. Merely opening an NSDocument.nib for a specific language creates the bug for that language. Luckily the bug is fixed in XCode 8.0 Beta. All localizations were tested in TeXShop 3.71 and none exhibit the bug. ### TeXShop Changes 3.69 and 3.70 Version 3.69 was never released. Version 3.70 has the following features. • Version 3.70 again uses the more extensive fixes by Martin Hairer for a memory leak problem, but with a small change to fix the bugs in the Preview toolbar that occurred in version 3.66. • The behavior of the pdf search field on the toolbar has been improved. As before, command-F activates the search field so text can immediately be typed into it. Push RETURN to select the first occurrence of the word of phrase typed. This now switches the first responder to the pdf view, so the selection is highlighted in blue and easy to find. To find the next occurrence, type command-g. To search backward, type shift-command-g. These commands again produce selections highlighted in blue. They are chosen to make searches in the text and pdf windows behave the same way. (In earlier versions, RETURN and SHIFT RETURN performed these functions, but this was not parallel to find for text, and left gray selections rather than blue ones.) To search on a particular page, go to that page and select some text, making sure the selection is not empty. The next search will begin at that spot. An empty selection will start the search at the beginning of the document. If a search reaches the end of the document, it will cycle back to the beginning. • The pdf drawer alternate search method is still available. It works on all systems, including Sierra. However, Sierra's PDF search routines seem to have significant bugs, which have been reported to Apple. If these bugs are fixed, the current version will probably fail on Sierra, but this will be very easy to fix. ### TeXShop Changes 3.67 and 3.68 Version 3.67 was never released. The changes in version 3.68 are listed below: • Version 3.66 included a fix for a memory leak written by Martin Hairer. This fix created an unfortunate bug. If the user closed the Preview window associated with a document and later typeset the document, the Preview window reappeared. But many tools in the window's toolbar no longer worked. Luckily, Martin Hairer provided two different versions of his memory leak fix, one quite conservative with just a few changes, and the other more elaborate with lots of changes. The bug only affected the more elaborate version. TeXShop 3.68 has the conservative set of Hairer bug fixes, and no longer exhibits the toolbar bug. • The new search field on the Preview window has been improved. Now when the pdf window is active, typing command-F will activate the search field so a phrase can immediately be typed there. (The drawer no longer opens.) As before, after typing a phrase in the search field, type RETURN to select the first occurrence of the phrase in the pdf file. Type RETURN again and again to select later occurrences. Type SHIFT RETURN to do a backward search. • In Sierra, the old pdf search routine in the preview window Drawer stopped working. In TeXShop 3.66, this search field was deactivated on all systems and replaced by the new search field on the window toolbar. Some users missed the old method, so in 3.68 it is restored on all systems. Users who try both search methods will notice some harmless interaction between the two methods. Sierra users will discover that the old method fails. If Apple later repairs the old method on Sierra, both methods will be kept and the interaction between these methods will be eliminated. ### TeXShop Changes 3.66 • Version 3.66 has important code changes by Martin Hairer of the Department of Mathematics, University of Warwick. These code changes fix memory leaks in previous versions of the program. The changes include replacing several instance variables with class properties, whose retain/release behavior under ARC is more predictable. But the primary change is to remove some strong reference cycles in which object A referenced object B and object B referenced object A, and neither could be released without first releasing the other. Recent versions of Apple’s PDFKit use large amounts of memory because they create and cache bitmaps for faster display. If Activity Monitor is used while opening a document in TeXShop and scrolling through the preview pages, this memory usage can seem alarming, but in practice it does not cause problems. The problems solved by Hairer are different and can be seen by closing documents without quitting TeXShop. In this case, the program did not recover the memory used by the document being closed. Hairer’s fix dramatically improves this sort of problem, although it is likely that smaller memory problems remain. • A few users reported a related bug. They would close a document, reach into the document’s folder, and throw the pdf into the trash. But the Macintosh would claim that the pdf was still in use and refuse to empty the trash until TeXShop itself closed. This problem is a symptom of a memory problem and is fixed by Hairer's code. • In Sierra, the old pdf search routine in the preview window Drawer stopped working. In TeXShop 3.65, this search field was replaced with a more useful search field in the Preview Window toolbar; the new search works in all versions of OS X. In recent Sierra releases, the old pdf search came partly to life, and interfered with the new search. Temporarily, the old search if turned off in all versions of OS X. If the old search works again in later versions of Sierra, it may be turned on again, but we suspect most users will use the new toolbar search field. ### TeXShop Changes 3.65 This fixes a few problems introduced in 3.64: • Version 3.65 again works on Lion and Mountain Lion, and thus on all versions of Mac OS from Lion to Sierra. • I omitted the QTKit framework, and made AVKit and AVFoundation optional. The AV frameworks aren't available on Lion and Mountain Lion, hence the crash of 3.64 on these systems. Demo Movies will only play on Mavericks and above. • The sync fix from source to preview for Sierra is only added on Sierra, since it seems to cause minor problems on earlier systems. • The tool to search PDF files is now localized. • Sparkle in TeXShop is updated to version 1.14.0. • Yusuke Terada added code to recalculate tab lengths whenever the user changes the font or font size. ### TeXShop Changes 3.64 TeXShop 3.64 fixes a few problems with the Mac OS 10.12 (Sierra) beta. One change may be of independent interest. • The initial beta release of Sierra had substantial PDFKit problems, but most were fixed by Apple in the next beta. One problem was jumpy, non-responsive scrolling. I fixed this in TeXShop and Apple later fixed it in general. My initial fix does no harm and is still present in 3.64. • Sync from source to preview worked in Sierra, but the preview selection was not highlighted. This bug was due to TeXShop and is now fixed. • TeXShop's Help Menu has a Demo item which can download and display two short movies for new users. This was coded using Apple's QTKit, which was deprecated in Mac OS 10.9 in favor of AVKit. In Sierra, QTKit is gone. TeXShop 3.64 switches to AVKit. The movies, which used to be in .mov format, are now in .mp4 format. • TeXShop's Preview window has a drawer, which displays an outline of the pdf if the source uses hyperref. The bottom half of the drawer allows searches of the pdf file, but does not work in the Sierra beta. Since the code for the search in the drawer comes directly from PDFKit documentation, I suspect this is an Apple bug which will eventually be fixed. In the meantime, TeXShop 3.64 adds a new search field to the Preview window's toolbar. Type a word and push RETURN and TeXShop will select the first occurrence of the word in the pdf. Push RETURN again to display the next occurrence, etc. Click the mouse in the PDF window to restart searching at the top of the document. Select some actual text in the PDF window to start searching at that point. The search item will remain after Sierra is released, even if Apple fixes the drawer bug, because I suspect that many users will prefer it. The most-often-requested new TeXShop feature is tabs in the source and preview windows. Sierra provides this feature automatically, without any additional TeXShop code. Creating these tabbed views is straightforward. Further details will be provided when Sierra is released. ### TeXShop Changes 3.63 TeXShop 3.63 is an internal version, never released. ### TeXShop Changes 3.62 • Latexmk upgraded to version 4.45 • Slight improvement in TeXShop Tips & Tricks by Herbert Schulz • The menu item "Select TeXShop as Default TeX Editor" is now active when either the Source or the Preview window is on top • George Gratzer's "First Steps", the first section of his book "More Math Into LaTeX", has been updated to the contents of the 5th edition. • The TeXShop "Experiment" command ignores smart dashes, and thus does not convert multiple dashes into a character which confuses TeX • A few error messages referred to http://tug.org/MacTeX rather than the correct http://tug.org/mactex. This is fixed. • The TeXShop Preference Setting for "Show Console" was not initialized to the current value when TeXShop was opened after quitting. This is fixed. • Added a fix by Martin Hairer when using a git server with TeXShop. Martin wrote "Here is a small improvement which is very useful to me. I use a version control system (git) for some of my papers. When git updates a file, it deletes it and then replaces it more or less immediately by an updated copy with the same name. The current version of TeXShop detects this, but it often just notices that the file was pulled away under it's feet and then either closes the document or replaces it by a blank. "I propose to introduce a small latency between the moment TeXShop gets notified of the file's deletion and the moment it checks for its status so that it correctly handles changes to the file made in that manner. More precisely, in TSDocument.h, I propose to add a sleep command at line 1580" ### TeXShop Changes 3.61 • "What's New" in TeXShop Help claimed that Sparkle was updated to version 1.31. The update version number was actually 1.13.1, the latest version. • In TeXShop Preferences under the Misc tab, the items "pTeX support" and "During File Save" are only useful in Japan. They are now labeled so users elsewhere will not be tempted to activate them. • The error message when typesetting fails to find pdflatex or another tool has been improved. • If the user is running El Capitan and has set the location of TeX binaries to /usr/texbin or /Library/TeX/texbin, but this second location does not exist, an error message explains what to do. • Slight improvements in Korean and Spanish localizations • Improved pTeX scripts by Yusuke Terada in ~/Library/TeXShop/bin. ### TeXShop Changes 3.60 • Updated to Sparkle 1.13.1 for security reasons. • TeXShop no longer adds a creator and type to files it writes. These were obsolete from the Classic version of the file system. • The command "Set TeXShop as Default TeX Editor" is now active when either the Source or Preview window is active • Slight cleanup in English and Korean localization. ### TeXShop Changes 3.59 There are several small changes in TeXShop 3.59: • A new item is provided in the TeXShop menu, "Select TeXShop as Default TeX Editor." Many programs are able to edit .tex files, so when the user double clicks such a file, it is not clear which program will open it. Selecting the new menu item informs Apple's Launch Services that TeXShop should open such files. The appropriate Launch Services API does not distinguish between different versions of a program. A few users are in the bad habit of keeping several copies of TeXShop on their computer, and then the new menu will select a random version to run. It is best to keep TeXShop in /Applications/TeX and update it via the Sparkle update mechanism. Then only one copy of TeXShop will be on the disk. The author of TeXShop sympathizes with sloppier users, since he has dozens of versions of TeXShop on his disk. He opens new files by dragging their icons to the TeXShop icon in the Dock to insure that the correct copy runs. • Alan Munn reported the following strange bug: \documentclass{article} \begin{document} \begin{enumerate} \item John started the car. \item John stopped the car. % environment completion here produces \stoped % even if the line is commented out % completing again produces the correct completion % but environment completion after these comments seems to work This bug is fixed. • The TeXShop menu has a new item just below Preferences called "Open ~/Library/TeXShop". When this item is selected, the Finder will open the ~/Library/TeXShop folder. In recent versions of OS X, ~/Library is a hidden folder. The new command makes it easy to access this folder without using special tricks. Files in this location customize TeXShop for the individual user. For example, the Templates subfolder has all templates which appear in the Templates pulldown menu. These templates can be opened and edited in TeXShop; other templates can be added to the folder. • For many years, users could type a line like % !TEX encoding = IsoLatinGreek at the top of a source file to indicate that the file should be opened or saved using the LatinGreek encoding. But if the encoding name, here "IsoLatinGreek", was not recognized by TeXShop, the program would open the file using the "Mac OS Roman" encoding without reporting an error. This bug is now fixed. An unrecognized encoding name will cause an error dialog to appear reporting the error, and then the file will be opened in "ISOLatin9", the current default encoding. The best way to avoid this sort of error is to use the Encodings Macro to write the displayed line, since this Macro lists all legal encodings and allows users to select the one they want. • The alternate front end TeXWorks uses the same encoding magic line, but has different names for many standard encodings. TeXShop now recognizes the TeXWorks names, making it easier for collaborators to share files. • The TeXShop Help menu now has a new document by Herbert Schulz titled "File Encoding in TeXShop". This document explains the significance of various encodings of the source file, a topic of importance to users who do not write in English. ### TeXShop Changes 3.58 Recent TeXShop versions have been released to fix or work around a series of El Capitan bugs, particularly in PDFKit. There are three major bugs: • Magnification broke because a Cocoa command to get the PDF data underneath a portion of a window returned a bitmap in El Capitan. A workaround for this bug was included in an earlier TeXShop release. • When a new version of a pdf document is loaded, there is a momentary flash before the document is displayed. This bug has not yet been addressed. • In several situations caused by loading a new file, PDFKit displays a blank page rather than the correct content on the page. This seems to be caused by a new Apple design to speed up pdf display by creating and caching bitmaps of recent pages. When the bug occurs, the bitmap is displayed too soon. When this bug occurs, it is fairly easy to obtain the missing image. With the blank page active, type command-shift-+ to zoom in and then acommand-shift-- to zoom back out. This causes the page to be displayed correctly. However, it is better to insure that the blank page does not occur. Several instances of this bug were fixed in earlier releases. This release fixes three other cases: • In external editor mode, typesetting caused blank pages to be displayed. This is fixed, or at least mostly fixed. It is important to configure TeXShop correctly so the fix works. There are two ways to use TeXShop in external editor mode. You can typeset with TeXShop, by making the pdf page active and typing command-T. Or you can typeset from the editor or from a shell, and configure TeXShop to update the display when the pdf file changes. In the first case, the TeXShop preference "Automatic Preview Update", under the Preview tab, should be off. In the second case, it should be on. • When the pdf window is split, the bottom half sometimes became blank. This bug is fixed. • When the pdf window is split and then the user typesets, half of the display is often blank. This version of TeXShop fixes the problem. The fix works well in "multipage format", which I recommend. It can have problems in "single page format" and "double page format", although it usually works in these cases. Because of these small problems, the fix can be turned off. To do so, type the following command in Terminal: defaults write TeXShop FixSplitBlankPages NO Incidentally, all three bugs have been reported to Apple. In addition, the following changes were made: • Max Horn fixed the "unindent" command. The previous version of this command would sometimes lose a character. • Max Horn also added #defines for NSAppKitVersion10_9 and the link in the TeXShop code base, so the source code should compile on Yosemite and Mavericks as well as on El Capitan. • James Crippen asked that "paragraph" and "subparagraph" be added as default tags because these items are used in the Memoir class. So currently in LaTeX, the following receive automatic tags: chapter section subsection subsubsection paragraph subparagraph macro environment • Fixed the French localization so both documents in Help that have been translated into French occur in the Help menu. The translations of documents by Herbert Schulz are by Rene Fritz. ### TeXShop Changes 3.57 • The command to show the Key Bindings editor broke in the German localization, and is now fixed. • The command to split the Source Window broke in 3.56 and is now fixed, at least in most localizations. This is not a bug in the code; instead it is a bug in how XCode processes nib files. Fixing it required dropping down to XCode 7.0 and editing very carefully there. The bug still exists in the text window when in single window mode. • TeXShop can now edit documents with extension lua. ### TeXShop Changes 3.56 Debugging code accidentally left in version 3.55 caused a pause between typesetting and display of the new pdf. This is fixed. ### TeXShop Changes 3.55 This version fixes two significant bugs when running in El Capitan: • The text boxes in the Preview toolbar were incorrectly sized, so numbers in them were not properly centered vertically. This includes the page number box, total page box, and magnification box. All are now fixed in all localizations. Localizations other than English are only lightly tested, so problems in the box display in these localizations should be brought to our attention. • The magnifying glass displayed bitmapped images rather than clear pdf text when run in El Capitan. This was discovered early on, and a bug report was filed with Apple on July 11. • Over the years, at least four different designs were written to create a TeXShop magnifying glass. All were eventually broken by Apple changes. The Yosemite magnifying glass contained three major calls: thePDFData = [[self documentView] dataWithPDFInsideRect: [[self documentView] visibleRect]]; NSImage *theImage = [[NSImage alloc] initWithData: thePDFData]; [theImage drawinRect: magnifiedRect fromRect: sourceRect operation: NSCompositeSourceOver fraction 1.0]; The first call asked the Preview Window to provide the raw pdf data creating the region visible on the screen. The second converted this to an NSImage, a common object for handling illustrations in Cocoa. The final call read from a section of this image, and wrote the result to a (usually larger) section, essentially enlarging the image. Our bug report claimed that the third call was broken in El Capitan. After furious work this week, it turned out that the third command works well and the bug is in the first call, which asks for the raw PDF data of a typeset document. Apple claims that drawing of pdf documents is faster in El Capitan; apparently that's because PDFKit converts several pages to bitmaps and saves them for later drawing. The first call occasionally returns raw PDF code, but more often it just returns a bitmap. Magnifying that bitmap gives unpleasant results. The bug is fixed by getting the raw PDF data a different way, on a page by page basis. Because I wanted to fix this bug rapidly, the current code only gets data from one page of a document. Imagine that several pages are shown on the screen, perhaps because scrolling left part of one page and part of another page on the screen. Or perhaps the user is displaying two pages side by side. When magnification begins by clicking on a point, only the material on that page will appear in the magnifying glass. If the glass moves off of the initial page, it will show white contents with no magnified material. Release the mouse, and push it again to magnify a different page. This code may be improved in the future. On Yosemite and earlier, the old code is used. We could use the old code everywhere if Apple fixed the bug. • One user was bothered by bouncing behavior when scrolling. Here is advice from a past TeXShop release: In Yosemite, the source code window's scroll controls have some elasticity, so the source bounces slightly at the top and bottom of the document. Yusuke Terada noticed that these bounces sometimes obscure the first or last lines of the document, making it difficult to edit these lines. Yusuke Terada added a hidden preferences to turn off this elasticity. To activate the hidden item, type the following in /Applications/Utilities/Terminal: defaults write TeXShop SourceScrollElasticity NO • Finally, complaints have surfaced that the display of pdf files in El Capitan is unsatisfactory for some combinations of monitor and computer. Everyone seems to agree that the display is sharp and clear on large Retina display machines, and the problem may be caused by Apple optimizing for these machines. If you are bothered by poor display quality, the best we can do is to repeat the advice given two years ago when this problem first surfaced: I am just barely able to notice a difference myself, using Apple's 27 inch Thunderbolt Display. A few users sent me email with pairs of png files, showing an image under Mavericks and under Yosemite and pointing out the fuzzy result on Yosemite, but in some of these cases I couldn't see the difference. So the problem seems to depend strongly on the computer screen used, and perhaps on user sensibilities. Some users may be completely happy while others are desperate for fixes. Version 3.44 of TeXShop has several hidden preference items which may help with this problem. There is no universal solution, so experimentation with these preference settings will be needed if you find the display fuzzy. TeXShop and many other graphical front ends for TeX and PDF display use Apple's PDFKit and Cocoa frameworks. These frameworks rasterize pdf images are an extremely low level not accessible to programmers. Version 3.44 tries to expose all the routines in Cocoa which could modify this rasterization. Notice that TeXWorks and Adobe Acrobat do not use PDFKit and Cocoa and thus behave differently. It does little good to call these programs to our attention since switching to a different pdf display library would betray a key feature of TeXShop (and other programs using these frameworks, namely that they are fully native applications. With these caveats, let us list possible solutions. Yusuke Terada noticed that in Japan, the display could appear fuzzy and then be made legible by tweeking the magnification. So he added code in TeXShop to do this automatically each time a pdf file is opened or typeset. To turn this feature on, type the following in Terminal: defaults write TeXShop FixPreviewBlur YES If this tweek fixes the problem, leave it on and stop reading. Otherwise turn the feature off by using the same command with YES replaced by NO, since the tweek is likely to interfere with remaining experiments. Apple's System Preferences in the General Pane has an item labeled "Use LCD font smoothing when available." A few users discovered that turning this item off cured fuzzy behavior. I think this fix won't help most users, but it might be worth a try. TeXShop also has a preference item under the Preview tab labeled "Smooth text and line art." This item was originally added to fix a different problem. One user created an illustration with very thin lines. On a previous TeXShop, the lines vanished with regular monitors, although they appeared with the Retina display. The user discovered that the lines appeared in Acrobat, and by turning on antialiasing they also appeared in TeXShop. The code provided by Cocoa to turn on antialiasing has additional features not exposed in previous versions of TeXShop. Cocoa provides the ability to set the level of antialiasing. The previous "Smooth text and line art" preference set this value as "high". In TeXShop 3.44, hidden preference settings can select the interpolation level. To test various levels of antialiasing, turn on "Smooth text and line art" in TeXShop Preferences and then set the hidden preference defaults write TeXShop InterpolationValue 3 where the final value can be any integer between 0 and 4. Apple's API documentation provides the following names for these values, which perhaps give a hint of their function. The list is as follows; the strange reversal of 3 and 4 occurs in the official list: 0 = NSImageInterpolationDefault 1 = NSImageInterpolationNone 2 = NSImageInterpolationLow 4 = NSImageInterpolationMedium 3 = NSImageInterpolationHigh Frankly, I suspect an entirely different solution will be best for most people. That solution is to change the font used for your TeX document, via the wonderful macros written by Michael Sharpe and added to TeXShop late this summer. For detailed explanation, read the description below under "TeXShop Changes 3.39." Notice that it is possible to add Michael's commands for one particular font to your default template, so that font will always be used for new documents. All of these fonts are included in the full TeX Live distribution, so using them should cause no trouble when collaborating with Windows or Linux users. The font commands take up four or five lines in the preamble, and are easily discarded once the document is complete if you want the final document to have a plain vanilla look. On the other hand, Michael's choices come from an expert and may satisfy more readers than the previous default font choices. ### TeXShop Changes 3.54 The Sparkle update mechanism was broken in 3.53. It is fixed in 3.54. For some time, TeXShop has not contained the two movies which appear in the Help Menu. They are downloaded when the user requests them. This broke in 3.53, and is fixed in 3.54. ### TeXShop Changes 3.53 El Capitan introduces a significant change for TeX users. The location /usr is no longer writeable, even by users with root privileges. Consequently, the symbolic link /usr/texbin has been relocated to /Library/TeX/texbin. This new link is automatically written by both MacTeX-2015 and BasicTeX-2015. If you updated to one of these, you have the link. Once the link exists, older versions of TeX like TeXLive-2013 also work fine. GUI programs must be reconfigured to look for the new link. TeXShop 3.52 and later does this automatically. For more information on TeX and El Capitan, see tug.org/mactex/elcapitan.html TeXShop 3.53 includes the following changes: • On Mavericks, the Preview display of text was slightly blurry on many screens. This was probably caused by changes Apple added to support the Retina display. Many work arounds for the problem has been suggested. Terada Yusuke added code which improved the display for many. His code is activated by a hidden preference defaults write TeXShop FixPreviewBlur YES Apple improved the pdf display in Yosemite, and again in El Capitan. But some users still see traces of the old blur. Terada Yusuke has modified his code for El Capitan, and users unsatisfied with the Preview output should activate the above hidden preference. • Near the end of the Macro menu, there is an item Tables --> Table'' which inserts the outline for a table into the source. The first line of this source is \begin{table}[htdp] However, d'' is not a legal parameter for tables. Previous versions of LaTeX ignored this error, but it is flagged as an error in the 2015 version. The easiest way to fix this is to open the TeXShop Macro editor and remove the d''. If you have never edited the default macros, you can also get the fix by quitting TeXShop, going to ~/Library/TeXShop and throwing the entire Macros folder in the trash. Then restart TeXShop and the current Macros folder will be created. • Some changes made in TeX Live 2015 caused a few programs to output unexpected SyncTeX code, which then caused TeXShop to lose control of the mouse. This was a TeXShop bug, not a SyncTeX bug. It was fixed in 3.52. When using SyncTeX, occasionally the system cannot find a match. In those cases, the older Sync method is called. But this older method turned out to crash for the same reason. So in 3.53, the old Sync is not called and in these unusual situations, no Sync is found. • One or two coding changes were made so TeXShop will compile with the latest XCode. ### TeXShop Changes 3.52 Many of the changes in version 3.52 prepare for OS X 10.11, El Capitan. In that system, the /usr/texbin link to the TeX binaries is replaced with a new link, /Library/TeX/texbin. Users who have installed MacTeX-2015 or BasicTeX-2015 already have this new link. • TeXShop 3.52 uses the new link automatically when appropriate, and thus needs no configuration for El Capitan. To be specific, on startup, if the path setting in TeXShop Preferences under the Engines tab is /usr/texbin AND /usr/texbin either does not exist or is not a symbolic link AND /Library/TeX/texbin exists and is a symbolic link, then the preference setting is changed to /Library/TeX/texbin. Similarly if the preference setting is /Library/TeX/texbin AND /Library/TeX/texbin either do not exist or is not a symbolic link AND /usr/texbin exists and is a symbolic link, then the preference setting is changed to /usr/texbin. In all other cases, the setting is not touched. • Engine files in ~/Library/TeXShop/Engines which define$PATH have been modified by adding /Library/TeX/texbin to the path; /usr/texbin remains so these files will work on both old and new systems.

• Macros in ~/Library/TeXShop/Macros has been modified to refer to /Library/TeX/texbin rather than /usr/texbin. (Only three occurrences of /usr/texbin were found in the old Macros file.) Users do not automatically get the new macros, so users with an older system will not be affected. Users who installed MacTeX-2015 or BasicTeX-2015 can safely use the new Macros because they have the new link.

• The English Help Panel has been modified to mention /Library/TeX/texbin rather than /usr/texbin.

• In the current El Capitan beta, sync from source to preview switches to the correct pdf page, but does not hilight the new selection in yellow. This is fixed.

• In the current El Capitan beta, the magnifying glass works but displays a bitmap rather than a sharp pdf image. I suspect this is an Apple bug which will be fixed.

• The German localization has been improved by Lukas Christensen. Thanks!

• Klaus Tichmann reported a synctex bug and a fix. The "synctex_scanner_get_name" sometimes returns NULL rather than a valid string. This can lead to loss of mouse control. The fix is in version 3.52.

### TeXShop Changes 3.51

• TeXShop has two new macros by Michael Sharpe, tabularize and tabularize + space. These macros were suggested by Nils Enevoldsen and make it easier to construct and edit tables. To examine the Macros, go to ~/Library/TeXShop/New/Macros and copy the items tabularize.plist and tabularize.pdf to the desktop. The second is documentation for the macros.

To add the Macros, select "Open Macro Editor" in the Macro menu. Then select "Add Macros from file...", which appears in this menu. Navigate to the desktop and select the file tabularize.plist.

• Many missing German translations were added to the German localization by Lukas Christensen.

• There is a minor fix to the Korean localization by Karnes Kim.

• Latexmk was updated to 4.43.

• The Help menu contains a short new document by Herbert Schulz, "TeXShop Feature Confusion".

• There is a new item in the Edit Menu, "Correct Spelling Automatically", and a related new item in the Preferences Panel, "Correct Spelling". The menu item toggles spelling correction on or off for the top most document. The Preferences item sets the default setting when a document is first created or opened.

Spelling correction is a new feature inherited from the iPhone. When it is on, the Mac automatically corrects the spelling of misspelled words, and often suggests completions for words or phrases that are partially typed. Note that "check spelling" and "correct spelling" are different; the first underlines misspelled words in red, while the second actually changes the text.

Many of us dislike spelling correction. When this system doesn't know a word, it can replace it with a new bizarre choice. For this reason, spelling correction is off by default until the Preference setting is changed.

Spelling correction only works with Apple dictionaries. If cocoAspell has been installed on your system and one of its dictionaries is chosen, spelling correction won't do anything.

• System 10.10.3 introduces a new emoji feature "Skin tone modifier" for ethnic diversity. Yusuke Terada's Character Info feature has been modified to support this feature.

• Previously, typesetting in single window mode left the text side of the window active. This is fixed, and now the behavior is determined by the "After Typesetting" item in TeXShop Preferences. When this item is set to "Bring Preview Forward", typesetting in single window mode makes the preview side of the window active.

• Yosemite 10.10.3, released on April 8, 2015, fixes the "preview blur" problem which cropped up when Yosemite was introduced. The original system was optimized for the Retina display and produced blurry text in the Preview window on regular monitors. In 10.10.3, the display is again crisp on these monitors.

Consequently, fixes for this problem introduced in TeXShop 3.44 and 3.45 are no longer needed. In particular, we recommend setting FixPreviewBlur to NO via the Terminal command

defaults write TeXShop FixPreviewBlur NO

### TeXShop Changes 3.50

• Richard Koch's email address changed from koch@math.uoregon.edu to koch@uoregon.edu. All occurrences of this address in TeXShop were changed.

• A TeXShop Preference item allows the user to set the size and location of the console window when it opens. This item has a button titled "Set with current position." In 3.49, this button was always active, even thought it only makes sense if the option "All consoles start at fixed position" is selected. Now it is active only in this case. This behavior is consistent with similar Preference item behaviors for the Source and Preview windows.

• There is a Chinese localization by Wei Wang, onev@onevcat.com.

• When rich text was pasted to OgreKit, the style was mistakenly pasted. This is fixed.

• Previously the Japanese yen mark was incorrectly passed to OgreKit. This is fixed.

• A strange behavior of OgreKit when using OS X Spaces, pointed out by Daniel Grieser, is fixed. Previously the Preview and Source windows were attached to a space, but the Find window floated to whatever space was currently active.

### TeXShop Changes 3.49

• TeXShop installs two movies for beginners in ~/Library/TeXShop/Movies/TeXShop. These movies are quite large, 5.4 MB and 9.4 MB as gzipped files. Until version 3.49, every update of TeXShop contained these movies, slowing download times. TeXShop 3.49 finally does the right thing; it no longer contains the movies. If the user asks to view one of them, TeXShop downloads that movie from the web site, installs it in the above location, and runs it. Once downloaded, the movie remains on the user's machine.

This simple change reduces the size of the TeXShop download from 54 MB to 39 MB, and the size of the unzipped program from 83 MB to 53 MB.

• The Experiment feature of TeXShop, introduced in version 3.37, did not handle the "% !TEX encoding = ..." line in the header of the source file correctly, so users with UTF-8 files ran into trouble using the feature. This is fixed.

• The Source <—> Preview menu item and associated keyboard shortcut now work in Single Window mode.

• In the French Localization, the item in TeXShop Preferences to set the font of the source file was broken. This is fixed.

• Three hidden preferences were added, allowing users to change the yellow highlight color to another color, when used by inverse sync from the pdf window to the source text. This is helpful if the user has changed the default colors of the source window. The new items are
defaults write TeXShop ReverseSyncRed 1.00
defaults write TeXShop ReverseSyncGreen 1.00
defaults write TeXShop ReverseSyncBlue 0.00

• Latexmk is updated to version 4.42

• MakeIndex failed on files with multiple dots in the name; now fixed.

• A new TeXShop Preference item under the Console tab allows users to set the default size and location of the Console Window. To set these values, open a document and use TeXShop’s “Show Console” menu to bring the console to the foreground. Adjust its size and location as desired. Then open TeXShop Preferences, select the Console tab, choose “All consoles start at fixed position” and press the “Set with current position” button. Then click “OK.”

### TeXShop Changes 3.48.1

• Version 3.48 had a serious problem when used in French. Double clicking on a TeX file opened TeXShop, but not the source. This was caused by a missing connection in the French nib file. This was almost immediately corrected in 3.48.1.

### TeXShop Changes 3.48

• Currently the keyboard shortcut Cmd-F brings up the Find Panel. There are three panels, depending on a Preference choice. In 3.48, the command brings up the Find Panel unless the Preview Window is active. In that special case, Cmd-F opens the drawer for the Preview Window and places the cursor in its Search Field.

This simple change was suggested by Markus Gail.

• Sparkle has been updated from version 1.5 to version 1.8. The TeXShop Preference Pane now has items in the Misc tab controlling the action of Sparkle. Users can choose to update manually with the "Check for Updates" menu. In that case, there will be no Sparkle notification of new updates. Or Sparkle can search for updates daily, weekly, or monthly, and notify the user when an update is available.

• There is another fix for the Yosemite scroll bug in Single Page and Double Page modes.

• Updated to latexmk 4.40h.

### TeXShop Changes 3.47

• The height of the Templates toolbar item for the Source Window was increased by one pixel in most localizations to make it match other items in the same toolbar.

• The code for keyboard shortcuts in the Preview window has been revised.
TeXShop has always enhanced the left and right arrow keys to provide paging if there is no horizontal scroll bar. This code is still present.
Otherwise, recent versions of TeXShop tried to fix a Yosemite bug in which scrolling paged in the wrong direction. This bug occurs in Single Page and Double Page modes, but not in Multiple Page or Double Multiple Page modes.

The new code only fixes the bug in Single Page and Double Page modes, reverting to the App Kit code in the non-broken modes. Moreover, the new code only fixes the bug in Yosemite and above. If Apple fixes the bug, the fix can be turned off completely, using the hidden default

defaults write TeXShop YosemiteScrollBug NO

• If TeXShop is quit without closing windows, the windows will reappear when TeXShop is restarted. Initially, only the Source Window was restored, but in recent TeXShop versions the Preview window is also restored.

Previously the Preview window was always restored to the main monitor, even if the user had multiple monitors. This is fixed and now the Preview window appears on the monitor it was originally on.

### TeXShop Changes 3.46

• In Yosemite with Single Page or Double Page modes in the Preview Window, the arrow keys scrolled in the wrong direction. This was fixed in a previous TeXShop version. However, the fix partly broke the behavior of the up and down arrows in all modes.

In 3.46, the old behavior for up and down arrows returns; these keys scroll up or down one line until coming to the end of a page, and then page.

• In previous versions of TeXShop, each typesetting job caused a slight adjustment in the portion of the page displayed. Typically, the window would gradually creep upward. This adjustment seemed to depend on magnification, the portion of the page displayed, and more. We tried various kludges to minimize the creep.

It looks like Apple fixed this bug in the latest Yosemite, so we have removed the kludges. Preliminary tests show that creep is greatly reduced. Notice that the problem will definitely remain in earlier versions of OS X. Upgrade to the latest version is possible.

• When TeXShop runs with Auto Saving active, some items in the file menu are modified automatically by Apple. These items are labeled
Save As, Duplicate, Rename, Move To, Export, Revert to Saved, Revert
In particular, Revert allows users to activate a "Time Machine" like window and revert back to an earlier version.

Some of these items do not work in Single Window Mode, and Revert causes TeXShop to crash. So (at least temporarily) the items are all disabled in Single Window Mode. Obviously they continue to work in the usual mode in which the source and preview are placed in different windows.

This crash has never been reported, and we suspect that Single Window users seldom try these items. Note that "Save" is unaffected by the change, and often used.

Warning: Apple has experimented with the placement of these items; in Lion, for instance, Revert was on a pull down menu activated from the window title. We have not gone back to earlier versions of the operating system to make corresponding fixes.

• There are minor improvements in the Japanese, Korean, and Italian localizations.

• OgreKit has been updated to the latest version. Also OgreKit is now localized for Korean.

• Yusuke Terada fixed "Remember last position" for the Console window. This is complementary to a previous addition of "Always Open Console at a Fixed Position".

• Fixed minor toolbar glitches pointed out by Herbert Schulz: "Page" and "Scale" were improperly clipped in some localizations including English.

• Added a new encoding option: Korean (Windows, DOS)

### TeXShop Changes 3.45.2

• A new TeXShop Preference item under the Console tab allows users to set the default size and location of the Console Window. To set these values, open a document and use TeXShop’s "Show Console" menu to bring the console to the foreground. Adjust its size and location as desired. Then open TeXShop Preferences, select the Console tab, choose "All consoles start at fixed position" and press the "Set with current position" button. Then click "OK."

• The Source <—> Preview menu item and associated keyboard shortcut now work in Single Window mode.

### TeXShop Changes 3.45.1

• In 3.45, the Trash-AUX command did not work if some directory names in the full path to a file contained spaces. This is fixed.

### TeXShop Changes 3.45

• The left column of the Macro Editor window was essentially blank, showing separator images but no text. This error was caused because TeXShop 3.44 was compiled on Yosemite. The same source code compiled on Mavericks worked on both Mavericks and Yosemite. A work around was found and the source now compiles and works on both Mavericks and Yosemite.

• The command to trash AUX files had a bug and did not fully work. The problem is now fixed.

• Karnes Kim produced a Korean localization of TeXShop, which is now part of the program.

• Yusuke Terada provided tweeks and fixes for the following:

• The hidden preference setting
defaults write TeXShop FixPreviewBlur YES
has been improved so that it works if users zoom the PDF by pinch gestures with the Magic Mouse or trackpad.

• In TeXShop 3.41, the maximum possible PDF window magnification was increased from 1000% to 2000%. But a few constants in the code still contained the 1000% limit. These have been changed to 2000%.

• A small error prevented the fix for remembering the PDF Window location when quitting. This is fixed.

• In the Macro Editor, dashes and quotes were automatically changed to smart dashes and smart quotes, breaking some applescript macros. This is fixed.

### TeXShop Changes 3.44

Version 3.44 has the following changes
• Several users reported a crash just after typesetting when TeXShop ran on Yosemite. The users told me that only certain documents caused crashes, and under unusual circumstances. For instance, some documents caused crashes if typeset twice in succession. By looking at crash logs, I could see that all these crashes occurred at the same spot in the code, but at first I was unable to reproduce these crashes.

Finally a user named Tim Leathart reported a crash, sent the source for a document creating the crash, and gave very precise instructions about producing the crash. Using this information, I was able to crash my machine and thus find the bug. It turned out that only documents using hyperref crashed, and the crash was caused by incorrect code in TeXShop used to process the outline that such documents often contained. It was not necessary to open the Preview drawer and view the outline to get the crash.

The code is fixed.

• On Yosemite using a Preview window configured for "Single Page" or "Double Page" display, the keyboard shortcuts to page up or page down were reversed. This bug was noticed by Yusuke Terada and fixed. There are no changes in "MultiPage" or "Double MultiPage" modes since Yosemite behaves correctly for these modes.

• Autosave for the Preview window was broken and is fixed.

• The next two items discuss hidden preferences to fix minor TeXShop annoyances. Before adopting these hidden preferences, users should determine whether they find the current behavior annoying.

In Yosemite, the source code window's scroll controls have some elasticity, so the source bounces slightly at the top and bottom of the document. Yusuke Terada noticed that these bounces sometimes obscure the first or last lines of the document, making it difficult to edit these lines. Others of us do not have this problem. Yusuke Terada added a hidden preferences to turn off this elasticity. To activate the hidden item, type the following in /Applications/Utilities/Terminal:

defaults write TeXShop SourceScrollElasticity NO
• Herbert Schulz noticed that during scrolling of the source window, the lines numbers scroll at a slightly different rate and require a fraction of a second to catch up. Yusuke Terada pointed out that this is due to a fix implemented in Lion for a Lion bug affecting line numbers. Apparently this line number bug has been fixed by Apple in Yosemite. A hidden preference is available to turn the fix off. When this is done, line numbers and text scroll in unison except near the ends when source elasticity applies. By turning off source elasticity as well, the line numbers and text scroll together:
defaults write TeXShop FixLineNumberScroll NO
defaults write TeXShop SourceScrollElasticity NO

• One user discovered that "Aggressive Trash AUX", which is activated by a hidden preference setting, could remove items in hidden ".git" directories and thus impact repository management systems. In version 3.44, TeXShop does not search hidden directories in aggressive mode.

• Finally, a number of users switching to Yosemite reported fuzzy preview images and inadequate antialiasing on certain monitors. I'm told the image looks fine on Retina displays including the new 27 inch iMac. Perhaps Apple optimized pdf rasterization for these displays without worrying enough about other monitors.

Frankly, I am just barely able to notice a difference myself, using Apple's 27 inch Thunderbolt Display. A few users sent me email with pairs of png files, showing an image under Mavericks and under Yosemite and pointing out the fuzzy result on Yosemite, but in some of these cases I couldn't see the difference. So the problem seems to depend strongly on the computer screen used, and perhaps on user sensibilities. Some users may be completely happy while others are desperate for fixes.

Version 3.44 of TeXShop has several hidden preference items which may help with this problem. There is no universal solution, so experimentation with these preference settings will be needed if you find the display fuzzy.

TeXShop and many other graphical front ends for TeX and PDF display use Apple's PDFKit and Cocoa frameworks. These frameworks rasterize pdf images are an extremely low level not accessible to programmers. Version 3.44 tries to expose all the routines in Cocoa which could modify this rasterization. Notice that TeXWorks and Adobe Acrobat do not use PDFKit and Cocoa and thus behave differently. It does little good to call these programs to our attention since switching to a different pdf display library would betray a key feature of TeXShop (and other programs using these frameworks, namely that they are fully native applications.

With these caveats, let us list possible solutions. Yusuke Terada noticed that in Japan, the display could appear fuzzy and then be made legible by tweeking the magnification. So he added code in TeXShop to do this automatically each time a pdf file is opened or typeset. To turn this feature on, type the following in Terminal:

defaults write TeXShop FixPreviewBlur YES
If this tweek fixes the problem, leave it on and stop reading. Otherwise turn the feature off by using the same command with YES replaced by NO, since the tweek is likely to interfere with remaining experiments.

Apple's System Preferences in the General Pane has an item labeled "Use LCD font smoothing when available." A few users discovered that turning this item off cured fuzzy behavior. I think this fix won't help most users, but it might be worth a try.

TeXShop also has a preference item under the Preview tab labeled "Smooth text and line art." This item was originally added to fix a different problem. One user created an illustration with very thin lines. On a previous TeXShop, the lines vanished with regular monitors, although they appeared with the Retina display. The user discovered that the lines appeared in Acrobat, and by turning on antialiasing they also appeared in TeXShop.

The code provided by Cocoa to turn on antialiasing has additional features not exposed in previous versions of TeXShop. Cocoa provides the ability to set the level of antialiasing. The previous "Smooth text and line art" preference set this value as "high". In TeXShop 3.44, hidden preference settings can select the interpolation level. To test various levels of antialiasing, turn on "Smooth text and line art" in TeXShop Preferences and then set the hidden preference

defaults write TeXShop InterpolationValue 3
where the final value can be any integer between 0 and 4. Apple's API documentation provides the following names for these values, which perhaps give a hint of their function. The list is as follows; the strange reversal of 3 and 4 occurs in the official list:
0 = NSImageInterpolationDefault
1 = NSImageInterpolationNone
2 = NSImageInterpolationLow
4 = NSImageInterpolationMedium
3 = NSImageInterpolationHigh

Frankly, I suspect an entirely different solution will be best for most people. That solution is to change the font used for your TeX document, via the wonderful macros written by Michael Sharpe and added to TeXShop late this summer. For detailed explanation, read the description below under "TeXShop Changes 3.39."

Notice that it is possible to add Michael's commands for one particular font to your default template, so that font will always be used for new documents.

All of these fonts are included in the full TeX Live distribution, so using them should cause no trouble when collaborating with Windows or Linux users.

The font commands take up four or five lines in the preamble, and are easily discarded once the document is complete if you want the final document to have a plain vanilla look. On the other hand, Michael's choices come from an expert and may satisfy more readers than the previous default font choices.

### TeXShop Changes 3.43

Version 3.43 has the following changes
• Fixed a bug after drawing a selection rectangle in the Preview Window. If this window became inactive and then was activated again, drawing into the window would become erratic or worse. Now when the window is deactivated, the selection rectangle is removed.

• TeXShop has a hidden preference reversing the order of the source and preview windows in single-window mode
defaults write TeXShop SwitchSides YES
After selecting this preference setting, use "Customize Toolbar" with the single window active to rearrange tools appropriately.

• Yusuke Terada fixed Automatic UTF-8-Mac to UTF-8 Conversion, which is used mainly in Japan, so it correctly opens root file documents.

• Yusuke Terada also fixed a couple of cases when TeXShop commands created a "ghost window" with no content, and made (command+1) switching source window also work on console windows.

### TeXShop Changes 3.42

Version 3.42 has the following changes
• In Split Full Window mode, additional toolbar tools are provided: the "Scale" tool, the "Color Index" tool, and the "Key Bindings" tool.

• Toolbar items for this window now have reasonable localized names, rather than the very technical names in version 3.41.

• Various bugs in the Split Full Window mode are fixed.

• The Spanish localization temporarily changed to Chinese. This is fixed.

• The Macro menu failed to work in Split Full Window mode if the user switched to another window and then back to the split window. This bug is fixed.

• In Full Window mode, if the text portion was split, both the Macro menu and the Sync between Preview and Source always used the same piece of text rather than switching when the other piece of text was made active. This is fixed.

• Yusuke Terada improved the new "Character Info" command from 3.41. He writes

• National Flags:

An emoji character of a national flag consists of 2 unicode characters. For example, 🇺🇸 consists of U+1F1FA (REGIONAL INDICATOR SYMBOL LETTER U) and U+1F1F8 (REGIONAL INDICATOR SYMBOL LETTER S), and 🇯🇵 consists of U+1F1EF (REGIONAL INDICATOR SYMBOL LETTER J)   and U+1F1F5 (REGIONAL INDICATOR SYMBOL LETTER P). Thus, they should be displayed as "a letter consisting of 2 characters", but it is displayed as "a letter consisting of 4 characters" in the current version of TeXShop. This is because the regional indicator symbol letters are positioned outside the BMP (Unicode Basic Multilingual Plane). I fixed this issue so that these national flags are correctly displayed as "a letter consisting of 2 characters".

• Support for Ideographic Variation Selector (IVS)

In Japan and China, some kanji characters have multiple variants. For example, both 神 and 神󠄀 have the same meanings (they mean "God") and the same readings. They are considered as variant forms of the same kanji. IVS, Ideographic Variation Selector, is used in order to distinguish them. For example, the single unicode character U+795E brings the output "神". On the other hand, the sequence "U+795E U+E0100" brings the output "神󠄀". U+E0100 itself is not a letter. This is a variation selector. In Unicode, there are variation selectors like this in U+FE00..U+FE0F (Variation Selectors), U+E0100..U+E01EF (Variation Selectors Supplement), U+180B..U+180D (Mongolian Free Variation Selectors). In the current version of TeXShop, the character info of "神󠄀" is displayed as "a letter consisting of 3 characters". I modified TSGlyphPopoverController.m for IVS support so that this is displayed as "CJK UNIFIED IDEOGRAPH-795E (Variant)", like "RED APPLE (Emoji Style)".

### TeXShop Changes 3.40 and 3.41

Version 3.40 was never released. Version 3.41 has the following changes

• When editing a document, it is possible to place the source view and preview view in a single window rather than dealing with two windows for these views. This is particularly useful when using the "full screen" option, since the screen will contain both source and preview views.

To implement this feature, a number of minor changes were required throughout the TeXShop source code. The initial implementation is therefore rather conservative. At the moment, for instance, no Preference item is provided to automatically open documents in this form.

If a document has both source and preview windows, activate the source window and then select the item "Use One Window" in the Windows menu. The two windows will be replaced by a single window containing both views. With this window active, select "Use Separate Windows" to replace the single window with a pair of windows.

The first time this happens, the single window will not have an appropriate size and position. Resize it appropriately. TeXShop will remember this size and position, but it is even better to carefully select an optimal size and position, and then with the window active choose "Save Source Position" in the Source menu. TeXShop will use that size and position in the future.

A source window cannot be converted to single window form unless the corresponding preview window also exists.

If a project has a root view and additional chapter views, only the root view can be converted to single window form. Thus the new feature is not likely to be useful for projects divided in this way.

• In previous versions of TeXShop, duplicate copies of many documents in the Help menu were placed in the Localized directories of TeXShop, even though these documents had never been Localized. This duplication is cleaned up in version 3.41, reducing the size of the program by almost a third. The English versions of the documents will still appear when TeXShop is used in another language.

• Yusuke Terada provided a new menu item in the Edit menu called "Character Info." To use it, select one or more letters in the source file and then select the menu item. If only one letter is chosen, a balloon will appear showing a magnified version of the glyph, its full unicode name, and its unicode character. When glyphs require two or three characters, all required characters will be displayed.

If several letters are selected, the balloon will list the number of characters, words, and lines in the selection, and show the unicode character for each glyph.

Below are sample balloons provided by this feature:

• Christian Icking discovered that TeXShop became inoperative or crashed when opening a file containing % !TEX root = but with no non-space characters after the equal sign. This bug is fixed.

• Typesetting for "Experiment" is more robust. It now uses the Preference settings for pdflatex and simpdftex latex and the personallatex setting. If the user's pulldown menu is set to latex, the three choices of 1) pdflatex, 2) tex + dvi, 3) personal script are obeyed. This should make the command work for TeX in Japan.

• The commands Next Source Window and Previous Source Window in the Window menu again work, and do not bring up "ghosts" of closed windows.

• In the previous version, the Indent and Unindent commands were modified to insert spaces rather than tabs in the source. A few users preferred tabs. There is now a preference item for these users; they should check "Use Tabs" in TeXShop Preferences, under the Source tab.

• The Preference command to select the source font was broken when TeXShop was used in English, due to a missing connection in the English Localization File. This is fixed.

• Yusuke Terada doubled the maximum magnification level allowed for PDF files, so it is now possible to look at very small details of the preview output.

• Yusuke Terada provided new Preference settings under the Miscellaneous tab for projects with a root file. When opening a chapter file, TeXShop previously also opened the root file and then immediately miniaturized the root source. Users can choose to avoid this miniaturization, or to avoid opening the root file at all. In the second case, the root will open when needed, for instance during typesetting.

### TeXShop Changes 3.39

• The most significant change in 3.39 is the addition of Michael Sharpe's "Recent TeX Fonts" document and associated font Macros. Michael and I attended the TeX User Group meeting in Portland, Oregon at the end of July, 2014. I knew him as an Applescript expert; several of his scripts are in TeXShop. Other macros from him will appear in a future version. To see his scripts, go to https://dl.dropboxusercontent.com/u/3825336/TeX/index.html. Pay particular attention to macrocopier.zip on this location, a stand alone program which makes it easy to maintain and extend TeXShop macros.

At the TUG meeting, I discovered that Sharpe is a font expert widely known to users on other platforms. TeX Live contains a very large number of TeX fonts, but it is not that easy to use them. Most font sets don't have mathematical symbols, and it becomes a design task to find pleasing combinations of fonts for text, sans-serif sections, and mathematics.

Sharpe wrote a document called "Recent TeX Fonts", now available in the TeXShop Help menu. This document describes a number of pleasing font combinations, one per page. Each page lists the features of a set, provides an extensive sample of text and mathematics typeset using it, and contains the exact LaTeX code needed to use the font set. These sets are the result of extensive work by Sharpe; I understand that some of them took four months to perfect.

One way to use the document is to select an article or book written with standard fonts and copy Sharpe's implementation section into the document's header and retypeset.

To make this even easier, Sharpe slightly modified the LaTeX template which comes with TeXShop, defining a section in the header bounded by %SetFonts comments. The space between two such comments can be empty when the document is originally written. Sharpe defined three macros called "GetFontSet," "SaveFontSet," and "TestFontSet." The first of these brings up a small dialog listing known font sets. When one is selected, its implementation code is written to the source document between the %SetFonts comments, replacing other implementation code there. So with one click and one typeset, the document can be seen written with a new set of fonts.

Users can also put their own implementation code between the %SetFonts comments. The SaveFontSet macro reaches between the comments and saves the implementation code to a file in ~/Library/TeXShop/bin named "SetFonts", which is used by the GetFontSet macro to list known font combinations. Thus "SetFonts" gradually builds into a library of known font combinations.

I'll let the TestFontSet macro speak for itself.

To use these Sharpe additions, it is necessary to use the full TeX Live as installed by MacTeX, because BasicTeX doesn't contain many fonts. All the font sets defined by Sharpe have been tested and are available with TeX Live 2014, except two. The garamondx font has a license permitting free personal use provided the font is not sold. This font is on CTAN, but it cannot be in TeX Live because TUG sells a DVD containing TeX Live. However, a script named getnonfreefonts is available to download and install this font. See https://www.tug.org/fonts/getnonfreefonts/.

The "SetFonts" template also has a Lucida entry. Lucida is a commercial font, sold by TUG and others. See https://www.tug.org/store/lucida/index.html. Many users own this set, and Sharpe's detailed and non-trivial code to use them will help them obtain the most from the fonts. It is our hope that the existence of these easy techniques will lead to more LaTeX documents that don't scream out "I was written with \TeX," and instead have a professional printed look.

• TeXShop has a new icon by Thiemo Gamma in Switzerland, designed for Yosemite. Gamma also redesigned the dialog which appears when you select the menu item "About TeXShop".

The story of TeXShop icons is complicated. The original icon was designed by Jérôme Laurens. Jérôme also designed the TeX Live Utility icon, and I like both a lot.

When the Retina display appeared, it was necessary to redraw the icon, but unfortunately source code for Jérôme's icon did not exist. Other users then contributed revised icons, which I didn't quite like. So I tried myself and discovered that making icons is really, really hard. Eventually William Adams managed to create a high resolution version of Jérôme's icon and I like it a lot. Adams also provided a document icon.

But Apple revised the look of icons in Yosemite. I intended to ignore the new design.

Then completely unexpectedly, Gamma sent a new icon. I think it is wonderful for a reason I'll explain in a moment. Gamma is extremely modest about it. When he learns how difficult it is for others to make icons and how much in demand good designers are, he'll have a happy life.

My goal for TeXShop has always been that it should vanish into the background, allowing writers to concentrate on the document they are writing without distraction. Sometimes this goal is met, and sometimes not. Gamma's icon is a symbol of this goal. It is simple and subdued, sitting there in the background.

TeXShop still contains Adams' icon for documents. The source code also still contains his program icon.

• TeXShop 3.38 has a significant bug, first discovered by James Crippen. When a source document is long and the preview window is active, clicking on the source window leads to a several second delay before the source window becomes active. This bug was caused by a single line of code, added to help a few users in Japan. The bug is fixed in 3.39.

The line of code creating the bug was added for users who meet all of the following conditions:

• They use Japanese input methods
• They customize the background and foreground colors of the source window
• They choose a dark color for the background

These users can activate the bad line and live with the bug by typing the following in Terminal

defaults write TeXShop ResetSourceTextColorEachTime YES

• Herbert Shultz provided a new version of the Help document TeXShop Tips and Tricks, and René Fritz provided a French translation.

• The Brazilian localization in TeXShop 3.38 was mistakenly added by Koch to the localization for Portuguese in Portugal. This is fixed in 3.39.

• Will Robertson asked that the TeXShop "indent" command insert spaces rather than a tab. This makes fine adjustments afterward easier. Version 3.39 gives Robertson his wish.

• Yusuke Terada provided fixes for a number of small problems in TeXShop:
The color matching options for copying from the Preview window, set in TeXShop Preferences under the Copy tab, were broken in recent versions. This is fixed.
The routine which selects an image from the Preview window has been improved.
Toolbar tips for mouse actions in the Preview window have been added and localized.

• Yusuke Terada also fixed a more significant bug. If a particular font is set in TeXShop Preferences, either by the user or by default, but that font is no longer in the system, then TeXShop would refuse to run. This may explain some very obscure problems reported in the past. The bug is fixed.

### TeXShop Changes 3.38

• If the option key is down when a source file is opened, the associated pdf file will not be opened.

• TeXShop is written in Cocoa, an object oriented framework inherited from NeXT. Object oriented programs create a large number of objects dynamically during program operation. "Memory management" is the task of disposing of these objects when they are no longer being used. If an object is disposed too soon, the program crashes when another part of the program tries to use it. If an object is left dangling and not disposed, memory gradually clogs up.

Recently Apple introduced "automatic reference counting", a technology which leaves the memory management task to the compiler, allowing the programmer to ignore it. TeXShop adopted this technology in version 3.35, leading to increased stability and significantly fewer crashes.

In reference counting, each object keeps a reference number counting the number of parts of the program using it. When a piece of the program is done with the object, that part sends the object a "release" message and the object decreases its reference count by one. When the count reaches zero, the object is automatically removed from memory.

There is one situation which the compiler cannot handle automatically. Suppose object A is using object B and object B is using object A. Each object then has a reference count at least one, and usually higher if the objects are being used by other parts of the program. Suppose now that the rest of the program is done with the two objects. The objects are sent a number of "release" messages, until eventually each has reference count one. Since the count is not zero, object A does not go away, so it does not send a release message to object B. Similarly ...

The solution of this problem is to manually introduce a "weak reference" from one object to the other. We give object A a reference to object B, but only give object B a weak reference to object A. A weak reference does not increase the reference count. Thus when all other objects are done with the pair, object A has reference count zero, but object B has reference count one. So object A is removed from memory, and just before that happens it sends a "release" to object B. Now object B has reference number zero, and it too is removed from memory.

TeXShop 3.38 completes the process of conversion to automatic reference counting, by correctly indicating weak references. Thus versions 3.35 through 3.37 could leave unused objects in memory, but 3.38 fixes that problem.

### TeXShop Changes 3.37

• Added a preference setting for the Preview window: smooth text and line art.'' By default this is on. The setting was requested by Tom Burke, who created an illustration using GeoGebra which looked pixelated when displayed at small size in TeXShop. Mysteriously, the illustration looked fine under the magnifying glass, or when printed. It also looked fine on a Retina display, but in that case the circles and lines were very thin.

The same preference setting is provided by Apple's Preview and other programs. Users with a Retina display may wish to turn it off.

• Yusuke Terada added small changes for users in Japan. He wrote "during the time Hiragana is input until it is converted to Kanji, undecided characters' are displayed, but the source text color is not applied and they are displayed in black. This behavior has been modified."

• A new item, "Experiment...", was added to the Edit menu and is available when the source window is active. This addition has been a recurring request of Wendy McKay. The item allows users to experiment with short, but complicated, fragments of TeX before copying the source into the main document.

When the item is chosen, a panel appears. Type a TeX fragment into the panel, say $$\sqrt{x^2 + y^2}$$. Push the Typeset button at the bottom of the panel, and a second panel appears showing the result of typesetting the fragment. The fragment can contain anything: a displayed formula, ordinary text, several pages of mixed material. To typeset, TeXShop creates a new source file with the header of the current document up until "\begin{document}", the new fragment, and a final "\end{document}." This also works in a project with a root file. In that case the contents of the root file up until "\begin{document}" are used.

Both panels have close buttons. The "escape" key will also close panels when they are active.

Although the two panels do not have resize buttons, they can both be resized. TeXShop will remember the new sizes and locations and use them the next time "Experiment..." is selected. The font in the source panel will be the default TeXShop source font. The keyboard shortcuts "command +" and "command -" work in the source panel to enlarge the text if desired. Key bindings and command completion are available in the source panel, but with one caveat. Command completion uses the tab key in the panel even if it uses the escape key for regular source, since the escape key in a panel closes the panel.

$defaults write TeXShop backgroundAlpha 0.6 (Actually my experiments show that both of these preference items are irrelevant, and the old SourceWindowAlpha and ConsoleWindowAlpha, documented in TeXShop Help, are enough to make transparent windows. I'll keep this item in the change document 'just in case.' -- Dick Koch) • When "utf export" is enabled to support pTeX in Japan, UTF-8-Mac encoded text is automatically converted to UTF-8 encoded text. In addition to the work of Terada, TeXShop 2.38 has the following changes: • Version 2.38 contains a new Chinese localization by Linus Yang, from Fudan University in Shanghai, China. Thanks! • The Help menu now contains a link to a wonderful document by Herbert Shultz called "TeXShop Tips & Tricks." This document describes a number of useful TeXShop features in much more detail than the Help panel, including sections on working with large documents, pdflatexmk, editing shortcuts, auto completion, and command completion. • The following bug is fixed: when a TeX source window is closed, the pdf Preview window is also closed. In previous versions, the Preview window was not deliberately closed in code, but it closed anyway because closing a document releases its nib file. This may have caused crashes in a small number of cases. In Apple's forthcoming Lion system, the corresponding crash always happens. But version 2.38 of TeXShop fixes this problem. In short, this fix may help stability on earlier systems, and is required for Lion. • The next addition is by Alvise Trevisan. In previous versions of TeXShop, if you type begin{itemize} (or \begin{}} or a number of other typical fragments) and then push the Escape key, the corresponding \end{itemize} will appear on the following line and it is only necessary to fill in the intermediate lines. Unfortunately, if the opening \begin{itemize} is indented, the indentation is not preserved for the corresponding \end{itemize}. But with Trevisan's modification, it is preserved. • Herb Schulz adopted Trevisan's code to provide a similar preservation of indentions throughout Command Completion. • The ConTeXt-MKIV.engine and the document "About the Inactive Folder" in TeXShop/Engines/Inactive have been revised to indicate that users must run the following command ONCE in Terminal before using this engine: luatools --generate • Added the file extensions bbx, cbx, and lbx to the list of files which TeXShop can edit, and activated syntax coloring for such files. • Added the extensions .bcf and .run.xml to Files->Trash Aux Files. This is needed to switch from biber to bibtex in latexmk. • Alan Munn updated the help files advanced_otherfiles, advanced_syntaxcolor, basic_preferences, and advanced_personaltetex. The revisions document a couple of obscure features, but the key point is that Munn's formatting makes these files easier to read. It also introduces some inconsistency in the appearance of help pages, but we hope the remaining pages will be reformatted in the same way over time. • The program contains version 4.23 of Latexmk. • For some time, TeXShop has contained a Substitutions submenu in the Edit Menu. This menu allows users to activate a number of operating system enhancements for inputting text: Smart Copy/Paste Smart Quotes Smart Dashes Smart Links Data Detectors Text Replacement Consult Apple documentation for details. Until version 2.38, users had to activate these items each time they opened a file. In TeXShop 2.38, the last choices a user makes are remembered and used when new files are opened, even after quitting TeXShop. Warning: Operating system 10.4 (Tiger) only supports smart Copy/Paste. System 10.5 (Leopard) adds support for smart quotes and smart links. The remaining items are only available in system 10.6 (Snow Leopard) and beyond. All items are standard parts of Apple's text system, and some may not be appropriate when editing TeX/LaTeX documents. • TeXShop 2.38 adds a new magic marker to select the spelling dictionary; this idea was first introduced in the latest release of TeXworks. Suppose a source file is written in German and one of the first twenty lines in the file is % !TEX spellcheck = de-DE Then the spell checker will use the German dictionary with this document, but will use the default spelling dictionary for all other open documents without this line. TeXShop reads this line when opening the file, so when the magic marker is created, the file must be saved, closed, and reopened before TeXShop will use it. If a project uses several include files, each include file must contain the line. When using this command, Apple dictionaries are specified using either the ISO 639-1 or ISO 639-2 standards for determining language designations, and the ISO 3166-1 standard for regional designations. The regional designation is used to distinguish between a language as used in one part of the world and that same language in another part of the world. For instance, French is "fr" in ISO 639-1 and "fre" in ISO 639-2; French (France) has regional designation "FR" and French (Canadian) has regional designation "CA". So to select a French dictionary in Canada, "spellcheck = fr" will work, and "spellcheck = fr-CA" would be even better. Since these are ISO standards, similar commands will work on other platforms, although TeXShop only runs on the Mac. The language standards are described in http://www.loc.gov/standards/iso639-2/php/English_list.php and the regional standards are at http:www.iso.ch although this second site is difficult to use. Specifying a cocoAspell dictionary is slightly tricky. The Spelling Preference Pane installed by cocoAspell lists all cocoAspell dictionaries, including active dictionaries. Names in this list are the names to be used following "spellcheck". When these dictionaries appear in Apple's list in the Language & Text panel, they often have different names. Those names don't work. For example, there is a ocoAspell dictionary named German. If the German dictionary is selected in the Spelling Preference Panel, then the resulting dictionary will be listed in Apple's panel as Deutch (Aspell). In this case % !TEX spellcheck = de will select Apple's German dictionary and % !TEX spellcheck = German will select the cocoAspell German dictionary, while % !TEX spellcheck = Deutsch (Aspell) will select nothing. Similarly there is a cocoAspell dictionary named German (Germany) in the Spelling Preference Pane. To select it, the appropriate command is % !TEX spellcheck = German (Germany) ### TeXShop Changes 2.37 TeXShop 2.37 is an extremely minor upgrade. • TeXShop 2.37 contains an updated Japanese localization by Seiji Zenitani. • TeXShop has latexmk 4.18; it has a Quick Start Guide for latexmk in ~/Library/TeXShop/Engines/Inactive/Latexmk. • Dick Koch's web address changed from http://www.uoregon.edu/~koch/texshop to http://pages.uoregon.edu/koch/texshop ### TeXShop Changes 2.35 and 2.36 • TeXShop 2.35 is an internal version never publicly released. • Added a new preference item which switches between the tab and escape keys as the trigger for command completion. • Recall that complicated commands entered with command completion include "marks" where the various command arguments occur. The Completion/Marks menu contains menu commands to go to the next mark, or to the previous mark. These menu commands have keyboard shortcuts which have not been changed. But TeXShop 2.36 adds extra keyboard shortcuts for these two commands: option-escape to go to the next mark control-escape to go to the previous mark When the tab key triggers command completion, these shortcuts become option-tab to go to the next mark control-tab to go to the previous mark • Keyboard shortcuts always cause trouble for some users, who may have third party utilities which already use those shortcuts. So there is a hidden preference to turn off the new shortcuts for next mark and previous mark: defaults write TeXShop CommandCompletionAlternateMarkShortcut NO • Added a menu item following the File/New command: New from Stationery... Selecting this item brings up a list of stationery: Beamer, AMS-Article, Letter, Project, ProjectChapter, etc. Each item is listed in the left column and briefly described in the right column. Selecting an item opens a new document with the contents of the chosen stationery. This document is not associated with the stationery file on disk, so pushing the typeset button asks the user to save the document and suggests as a default name "Untitled", exactly as if the document had been created by the New command. Version 2.36 contains rather rudimentary stationery files. I'm hoping users will contribute better and more robust alternatives for future versions. • Stationery files are stored in a new folder: ~/Library/TeXShop/Stationery. This folder works like all other folders in ~/Library/TeXShop. Users can remove files from the folder, edit files currently there, and add additional files. To recreate the default folder, entirely remove the Stationery folder and restart TeXShop. Each stationery document ends with extension ".tex". If the folder contains a file with the same name, but extension ".comment", then this file is assumed to contain a one line comment about the file, which will appear in the right column of the stationery dialog. Thus the folder contains both Beamer.tex and Beamer.comment. This "comment" file is optional. An easy way to create a comment file is to duplicate an existing file, rename it, and edit its contents with TeXShop. The stationery mechanism is a variant of the Templates menu in TeXShop, which is unchanged. My hope is that the default stationery menu will lead new users more quickly to the standard documents almost everyone eventually creates. Hence I intend to keep the default collection fairly small. Users are free to add additional stationery to the mix. • Version 2.36 contains a slightly revised LilyPond engine. • Version 2.36 contains a new default ConTeXt-MKIV engine, created after consulting Hans Hagen at TUG-2010. ### TeXShop Changes 2.34 • Removed keyboard shortcut for "hard wrap", since pushing it by mistake can have drastic consequences. • Added new Edit menu items: Substitutions, Transformations, Speech. These are standard Apple items, which automatically add these features to the editor. However, part of this addition is not complete. In a future version, there will be Preference items to preserve the user's choices for smart copy/paste, smart quotes, smart dashes, smart links, data detectors, and text replacement. Currently, choices are temporary while the document is open. • New version of Latexmk, 416a. • LuaLatex is now a default engine, since LuaTeX has progressed to a system which can be used for real work. But only new users will see the change; older users must drag LuaLatex from the Inactive folder to the active area. • The Sage engine and documentation are slightly improved. • Fixed the problem of offset line numbers in the German localization. • Added the Stex extension as one TeXShop can edit and syntax color; this is used when working with R. ### TeXShop Changes 2.32 and 2.33 • TeXShop 2.32 is an internal version never publicly released. • The major change in 2.33 improves the upgrade process. In previous TeXShop versions, it was necessary to regenerate various folders in ~/Library/TeXShop to get new defaults. While this method still works, the changes make regeneration unnecessary. There are three aspects to the change: • TeXShop now automatically updates three subfolders of ~/Library/TeXShop: bin, Engines/Inactive, and Scripts. This upgrade does not remove files added by the user; it only writes new files and folders or updates existing files and folders known to TeXShop. Note that active engines in ~/Library/TeXShop/Engines are not updated; only the inactive folder is updated. • TeXShop adds a new folder, ~/Library/TeXShop/New. This folder can be totally rewritten during an update. • Finally, TeXShop Help contains a file named "About This Update," which is rewritten for each update, explaining the exact steps needed to obtain new defaults. As an example of how these changes are used, consider the case when there is a new default Macro. It is no longer necessary to regenerate the Macros folder to obtain this Macro. Instead, the New folder will contain the new macro. Use the Macro Editor's "Add Macros from File..." item to add the macro, and drag it in the Macro Editor's list to an appropriate spot. Another example: the latexmk engine is often upgraded, but the upgrade usually changes support files in bin rather than the engine itself. From now on, such upgrades will be made automatically without user intervention. Fairly often, additional engines are added to the Inactive folder during upgrades. These will automatically appear without user intervention. For version 2.33, it is important that latexmk users read "About This Release" so they will make a few changes needed to automate future upgrades. One technical detail: the New folder contains a hidden file listing the version of TeXShop which created the most recent update. TeXShop will only update files in ~/Library/TeXShop if it is a later version than the version listed in this hidden file. So TeXShop doesn't update at each new start, and old version can be run without changing ~/Library/TeXShop. • Improved Spanish localization by Juan Luis Varona. • Fixed a bug reported by Tomas Zahradnicky: when a user attempted to print a file which had not been typeset, a dialog appeared asking the user to typeset first. The dialog has an "OK" button, but clicking the Close icon instead caused a hang. Fixed. • Fixed a bug reported by Micael Sharpe: searching in the Preview window and afterward closing the source window sometimes caused a crash. Fixed. • New code by Scott Lambert to improve the Comment/Uncomment and Indent/Unindent code. • Added fdb_latexmk to the extensions automatically removed by "Trash AUX Files", to improve the operation of latexmk. • The flip code used by some default macros is now a universal binary. ### TeXShop Changes2.31 • Goto Error is improved. It now highlights the text just before the error (as reported by TeX in the console) rather than an entire line containing the error. When searching for errors, users should first look at the spot where the highlighting ends. This change was requested by users who let TeXShop automatically soft wrap lines; to TeX, these source files appear to contain whole paragraphs rather than individual lines. In earlier versions of TeXShop, Goto Error highlighted these entire paragraphs, making the error hard to spot. • Fixed the notorious "toolbar incorrectly drawn bug". This bug occurred when the Preview toolbar contained the "mouse mode matrix" but this matrix was forced offscreen when the Preview window appeared because the window was too narrow to contain it. In that situation, the tools in the toolbar were drawn too high and partially cutoff, or so high that they were invisible. The bug is fixed. • Fixed an obscure bug reported by Jean-Michel Bismut: he got intermittent crashes when closing the Preview window with command-W or the red close circle. The bug mainly appeared when TeXShop was used with an external editor. Fixed. • Fixed a bug reported by Cesar Rivas: when the Default Page Style was "Single Page", the toolbar scale reported the wrong value, and thus zoom in and zoom out started from the wrong values. The bug fix solved another problem: previously if the user picked a mouse tool like "magnify" that was not the default and then typeset, the toolbar would still show the magnify tool active, but the actual tool would change to its default value. Fixed. • TeXShop has a new SageTeX engine by Dan Drake. This engine is easier to install because SageTeX is now part of Sage rather than an extra download. The engine no longer reruns Sage when typesetting a source in which the sage commands have not changed. For a brief time, SageTeX was part of TeX Live 2009. This is no longer true because SageTeX is closely tied to Sage and needs to be updated when Sage is updated. SageTeX users should carefully read the short document in ~/Library/TeXShop/Engines/Inactive/Sage before installing the new engine; the document explains the simple step required when upgrading Sage. • The internal TeXShop script which calls ConTeXt was modified to make the Abort command work. Although it worked for other engines, it recently stopped working for ConTeXT. Steffen Wolfrum reported the bug and was instrumental in finding a fix. The broken script was a tcsh script, and Wolfrum discovered that Abort worked when the internal script was rewritten as a bash script. • Added a new menu item, "Abort Typesetting", with a keyboard shortcut. This makes it possible to call abort from the keyboard without using the mouse. The shortcut works regardless of which window is active. • The pdf file is now closed when the Preview window is closed. In version 2.30, the entire document had to be closed to close the pdf file. In 2.29, TeXShop itself had to quit to close the file. So we are making incremental progress. • Improvements in French localization by Rene Fritz. • Slight improvements in ConTeXt and MetaPost help sections. • Slight improvements in latexmk. • Better error detection in the "Paste Spreadsheet Cells" macro. • The default KeyEquivalents.plist in ~/Library/TeXShop/Menus was defective; among other things, it had comments within comments, which is illegal. The file has been fixed. KeyEquivalents.plist doesn't actually change any keyboard shortcuts because the changes it illustrates are commented out. But users can change TeXShop's default keyboard shortcuts by editing the file. However, there are some limitations. The OgreKit Find Panel menu items are handled in a special manner and cannot be changed with KeyEquivalents. The Macro menu items are also handling in a special way and cannot be changed with KeyEquivalents, although they can be changed with TeXShop's built-in Macro Editor. Finally, File menu items are sometimes overridden by Cocoa, so shortcut changes in that menu can have unintended consequences. ### TeXShop Changes2.30 • TeXShop has a new item in the Help Menu named "About This Release." This item will be revised for each release, and explains any steps needed to activate new features. Users should form a habit of reading this short file after upgrading. New users get the latest defaults and can ignore the step. But older users may need to make small changes in Preferences, and regenerate certain subfolders in ~/Library/TeXShop. These locations allow users to modify the default behavior of TeXShop, so the program does not automatically update them because it does not want to deactivate user choices behind the user's back. • This version fixes a crucial crash bug involving synctex, searching pdf documents, and related notifications. Some users ran into the bug when attempting to search pdf documents. Others had crashes immediately after syncing. Many users avoided the crash entirely. Now it should be fixed for everyone. • TeXShop has a "Goto Error" menu command, mirrored on the console window. Until this version, the command only worked on individual files. But the command now works with projects controlled by a root file. If an error occurs in an included source file not open on the desktop, that source will open and the line with the error will be highlighted. This change requires a new flag in all engines: " --file-line-error". In TeXShop default preferences, this is set for pdftex, pdflatex, simpdftex, and xetex. If users wrote other engines, they will need to add the flag for these. • New MetaPost and MetaFun engines by Nicola Vitacolonna are included. The engines are called "nv-metapost" and "nv-metafun." To prepare for these engines, the operation of TeXShop when using MetaPost and MetaFont has been revised. The built-in MetaFont command has been removed entirely; Vitacolonna's nv-metapost works much better for that purpose. The buildin MetaPost command has been retained for compatibility with projects by current users. This command just calls mpost directly. The preference item which switched this command between MetaPost and mptopdf has been removed. Users working with MetaPost for illustrations, or MetaFont, users will want to use nv-metapost and nv-metafun instead. Minimal documentation for these commands is available in TeXShop Help's advanced section on ConTeXt and MetaPost. But a more extensive README by Vitacolonna is available in ~/Library/TeXShop/Engines/Inactive/MetaPost. • Very important improvements to command completion by Herbert Schulz are now included. These improvements allow "tags" in completed commands with parameters. When a command is completed, the entire command, including tags where the required parameters go, appears in the source file, and the first tag is selected. The user can type the parameter, replacing the tag. A keyboard shortcut then activates a new menu item which jumps to the next tag. The user can thus fill in all parameters without removing their hands from the keyboard. A greatly expanded command completion file by Herbert Schulz is included in this release. For detailed instructions, read the document about command completion written by Schulz and available in ~/Library/TeXShop/CommandCompletion. • A new "Paste Spreadsheet Cells" macro by Alan Munn has been added to the Macro menu. This wonderful macro allows users to copy an array of cells from a spreadsheet and paste the array, properly formatted with TeX commands, in the TeX source code. Munn wrote instructions for this command, which are in TeXShop Help's Macro section, in Default AppleScript Macros. • A new latexmk engine, version 4.13a, is included. • The right justification feature introduced in TeXShop 2.28 for Arabic, Hebrew, and Persian has been improved. Now a line must start with a character from one of these languages before it is right justified. Thus lines containing TeX commands with embedded Arabic, Hebrew, or Persian will still be left justified. • Added Windows Latin 1 to the list of supported encodings. • Added "ctx" to list of extensions which are regarded as TeX files and can be syntax colored and typeset. • In 2.29, closing a document left the associated pdf file open until TeXShop quit. This bug is fixed; the pdf file is closed when the source document closes. ### TeXShop Changes 2.27 - 2.29 Here are the changes: • There are many changes in TeXShop Help, to remove all references to teTeX, to add a help section on encoding, and to separate the section on Engine files into one section on General Engine Files and a second section on XeTeX. • There are slight improvements in the Program, Encoding, and Root macro files by Ramon M. Figueroa-Centeno. • The -synctex=1 flag was added to the XeTeX and XeLaTeX engines. • A bug was fixed which broke SyncTeX when filenames contained unicode characters. • Trash AUX files now trashes .synctex and .synctex.gz files. • The script for mptopdf changed to much more extensive script by Nicola Vitacolonna. This script, and one for metafun, are in the inactive folder of the Engines folder. But the metapost script is also used internally, replacing the original naive script. • An extra source preference named "Arabic, Persian, Hebrew" has been added. This item only works if Syntax Coloring is active. When the new item is activated, lines in the source which contain characters from these languages --- i.e., characters in the range 0x0590 - 0x06FF -- are right justified on the screen. This does not affect actual typesetting of the file. • Removed command line equivalents for "Bold" and "Italic". • Removed "package" check for file types tex, ctx, bst, drv, abc, ly, texi, Rnw. Now no file types have "package" checked. The reason this obscure bug got into the code is unclear; it caused some folders on the desktop to appear as packages for TeXShop. • There are a small number of German localization corrections. • The keyboard command to trash AUX files also works if the console or preview window are active. • If the shift key is held down while selecting "Trash AUX Files", the pdf preview file is also trashed. This key can be held in combination with option or not, depending on the choice of aggressive trash. However, aggressive trashing with the shift key down will NOT remove other pdf files (!) • The code for SyncTeX is revised. TeXShop used to call a script in TeX Live by Jerome Laurens to interprete .synctex files. This script changed in TeX Live 2009, breaking synctex operation. Now TeXShop embeds the script in TeXShop itself (as it should have from the beginning), making it immune to changes in the script. This makes it possible for Laurens to improve the script, and then for TeXShop to adopt these changes as its code is revised. In the original TeXShop for TeX Live 2009, the embedded code didn't have POWERPC code, causing crashes on powerpc. This is fixed. The INTEL version of the embedded file also has information to interprete files produced by dvips. ### TeXShop Changes 2.26 Version 2.26 is a minor upgrade to fix several bugs in 2.25. Here are the changes: • The TeXShop/Engines/Inactive folder contains two scripts from Daniel Becker which call texcount to count active words in a TeX source file. These engines were promised in 2.25 but erroneously omitted. They are in 2.26. To obtain them, quit TeXShop and move the entire Engines folder from ~/Library/TeXShop to the Desktop. Then restart TeXShop. TeXShop will create a new Engines folder. Merge in any changes you have made in the old Engines folder on the desktop to the new folder. • Juan Luis Varona sent new Program and Encoding macros which display the various choices, so it is not necessarily to look up the wording of these choices. A few days later, Ramon M. Figueroa-Centeno send similar but fancier macros. Ramon's macros are now in TeXShop. To obtain them, quit TeXShop and move the entire Macros folder from ~/Library/TeXShop to the Desktop. Then restart TeXShop. TeXShop will create a new Macros folder. Merge in any changes you made to the old Macros on the desktop to the new copy, using the Macro Editor. • A memory leak introduced by the code to split the Preview window in 2.25 is fixed. The bug was similar to the old flaw in PDFKit which caused memory to be gradually used up when typesetting a document many times, but this time the bug was caused by me. • A bug in the zoom code for the preview window when using multiple monitors is fixed. • A bug which caused TeXShop to ignore a "% !TEX TS-program = ..." command when typesetting from a file with an associated root file is fixed. • The French localization is improved. • A localization error caused the "Split Window" icon on the Preview Window toolbar to display strange text. This is fixed. • A bug caused the Preview Window's toolbar to vanish temporarily if the user tried to move certain text portions of the toolbar. This is fixed. • One of the keyboard zoom shortcuts acted only on the top portion of the Preview window when split. This is fixed. • The TeX mdimporter code distributed with TeXShop in 2.25 contained only i386 code. Now it contains code for both PPC and i386. ### TeXShop Changes 2.21 - 2.25 Versions 2.21 - 2.24 were internal builds, never released. Here are the changes in them and version 2.25: • Split window, previously available for the source window, now also works for the Preview window. Buttons and tools which interact with the Preview window are applied to the active portion of the Preview window when split. To activate the other portion, click on it. To avoid cluttering the interface, the active portion of the Preview window is not marked. Note that it is possible to use different Display formats in the two views. For instance, after splitting the window you can activate the lower portion and select Double Multiple Page in the Display Format menu to obtain a single page view in the top half and a double page view in the lower half. • Syncing from source to Preview now scrolls the selection to the visible portion of the window. When the Preview is split, syncing from source to preview goes to the active portion of the Preview window. • A new menu command, Show Log File, opens the log file. This file is updated after typesetting. If a source file has a root file, the menu command opens the log file of the root file, rather than the nonexistent root file of the input file. If the command key is held down while choosing this menu item, a dialog will appear asking for the extension of the file to be opened. For instance, typing "aux" into the dialog opens the aux file rather than the log file. The requested extension can be typed with or without an opening period. • A new Help menu command, "Show Package Documentation", opens a dialog which requests the name of a package in TeX Live. It then opens the TeX Live documentation for this package, using the command line program "texdoc." This improvement was suggested by Juan Luis Varona. TeX Live has a vast amount of documentation; go to /usr/local/texlive/2008/texmf-dist/doc/latex to see some (but not all) of this documentation. Note that almost all documentation folders have lower case names; therefore it is best to name packages in lower case when requesting documentation: pdftex, latex, graphicx, geometry, texdoc. But there are exceptions: IEEEtran. Documentation is sometimes available in several different forms: pdf, html, etc. Add the extension to the request to see a particular form of the documentation. For instance, enter "pdftex.pdf" or "pdftex.html" to see these forms of the pdftex documentation. Texdoc will choose a convenient form on its own if the extension is omitted. Texdoc does not open the documentation in TeXShop; instead it uses the Mac's default application for a given extension. By default, the Macintosh opens pdf files in Preview and html files in Safari, so texdoc will use those viewers. There is a standard way to redefine the default application for an extension. If you change the default, texdoc will use the new default application. It is also possible to directly configure texdoc to use particular viewers; see the texdoc documentation for details. Sometimes texdoc will not find documentation for a package, style file, or program. In that case, nothing will appear. In particular, TeXShop does not put up a warning dialog when documentation is not found. Although such a dialog would be useful at first, in the end it might become annoying. • It is possible to set the foreground color of the Console window in Preferences. This was requested by users who prefer white characters on black backgrounds for the console. • A new menu command opens the console if it has been closed. • The menu items to change the text color in the source, to justify right, left, or center in the source, and to bring up the ruler in the source have been removed, since they make no sense in TeX. • There are localization improvements in French, Spanish, and Japanese. • This version fixes a bug which ignored Console Preferences when using external editors. • TeXShop can now create and edit asy files. • Added a contextual menu item to the Source and Preview windows: Sync. Some users may prefer this menu item for synchronization because using it avoids the command key. • The TeXShop/Engines/Inactive folder now contains two scripts from Daniel Becker to call texcount to count active words in a TeX source file. The output may be more accurate than the output from detex, which is currently called by TeXShop's "statistics" command. Users who upgrade TeXShop can get the new Inactive folder by quitting TeXShop, moving ~/Library/TeXShop/Engines to the desktop, and then restarting TeXShop. The new default Engines folder will be created by TeXShop. After it is created, merge extra items in your old copy on the desktop back into the ~/Library/TeXShop/Engines folder. • The Inactive folder also contains a "sage.engine" file. This engine makes it possible to use the open source mathematical software Sage, a replacement for Maple, Mathematica, and MatLab, directly from within a TeX source file. For instance, a single TeX line can ask Sage to plot a function; in the typeset output, this plot will appear at that spot. Or a single line can ask Sage to integrate a complicated expression symbolically; in the typeset output, the answer will be shown, typeset consistently with other mathematical expressions in the document. The inactive folder contains an example document typeset in this way. Sage is available free at http://www.sagemath.org/. • There was discussion on one of the mailing lists about the logic behind TeXShop's "Typeset" menu command, the "%!TEX program" mechanism, and the fact that "BibTeX" and "MakeIndex" are not really typesetting commands. Members of the list tried to understand the logic behind fine details of TeXShop's operation, but this was a hopeless task because there wasn't much logic present. An attempt has been made in version 2.25 to provide consistent behavior, but without a complete overhaul of the interface. The code now works in the following way: The "Typeset" command in the Typesetting menu always does exactly the same thing as the "Typeset" button in the source window toolbar. Both commands call the typesetting command listed in the drop down menu next to the toolbar button, unless the first few lines of the source file contain a line of the form %!TEX TS-program = ... If such a line is present, then the Typeset command uses the indicated program instead (unless the drop down menu is set to bibtex or makeindex; see comments below). The selected item in the drop down menu does not change, so commenting out the source line will cause typesetting to revert back to the method indicated in the drop down menu. Incidentally, TeXShop ignores extra comment characters at the beginning of the above source line, so it cannot be commented out by adding an extra comment. I prefer to add a space between the "TS" letters. In previous versions of TeXShop, it was not possible to select bibtex, makeindex, metapost, context, or metafont in the "%!TEX TS-program" line, for purely historical reasons. This anomaly has been fixed, and any engine can be selected: tex, pdftex, latex, pdflatex, bibtex, makeindex, metapost, context, metafont, or a user defined engine There should be one space after the equal sign before the program name, and case is important. Selecting bibtex or makeindex in the drop down menu causes these programs to be called even if a "%!TEX TS-program" line is present, since these two programs aren't really typesetting engines and a user may need to call them even when an unusual typesetting engine is being used. So much for the basic "Typeset" command. The TeXShop "Typeset" menu also contains items to call TeX, LaTeX, BibTeX, MakeIndex, MetaPost, ConTeXt, and MetaFont. These items are present mainly for historical reasons and most users ignore them. Adding new engines to TeXShop doesn't add extra menu items because the menu would become awkwardly long if a user had a large number of extra engines. The BibTeX and MakeIndex items are treated specially. Selecting one of these items causes TeXShop to run the resulting program regardless of the setting of the toolbar's drop down menu and the possible presence of a "%!TEX TS-program" source line. This is probably the most convenient way to call these two commands. The remaining TeX, LaTeX, MetaPost, ConTeXt, and MetaFont menu commands behave in a slightly different way. Selecting one of these menu items causes TeXShop to run the resulting command, regardless of the toolbar's drop-down menu selection and regardless of any "%!TEX TS-program" line. Moreover, selecting one of these menu commands changes the toolbar's drop-down menu selection to the engine chosen in the menu command. The idea behind this design is that beginning users may first find the menu commands and typeset using them. If such a user later uses the "Typeset" button in the toolbar, it should cause the same behavior as the earlier menu command. Sorry for this complexity; I'm trying to balance leaving the interface unchanged for users set in their ways with easier use of the BibTeX and MakeIndex commands. ### TeXShop Changes 2.19 - 2.20 Version 2.19 was an internal version, never released. Here are the changes in it and version 2.20: • Line numbers are displayed in the source file. A preference item turns this feature on or off; a menu item turns it on or off for the currently active window. This feature depends on free code by Paul Kim at Noodlesoft. The code is at http://www.noodlesoft.com/blog/; see "Displaying Line Numbers with NSTextView". I don't read this blog, but the code was pointed out to me in an email from Ryan Cuthbertson, who downloaded the TeXShop source code, implemented the change, and sent crystal clear instructions explaining how to add the feature. Kudos to Cuthbertson. Kudos especially to Paul Kim and Noodlesoft; Kim's code is so well written that Cuthbertson had to add only 32 lines of code to TeXShop to make it work. • TeXShop now uses Sparkle to implement "Check for Updates." This brings many advantages. Rather than directing a user to the TeXShop web page when an update is available, TeXShop now lists new features directly, downloads the update upon request, and even quits TeXShop, installs the new version, and restarts the program upon request. Sparkle is another remarkable product from the open source software community. Written by Andy Matuschak and available at http://sparkle.andymatuschak.org/, it provides every feature you'd want in an update mechanism.The documentation for developers available on the web page is a model of clarity and simplicity. Sparkle is used by a number of other GUI programs for TeX, so users for find it familiar. • The console window has been greatly improved by Will Robertson, who sent a new Nib file containing his changes several months ago. I waited to implement the improvements until I could add a console preference tab to TeXShop Preferences allowing users to modify Robertson's choices. The font and background color for the console can be modified in Preferences. Users can adjust the console width to match the number of characters typically output by TeX, and then select a preference allowing the window to be resized only in the vertical direction. Note that preference changes are immediately reflected in the console, so the trick to easy console configuration is to bring a console window to the front, open Preferences, try out various fonts, font sizes, and background colors until satisfied, activate horizontal resizing and adjust the console width, and then, if desired, lock down this width in Preferences. • A number of items in the Preference panel have been moved to make the operation of the panel more transparent. The most important tab items come first: Source, Preview, Console, Typesetting. In the Preview tab, the "Fixed Magnification Amount" appears immediately following the "Magnification Method" to make it clearer that "Fixed Magnification" only applies when the "Magnification Method" is "Fixed Magnification." • Previously, clicking the green "Zoom Dot" on TeXShop windows expanded the window to fill the screen. An attempt has been to made this operation more rational. The Source window now expands to fill the left portion of the screen; the console expands only vertically, and the Preview window expands to fill the right portion of the screen. The Preview window expands by the largest amount because users may want to zoom the image and check fine details. I'd appreciate advice on refinement of the zoom behavior. Recall that the behavior must make sense on small portable screens and large Cinema displays. • For some time, TeXShop recognized hidden preference items to set the background color of the Source and Preview windows. These preference items are now exposed and can be set in the Preference dialog. • A bug in the MatrixPanel code disabled the hidden preference "matrixsize''. This bug is fixed. • The name of the alternate typesetting mode "TeX and Ghostscript" has been changed to "TeX and DVI". This fulfills a request of the American Mathematical Society, who have been dealing with users claiming that TeXShop cannot produce dvi files. ### For Users of Previous Versions Changes in TeXShop 2.16 through 2.18 Versions 2.16 and 2.17 of TeXShop were constructed for test versions of MacTeX-2008, and released only to a few people testing that install package. Version 2.18 is now officially released on the TeXShop site. Here are the changes: • Added a new Preference item under the Typesetting tab. The preference is called "After Typesetting" and the choices are "Bring Preview Forward"' and "Continue Editing."' The first item activates the Preview window after typesetting and brings it forward, as TeXShop has behaved in the past. When the "Continue Editing" item is activated, typesetting updates the contents of the Preview window but leaves the Edit window active with the editing cursor blinking. This makes it possible to typeset, glance over to check that things look right, and continue editing. This option is particularly useful on large monitors which can show the full contents of both windows. • Added support for SyncTeX. SyncTeX is new synchronization technology by Jerome Laurens which is included in TeX Live 2008 (but not earlier TeX distributions). The technology is built directly into pdfTeX and XeTeX. In modern TeX distributions, most typesetting actually calls pdfetex (even if using latex to output a dvi file), and thus the technology is available for such typesetting. To use the technology, add the flag --synctex=1 to the command line call to TeX. For example, in TeXShop Preferences under the Engine tab, the lines specifying pdfTeX for Tex and pdfLaTeX should read pdftex --shell-escape --synctex=1 pdflatex --shell-escape --synctex=1 A similar flag should be added to other engine scripts. The TeXShop defaults for these preferences already include this flag for pdftex and pdflatex, but not for other engine files. If the flag is included and an older version of TeX is called, typesetting will still occur (TeX will report to the console that it does not understand the flag.) The flag causes TeX to output an additional "synctex" file during typesetting, containing information linking the TeX source file(s) to the TeX pdf file. This file is similar to the old pdfsync file generated by the older PdfSync technology, but with the very significant difference that line and page breaks are no longer changed when outputting the data. Laurens also wrote a command line program named "synctex" which is included in TeX Live 2008; when this program is called with a request for appropriate synchronization data, the program parses the synctex file and outputs appropriate data. To activate SyncTeX support in TeXShop, go to TeXShop Preferences under the Misc tab and select "SyncTeX" as the "Sync Method." This is the default value if you are installing TeXShop for the first time. If SyncTeX synchronization is chosen, user interaction is exactly the same as in the old Search method. Hold down the command key while clicking at a spot in the source document. The Preview window will become active and the corresponding spot will be circled in red. Or hold down the command key while clicking at a spot in the Preview window. The source window will become active and the corresponding TeX input commands will be highlighted in yellow. When these commands are used,TeXShop will fall back on the old Search method if SyncTeX does not find an appropriate synchronization. The most common cause for SyncTeX failure is the absence of a synctex file, which will certainly happen when the file is typeset with an older distribution. Thus users can switch between TeX Live 2007 and TeX Live 2008 without changing their synchronization preference. A few users might like to test TeXShop's SyncTeX support without being confused by calls to the old Search synchronization method. To simplify this test, there is a new hidden preference which forces synchronization to use only SyncTeX: defaults write TeXShop SyncTeXOnly YES Support for SyncTeX was added to TeXShop 2.18 at the last moment. Synctex is now used in both directions, and is generally much better than the old search synchronization. But many improvements should be possible as I digest what Jerome has provided. Many thanks to Jerome Laurens for this wonderful work. I think you will notice an immediate improvement. • Added encodings ISOLatinGreek, MacCentralEurRoman, and WindowsLatin2 (i.e., WindowsCentralEurRoman). The names of the encodings are Greek (ISO 8859-7) Mac Central European Roman Central European (ISO Latin 2) Central European Roman (Windows) and the %!TEX encoding = *** abbreviations are IsoLatinGreek Mac Central European Roman ISOLatin2 WindowsCentralEurRoman • In %!TEX encoding = %!TEX root = %!TEX TS-program = %!TEX projectfile = allow a space between % and ! for better formatting, and to remove %! postscript ambiguity. The old syntax without the space is, of course, also supported. • Added code by Adam Maxwell to permit BibDesk Completions; this is controlled by a new Preference Setting. By default, it is not activated. • Fixed French nib file so Typeset menu works again (there are no longer simultaneous checks on "PdfTeX" and "TeX \& Ghostscript"). • Fixed tab settings, so now changing tab spacing in Preferences works correctly. • Command-T now typesets even when the console window is active. • Fixed pdf updating. If a user has an external editor and uses TeXShop to display pdf output, and if the "Automatic Preview Update" preference is set, then whenever the pdf file is updated, TeXShop reads and displays the latest version, activating the pdf window when it does so. There is a hidden preference item named "BringPdfFrontOnAutomaticUpdate". If this is set to "NO", then the preview window is supposed to be updated but not brought forward. Recently, the preview window did this, but didn't display the new content until the user manually activated it. This is fixed. • Instead of separate commands to display each of George Gratzer's symbol tables, there is one command to display all of the tables in one document. It is much easier to find a symbol if you can scroll through tables rather than guessing which table has the desired symbol. • Modified default LaTeX macros to bring them up to date. Changes in TeXShop 2.15 TeXShop 2.15 was an experimental release. It lived for a long time on my personal web page with a promise to migrate it to the usual TeXShop site. After the promise didn't materialize for several months, the link on my personal site was noticed by Version Tracker, and for several months that system pointed to the experimental 2.15 as the latest release. At last 2.15 has become "official" with the release of TeXShop 2.18. Here is a list of new features: • Fixed severe memory leakage on Leopard; said another way, the hidden preference item ReleaseDocumentClasses is now automatically set correctly on Leopard. This very significant bug, which I listed for a long time as the most significant bug in TeXShop, was caused by an Apple bug in PDFKit. This bug is fixed in Leopard. Consequently, users must be running System 10.5 to obtain the fix. • Fixed pdf drag and drop on Leopard. In earlier versions on Leopard, a dragged pdf selection had a white background, making the feature problematic for Keynote and other programs. Now a dragged pdf selection has a transparent background, as it always did on Tiger. • Support for the Hiero package, used to typeset hieroglyphics. See http://www.filipvervloesem.be/hierotexmac/ and the detailed explanation on http://www.filipvervloesem.be/hierotexmac/hierotex.html. • Support for Sketch, used to construct 3D images in pdf files. See www.frontiernet.net/~eugene.ressler/. • Generalizing the last two items, support for adding additional extensions to the list of filetypes which can be processed via TeXShop engines. • The default templates now include a template for Beamer taken directly from the beamer web page. To see it, move the folder ~/Library/TeXShop/Templates to the desktop and restart TeXShop. The default Templates folder will be created. Merge your old Templates folder in with the new one. Here are more details on each of these items. • When TeXShop was first released on Tiger, users ran into an annoying bug which caused the program to gradually slow to a crawl after several typesetting actions. The problem occurred when a new pdf file was loaded into PdfKitView for the Preview window. According to Apple documentation, this should have released the previous data from memory. The release did occur, but it caused the program slowdown. To fix this problem, I added code to TeXShop which tricked the system into believing that the old data structures were still being used so the system didn't try to release them. This meant that TeXShop gradually used more and more memory over time, and it caused other problems as well. In notes to collaborators, I called this "the single most important bug in the program." This was really a PDFKit bug. But although I have reported several bugs to Apple (and they have been very good about fixing them), I didn't report this problem because I needed to make a small demo program illustrated the bug, and never got around to it. When system 10.4.3 was released, it looked to me like the problem was resolved, and I modified the TeXShop code to release memory on 10.4.3 and higher. Unfortunately, it soon became apparent that the problem remained, particularly for large pdf files. Luckily, I had added a hidden preference to TeXShop called "ReleaseDocumentClasses"; the value of this preference could be 0 to release the data on system 10.4.3 or higher 1 to never release the data 2 to always release the data Initially the default value of this preference was 0, but I soon changed it to 1, restoring the old "kludge behavior." But when Leopard came out, several users reported that this preference can safely be set to 2. Further testing showed that the PDFKit bug was fixed in Leopard. Therefore, in TeXShop 2.15 the data is always released on Leopard, regardless of the value of ReleaseDocumentClasses. The old behavior still applies on system 10.4.11 and earlier. But just in case, there is another hidden preference called ReleaseDocumentOnLeopard. The default value of this preference is YES. If it is set to NO, the old preference ReleaseDocumentClasses becomes active and behaves as before. • TeXShop has the ability to select a portion of the pdf image, copy the selection, and paste it into another program. Users can also drag the selection directly to another program. Before the program LaTeXiT was introduced, this feature was often used, but now LaTeXiT is usually the better way to proceed. The file format of the copy is controlled by TeXShop preferences; the default value is to copy as pdf with a transparent background, making it easy to use the result in Keynote and similar programs. This feature broke in the beta version of Leopard which Apple released at the 2007 Developer Conference. Later I managed to modify my code and fix the problem. But in the release version of Leopard, my fix also broke. At the developer conference I spoke to the author of PDFKit, who recommended a different fix. That fix is now in TeXShop 2.15. The old code used the NSView method "dataWithPDFInsideRect" directly in the PDFKit View. Before calling this method, it set the background color of the image in PDFKit to be transparent, and it also modified the PDFKit "drawPage" method to skip drawing a background when drawing for a selection. However, PDFKit in Leopard seems to have additional drawing layers which make the individual pages of an image stand out, and these layers add their own backgrounds. The new method uses PDFKit's page object and the routine "dataRepresentation"', which I learned at the developer conference does not include background information. This data is then placed in a NSPDFImageRep object, imaged in an offscreen NSView object, and captured with the object's "dataWithPDFInsideRect" method. There is a slight change when copying and dragging selections. Earlier, a selection could span more than one page. Now the copy will only include the portion of the selection which is on the page under the cursor. By the way, this fixes the last TeXShop Leopard bug known to me. • TeXShop now contains an engine file in .../Library/TeXShop/Engines/Inactive for use with the Hiero package. An additional README in the folder explains how to install Hiero. The Hiero ".htx" extension is now recognized by TeXShop, and an icon for such files is provided. To obtain this engine, it is necessary to move the folder ~/Library/TeXShop/Engines elsewhere, say to the desktop. Then restart TeXShop. The program will create a new Engines folder, containing the new inactive items. Then merge the Engines folder on the desktop into this new default Engines folder. • The same directory contains an engine file for Sketch. An additional README in the folder explains how to install Sketch. The ".sk" extension is now recognized by TeXShop. • The previous two items are special cases of a general problem. A number of users have tried to use TeXShop's engine mechanism to process a source file and preview the resulting pdf output in cases where the processing engine isn't TeX at all, but rather some other Unix binary program. In many of these cases the source file has a new extension; for instance, ".htx" in the Hiero case, and ".sk" in the Sketch case. There are two problems with this technique, one minor and one major. The minor problem is that when TeXShop creates a file, it always adds an appropriate extension, usually ".tex". In the Save dialog there is a pulldown menu listing all extensions known to TeXShop. By using this menu, files can be created with other extensions like ".ltx", ".ctx", and so forth. But if an extension is not in this list, creating it within TeXShop is tricky. Users often try to directly type an extension, saving for example a file with name "myfile.htx". But actually TeXShop will then create "myfile.htx.tex" and even worse, the Finder may then hide the ".tex" extension. Luckily, there is a solution. One of the file types which TeXShop can save is named "Plain Text Document". Such a file has no extension. So if the user saves "myfile.htx" after selecting the "Plain Text Document" dropdown menu item, they actually will get "myfile.htx". The good news is that when TeXShop opens a file with an unexpected extension, say by dragging the file to the TeXShop icon, it will preserve the correct extension when saving. So this first problem is a minor problem during file creation, but it doesn't interfere with later processing the file. The major problem is that TeXShop deactivates the "Typeset" button when a file is opened with an unknown extension, or with an extension which is not used by source files. For example, TeXShop can open pdf files and jpg files, but it doesn't allow the user to typeset such files! Users who wanted to process ".htx" and ".sk" files with an engine found that they could not use the engine because of this behavior. TeXShop 2.15 has a new mechanism for such users. A hidden preference allows users to add extensions to the list of legal extensions which activate the Typeset button. For example, the command defaults TeXShop OtherTeXExtensions -array-add "htx" adds ".htx" to the list. To clear the list and start over with the built-in defaults, use defaults TeXShop OtherTeXExtensions -array Actually, ".htx" and ".sk" are now built-in, so these users do not need the new mechanism. But it is available for future users. • The Beamer template can certainly be improved. I'd appreciate help from experts. Changes in TeXShop 2.14 • The "Cancel" and "OK" buttons work again in the Line dialog, Project dialog, and Print Source dialog. • New French, German, Japanese, and Spanish localizations. • The "altpdftex" default in the Preference dialog is changed to the correct "simpdftex" default. • If a Help document is already open, it is now correctly brought to the front when chosen. • With the help of Herbert Schulz, the help file "First Steps with General Typesetting" has been typeset with XeLaTeX. • In previous versions, when a file was opened for external editing or when a graphic file, ps file, or dvi file was opened, the file was first read as a text file even though the text window was not displayed. This significant bug is fixed. One result is that graphic files open much faster. Changes in TeXShop 2.13 • The above text asserts that "previously the 'Document Font' preference for the source file was not respected when the file was opened later. Fixed." Actually, this bug was only fixed on Leopard. Now it is also fixed on Tiger. • Pdfsearch (i.e., sync) from the Source window to the Preview window broke in 2.12. Fixed. • Command completion broke in 2.12. Fixed. Changes in TeXShop 2.12 • Version 2.12 is no longer a beta. "Check for Updates" will again work because the actual release number will change with each new release. • Version 2.12 works on both Tiger and Leopard. It fixes all known Leopard bugs. This is a key goal of the release. We intend to test the program on future Leopard betas and fix any new Leopard bugs immediately. • The following bugs on Tiger are also fixed: • Previously if a user's "Save Related Files" preference item was checked, and a source file included the line \input myfile.tex the program would enter an infinite loop during typesetting. Fixed. • Previously the "Document Font" preference for the source file was not respected when the file was opened later. Fixed. • Previously if a file with a medium sized source file was opened, there was a delay before it appeared on the screen. Fixed. • Previously if a file had a very large source file (book length), it took a long time to load. During that time, any interaction with the source would lead to a spinning cursor and ultimately a crash. Some users got in the habit of opening the file and then getting coffee, since it was difficult to tell when loading ended. This significant bug is fixed. • The keyboard shortcuts Apple-plus and Apple-minus (without the shift key) zoom in or out on the Source window's contents. The keyboard shortcuts Apple-plus and Apple-minus (with the shift key) zoom in or out on the Preview window's contents. Incidentally, on Leopard this version also zooms in and out on the Preview window's contents using these shortcuts without the shift key, so the same shortcuts work on both the Source and Preview windows. • The keyboard shortcuts for Rotate Clockwise, Rotate Counterclockwise, and Latex Panel were changed to make way for these zoom shortcuts. • A "Fullscreen" menu command has been added. Selecting it puts the Preview window in fullscreen mode. It is possible to page through the document using the arrow keys, or using spacebar and shift-spacebar. The mouse is active, so hyperlinks and Beamer controls work. To exit this mode, hit the ESCAPE key. This command is useful for users who work with Beamer slides, allowing them to display the slides with a projector directly in TeXShop. • A surprising number of users do not use the Source and Preview preferences "All Windows Start at Fixed Position." To encourage the use of these preferences, we added an item "Save Source Position" to the Source menu and added an item "Save Preview Position" to the Preview menu. The user should position Source and Preview windows as desired and select these items to make TeXShop always use these positions in the future. With this addition, most users will not need to open the Preference Pane when they start using TeXShop. • We substantially revised the Help menu. This is a work in progress; the infrastructure is now present, but the contents can be improved. • The items in this menu have been divided into groups. The first is about TeXShop, the second about General Typesetting, and the third about Mathematical Typesetting. • In the TeXShop portion, a short document tells beginners everything they need to know to begin using the program. This is followed by two Movies which illustrate TeXShop use. Finally, the old Help panel is provided for advanced users. • The General Typesetting section currently contains only a short document about XeTeX. It should later be expanded with a manual teaching key points of non-mathematical typesetting. • The Mathematical Typesetting section has a short introductory document. But with George Gratzer's permission, this is followed by his complete Short Course, the first section of his new book about LaTeX and AMSTeX. George also allowed us to include the various symbol tables from the appendices to the book. We appreciate these wonderful contributions! • The number of movies for TeXShop could later be expanded, and movies could be added to the General Typesetting and for Mathematical Typesetting sections. The basic Movie mechanism behaves like Templates. TeXShop stores movies in ~/Library/TeXShop/Movies/TeXShop. If a user adds movies to this location, they will be listed in the TeXShop Help menu the next time TeXShop starts. This makes it possible to distribute additional movies over the web. We also experimented with streaming movies, but want to shy away from these because we have no natural streaming server. Changes in TeXShop 2.10 Beta 10 • Addede a new feature requested by George Gratzer. When extensive index items are added at the end of a book project, the source code becomes difficult to read. TeXShop now has an optional checkbox toolbar item for the source code window; when the box is checked, index items are colored yellow. This yellow color makes index items almost invisible and the remaining source becomes readable again. To make index items visible, uncheck the toolbar item. • The yellow color applied to to index items in this manner can be changed by hidden preferences "indexred", "indexgreen", and "indexblue". For example, to change yellow to green, issue the commands defaults write TeXShop indexred 0.0 defaults write TeXShop indexgreen 1.0 defaults write TeXShop indexblue 0.0 • Fixed a bug which caused TeXShop to crash when windows were closed. This bug was intermittent; some users never experienced it and others experienced it daily. • Fixed a bug in which the Comment and Uncomment menu items failed to work if the cursor was at the beginning of a line. • New Japanese Menu localization Changes in TeXShop 2.10 Beta • TeXShop 2.10 Beta marks the switch to Max Horn's code cleanup. This code will be much easier to maintain. Syntax coloring code has been greated improved, and there are many other improvements. • Inevitably, bugs were introduced in the cleanup. For example, for a brief time applescript ceased to work. New beta versions were introduced to fix these bugs without a detailed change history. • Starting with 2.10beta10, the change history will be kept up to date. We expect the program to step out of beta status very soon. The following change was made to TeXShop 2.09d • Fixed a bug when opening jpg and other image files while the default encoding is UTF-8. The following change was made to TeXShop 2.09c • ScriptRunner, an internal TeXShop application which runs applescripts, is now a univeral binary. The following change was made to TeXShop 2.09b • The OgreKit Find Panel Framework has been replaced with the latest universal binary version, 2.1.2, from the OgreKit site. This fixes several problems in the previous version when run on Intel processors. The following changes were made to TeXShop 2.09a • After typesetting, TeXShop leaves the scroll position fixed rather than scrolling to the top of the page. • Double clicking on a bracket like (, {, [, ], }, or ) selects all text between the bracket and its matching pair. Double clicking on a bracket with the option key down selects just the bracket. The following changes were made to TeXShop 2.09 • The ISO Latin 9 encoding was broken; now it is fixed. • New menu items were localized in German and Japanese • The hidden preference to keep backup files of source documents was incorrectly described in help as requiring "SaveBackup" rather than the correct "KeepBackup". This section of help is fixed. To keep backup files, type the following in Terminal: defaults write TeXShop KeepBackup YES • A new hidden preference causes the drawer to be open when Preview windows are first opened: defaults write TeXShop PreviewDrawerOpen YES • A new hidden preference adds additional automatic tags for ConTeXt users. Currently lines beginning with \chapter, \section, \subsection, and \subsubsection are automatically added to the Tags pulldown menu. If this preference is chosen, lines beginning with \subsubsubsection, \subsubsubsubsection, \part, \title, \subject, \subsubject, \subsubsubject,\subsubsubsubject, and \subsubsubsubsubject are also added. defaults write TeXShop ConTeXtTags YES • TeXShop Help has a new section explaining how to make and use TeX formats. • A user wrote complaining that dvips could not find figures references in the parent directory as ../figures/xxx.eps during typesetting in tex + ghostscript mode. Gerben Wierda told him that this is a change in the default behavior of dvips because the old behavior was insecure. To return to the old behavior, modify the TeX + dvips + distiller preference in TeXShop Help under the Engine tab to simpdftex latex --maxpfb --extradvipsopts "-R0" The following change was made to TeXShop 2.08 • In a copy of 2.07 temporarily on the network, conversion of eps files to pdf files was done with ps2pdf rather than the usual epstopdf. This was a mistake and was rapidly fixed. It is fixed in this version. • In the German localization, the "Default Command" preference under the Typesetting tab was not connected. Fixed. • In the German localization while using the German keyboard, the apple-{ shortcut for commenting failed. To fix this, the shortcuts for comment and uncomment in this version are apple-3 and apple-4. This change is only made in the German localization. • If the "select tool" was chosen in the Preview window and the user switched to the source window with apple-1 and then typeset, the select tool would no longer be selected when the Preview window became active again. This is fixed. • The "Insert Reference" macro failed because the first line was "--Applescript direct" rather than "--Applescript" This is fixed for new users, but TeXShop macros are not changed when users upgrade because they made have modified the macros. So users need to make this change on their own. The following change was made to TeXShop 2.07 • Some users still report a spinning beachball, so we revert back to the default value of "1" for the hidden ReleaseDocumentClasses preference. Users who installed 2.05 or 2.06 during the 12 hours it was on the network need to type the following command in Terminal: defaults write TeXShop ReleaseDocumentClasses 1 The following changes were made to TeXShop 2.06 • Removed Indent, Unindent, Back, and Forward key shortcuts from non-English localizations of Menu.nib. • Now includes TeX-mdimporter 1.2, which fixes a memory leak in the original. • Recommended the "Set Default Values" button in Preferences The following changes were made to TeXShop 1.43 • The ISO Latin 9 encoding was broken; now it is fixed. • The "Check for Updates" menu item code had an error. If the user was running on a pre-Tiger system, it correctly looked only for updated versions of TeXShop 1. If such a version was found, it correctly reported the new version it would download. But then it actually downloaded the Tiger version. This is now fixed, but it doesn't fix versions of TeXShop earlier than 1.43, of course. (Note that this command on TeXShop Version 2 has always worked.) • The hidden preference to keep backup files of source documents was incorrectly described in help as requiring "SaveBackup" rather than the correct "KeepBackup". Thus to keep backup files, type the following in Terminal: defaults write TeXShop KeepBackup YES Versions 1.42 and 2.05 add new features and fix several bugs: New features in 2.05: • TeXShop 2.05 is now a Universal Binary, containing code for both the PowerPC and Intel processors. The system automatically runs the correct version of the code. • The default TeXShop preference for the teTeX binary directory is /usr/local/teTeX/bin/powerpc-apple-darwin-current. But if users have installed Gerben Wierda's latest TeX redistribution, they also have Intel binaries. On Intel machines, the teTeX binary directory should then be /usr/local/teTeX/bin/i386-apple-darwin-current. TeXShop now has code to make this change automatically. When the program first starts, it calls "uname -p" to determine the current processor. If the result is "i386", then TeXShop permanently changes the above preference to /usr/local/teTeX/bin/i386-apple-darwin-current. However this change is not made if the user has manually changed the default /usr/local/teTeX/bin/powerpc-apple-darwin-current to some other location. Thus if a user has the Fink teTeX distribution or some other distribution and has set the teTeX binary directory preference to point to it, the preference will not be changed. • When TeXShop was first released on Tiger, users ran into an annoying bug which caused the program to gradually slow to a crawl after several typesetting actions. This bug was fixed a couple of days after the release. The problem occurred when a new pdf file was loaded into the PdfKitView in the Preview window. According to Apple documentation, this should have released the previous data structure from memory. The release did occur, but it caused the program slowdown. So the bug fix consisted of tricking the system into believing that the data structures were still being used so the system didn't try to release them. A side effect was that memory gradually filled up and some users learned that they needed to quit TeXShop and restart after each day's work. Recent investigation seems to show that this bug is fixed in Tiger 10.4.3. Consequently the latest version of TeXShop tests which system is running and releases the old data structures when the system is at least 10.4.3, but not otherwise. This behavior is controlled by a new hidden Preference item: • defaults write TeXShop ReleaseDocumentClasses 0 The default value is 0, causing the program to behave as just described. If the value is 1, the old data structures are never released and the program behaves exactly as earlier versions of TeXShop 2. If the value is 2, old data structures are always released. Thus if you find that the program becomes sluggish after several typesetting jobs, change ReleaseDocumentClasses to 1 and then report the behavior to me with as many details as possible. • Michael Witten, a student at MIT, added multiple wrapping modes to TeXShop. Users can choose "no wrapping" so lines continue right until the user pushes ENTER, or "word wrapping" so text is wrapped at word boundaries (this was the prior behavior), or "character wrapping" so text wraps exactly at the last possible character. Not that these wrappings are "soft"; resizing the window will change the wrapping. The default wrapping is "word wrapping" but a menu command allows the wrapping to be changed. Moreover, a hidden preference allows the default wrapping to be changed: • defaults write TeXShop LineBreakMode 1 where "None" = 0, "Word Wrap" = 1, and "Character Wrap" = 2. Wrapping is done at the right side of the window unless the ruler is active; if it is, wrapping is done at the "right marker" • Witten also added the command "Hard Wrap". If a paragraph is selected, this command inserts hard wrapping commands at the right side of this paragraph. After this step, resizing the window leaves the wraps fixed. This is useful if you send source to a colleague whose editor has fixed width and no wrapping. If the "Hard Wrap" command is chosen but no selection has been made, the hard wrap applies to the entire document. Note that "Hard Wrap" is undoable. • The TeXShop Application Bundle now contains Norman Gall's TeX-mdimporter Spotlight importer. Files with extensions .tex, .latex, .ltx, .ctx. and .texi will be indexed by Spotlight when saved. In systems 10.4 through 10.4.2, TeXShop files were automatically indexed because they have type TEXT, but Apple changed this procedure in 10.4.3. So the importer is now required to index files. The system automatically recognizes the importer when TeXShop is first installed. It is then used to index .tex, .ltx, etc. files even if TeXShop is not running. If Gall later updates the importer and you install the new version in ~/Library/Spotlight or other canonical spots, the updated version will be used rather than the version in the TeXShop bundle because Apple's importer search routines use importers in bundles as a last resort. Gall's importer was not written with TeXShop in mind, but is instead designed to be used by all TeX editors and front-ends; the hope is that there will be a universal importer rather than a different one for each front end. For the latest version, see http://www.spookyhill.net/~gall/latex. • The commands "altpdftex" and "altpdflatex" in Gerben Wierda's TeX distribution have changed to "simpdftex tex" and "simpdftex latex". These are now the default preference values for new TeXShop installations. Moreover, the first time a user tries to typeset in the "tex + ghostscript" mode, TeXShop will check these preference items, and change them if necessary. It does this by determining whether "simpdftex" is in the TeX binary directory. If so, and if the command in the TeX + dvips + distiller "TeX Program" field in the TeXShop Engine Preferences is "altpdftex", then this field is changed to "simpdftex tex". Any additional flags in the preference field are retained. At the same time, the "Latex Program" field is changed. If it is "altpdflatex", it is changed to "simpdftex latex", retaining any additional flags. • Added ISO Latin 9 encoding • Now (apple)-[ and (apple)-] act differently in the editing window and preview window. In the editing window they are "unindent" and "indent". In the preview window they are "back" and "forward". A disadvantage is that it was not possible to add these commands to the menus, so users need to remember these abbreviations. This change was requested by users with German and other keyboards on which (apple)-< and (apple)-> cycle through windows. Users with English keyboards cycle through windows with (apple)-. • Added a new hidden preference • defaults write TeXShop LeftRightArrowsAlwaysPage YES The default value is NO. When set to YES, the left and right arrows scroll by a page even if the horizontal school bar is active. • Changed the English under the Preview tab of Preferences from "After Window Review" to "Magnification Style" and changed "Preview Window Magnification" to "Preview Window Fixed Magnification" to more carefully explain the function of these preference items. Notice that TeXShop only uses the Preview Magnification value if the Magnification Style has been set to "Fixed Magnification". • Added a new item • %!TEX projectfive = which can be added to the top of TeX source files. This change is primarily for ConTeXt users so they can use the new sync method. When synching from the preview window to the source window, TeXShop needs to know all sources file for the document being previewed so it can open source files not currently open if necessary. It does this by parsing the root document, looking for \include and \input lines. But ConTeXt uses different commands to input files. The new syntax allows ConTeXt users to directly indicate in the root document which additional source files need to be searched. Here are examples: • %!TEX projectfile = /Users/koch/MyDoc/chapter1.tex • %!TEX projectfile = chapter2.tex • %!TEX projectfile = ../chapter3.tex • Added .Rnw as an extension TeXShop can edit. This was a request of Paolo Bosetti, who uses TeX and R and Sweave together. • When a user tries to open a .dvi file, TeXShop runs a script to convert the dvi file to a pdf file. In previous versions, it ran a different script when the .dvi was in a writeable directory than when its directory was not writeable. But Gerben Wierda has revised the simpdftex script to handle both cases, so now TeXShop always calls simpdftex to do the conversion. Actually it calls the TeX + dvips + distiller script which is set in Preferences; this preference will be simpdftex if the user has a fairly recent TeX distribution. • Added a new hidden Preference • defaults write TeXShop RedConsoleAfterError NO If this default is YES, then after the first error the remaining text in the console will be red. The default value is NO. • Slightly modified the appearnce of the Console window, particularly in English. More work is needed here. Note that the console window can be resized and relocated, and the system will remember this new size and location when TeXShop is restarted. • In version 2.05, fixed "undo past a save" using the new Tiger command [textView breakUndoCoalescing]. Previous versions of TeXShop allowed users to undo past a save command. But this required "tricky code" and one effect of the trick was that TeXShop sometimes lost track of whether the current state of the document had previously been saved, and so didn't save the document before typesetting, giving strange results in the preview window. • Versions 2.00 through 2.04 of TeXShop sometimes had trouble remembering new preference settings; it was necessary to set them several times before they "took." This is fixed. New features in 1.42 and 2.05: • The commands "altpdftex" and "altpdflatex" in Gerben Wierda's TeX distribution have changed to "simpdftex tex" and "simpdftex latex". These are now the default preference values for new TeXShop installations. Moreover, the first time a user tries to typeset in the "tex + ghostscript" mode, TeXShop will check these preference items, and change them if necessary. It does this by determining whether "simpdftex" is in the TeX binary directory. If so, and if the command in the TeX + dvips + distiller "TeX Program" field in the TeXShop Engine Preferences is "altpdftex", then this field is changed to "simpdftex tex". Any additional flags in the preference field are retained. At the same time, the "Latex Program" field is changed. If it is "altpdflatex", it is changed to "simpdftex latex", retaining any additional flags. • Added ISO Latin 9 encoding • New German localization and help files. • New Japanese Help by Yoshihisa Okazaki with help from Seiji Zenitani. • New Spanish help files and localization. • Uses version 1.2.4 of OgreKit. • Conversion of eps, ps, and dvi files to pdf (caused by opening such a file) now works even if the path to the file has folders whose names contain spaces. In all three cases, the file can now be in a folder without write permission. • Trash AUX files now removes files with more extensions: cos, idv, 4ct, 4tc, lg, xref, ttt, fff, ent, wrm. • If the user tries to open a file with UTF-8 Unicode encoding, but the file is not a legal utf8 file, a dialog now appears warning of the problem, and the file is opened with MacOSXRoman encoding. • Bib files are promoted to full class citizens; text can be dragged to them, syntax coloring works, etc. • A remark: users have reported that they can no longer "find" words in the console window. Actually, they can. This window has two portions. When typesetting ends, the bottom portion is active, so the find panel searches that portion. To activate the top, click on it. Then "find" works. • Added a preference to control first mouse behavior: "Select on Activate." When this is YES, a click in the source window will also set the insertion point to the click point. If it is NO, a second click is required to change the insertion point. • Added pdf to the types of files TeXShop can edit, and added a pdf icon. This allows TeXShop to be chosen as the default pdf viewer. • Added Lilypond, abc, and bst as extensions that can be edited. • Added code by David Reitter so that selecting the word \int, etc., selects the beginning "\" as well. Bugs fixed in 1.42 and 2.05: • Japanese Image Copy Type Preference failed due to incorrect localization. Now fixed. • Command Completion's configuration file is now loaded and saved in UTF-8 Unicode. • Errors fixed in pdfsync. • When typesetting engines are called, they are now passed the program filename with extension, rather than just the filename. • In 1.35, it was only possible to switch between the OgreKit Find panel and the Apple Find panel in the English localization. This is fixed. • The menu item to bring up the statistics panel was only in the English version. Now it is in all versions. • In all display modes except single page mode, a black border is drawn around each pdf page. Previously this border was slightly inside the page, cutting off a slight border around the page. Now it is just outside the page. Thanks to Scott Ranby for pointing out this error. • The "%!TEX TS-program" and "%!TEX root =" commands now when when used with an external editor. Changes in 1.41 and 2.04 • These versions of TeXShop are in the first release of the TeX install package MacTeX.pkg, but were never otherwise released. Changes in 2.03 • Improved the PDFsearch code (i.e., sync) for \include{file}, \input{file}, and \import{file}. Users who had trouble using sync with large projects may find that it works now. • When the Find panel is opened with command-F, the previous search phrase is now hilighted so users can erase it by just typing a new search phrase. • Command-left-arrow and command-right-arrow perform page up and page down when the Preview window is open, but they now move the editor to the start or end of the current line, restoring a keyboard shortcut which was inadvertently broken in 2.01. • New Spanish localization and Spanish Help by Juan Luis Verona. • Additions to the German localization by Martin Kerz. Changes 1.40 • When the Find panel is opened with command-F, the previous search phrase is now hilighted so users can erase it by just typing a new search phrase. Changes in 2.02 • Added command left arrow for previous page, command right arrow for next page, command [ for back, and command ] for forward. These keyboard shortcuts are also used by Apple's Preview. To make room for these shortcuts, the shortcuts for indent and unindent were changed to command < and command >, and the shortcuts for comment and uncomment were changed to command { and command }. • The left and right arrows scroll left and right if the horizontal scroll bar is active, but page up and down otherwise. This behavior copies the behavior of Apple's Preview. • When the cursor is over a link in the Preview window, clicking on the link will activate the link regardless of the active tool at that moment. • The magnification toolbar item and page number toolbar item now have no surrounding outline, so they shrink to small size and look cleaner than before. • Enlarged the number of files searched by the new sync method from 20 to 60. • Fixed OgreKit permissions. • Japanese Localization by Yoshihisa Okazaki. Changes in 1.39 • Japanese Localization by Yoshihisa Okazaki. • Spanish localization by Juan Luis Varona Malumbres. • Fixed OgreKit permissions Changes in 2.01 • A missing default preference caused the background color of the pdf window to be black. This is fixed. • The beachball could appear after typesetting a document, causing a substantial delay before the editor became accessible. Fixed. • The preference to set the location and size of the preview window broke. Now fixed. • Changing the default magnification did not immediately change the magnification in open windows. Fixed. • Dragging a portion of text from one spot of the source to another broke. This is fixed. • TeXShop and TeXShop Help are now localized in German. • The twelve point book heading macro contained a spurious letter. This is fixed for new users, but other users need to remove the letter using the Macro editor. Changes in 1.38 • Dragging a portion of text from one spot of the source to another broke in Tiger. This is fixed. • Minor additions were made to the German localization. • The twelve point book heading macro contained a spurious letter. This is fixed for new users, but other users need to remove the letter using the Macro editor. New Features in 2.00 • A new synchronization method has been added to TeXShop, using the ability in Tiger to search for strings in pdf files. The new method does not require including a pdfsync.sty file, so it works out of the box on files typeset using any engine: pdftex or pdflatex, TeX + ghoscript or LaTeX + ghostscript, XeTeX, and other engines. • Click on a word or phrase in the source file. TeXShop will scroll the preview window to the corresponding phrase and circle it in red. Click on a word or phrase in the preview window. TeXShop will open the corresponding source file if it is not already open, scroll the source to the appropriate spot, and highlight the source phrase in yellow. • A new TeXShop preference item selects the synchronization method to be used: the old pdfsync method, the new search method, or a combination in which the new search is used, but the program falls back on pdfsync if the new search does not succeed. • Version 2.00 uses PDFKit, which is new in system 10.4 (Tiger). Consequently it requires Tiger. Version 1.37 contains all changes in 2.00 except those which depend on PDFKit. If serious bugs are found in 1.37, they will be fixed in updates: 1.38, 1.39, etc. However, TeXShop development from this point on will build from the 2.00 version, and updates to 1.37 beyond bug fixes are unlikely. • TeXShop supports hyperlinks. To activate this feature, add the line • \usepackage[colorlinks=true, pdfstartview=FitV, linkcolor=blue, citecolor=blue, urlcolor=blue]{hyperref} to the heading of the source document. Links to external web sites can then be added to tex documents using commands like • \href{http://www.uoregon.edu/~koch/}{Koch homepage} Links to other portions of the tex document can be added using commands like • \hyperlink{lemniscate}{Graph of Lemniscate} where the tag "lemniscate" is created using a command like • \hypertarget{lemniscate}{} To navigate with these links, choose the new "text" tool and clink on the colored links. • The preview window toolbar contains "Back" and "Forward" buttons so one can jump to a spot using a link, and then jump back. • Hyperref.sty automatically adds links to citations, so readers can rapidly jump from a citation to the corresponding bibliography entry. • The hyperref package also creates a document outline. For example, the main outline of a book is a list of chapters; each chapter entry contains a list of sections, and so forth. To see this outline and navigate through the document with it, use the new "drawer" tool to display the pdf window's drawer. • The text tool can be used to select a portion of text in the preview window and copy this selection to an editor. This differs from the "pdf selection tool" which copies a portion of the document as a pdf illustration --- the text tool copies editable text. • Searching the pdf preview is supported. Use the search tools in the bottom half of the window's drawer. • PDFKit brings additional polish to the display of pdf documents. It supports documents with isolated rotated pages, and correctly prints rotated pages in landscape mode. It supports liveupdate of window resizing if the magnification preference is set to "fit to window." Etc. New Features in 2.00 and 1.37 • The remaining new features are available in both new versions. • Earlier versions of TeXShop allowed users to set the typesetting engine of a file, its encoding, and its root file by adding appropriate comments to the top of the source file. For example, the following commands set the typesetting engine to xelatex, the encoding to UTF-8 Unicode, and the root file to ../Main.tex: • %&xelatex • %&encoding= UTF-8 Unicode • %SourceDoc ../Main.tex But this syntax was a mistake because the symbols "%&" are reserved for the use of TeX. • In versions 1.37 and 2.00 of TeXShop, the syntax has been changed to the following: • %!TEX TS-program = xelatex • %!TEX encoding = UTF-8 Unicode • %!TEX root = ../Main.tex It you used the earlier facility, you need to change your old source files to the new syntax. I'm very sorry to cause this work, but the change is really necessary. This syntax is mentioned in the description of version 1.35, but this change was not actually released until this version. • If you are in the middle of a project and cannot make the change now, you can temporarily set a hidden preference to revert to the old syntax. To do so, open Apple's Terminal program and type • defaults write TeXShop UseOldHeadingCommands YES Once this is done, the new commands will be recognized but the old commands will also work. However, I recommend turning this preference off as soon as possible. • Commands have been added to the default Macros menu which insert the symbols "%!TEX TS-program = " and "%!TEX encoding = " and "%!TEX root = " into the source document; new users will see these entries. Users who are upgrading can easily add these symbols as well. To add the program entry, choose "Open Macro Editor" under the Macro menu. Click the "New Item" button, name the item "Program" and set its content to • %!TEX TS-program = #INS# Repeat for the "Encoding" and "Root" items. • Martin Kerz added a "Check for Updates..." command to TeXShop. • Martin Kerz also designed the new TeXShop web page. Thanks! • OgreKit for searching has been upgraded to the latest 2.0.1 version. • Additional filetypes can be edited, including files with extensions "abc", "bst", "bib", "lp", and "pdf". The addition of "pdf" allows TeXShop to be chosen as the default pdf viewer. A new pdf icon has been created so the system can use it on pdf files it will display in TeXShop. • David Reitter modified the selection code so if the user clicks on a control word like \gamma, the initial "\" symbol will also be chosen. • A new preference item "Select on Activate" was added. When this item is checked, a mouse click on the text window will select this window and also place the cursor at the spot that was clicked. If the item is not checked, the initial mouse click will only activate the window. A separate click is then needed to position the cursor. • New hidden preferences were added for users who change the default foreground and background colors of the editing window. These preferences set the color of the insertion point (without these preferences, the insertion point could become invisible). To set the insertion point to white, for example, • defaults write TeXShop insertionpoint_R 1.0 • defaults write TeXShop insertionpoint_G 1.0 • defaults write TeXShop insertionpoint_B 1.0 • Recall the defaults to set the text foreground color in the editing window (introduced already in 1.35) • defaults write TeXShop foreground_R 0.3 • defaults write TeXShop foreground_G 0.3 • defaults write TeXShop foreground_B 0.3 • Also recall the defaults to set the text background color in the editing window (introduced already in 1.28) • defaults write TeXShop background_R 0.42 • defaults write TeXShop background_G 0.39 • defaults write TeXShop background_B 0.77 • When a file is typeset, all open changed files with the same root are first saved. • In previous versions, it was possible to add a Macro button to the Preview Window Toolbar in English, but not in other localizations. This is fixed thanks to Juan Luis Varona. • New Japanese Help by Yoshihisa Okazaki with help from Seiji Zenitani. • A proxy icon is now added to the title of the preview window. This icon can be dragged to the desktop or other folders to create a copy of the pdf file. The source window has always had a proxy icon. Thanks to Rene Donner for suggesting this feature and explaining how to implement it. • TeXShop has always had a "Revert To Saved" item under the File menu, but it has never worked! Sorry. This is fixed. • Improvements were made in the pdfsync code. • If the user tries to open a file with UTF-8 Unicode encoding, but the file is not a legal utf8 file, a dialog now appears: • This file is not encoded in UTF-8 Unicode. The file has been opened with MacOSRoman encoding. If that is not correct, close it and open again with an appropriate encoding. • This change is mainly for people trying to open a fine with UTF-8 Encoding when the file was not coded for UTF-8 Unicode. A random collection of bytes will almost never be a legal UTF-8 Unicode file. Note that usually TeXShop cannot tell the correct encoding for other encoding defaults. For example, a Latin1 file will open fine in MacOSRoman encoding, though some of the letters may be wrong. • New Spanish help files and localization • bib files are promoted to full class citizens; text can be dragged in them, syntax coloring works, etc. • This is a remark rather than a bug fix. Users have reported that they can no longer "find" words in the console window. Actually, they can. This window has two portions. When typesetting ends, the bottom portion is active, so the Find panel searches that portion and beeps when it finds nothing. To activate the top, click on it. Now Find works. • Japanese Image Copy Type Preference didn't work, due to incorrect localization. Now fixed. • Command Completion was repaired; the configuration file is now loaded and saved in UTF-8 Unicode, and the first line of the file, opened with Format --> Completion --> Open Completion File, is • %!TEX encoding = UTF-8 Unicode • Users who are upgrading and work with unicode scripts should select the menu item Format --> Completion --> Open Completion File... and add this line to the top of the file. • When typesetting engines are called, they are now passed the program filename with extension, rather than just the filename • Conversion of eps, ps, and dvi files to pdf (caused by opening such a file) now works even if the path to the file has folders whose names contain spaces. In all three cases, the file can now be in a folder without write permission. • In 1.35, it was only possible to switch between the OgreKit Find panel and the Apple Find panel in the English localization. This preference now always works. • Trash AUX Files now removes files with more extensions: • ccs, idv, 4ct, 4tc, lg, xref (from TeX4ht; request of Bob Kerstetter) • ttt, fff, ent (from endfloat and endnotes; request of Herb Schulz) • wrm (from WARMreader; request of Gary Gray) • The list doesn't contain dvi (never did). I've removed bbl at the request of Lawrence Paulson, Gary Gray, ADITYA TRIVEDI, and Josep Font. • The menu item to bring up the statistics panel was only in the English version. Now it is in all versions. • Further pdfsync fixes from source to preview. If a project had a SourceDoc ./main.tex line instead of a SourceDoc main.tex line, pdfsync could fail. This is fixed. • A further pdfsync fix in case the user wrote \include{./MyChapter/Chapter1} rather than \include{MyChapter/Chapter1} • Now when a file is typeset, all open changed files with the same root are first saved. Version 1.36 was never released Version 1.35 adds new features and fixes several bugs: • An important recent development is the release of XeTeX and XeLaTeX by Jonathan Kew. See • http://scripts.sil.org/xetex XeTeX is not part of Gerben Wierda's standard installation, but it is available with Wierda's i-Installer as an optional install directly from Jonathan Kew. XeTeX can access Macintosh fonts directly, so TeX documents can be written with Lucida Grande, Zapfino, and any other Mac font. Moreover, XeTeX understands Unicode, so for example users can type Arabic into the source window from right to left, typeset with TeX, and obtain Arabic in the output window. In particular, XeTeX source documents have UTF-8 Unicode encoding. • TeXShop 1.35 supports XeTeX directly as follows: • a) XeTeX and XeLaTeX are now available in the pull-down typesetting menu on the source window • b) Using preferences, a user can make XeTeX or XeLaTeX the default typesetting option • c) If one of the first ten lines of the source has the form • %&encoding=UTF-8 Unicode then that file will be loaded and saved with UTF-8 Unicode encoding, regardless of the default encoding chosen for other documents • d) If the first line of the source has the form • %&program=xetex or %&program=xelatex then the appropriate program will be used regardless of the typesetting option chosen. • These XeTeX features form a special case of a new general method for adding typesetting engines to TeXShop. There is a now a folder in ~/Library/TeXShop named Engines; the files in this folder are shell scripts which call typesetting programs. When TeXShop first starts, it examines this folder and adds the script names of files it contains to the pull-down typesetting menu. Choosing one of these items and pushing the Typeset button calls the script. Users can write their own scripts and add them to the Engines folder. Items in ~/Library/TeXShop/Engines can be chosen as default typesetting method in TeXShop Preferences. In previous TeXShop versions, the typesetting program can be set in the first line of the source code by writing %&tex, %&latex, %&pdftex, etc. For compatibility reasons, this still works, but the preferred syntax is now %&program=tex, %&program=latex, %&program=pdftex, etc. This new syntax also works for any new typesetting engine added to ~/Library/TeXShop/Engines. For example, %&program=xelatex chooses XeLaTeX. • The encoding used to open or save a file can be set by writing a line of the form • %&encoding=UTF-8 Unicode as one of the first 10 lines of a source document. Any supported encoding is allowed; TeXShop's Help Files list the string which must appear on the right for each of these encodings. To bypass this behavior, hold down the option key while opening a file. • TeXShop has a new Find panel by Isao Sonobe. This panel supports regular expressions. Users can switch between the new panel and the original one in Preferences. The Find panel depends on OgreKit, a Cocoa framework for handling regular expressions by Sonobe. See • http://www-gauge.scphys.kyoto-u.ac.jp/~sonobe/OgreKit/ OgreKit is distributed using a slightly modified version of the BSD license. This license can be found in the Documentation included directly in the OgreKit Framework folder in the TeXShop source distribution. OgreKit requires Panther, so the new panel will only appear on machines running Panther. There are many nice features in this new Find panel, which users can discover for themselves. OgreKit modifies the "Find" menu submenu of the TeXShop Edit menu, replacing it with a more extensive menu. This might be confusing to Localizers, because the menu in the TeXShop nib file is not the menu they will see when TeXShop is running. The Find menu in the nib file should not be modified because it will be active in system 10.2. Instead the corresponding menu in OgreKit needs to be localized in the TeXShop source. The Find panel presents buttons controlling how it will find words; the settings of the buttons will be remembered from session to session. Adjust them until Find works as expected and then relax. • TeXShop 1.35 is distributed with the latest pdfsync.sty by Piero d'Ancona and J. Laurens. This fixes typesetting problems caused by the version distributed with TeXShop 1.34. TeXShop did not keep up with the changes by d'Ancona and Laurens for several months; sorry! In the new version, \include and \input are supported; to use the second, the syntax \input{thisfile} must be used rather than the syntax \input thisfile. The new version supports \pdfsync, \pdfsyncstart, and \pdfsyncstop. Use the first of these commands at any spot where you want to reference a point. If pdfsync breaks your code, enclose the offending section in a \pdfsyncstop, \pdfsyncstart pair. Suppose you are typesetting myfile.tex. Pdfsync creates a file named myfile.pdfsync containing synchronization data. Roughly speaking, each data entry describes a synchronization point as follows: • the page number of the output where the point occurs • the location on this page • the name of the source file producing this particular output • the line number in this source file for this particular output • There is a way to get TeXShop to display these synchronization points. The preview window toolbar has a new checkbox item called SyncMarks. By default, this item is not shown; use Customize Toolbar in the Window menu to select it. When the checkbox is checked, synchornization points are shown. By default, this item will not be checked when the Preview window first appears. A hidden preference item can change this: • defaults write TeXShop ShowSyncMarks YES • TeXShop 1.35 has new matrix code by Jonas Zimmermann. The Matrix Panel now makes tables. Examine the panel to find all of the new features. There is a hidden preference to set the default size of the matrix: • defaults write TeXShop matrixsize 12 A very small number of users may have modified "matrixpanel.plist" in ~/Library/TeXShop/MatrixPanel. This plist has been extended; the new list is called "matrixpanel_1.plist". Please edit this file to add your changes. • In previous versions of TeXShop, if you clicked elsewhere and then clicked on the edit window to edit, you would need to click twice to correctly position the cursor. This is now changed; the first click in the edit text is recognized and positions the cursor. When applescript runs under the Macro menu, it starts a small second application embedded in the TeXShop folder to actually run the script. That is because when a command like "latex" runs, and there is an error on the source, the console appears to accept user input, but the TeXShop event loop is not running during the applescript action, so no user input can occur. Many applescripts do not have this problem. TeXShop now allows users to begin applescript macros with the command • -- applescript direct When written this way, the script will be run directly by TeXShop rather than by the second small application. • Added a menu command "Trash AUX Files" and a button on the console "Trash AUX Files." When involked, these commands move to the trash all files in the current source directory with the same name as the source file and extensions aux, bbl, blg, brf, glo, idx, ilg, ind, ioa, lof, log, lot, mtc, mlf, out, pdfsync, and toc. Thanks to Will Robertson for suggesting this command and producing this list of extensions. Additional extensions can be added to this list with a hidden preference. To add "dvi" to the list • defaults write TeXShop OtherTrashExtensions -array-add "dvi" Several such extensions can be added in this way, one by one. To remove all additions • defaults write TeXShop OtherTrashExtensions -array The original list of extensions above will always remain active. Suppose a book project has a main.tex file in a folder, and then chapters in subfolders which are accessed using commands like \include{chapter1/chapter1.tex}. When this book is typeset, main.aux and other files will appear in the primary folder, and chapter1.aux will appear in a subfolder. So the "Trash AUX Files" command does not do a complete cleanup. But if the option key is pressed when the menu item is chosen or the button on the console window is pressed, then • a) SourceDoc and Root File information will be used to find the root document • b) All files with appropriate extensions listed above will be moved to the trash from this folder and all subfolders, even if the name does not agree with the name of the root file. Some users may want to throw caution to the winds and arrange that "Trash AUX Files" always performs this more extensive cleanup. A hidden preference allows this: • defaults write TeXShop AggressiveTrashAUX YES • Added new templates by Will Robertson. These are heavily commented. It is intended that users will edit them to fit their own requirements. The templates are only installed if TeXShop is running for the first time, or if the Templates folder is completely removed from ~/Library/TeXShop. But Will's templates are in a folder named "More" in the TeXShop distribution; old users can obtain them by moving "More" to ~/Library/TeXShop/Templates. • Added new macros by Will Robertson to create tables and arrays, to insert a reference, and to open other project files quickly. These macros have been praised on the TeX-On-MacOSX mailing list. The macros are available for new users; older users can obtain them by following simple instructions which come with TeXShop 1.35. • Added a macro to examine files in the teTeX tree. For example, if "article.sty" is typed in the dialog produced by the Macro, kpsewhich is used to find this file in the tree and open it in TeXShop. • There are hidden preferences to set the color of the text in the source window • defaults write TeXShop foreground_R 0.3 • defaults write TeXShop foreground_G 0.3 • defaults write TeXShop foreground_B 0.3 This color will show if syntax coloring is on; otherwise it will be black and then color can be selected in the Font menu. When used with existing hidden preferences to set the source window background color, these commands can be used to write source as white on black, or with other color schemes. TeXShop has new macros to set the source window colors, and to reset to default colors. • There are hidden preferences to make the source, preview, and console windows partly transparent. • defaults write TeXShop ConsoleWindowAlpha 0.75 • defaults write TeXShop SourceWindowAlpha 0.75 • defaults write TeXShop PreviewWindowAlpha 0.75 Here an alpha value of 0.00 is completely transparent and an alpha value of 1.00 is completely opaque. Use these commands cautiously! • TeXShop now has a Statistics panel, which lists the number of words, lines, and characters in a document. This is obtained by calling • detex myfile | wc When first called, the document on disk is tested. After changes are made to the document, the "update" button saves the document and calls detex again. The detex command removes tex commands, but the word count is still only approximate. Input and include files are counted by this command. • New German Help by Martin Kerz. Kerz also redesigned the TeXShop Help Window to follow Apple's current guidelines. These changes appear in English and German, but may not appear in other localizations. • When a file is drag-and-dropped, any alias is now resolved. Thus alias graphic files (and other files) can be used provided they are dragged and dropped to the source. Alias files will not work if their names are typed directly because the tex engine does not understand aliases (it does understand symbolic links). • Several changes were made in the Japanese portions of the code by Seiji Zenitani, with help from Yu Itoh and Koichi Inoue. There is a new Japanese encoding, Shift JIS X0213, which will become a new standard in Japan. There is now utf.sty support for pTeX. Before this change, Japanese pTeX supported only 6000 Kanji characters, but utf.sty supports more than 20,300 characters. This support is turned on by a preference item in Misc. When on, TeXShop exports non-ptex chracters as utf.sty codes. For example, unicode characters become \UTF(Hex code) and non-unicode characters become \CID(glyph ID). • Zenitani also added new Japanese default settings. Previously, Japanese ptex distributors provided their own "altpdflatex" scripts, which was confusing for beginning users. This new version of TeXShop bundles "altpdflatex-for-ptex" scripts and installs them in ~/Library/TeXShop/bin. The new Japanese default settings in Preferences automatically set up TeXShop to use these new scripts. • Added the following Chinese encodings at the request of Adam Si: Mac Chinese Traditional, Mac Chinese Simplified, DOS Chinese Traditional, DOS Chinese Simplified, GBK, GB 2312, and GB 18030. • Added a new Japanese help system by Yoshihisa Okazaki. • Added new Spanish localization and help. • TeXShop can now open and write files with extension .dn and .engine. • There is a hidden preference • defaults write TeXShop BringPdfFrontOnAutomaticUpdate NO which causes the pdf window to remain where it is when it automatically updates and is used with an external editor. This preference was requested by a user with an X11 editor and only seems necessary in this case. • Users sometimes upgrade Mac OS X via "archive and install". After the installation, TeXShop remains but teTeX is blown away. The first time such users typeset a file, they see an error dialog reporting that "pdflatex cannot be found." This error dialog has been revised to explain more clearly the likely cause, and resolution, of the problem. • The TeXShop web page now contains a "LaTeX Documentation" section listing recommended books and links to free LaTeX guides on the internet. The web page also makes available a number of short LaTeX example files by Will Robertson. • When a large number of windows were open, switching from one window to another took a long time and yielded a spinning disk; TeXShop was completely unresponsive during this time. This slowdown was caused by a bug in the Macro code. The problem is now fixed. • If a dvi file was opened in a directory without write permission, TeXShop could not create and display a corresponding pdf file. Now it will create the pdf file in a temporary directory and display it. • If the abort button was pushed in the console and the user later typed and pushed RETURN, the program crashed. Fixed. • Two minor error dialogs, which should have appeared in a window, instead appeared on the desktop with an inoperable "OK" button. This is fixed. • In localizations other than English, attempts to get the applescript dictionary crashed TeXShop. Fixed. • The Bibtex, etc., tools in the source window did not work if a file had a root file. Fixed. Version 1.34 adds new features and fixes several bugs: • Added a Matrix Panel by Jonas Zimmermann, zimmerleut@gmx.de. Many thanks. • At the request of Claus Gerhardt, added an extra applescript command, "goto line". For instance tell front document of application "TeXShop" goto line 15 end tell • Added a first cut at pdfsync. Clicking on a spot in the pdf file while holding down the command key takes the user to the corresponding point in the source file. If the source file has include files, this operation will open the appropriate include file and take the user to a point in that file. Read the help file "General Help: Pdfsync" for important details. This change depends on pdfsync.sty, a file create by Piero D'Ancona with improvements by Jérôme Laurens. • Also added pdfsync the other way. Clicking on a spot in the source file (including source files with root files) while holding down the command key will select the corresponding page in the pdf file. • The TeX, Latex, Bibtex, Makeindex, Metapost, Context, and Metafont buttons on the toolbar reset the default typesetting engine. This no longer happens. Thus it is possible to hit the Bibtex button and then hit command-T to typeset again. • The abort button on the console window did not stay fixed when the window was resized. Thanks to Sean Luke for pointing out these first two errors. • The command-1 keystroke switches back and forth between the source and preview windows. In previous versions, this did not work when a source window had a root file set by myfile.texshop or %SourceDoc. This is now fixed. Clicking command-1 while in the source brings up the corresponding preview window. Clicking command-1 again brings up the original source file. A given preview window may have several source files. Command-1 will bring up the last source file which was switched to the preview using command-1, or the root source file if there was no previous switch. • New Spanish help files by Juan Luis Varona Malumbres. Thanks. • Printing now respects the "scale" setting in Page Setup. It does not respect the "paper size" setting since paper size is set in teTeX. Printing works like this: the dimensions of the printed document are set by tex and encoded in the pdf file; this pdf is resized by the scale factor if this factor is not 100%, but otherwise is placed full size and centered on the printed page; usually the document size and printed page size are the same, but in rare cases when they are not, the edges of the document might be cut off. Version 1.33 adds new features and fixes several bugs: • The changes in version 1.33 support improved apple scripting, better macro support, and improved interaction with external editors. • Improved macro support was prompted by Claus Gerhardt, who wrote several useful scripts included with version 1.33. For example, one script calls htlatex to typeset a latex file for the web. The script saves the source, typesets, and opens the resulting html file in Safari. Thus the script behaves exactly like the Latex typesetting button except that it creates an html rather than a pdf, and displays the html in Safari rather than TeXShop. An advantage of this approach is that users can create their own scripts similarly and thus add features to TeXShop without waiting for new program code. • TeX typesetting often requires a sequence of operations. To process a file with a bibliography, the source must be run through latex, bibtex must be run, and latex must be run twice more. A script is included to do this automatically. The script saves the source before the first latex run and updates the preview display at the end. Users can easily customize this script for their own workflow. • Additional scripts convert the tex source file to a file with Windows line feed convention, or a file with Macintosh 9 line feed conventions, or a file with Unix line feed conventions. Mac OS X understands all line feeds without help, but many computers are not so smart; the conversions are useful when sending files to friends. The "flip" binary used to do these conversions was written by Craig Stuart Sapp. See http://ccrma-www.stanford.edu/~craig/utility/flip/ for details. • A script is included to call pdfselect and extract portions of pdf documents. A user could request one file containing pages 3 through 7 of the tex document, one containing page 29, and one containing pages 31 through 36. The advantage of placing this code in the Macros menu is that a user interface is provided, so users don't need to remember calling conventions for pdfselect and don't need to switch to the Terminal. • A #DOCUMENTNAME# variable was added to the Macro editor, giving applescript commands the name of the calling document. • The following applescript commands were added to TeXShop. Consult the TeXShop help files for details about writing your own scripts using these commands. • typeset • latex • tex • bibtex • context • metapost • makeindex • typesetinteractive • latexinteractive • texinteractive • bibtexinteractive • contextinteractive • metapostinteractive • makeindexinteractive • refreshpdf • refreshtext • taskdone • Improved support was added for external editors, following prodding by Joachim Kock. Several changes have been made: • There is now a preference to turn on continuous updating of the preview window if the user is running in external editor mode. Once each second the program checks to see if the pdf file has been updated. If so, it refreshes the pdf display. • The interval between refresh checks is controlled by a hidden preference item named RefreshTime. To reset to another interval in seconds (say every 2.19 seconds) defaults write TeXShop RefreshTime 2.19 • Applescript command support has been added to TeXShop so external applications can send commands to it. For external editors, the important script commands are • latexinteractive • texinteractive • bibtexinteractive • contextinteractive • metapostinteractive • makeindexinteractive • typesetinteractive • refreshpdf • taskdone • open_for_externaleditor • The first seven commands call TeXShop's typesetting engine. When one of these commands is called, control immediately returns to the calling program even though the typesetting operation is not complete. The taskdone command returns FALSE while this operation continues and TRUE when it is done, so a calling program wishing to send several commands can send one command and then test that it has been completed before sending another command. • Refreshpdf updates the preview display, and can be used instead of continuous updating to control that display. Typesetting commands automatically update the display upon completion. • The open_for_externaleditor command opens a .tex file, calling "Open for Preview..." • Additional features not related to scripting or external editors have also been added: • "Select All" can be used to select the full page of pdf output in selection mode. There is one restriction; in Multi-Page and Double-Multi-Page mode, select all is only active if the document has at most 20 pages, since otherwise the selected pdf will be enormous and bring the machine to a crawl. • A preference item now allows users to distill with Apple's pstopdf rather than ghostscript. This only works in Panther because pstopdf is only in Panther. If the preference is chosen but Panther is not running, the old ghostscript code will be used. When the preference is chosen, ghostscript is no longer needed for internal TeXShop scripts, but it may still be required for teTeX style files. One such case is epstopdf.sty, used to automatically convert eps files to pdf format during typesetting. • Zenitani provided additional drag and drop support. The new version reports an error if the filename of the dropped file contains a space. The new code also permits customization, in a somewhat strange way. To customize drag and drop code, add a new submenu to the Macros menu titled "Drag & Drop". Inside this folder, insert items for file types and make the text of each item be the code to be produced by drag and drop. For example, one item might be called ".pdf" and the body of this item might be "\includegraphics[#INS#]{%r}" where neither item would include the quotation marks. In these inclusions, • %F = full path of an dropped file • %f = dropped filename • %r = relative path of the dropped file • %n = filename without extension • %e = extension • If an extension is not listed in the Drag & Drop menu, or if there is no such menu, then drag and drop behaves as Zenitani proscribed, so most users won't need to customize the code. • If the dropped pdf file is originally exported from LaTeX Equation Editor, and if its file size is not too large (less than 1MB), TeXShop reads back equations from the file. If you don't like this, option-drag the file. • German help has been updated by Martin Kerz, the Italian localization has been updated by Nicola Vitacolonna, the Spanish help was updated by Juan Luis Varona Malumbres, the French localization was updated by Hendrik Chaltin, and a Romanian localization was added by Andrei Teleman. Thanks! • Macros can now be called when the preview window is active; commands which insert text will be deactivated in this mode. A toolbar item for the Preview window was added so the Preview toolbar can display a Macros button. • An "Abort" button was added to the console for people who want to stop the typesetting program in midstream. This is a minor change. • Code by Elliott Hughes was added to clean up some of the code calling a latex, tex, bibtex, etc., task. If the binary file is not found, the program now puts up an error message explaining the error and asking if the preferences bin path is correct. This will be useful for those running fink who forget to change the preference. • At the request of Joachim Kock, when TeXShop opens a file for Preview, or is in external editor mode and opens a file, the program now compares the dates of the source and preview files. If the preview file is not up to date or does not exist at all, the source file is automatically typeset. There is a hidden preference to turn this behavior off, but it is on by default: To turn it off defaults write TeXShop ExternalEditorTypesetAtStart NO • A few users reported that their printers added a slight yellow background to the page. Only a few printers had that problem. Frank Stengel discovered that it was caused by a NSEraseRect call in the print drawing routine. This call has been removed; now TeXShop prints using only one line, the vanilla Cocoa call [myRep draw]. • In Panther, all Text objects offer word completion. If a portion of a word is typed and option-escape is typed, the system will offer a list of possible completions. This works in TeXShop, TextEdit, and other Cocoa programs. But TeXShop's Command completion was broken in Panther, and made it impossible to use this new feature. This is fixed. • TextShop has an applescript command to add text, but this command did not update the undo stack. This was fixed by Stefan Walsen; his patch is in version 1.33. • If the user printed the source and later printed the typeset document, the document would be lowered on the page. This is fixed. • Jerry Keough found a strange bug when using TeXShop in Jaguar. If the user's preference setting asked that no empty document appear at startup and if the user opened a document, made the pdf window active, and then reached over and closed the source window, the next menu use would crash the program. This bug did not occur in Panther. It is fixed. Version 1.32 adds new features and fixes several bugs: • There is a new menu item, "New Tag", which inserts an empty tag in the source text and positions the cursor so the user can add the name of the tag. As a corollary, there is now a keystroke to add a new tag; the keystroke is command-2. • In Applescript macros, the terms #LOGPATH#, #AUXPATH#, #INDPATH#, #BBLPATH#, and #HTMLPATH# will now be recognized; this has been added at the request of Claus Gerhardt. • There is a new preference to set the program called by MetaPost. See the TeXShop help file for an explanation. • The drag and drop code has been improved by Seiji Zenitani. Dropping files of types pdf, jpg, jpeg, tif, tiff, eps, or ps on the source document will produce \includegraphics and a reference to the file. Dropping a file of type cls, sty, or bib will \documentclass, \usepackage, or \bibliographystyle and a file reference. Dropping any other text file will produce \input and a file reference. • There is a new preference to set the program called by BibTeX. This preference is required because jbibtex is used in Japan. • Although the magnification level can increase to 1000 in version 1.31, the arrow keys next to the magnification control only allowed values up to 400. This is fixed. • If the preview window's toolbar was in text-only mode and the magnification panel was selected, the resulting small dialog window would not go away in 1.31. This is fixed. • In Preferences, if the user set the tab size or the preview window magnification and then cancelled, the new values would still appear when the Preference panel was again displayed. This is fixed. • Suppose the preference to place the first page on the right side is active. In 1.31, the left arrow key did now work in double page mode, and the right arrow key stopped one page before the end. In double multipage mode, the end key, the page down key, and the right arrow key stopped before displaying the last page. All of these problems are fixed. Version 1.31 adds new features and fixes several bugs: • Macros items are now specific to the typesetting engine set in the current window. Two default sets are created when TeXShop first starts, one for Latex and one for Context. (The Context set was created by Hans Hagen; thanks!). Suppose a different engine is selected, say TeX. When it starts, it will have the default Latex macros. But if this set of Macros is edited with the Macro editor, the new set will always be associated with TeX, while the old Latex macros will continue to be associated with Latex. Of course the Latex macros can also be changed. • A new preference item allows the first page in the two double page modes to be either on the left or on the right. Books usually put this page on the right, so that is the default preference. • The preference dialog has a new pulldown menu to reset preferences to default values. This addition was requested by Seiji Zenitani for users in Japan who must cope with three different versions of pTeX. These users can now rapidly set preferences without consulting documentation on web sites. • The largest possible magnification in the preview window is now 1000 (previously it was 400). • Additional French menu translations by Hendrik Chaltin; thanks! • The command to switch between source and preview windows was changed from control-1 to command-1 and a menu was added for this task. • Three Panther problems are fixed. A few interface changes were made to improve appearance in Panther. This release is essential for Panther. • In Panther, older versions of TeXShop refuse to create new files, although they can open existing files. This was fixed by adding two lines to the "displayName" code. • In Panther, the small yellow tags which display the current page when scrolling in multipage and double multipage display formats were blank. Also, the small yellow tags which display the size of a selection rectangle to copy a portion of the pdf window were blank. This is fixed. • On my system, Panther spellchecking often fails for all programs. This happens at boot time. The computer boots up, but even if the first program used is TextEdit or Mail, it refuses to "spell check as you type" and the "Spelling dialog" refuses to appear. I suspect this is due to a defective third party program on my disk, since other Panther users haven't seen the problem. But I haven't been able to isolate the bug. Once the problem occurs, TextEdit and Mail have minor text input glitches which are cured by turning off continuous spell checking. TeXShop had more serious glitches in this situation. So in 1.31, extra code has been added to turn off continuous spell checking when TeXShop starts if the spell checker is not available. • Fixed a bug reported by Luis Sequeira: when text was dragged within the source window, it was always copied and pasted. It should have been cut and pasted unless the option key was down. This is fixed. • Juan Luis Varona Malumbres slightly improved Spanish help (small icon for the list of help files in the drawer). • In two page mode, typesetting no longer scrolls to the first page. • The new page and magnification buttons retain firstResponder status (as before 1.29) so users can experiment with several settings without clicking again for each experiment. • In version 1.30 and before, if the user input an impossible line into the "Go To Line" dialog, the program could crash; this is fixed. Thanks to Eric Seidel for the bug report. • Kevin Ballard, kevin@sb.org, contributed a new English.lproj folder with revised placement of interface items in preferences, slightly revised menu items, and other changes to improve the look of the interface in Panther. Many thanks! • Made spacing changes for Panther in the German preference panel. Thanks to Martin Kerz for the suggestions. • There is a hidden preference item to turn off tag computation: "defaults write TeXShop TagSections NO" but this preference was disabled somewhere along the line and certainly in 1.30. It is enabled again. • The Preference Panel is no longer hidden when TeXShop is deactivated. Version 1.30 fixes several bugs. • When TeXShop was hidden and later shown, the source window scrolled to the top. This is fixed. • Other bugs in split window were fixed. • The right mouse again works in the source window. • When the toolbar was displayed in text only mode, menus behaved strangely. This is fixed. • When a document is typeset, it is no longer saved first if it has not been changed since the last save. • TeXShop Help has better indexing; clicking on the TeXShop icon in help brings you back to the main page. • Additional localizations in German and Spanish. Version 1.29 adds many new features and fixes several bugs. • New PDF display options have been provided by Mitsuhiro Shishikura. The original page by page option is still available, but it is now also possible to scroll through the entire pdf document or to display two pages side by side. The default choice can be set in Preferences and the display can later be changed by menu action. • Shishikura has also modified the magnification options for preview display. The original option is still available, but it is now possible to display in actual size, or fit the display to the size of the window. A default choice can be set in Preferences and the magnification behavior can later be changed at will by menu. • The magnification glass behavior has changed slightly. A toolbar item fixes the size of the region to be magnified; double or triple clicking enlarges this region. • It is possible to select a portion of the pdf preview display and copy and paste the resulting graphic into another program. Drag and drop of the selection is also supported. Preference items allow users to select the file type of the copy (pdf, png, jpg, tiff, etc.) and the foreground and background colors and transparency. This feature is also due to Shishikura. • Preview selection combined with drag and drop can be used with Keynote. Using the default copy preferences, a text selection can be dropped on a Keynote slide; the background of the text will be transparent, so the slide background will show between the letters. This text can be resized since the default copy format is pdf. • Seiji Zenitani has added the ability to drag and drop files onto the source window. If a tex file is dropped, an "\input " command will be added there with a relative path to the file. If a graphic file is dropped, an "\includegraphics " command will be added. • Shishikura also added command completion. Type the first few letters of a word and hit the escape key. The remaining letters will be entered. Hitting escape again will cycle through all possible completions. Initially this will have limited usefulness because the completion dictionary is almost empty. To add a word to the dictionary, select the word and choose "Add Word" under the Format menu. Notice that this menu command has a key equivalent. To see and edit the entire dictionary, choose "Open Completion File" under the Format menu. Notice that the completion can be more complicated than just a single word, and the cursor can be placed correctly within this completion. Examine the samples provided in the default file for details. This feature will be improved in later versions. • The source window can now be split, so one section can be viewed and written while another portion is also visible. Keyboard input can go to either split portion and will also immediately appear in the other portion. • The source and preview window toolbars now work in text only mode. • TeXShop now has support for ISO Latin 5 (used in Turkey) and for several Russian formats. Vladimir Novikov provided helpful information about formats to support. • Some users must deal with a number of file encodings. For these users, the open and save panels now allow the file encoding to be individually chosen for a file. When a file is first opened, the default choice for this encoding will be the one listed in preferences, so most users can ignore this new choice. If a different encoding is chosen when a file is opened, that encoding will be the default choice when the file is later saved. • A small number of users ran into the following problem. They would receive a file with one encoding, say UTF-8, but mistakenly open it with another encoding, say Mac OS Roman. If they did not notice the problem, they might typeset the file. Typesetting always saves the file first, so the original file would be overwritten with a file in a different encoding, losing information. TeXShop now has a hidden preference to provide some protection in this situation. When this preference is active, TeXShop will create a backup file before it saves or typesets a file. To turn this on, type the following command in Terminal: • defaults write TeXShop SaveBackup YES • Support for epsi files was added. • The default commands for pdftex and pdflatex are now "pdftex --shell-escape" and "pdflatex --shell-escape." The "shell-escape" portion of this text tells pdftex that it is legal to run other programs during typesetting. This is useful because if tex finds a graphic file in an unsupported format, it can automatically call another program to convert it to supported format. For example, the default Latex template automatically converts tif files to png and automatically converts eps files to pdf. • This creates one difficulty that may worry some users. The "shell-escape" flag allows pdftex to run ANY program. Thus a disgruntled student could send you a tex source file by email and when you typeset it you would discover that some of the files in your directory had been erased. • I believe the danger is slight. A source file which did harm would have to be created deliberately; sending a "virus" via tex source seems somewhat esoteric. Nevertheless, there are two ways that you can protect yourself. The first and easiest is to remove the letters "--shell-escape" from the two spots they occur in Preferences and then convert all of your graphic files by hand. • TeXShop now provides a different protection. A preference item under the Engine tab is labeled "Shell Escape Warning;" this item is off when TeXShop is delivered. If the item is on and "shell-escape" is active, then the first time a file is typeset during a TexShop session, a warning dialog will appear allowing you to turn shell-escape off for that particular file. This dialog will not appear again during the session for that particular file. Thus you can typeset your own files using "shell-escape" and typeset files received in the mail without "shell-escape." • TeXShop can now create submenus in the Templates menu. To do so, create folders in the Templates folder. This code was written by Seiji Zenitani. • It has always been possible to color TeX output. To do so, add the line • \usepackage{color} • to the preamble, and insert a line like • \color{blue} • before typesetting begins. To color a limited section of text, use a command like • {\color{red} This is very important!} • To define custom colors, use a command like • \definecolor{mycolor}{rgb}{0.2, 0.7, 0.8} • When output is colored, the output may be difficult to read on the preview screen. TeXShop has hidden preferences to set the background color of the preview window. This background color will not appear when the document is printed. To set the background to gray, issue the following commands in Terminal: • defaults write TeXShop Pdfbackground_R 0.5 • defaults write TeXShop Pdfbackground_G 0.5 • defaults write TeXShop Pdfbackground_B 0.5 • Change 0.5 to 1 to get back to white. If you find yourself changing the background often, create an Applescript macro named "PDF background gray" with the Macro Editor using the following text: • --AppleScript • do shell script "defaults write TeXShop Pdfbackground_R 0.5" • do shell script "defaults write TeXShop Pdfbackground_G 0.5" • do shell script "defaults write TeXShop Pdfbackground_B 0.5" and create a similar macro named "PDF background white". • The German help file was revised by Martin Kerz and Laurent Meister. Additional French localization was provided by Jean-Claude De Soza. Additional Spanish localization was provided by Juan Luis Varona Malumbres. • Undo is now permitted past typesetting operations and file saves. Thus it is possible to typeset and then undo several changes made before the typesetting command. This bug was fixed earlier, but the fix created problems and had to be removed. Now the fix is back for good. • When a user closed a document and then tried to throw the pdf away, the Finder complained that it was still open. TeXShop would have to quit before the pdf could be thrown away. This bug was fixed by Wolfgang Lux. • The error coding failed for the new root file behavior. If "chapter1" had a root file, then after typesetting, control-E and the error menu command would be inactive. This is fixed. • The \phi and \varphi symbols were reversed in the Latex Panel. This was reported by Oleg Skipa and Rob Leigh and is now fixed. The code inserted by the "[" and "]" symbols in the Latex Panel is now correct, and the cursor is conveniently placed for the "Equations" entry. • The metapost script was improved by Joseph C. Slater. • Some international characters in autocompletion.plist were repaired by Alexander Wittig. • In German, the latex panel initially required two clicks to open. This is fixed. Version 1.28 fixes some minor bugs in 1.27 and adds a few extra features: • TeXShop finally uses the Apple Help System. This change is entirely due to Martin Kerz, who wrote all of the html code. Much easier to use than the old version! • The magnification glass has additional behavior. Holding down the command key while mousing sets magnification level much as the option key does, except that this level is then remembered until the window closes. If it is set to large mode, then holding down the option key temporarily magnifies in small mode. • There is a new preference to set the background color of the source window. This preference has no interface. To reset it to (r, g, b) = (.42, .39, .77), issue the commands • defaults write TeXShop background_R .42 • defaults write TeXShop background_G .39 • defaults write TeXShop background_B .77 The values should be between 0.00 = black and 1.00 = white. Default is r = g = b = 1.00. • A bug reported by Michael Murray has been fixed: the program selection tabs in the source and pdf windows weren't synchronized, so the typeset command sometimes did something unexpected. • Richard Hazeltine ran into a bug in which his main.tex file had an associated root file main.texshop which contained "main.tex". In the past this would be harmless, but in TeXShop 1.27 it created an infinite loop. TeXShop is now protected against this simple kind of infinite loop; in this special case, the file will typeset normally. Cases in which f1.texshop points to f2.tex and f2.texshop points to f1.tex will still create an infinite loop. • There is a new German localization by Martin Kerz, and a new Spanish localization by Juan Luis Varona Malumbres. • The "root file" behavior was slightly modified as requested by Gary Gray. If the user opens a file which has a root file set by the "%SourceDoc" mechanism or by the "Set Root File" mechanism, then the root file is also opened. This means, in particular, that the pdf preview window opens. If the file is already open, then nothing unusual happens. But if the root file is not open, then after it is opened the source file of the root file is miniaturized. This is done by the zoom mechanism (mainly because I don't know how to turn that zoom off). The zoom is a little surprising, but after a while it makes sense; TeXShop is saying "there is a root file and it is down here in the dock if you ever need it." • A new toolbar item allows users to turn autocompletion on or off rapidly on a document by document basis. This idea (with sample code) comes from Maarten Sneep. • In the past, if more than one item in the tags menu had the same text, only the first item was shown. This bug is fixed in 1.28 by Seiji Zenitani. The following changes were made in version 1.27: • The majority of new features in this version are due to Mitsuhiro Shishikura, who sent them just as version 1.26 was being released. The new TeXShop source code contains a folder with the email messages sent by Shishikura; they provide an excellent model of the correct way to suggest changes. Shishikura sent revised source code, a description of what the changes were supposed to accomplish, and a description of exactly where the source code changed. • Shishikura additions: • Pressing the mouse in the pdf display magnifies a small surrounding section of the display. Holding the option key while pressing enlarges the section being magnified. • A new macros menu and marcos button in the toolbar define an alternate way to insert text into the source document. Items in this menu behave like buttons in the existing Latex Panel. In addition, AppleScript items in the menu run user defined scripts. For example, a default script opens the pdf output in Adobe Acrobat. • A Macro Editor is provided to modify the Macros menu, defining new macros and rearranging the existing items in the menu. The help menu contains an item displaying help for this editor. • User inputs in the console window are added in red to the display at the top of this window, so this display has a complete record of interaction with TeX during typesetting. • Added support for file types .def, fd, .ltx, .clo • Added a "Typeset" menu, with keyboard shortcut command-T. This typesets the file with the currently chosen program. To make this change, the typeset menu and toolbar items have been rearranged to behave in a more rational way. • Extensive support was added for users in Japan. An additional encoding, Japanese (JIS), is added to those defined by Seiji Zenitani in verison 1.26. Earlier versions required special versions of completion.plist when using the Japanese "yen" encoding; this is no longer necessary. (Explanation for users not in Japan: Japanese keyboards often omit the \ character, replacing it with the "yen" character ¥. A special version of tex is available which uses ¥ rather than \ as a TeX escape character. TeXShop recognizes this substitution when using the encoding Japanese (ShiftJIS ¥).) • The following change was inspired by a contribution from John.Nairn, to be listed in a minute: • The "Set Project Root" behavior of TeXShop has changed. Users writing books often organize the project as follows: a master source file, perhaps called "Main.tex," is created. This file defines global macros and then inputs the sources for individual chapters. The source files for these chapters are contained in subfolders, one for each chapter. In TeXShop, it is possible to associate a "root file" with each chapter file. In previous versions, when the chapter was typeset, TeXShop actually typeset Main.tex and associated the resulting pdf file with the chapter. If several chapters were open at once, several copies of the book pdf file would appear. In the new program, this does not happen. Instead, when the chapter is typeset, TeXShop opens Main.tex if it is not already open and typesets this file. So only one pdf file is displayed, even if several chapter files are open. • The two additions below were contributed by John Nairn: • It is no longer necessary to set the project root for each chapter. Instead, include a line of code in the chapter source of the form "%SourceDoc ../Main.tex" without the quotations to achieve the same effect. (Nairn's code behaved as described in the previous paragraph; TeXShop has been revised so root files can be set in two different ways, but both ways produce the same effect.) • A new preference item has been added called "During File Save, Save Related Files." When a document is typeset, it is first saved. If this item is checked, the document will also be searched for \Input lines, and if the resulting files are also open in TeXShop, they will also be saved. • Localization support for Japanese and Italian is improved. • TeXShop now keeps configuration files for Templates, the Latex Panel, the Macros Menu, possible redefinition of menu keyboard shortcuts, and possible autocompletion codes in subfolders of the folder ~/Library/TeXShop. These folders are created with default configuration files when TeXShop first starts. To move TeXShop to a different machine preserving these configurations, copy the ~/Library/TeXShop folder to the new machine. • Bugs Fixed: • New documents are now titled "Untitled", "Untitled-1", "Unititled-2", etc. In TeXShop 1.26 and earlier, these names contained spaces even though TeX cannot process file names with spaces. I tried to fix this bug several times without success; the fix is due to Shishikura. • Preference acceptance of changes made by typing in text boxes has improved. • Several users wrote that their preference changes of default pdf magnification were not accepted when they pressed "OK." Until recently, I could not reproduce this bug. It turns out that the pdf window had to be open when making the preference change or else the change would appear to work but wouldn't. This is fixed. • TeXShop can display jpg and tiff files. In 1.26 and earlier, the display window was blank if the default pdf magnification was not 1. This is fixed. • When syntax coloring, TeXShop interpreted the sequence \% as the beginning of a comment. This is fixed. The following changes were made in version 1.26: • TeXShop now supports ISO Latin 2, UTF-8 Unicode, Standard OSX Unicode, Japanese (ShiftJIS 1), Japanese (ShiftJIS 2), and Japanese (EUC) file formats. See the English version of the help file for tips on using unicode with TeX. • TeXShop has a Japanese localization by Seiji Zenitani. • The Latex Panel has a Custom tab where users can add sixteen personal symbols. This code is by Georg Klein. • It is now possible to customize all keyboard menu shortcuts. • An auto completion facility has been provided by Greg Landweber. For instance, typing ^ gives ^{ } with the cursor placed between the two brackets. This facility can be turned on or off in preferences, and can be completely customized by the user. • TeXShop can open and save metafont (mf) and metapost (mp) files. It can now open, edit, and save any text file. • Basic metafont support has been added. • Preference defaults and the Latex Template have been modified to allow automatic conversion of eps files to pdf files and automatic conversion of tif files to png files during typesetting with pdflatex. Effectively, pdflatex can use any graphic format from the list pdf, eps, jpg, tif, png. • A configure menu item now brings up a TextEdit document explaining changes in default preferences and default templates. The document explains how to make power user changes in TeXShop configuration. It contains a list of important web sites. • The German localization and some internal code have been improved by Max Horn. • TeXShop inserted a \b at the start of new files; it no longer does this. • When saving a file, the undo stack is no longer initialized. • Additional improvements in syntax coloring code have been made. • The "indent" command now inserts tabs rather than spaces. The following changes were made in version 1.25: • For a long time, it has been possible to configure TeXShop so it will not open an empty document on startup. If so configured, TeXShop no longer opens empty documents when activated from the Dock. Thanks to Gerben Wierda for pointing out the correct Cocoa call to implement this. • There is now a preference to set the width of tab stops. • Selection of text between matching parentheses has been improved. In earlier versions, when a user selected a parenthesis, the entire text to the matching parenthesis would also be selected. In the new version, nothing unusual happens when a parenthesis is selected. If a user clicks once on a parenthesis, the cursor will be placed at that spot. If a user clicks twice on a parenthesis, the parenthesis will be selected. If a user clicks three times on a parenthesis, the entire text to the matching parenthesis will be selected. If there is no match, the line containing the parenthesis will be selected. • Martin Heusse has modified Nicolás Ojeda Bär's code so it also respects initial spaces on lines. If a line starts with several tabs or spaces, the following lines will also start with these tabs or spaces until they are canceled. • The color syntax code for Jaguar has been improved. Earlier versions created bugs in continuous spell checking; these are fixed. Earlier versions also caused the editor to forget the current font occasionally; this is fixed. • A week ago, Bruno Voisin reported a crashing bug when a left parenthesis toward the end of text was selected and the parenthesis had no match. This is fixed. • Sarah Childers reported (and fixed!) a bug involving Templates. TeXShop was supposed to allow users to remove or rename files in ~/Library/TeXShop/Templates. In that way, the Templates menu could be customized. However, TeXShop actually recreated files which were renamed or removed. This is fixed. Childers sent the appropriate repair code, which is used unchanged in version 1.25. (Incidentally, the default templates can be recreated by removing the entire folder ~/Library/TeXShop/Templates) The following changes were made in version 1.24: • Sections to be commented out can now contain comment lines. The "comment" and "uncomment" commands will preserve these internal comments. • In version 1.23 when a line contained$, the following characters were incorrectly colored green for a while. This is fixed.
• In version 1.23 if the user set a different font or size in preferences, modifications of the first text line would change that line of text to Helvetica 12 point type. This is fixed.

The following change was made in version 1.23:

• If a typesetting operation quits prematurely and the user tries to interact with the console by pushing the return key, TeXShop crashed. This bug has been fixed; it has existed for a long time.

The following change was made in version 1.22:

• There are further improvements in the syntax coloring code. The improvements introduced in version 1.21 only increased initial syntax coloring speed when documents are opened. This time, the code used when entering text has been improved. The crucial idea behind this improvement was made by Martin Heusse. Thanks!!

The following changes were made in version 1.21:

• The default altpdftex and alpdflatex calls were changed to reflect changes in Gerben Wierda's latest TeX distribution.
• The syntax coloring code was changed for Jaguar. When a document is first opened, TeXShop must syntax color everything. This can be done in two ways: the document can be colored before its window opens, or the window can be opened and then the syntax coloring can be applied gradually as a background task. Earlier versions of TeXShop used the second approach. But in Jaguar, coloring in the background is dramatically slower than coloring before the document opens, so version 1.21 colors first. Documents may take slightly longer to open, but the program should be responsive as soon as they open. If users find this delay annoying, please write me.

The following changes were made in version 1.20:

• The syntax coloring code was changed to make the program responsive under Jaguar. This is a preliminary fix; further optimizations will be made soon.

The following changes were made in version 1.19:

• Changes made in page setup cause the source file to be marked as changed. When TeXShop quits, it asked if these changes should be saved. In earlier versions, if a user clicked "yes" but was using an external editor, the source file would be replaced by an empty file. This bug was discovered by Nelson Byrne and is fixed; in the current version, files edited with an external editor are never marked as changed.
• The Dutch and Portuguese localizations were brought up to date.

The following changes were made in version 1.18:

• A bug introduced in 1.16 caused the tag code to occasionally output a huge number of error messages to the system log. A few users ran out of memory. Version 1.18 was released to cure this bug. Thanks to Stuart Midgley for the error report.
• TeXShop can now load and save files with MacKorean encoding.
• In version 1.17, the default script for tex + ghostscript was changed from "altpdftex" to "altpdftex --dvipsopts "-Ppdf". In 1.18, the default is instead altpdftex --dvipsopts "-u +pdftex.map -u +Ttbbold.map -u +wolfram.map" following a suggestion from Gerben Wierda.

The following changes were made in version 1.17:

• Previously, TeXShop could occasionally crash the first time the user pushed the RETURN key after opening a new document. The problem is fixed. Thanks to Nicolas Boccard for reporting the bug and sending a crash log.
• In the "Engine" Preferences for "TeX + dvips + distiller", the defaults are now set to altpdftex --dvipsopts "-Ppdf" and altpdflatex --dvipsopts "-Ppdf" rather than just "altpdftex" and "altpdflatex". Old users should change these preferences by hand to obtain best results with the TeX + Ghostscript typesetting option.

The following changes were made in version 1.16:

• If the source document has serious errors, LaTeX may generate a defective pdf file. In past versions, TeXShop would try to display this pdf file, become confused, and then refuse to display pdf previews for that particular document until the program was restarted. This bug is now fixed. Thanks to my colleague Jim Isenberg for complaining loudly about the bug.
• TeXShop can process .ins and .dtx files. Thanks to Niccola Vitacolonna for suggesting this addition.
• TeXShop has configurable toolbars. This is entirely the work of Anton Leuski, who sent code and nib files implementing the change. Thanks for this crucial addition!
• TeXShop supports Applescript. This is also the work of Anton Leuski. Applescript support will improve gradually over the new few versions of TeXShop.
• TeXShop can rotate the pdf image for previewing. This is necessary for certain slide packages. Thanks to Robert Love for requesting this change (several times!).
• The arrow keys now work in the preview window. The left arrow gives the previous page, the home key gives the first page, the up arrow scrolls upward a couple of lines, etc. Thanks to Hanspeter Schaub for this suggestion.
• TeXShop can now be configured for an external editor. There is a new menu item named "Open for Preview..." When this item is chosen, the user is asked to select a tex source file. But only the associated pdf preview window opens. If the source has not yet been typeset, this preview window will be blank. The preview window can be configured to contain a typesetting button using Leuski's toolbar. Users can open their source file in any editor. When it is time to typeset, they save the changes in their editor, switch to the preview window, and typeset. In this mode, TeXShop itself never opens or modifies the source file. It simply passes this file to the Unix TeX or LaTeX process.
• For users who prefer external editors most of the time, there is a new preference item called "Configure for External Editor." When this preference is chosen, the "Open" and "Open Recent..." menus open tex source files in the above manner for editing with an external editor. Moreover, the "Open for Preview..." menu becomes "Open for Editing..." and opens the source file in TeXShop's internal editor for those rare occasions when the internal editor is desired. Recall that the "Open" and "Open Recent..." menus can also open jpg, tiff, ps, pdf, dvi, log, and other files; selecting the new preference does not change this behavior.
• Applescript support for the "external editor option" will improve in subsequent versions of TeXShop, making it possible to typeset entirely from within an applescript-capable editor.
• The encoding preference was broken in some internationalized versions due to a missing tag. This was silently fixed in 1.15 and now officially fixed. Thanks to Juan Luis Varona Malumbres for pointing it out.
• Small changes were made in the Italian localization, as suggested by Nicola Vitacolonna.
• While supplying the Spanish translation for TeXShop 1.16, Juan Luis Varona Malumbres gave an alternate translation of the phrase "File format" in the save dialog. However, we provided no such phrase. It turns out that Apple automatically added an item to the save dialog allowing users to choose between the extensions "tex," "ins," and "dtx." That is because TeXShop now declares that it is an EDITOR of ins and dtx files. So we made TeXShop an editor of bib files as well and now users can create a bib file from scratch and give it the extension "bib" without going into the Finder. This fixes an earlier bug.

The following changes were made in version 1.15:

• A new menu item enables spell checking as you type. The initial setting of this menu is determined by a preference item, but the setting can later be toggled. This change was prompted by the release of the Unix spell checker Aspell for Mac OS X. This spell checker, by Kevin Atkinson, is "a more intelligent Ispell." It was ported to Mac OS X by Anton Leuski and converted into a spelling service. The spell checker has a Latex filter, and so becomes the long-awaited "cocoa spell checker for TeX." To obtain the spell checker, which is free, go to http://homepage.mac.com/leuski/cocoaspell/
• The English version of the help file has been expanded. In particular, the operation of MetaPost is explained more clearly. These changes will eventually appear in Internationalized versions of the help file.
• The Latex Panel has been polished. For example, it is now possible to select a section of text and then choose the typeface Emph; braces will be placed around the selected text. The cursor is also placed more carefully when items are inserted from the panel.
• The elegant code for this change was written by Max Horn. Each palette item is represented by a string in the file "completion.plist." This string will be inserted into the source when the Palette item is chosen. Horn's code allows the completion.plist string to contain #SEL#; each such occurance is replaced by the current selection when the string is inserted. Similarly if the completion.plist string contains #INS#, this will become the cursor position when the string is inserted.
• As soon as Geoff Lenglin heard of this code, he modified completion.plist to take advantage of it. Other errors in completion.plist were fixed.
• It is now possible to customize completion.plist. Recall that TeXShop adds a folder ~/Library/TeXShop/Templates to the user Library for templates. If this folder contains a folder ~/Library/TeXShop/LatexPanel containing a completion.plist file, then this file will be used instead of the default file in the TeXShop bundle.
• Subsections and subsubsections are now added to the tags menu automatically.
• TeXShop now has the option of loading and saving files using the MacJapanese encoding. This change is due to Makoto Inoue, and makes TeXShop compatible with the Japanese versions of TeX and LaTeX called ptex and platex, available at ftp://ftp.ascii.co.jp/pub/TeX/ascii-ptex/.
• In previous versions, if a user edited a file, closed it, and decided not to save the changes, the associated pdf window might not close, leading to a crash at some later time. This is fixed.
• Some panel entries like \item inserted strings containing the illegal character 0x007f. This is fixed.

The following changes were made in version 1.14:

• TeXShop now has a panel of common Latex symbols and commands; clicking on a symbol in the panel inserts the corresponding text into the source document. The panel can be displayed using an item in the Windows menu or a corresponding key stroke. This wonderful panel is entirely the work of Geoffroy Lenglin, who just finished a masters degree in Aeronautics and Astronautics at MIT. Geoffroy can be reached at geoffroy.lenglin@m4x.org.
• A few symbols in the panel require that appropriate packages by loaded in the tex source file. For instance, the blackboard bold characters require the line \usepackage{amssymb}. This line is in the latest Latex template, but the new template will not replace the old one if you already use TeXShop. See a related remark below.
• TeXShop can load and save files in Iso Latin format, using code from Martin Heusse. This encoding can be chosen with a preference item; the previous encoding, Mac OS Roman, remains the default. Iso Latin encoding makes it possible to type accented characters directly into the source file if certain packages are included with the tex source. Thanks also to Mats Weber for reinforcing the need for this change and providing alternate coding.
• The TeXShop editor remembers tab indents. If a line starts with several tabs, the following lines will also start with these tabs until they are canceled. This change is entirely due to Nicolás Ojeda Bär in Argentina, whose email address is lojedaortiz@interlink.com.ar. Ojeda Bär sent two short, elegant procedures which were simply plugged in to the TeXShop code. Ojeda Bär writes that he is just finishing high school. He has a bright programming future! Thanks.
• TeXShop automatically adds \section and \chapter entries to the tab menu, as suggested by several folks on the tex mailing list.
• This version has improvements in the Spanish localization by Juan L. Varona, improvements in the Italian localization by Giuseppe Carlino, improvements in the German localization by Martin Kerz, and a new Portuguese localization by Paulo T. Abreu.
• The LaTeX Template has been dramatically simplified. Since the graphicx package now understands whether it is called by latex or by pdflatex, elaborate instructions to this package from within tex source can be eliminated. When TeXShop is upgraded, the copy of the LaTeX template in ~/Library/TeXShop/Templates is not changed because the user may have modified it. But the TeXShop folder in this release contains a copy of the new template. Users who did not modify the original template can simply replace it with the new copy. Other users can open the file ~/Library/TeXShop/Templates/LatexTemplate and edit it to resemble the new template. Notice that the new LatexTemplate contains a line \usepackage{amssymb}, so the blackboard bold symbols on the new LaTeX Panel will be accepted by TeX.
• Saved documents again have type TEXT. This feature broke with system 10.1. The bug fix requires new Apple code which comes with system 10.1, so TeXShop now requires system 10.1 or higher.
• In previous versions of TeXShop, when a user typeset a document, came to an error, fixed the error, and then typeset again without completing the previous job, an extra folder was left in the /tmp directory. When typesetting was done by pdftex or pdflatex, this folder contained a complete copy of the source file. When typesetting was done by tex + ghostscript or latex + ghostscript, the folder contained smaller files. Every time a typesetting job was interrupted, a new folder was created in /tmp. These folders were not removed until the user rebooted the machine. This important bug is really two bugs, one for pdftex and pdflatex and another for tex + ghostscript and latex + ghostscript. The bugs are fixed in TeXShop 1.14. The tex/latex + ghostscript portion of the bug fix requires a new altpdftex script, contained in the Gerben Wierda's teTeX release of January 24, 2002. TeXShop will work with earlier Wierda releases, but then the latex + ghostscript bug won't be fixed.

The following changes were made in version 1.13:

• ConTeXt is a general purpose TeX macro package by Hans Hagen; for some, it will be a serious alternative to Latex. See www.ntg.nl/context/ for details. A useful introduction can be found in the document "LaTeX in proper ConTeXt" available athttp://berend.gameren.nl/tex/. TeXShop now supports ConTeXt.
• MetaPost is a MetaFont like system by John Hobby which can output postscript. This package can be used to draw elaborate postscript illustrations. See http://cm.bell-labs.com/who/hobby/MetaPost.html. Interesting MetaPost examples can be found at many web sites; for instance http://www.cs.ucc.ie/~dongen/mpost/mpost.html. TeXShop now supports MetaPost.
• TeXShop now has the ability to temporarily comment out sections of source text, as suggested by Gary Gray. If text has been selected and the menu item "Comment" is chosen, comment symbols will be added to the first position of each line of selected text. Similarly if text if selected and the "Uncomment" menu command is selected, comment symbols will be removed from the first position of each line of selected text.
• TeXShop can indent sections of source text, using the comment syntax just described.
• TeXShop comes with a Spanish localization by Juan L. Varona. Thanks!
• In previous versions, the English and Italian versions of the pdf window had the pdf display too far to the left, cutting off the left margin and left scroll arrow. This is fixed.
• In previous versions, TeXShop could open pdf, eps, tif, dvi, and ps files, but could not print these files. Now it can print them.
• The magnify button only worked once in system 10.1; using it more than once froze the display. This is fixed.
• If the console window was hidden and bibtex was run on a file which contained an error, then bringing the console window forward crashed TeXShop. This is fixed.

The following changes were made in version 1.12:

• TeXShop can now open .dvi, .ps, and .eps files. In particular, opening an eps file simultaneously converts it to pdf, saving the pdf version in the same directory as the eps file. The version of epstopdf used to convert can now deal with Macintosh line feeds as well as Unix line feeds, so Mathematica files no longer need to be fixed before they are converted. These remarks also apply to command line invocations of epstopdf, since the modified epstopdf is in the distribution of teTeX on this site.
• An important goal of this release is to inoculate TeXShop and teTeX against Fink. Fink is a system which can install X-windows software on your machine. Fink installs programs in /sw/bin and resets the PATH variable so this directory is searched first. Users who installed the Fink versions of ghostscript and/or teTeX in the past discovered that portions of TeXShop tried to use the Fink versions and produced incorrect results. The new versions of TeXShop and teTeX/ghostscript use the correct versions of teTeX and Ghostscript even if Fink versions are installed. (Users who install Fink versions should realize that these versions will be used if called from the Terminal. This is more likely to cause problems with teTeX than with Ghostscript. Gerben Wierda's distribution of teTeX has features which are missing in the Fink teTeX; it has been configured to find extra files installed in ~/Library; it contains a bibtex which can accept files with Macintosh line feeds, and it contains the very latest pdfTeX with patches for Acroread 5.)
• It is now possible to save the typesetting method with the file, so a file will be typeset with the correct tools regardless of TeXShop preference settings. If the first line of a file is %&tex, then tex + ghostscript will be used. If the first line is %&latex, latex + ghostscript will be used. If the first line is %&pdftex, pdftex will be used, and if the first line is %&pdflatex, pdflatex will be used.
• When syntax coloring is on, the symbols \$, {, and } will be colored dark green.
• Syntax colors can be changed using the defaults database.
• The preference settings for TeX programs can now contain flags.
• A few memory leaks were fixed.
• A bug with printing when using a project root was fixed.

The following changes were made in version 1.11:

• Previous versions of TeXShop preserved vertical scroll position in the output window when changing pages. The new version scrolls, so the entire document can be read without using the scroll bar by hitting "Next" over and over. The old behavior can be chosen in Preferences.
• After typesetting, users can select and copy messages from the console.
• When TeXShop typesets using the TeX + Ghostscript option, it constructs a temporary postscript file which is converted to pdf format. A preference item has been added causing TeXShop to retain this postscript file.
• TeXShop files created by the new version have type "TEXT" so they can be recognized by Carbon-based applications. This required 10 lines of Carbon code in an application which is otherwise written in Cocoa.
• A preference item allows users to decide whether TeXShop should produce a blank page when it starts.

The following changes were made in version 1.1:

• TeXShop has an additional typesetting mode which runs latex to produce a dvi file, dvips to convert it to a postscript file, and ps2pdf to convert the postscript to pdf. A menu item allows users to change between this typesetting engine and pdflatex. In the new mode, eps illustrations can be used without conversion, postscript special commands work, and certain bitmap fonts which do not correctly display using pdflatex can be seen. Thanks to Sean Luke for providing the original script for this mode, and to Gerben Wierda for polishing the script and including it in teTeX.
• TeXShop preferences have been modified to work with a new compilation of teTeX.
• The previous version of TeXShop did not correctly indicate changes made to tex source after saving to disk, so users could close the file without being asked if they wanted to save changes. This is fixed.
• The previous version did not allow users to save changes made to bibtex files. This is fixed.

Version 1.1 of TeXShop is accompanied by a new compilation of teTeX by Gerben Wierda. The new compilation has numerous bug fixes and improvements, including

• teTeX comes with an installer; the Terminal program is no longer needed during installation.
• Both teTeX and ghostscript are installed. Ghostscript is used by a few new teTeX programs.
• Bibtex now works with files using Macintosh line feed conventions, so such files need no longer be converted before being used.
• teTeX has been configured so users can install their own style files, fonts, etc. in ~/Library/teTeX. Therefore the file texmf.cnf does not need to be reconfigured, as in the past.
• Texconfig can handle pdftex.
• The bbold font now works.
• An aldpdftex script, used by the new TeXShop typesetting mode, has been added.
• The new version of pdftex accepts many pdf illustrations which were mangled by earlier versions.

The following changes were made in version 1.0:

• Apple has fixed NSPDFImageRep! Consequently TeX fonts appear in the output window and typeset documents can be printed directly from TeXShop.
• Apple has also dramatically increased rendering speed.
• The ghostscript option has been removed because it is no longer necessary.
• TeXShop preferences are now saved using the Mac OS X "defaults system." Because of this change, you must reset your preferences the first time you run version 1.0 of TeXShop. If you used an older copy of TeXShop, you can discard the folder "~/Library/Preferences/TeXShop Prefs."
• Templates are now stored in ~/Library/TeXShop/Templates rather than ~/Library/Preferences/TeXShop Prefs/Templates
• The magnification scroller at the bottom of the pdf page has been replaced by a simple input box, giving more room for pdf text.
• The template command can now be undone.
• Bugs in syntax coloring have been fixed.
• Parenthesis matching works for left parentheses.
• Parenthesis matching is snappier.
• In older versions, spaces were not permitted in directory names anywhere along the path to the tex source file; in the current version, this restriction only applies to the source file name itself.
• The German localization is not complete because there wasn't time to finish it before the release of Mac OS X.
• On April 7, 2001, an Italian localization by Giuseppe Carlino was added. Thanks!
• On April 30, 2001, several additional changes were made: first, a Dutch localization by Maarten Sneep was added. Thanks!
• The TeXShop menu was revised to conform to Mac OS X guidelines, with menu commands to "Hide Others" and "Show All."
• Control-1 now switches between the source window and the associated pdf window.
• Arrows beside the magnification box allow for rapid increases and decreases in magnification. This follows a suggestion by Sven A. Schmidt.
• A preference item allows users to configure the console window so it only appears when there is a typesetting error.

The following changes were made in 1.0d6:

• Parenthesis matching: typing a ), ], or } briefly flashes the matching symbol, and double clicking one of these symbols selects all text between it and its match.
• Syntax coloring: tex commands appear in blue and comments appear in read. This feature can be turned off in the preferences dialog.
• Tags: a source code line which begins with %: is interpreted as a tag and listed in the tag pulldown menu. Choosing a tag scrolls to the corresponding line in the source code.
• TeXShop can now open jpg, tiff, and pdf files.
• TeXShop contains a German localization constructed by Keith J. Schultz. Thanks!

The following changes were made in 1.0d5:

• The help file now refers to Gerben Wierda's distributions of teTeX and Ghostscript.
• TeXShop contains a French localization constructed by Jerome Laurens. Thanks!
• TeXShop remembers the lines of source code containing the first 20 errors; a menu item (and equivalent keystroke) cycles through these lines in the source file.

The following changes were made in version 1.0d4:

• Previous versions saved TeX source as 7-bit ascii. The current version saves source as 8-bit ascii, permitting European users to directly type accented characters if they use appropriate Latex packages.
• TeXShop can now open most files, for direct viewing of log files, BibTeX data files, and so forth.
• TeXShop can now run BibTeX.
• The "line command" grays out an entire line for easier viewing.
• A few interface changes have been made.