• TeXShop
• About
• Obtaining
• Installing
• Extras
• Links

[ Direct Download: US server | EU server | Source ] [ Contact ]

• Links
• Changes in 2.09 and 1.43
• Version History
• TeXShop Source Code
• TeXShop 1.43 Source Code
• About TeX Live
• Margin Kerning
• Converting Graphic Formats
• User Contributions

TeXShop History

For Users of Previous Versions

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.
• teTeX and pdftex have been upgraded to the latest versions.
• 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.
• ConTeXt has been upgraded to the latest version.
• Texinfo has been upgraded to the latest version.
• The bbold font now works.
• Epstopdf.sty has been added.
• 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.