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

How To Diagnose and Report TeXShop Bugs

Simple TeXShop bugs should be sent Richard Koch, but anything significant should also be reported to SourceForge as described below. Bugs in the TeX distribution should be reported to the author of the implicated tool. One way to diagnose typesetting bugs is to typeset from the command line and see if the bug is still present. If so, report the problem to the maintainers of TeX; otherwise report it to Richard Koch.

SourceForge and SVN

TeXShop is now available as a SourceForge project, thanks to Max Horn. To find the TeXShop page there, go to http://sourceforge.net/projects/texshop. Notice that there are locations to file bugs and request new features.

The TeXShop source code is kept in a subversion repository on SourceForge. To work with the source code in this form, you first need to install a subversion client on your Macintosh. A free universal binary of version 1.3.1 is available at http://metissian.com/projects/macosx/subversion. You'll also need documentation; a free book on svn is available at http://svnbook.red-bean.com

You can check out the texshop code with a Terminal command. To get the latest, possibly unstable, development version, use

svn co https://svn.sourceforge.net/svnroot/texshop/trunk texshop
where the last word in this command can be replaced by the name of a source code folder you'd like Subversion to create and populate. To get the source code for the current state of 2.10 with all bug fixes made to date, replace this command with
svn co https://svn.sourceforge.net/svnroot/texshop/branches/texshop-2.10 texshop-2.10

Important Bug Reports

Please report all important bugs using the SourceForge bug tracking system. To report a bug, go to the TeXShop project on SourceForge: http://sourceforge.net/projects/texshop Click on "Bugs" in the list of tasks under the TeXShop name at the top left. On the resulting page, click on "Submit New." On the right side of the resulting page under "Group", select "v2.10beta." (This step is quite important, since we will concentrate on bugs in the beta release and ignore other bugs and feature requests until 2.10 is released). Fill in a summary and detailed description in the spaces provided. It is not necessary to have a SourceForge account to file a bug report. So you can ignore the "Please log in!" request and push "SUBMIT" when you are finished. However, SourceForge accounts are free; if you log in before submitting the bug, you will receive notification when the status of the bug changes.