### What is it?

Smultron is a text editor which I've written in Cocoa for Mac OS X.

### Requirements?

Mac OS X Tiger 10.4.5 or later

### The name?

Smultron is the Swedish name for wild strawberry and I thought it sounds kind of nice. Plus I didn't have to think about the icon for the application.

### Why you've written it?

I've always thought that there has been a need for a free text editor on Mac OS X where you can change the current document quickly, has a toolbar, encodings support, authenticated saves and syntax colouring, split window etc. There are very good text editors as open source but they are generally written in Java or for X11, which just doesn't feel quite right.

### Can I make the toolbar icons less colourful?

Quit Smultron and open Termial. Write: "defaults write org.smultron.Smultron UseBlackAndWhiteToolbarIcons -bool YES" (without the quotes) and you will have black and white toolbar icons when you start Smultron. Exchange YES to NO if you want the colours back.

### Can I use it with my FTP-program?

Yes. You can usually decide which program should be an external editor in the FTP-programs and if you choose Smultron and then choose to open the file in the external editor it opens in Smultron, and then when you save the file in Smultron it is automatically uploaded to the FTP-site.

### How do I delete snippets, commands etc.?

Select it and press Backspace or Delete on the keyboard.

### How can I see the current function?

Either in the Info window or, if you choose the Functions menu (in Tools) or the toolbar icon the current function is marked.

### How can I see the all Spotlight information in to Info window?

Place the cursor in the information and just go down or right with the cursor keys and the text field will scroll to show all information.

### Where are things saved?

Snippets, Commands and Projects are saved in <your home folder>/Application Support/Smultron/Smultron.smultron. Preferences and open files are saved in <your home folder>/Library/Preferences/org.smultron.Smultron.plist.

### How do I turn on syncing and what is synced?

Go to .Mac in System Preferences and under the Sync-tab you can find Smultron Snippets and Commands. Check the box and then all your Snippets (and the corresponding collection) and Commands is synced.

### How do I uninstall it?

Drag Smultron to the trash, and you can find the preference file at <your home folder>/Library/Preferences/org.smultron.Smultron.plist. If you've installed the command-line utility you can find "smultron" in /usr/bin and its man file "smultron.1" in /usr/share/man/man1. You also need to remove the file <your home folder>/Application Support/Smultron/Smultron.smultron.

### How can I unregister Smultron for .Mac syncing?

If you don't want to use Smultron anymore you can unregister it for .Mac syncing by running a command called unregisterSmultronSyncSchema which exists in the application bundle. If e.g. Smultron is in the Application folder run the following command in Terminal: /Application/Smultron.app/Contents/Resources/unregisterSmultronSyncSchema Please note though that if you run Smultron again it will reregister automatically.

### What's resolution-independence

Traditionally graphics and text have been displayed with 72 dpi on the computer screen and this has left the graphics and text looking slightly "pixelated". Hopefully Mac OS X 10.5 Leopard will include resolution independence as a major feature as that will make everything look sharper (but less will be displayed of course). Smultron 2 is prepared for this and you can test this already on Mac OS X 10.4 Tiger if you have Quartz Debug installed (it is included with the Developer Tools). Start it and choose Show User Interface Resolution and set it to e.g. 2.0 and (re)start Smultron 2.

### What are the items in the bottom of the tools menu?

All snippets are listed at the bottom of the tools menu so that they can be easily inserted into the text and they are listed so that every collection gets its own submenu.

### How do I translate Smultron into my own language

You need first of all to install the Developer Tools. Then download the sourcecode so that you can get the RBSplitView.palette and PSMTabBarControl.palette; put those in /Developer/Palettes. Then ctrl-click on the Smultron application and choose Show Package Contents. In the folder Resources you'll find several language folders; choose English.lproj and copy it onto the desktop. Rename it to your language (the easiest way to know exactly what name it should have is to look inside another application that you know already has support for your language). Then open the Localizable.strings in a text editor (and make sure that it opens with text encoding Unicode UTF-16) and translate the right side of every string (you'll see things like %2$@ and you need to keep them in the string as that is the code to insert e.g. a filename). Then open all .nib files in Interface Builder and translate all text to your language and make the necessary adjustments. You don't need to translate SingleDocument.nib and Smultron Help. (In Snippets.nib you can find two "hidden" strings by tripple-clicking the Collection and Name table headers and then press Command-4 to see the Bindings, choose Value and then under Null Placeholder you'll find a string to note that a name hasn't been set yet.) You can test your translation at all times by dragging your folder into Resources in the application bundle and then (re)start Smultron. You can send the finished translation to me (the e-mail address can be found in About Smultron) and I'll include it with the next release.

### Anything else?

Cocoa is incredibly great!

### Where is the code?

smultron.sourceforge.net

### Where can I find the latest version of Smultron?

smultron.sourceforge.net
Copyright (c) 2007 Peter Borg