# GENERAL:

## At Startup:

### Create new document:

Whether you want a new empty document or nothing at all when you start the program. This option has no effect if you start with a file e.g. by double clicking on a file.

### Check for updates:

If you are connected to the internet Smultron will check to see if you are using the latest version of Smultron, and if you aren't you get the option of downloading it. Or you could use the button to check manually.

## New Documents:

### Syntax colour

Whether new documents should by default get syntax colours according to the settings in the Syntax Colouring tab (see also Syntax Colouring).

### Line wrap:

Whether new documents should wrap the lines by default so you can see the whole line even if it is long.

### Show invisible characters:

Whether to show invisible characters as default for new documents.

### Spell check as you type:

Turns on spell checking automatically.

### Show line gutter for new documents:

Whether to show the line numbers field for new documents. The width is in pixels and the line numbers field automatically resizes if it is too small. Set the width to no less than 20 and there really should be no need to have it larger than 50 but you can if you want to.

## Editing

### Show matching braces:

When you when you write a ), } or ] Smultron briefly highlights the corresponding (, { or [ if it can find it, otherwise it beeps.

### Indent new lines the same as the line above:

After you press Enter places the cursor on the new line where text starts on the preceding line.

### Treat { and } intelligently:

Indents one step on the next line if the last character on the preceding line is a { and shifts the characters on the line to the left when inserting a } if there are no letters before.

## Auto Complete:

### Suggest automatically, after delay:

Whether the list of matching word-completions should appear automatically and how long (in seconds) after the last pressed key that the list of matching words should appear.

### Include standard words:

Whether the word common English words should also be included in the auto-completion instead of just the words from current syntax definition.

### Number of items in Recent menu:

How many past files to display in the File menu under Recent Items.

# APPEARANCE:

### Text Font:

Set the font and size for the text of the document and also for its line numbers.

### Text colour:

Set the colour of the text of the document.

### Background colour:

Set the colour of the background of the document but not for its line numbers.

### Tab width:

This sets how wide a tab should be; it calculates the width by checking the width of the number of spaces you state here in the current font.

## Documents List

### Use solid background:

Use a solid colour instead of a blue background colour for every other row.

### Show full path of document:

If you want the full path of the document to appear in the documents list.

### Reversed:

If you want the full path of the document reversed in the documents list, e.g. index.html/Desktop/steve/Users. This can be helpful if you want to see which folder a document comes from.

### Size of text:

Set the size of the system font to either 11 or 13 where the open documents are listed.

## Miscellaneous

### Show full path in window title:

If you want to display the full path to the current document e.g. “CocoaIsWonderful.html - /Users/steve/Desktop” instead of just “CocoaIsWonderful.html” in the title of the window.

### Show page guide, at column:

If you want to display a faint line after e.g. 80 characters. This only works correctly when you use a monospaced font.

## Show In Status Bar:

### Last saved, in format:

The date and time of the last time the document was saved and the format it should be displayed in. See Hidden Preferences for instructions on how to change the format yourself.

### Length of document:

The number of characters in the document

### Length of selection:

The number of characters in the current selection, if less than two characters are selected this won't show in the status bar

### Position:

Shows first the location of the cursor in the line and then the location of the cursor in the whole document.

### Text encoding:

Show which encoding the current document has; you can change it through Text Encoding in the Text-menu and also set the Preference as you like in the Open & Save tab.

### Syntax definition:

Show which syntax definition is set for this document; you can change it through Syntax Definition in the View-menu and also set the Preference as you like in the Syntax Colouring tab.

# SYNTAX COLOURS:

### Active - Colour:

Here you can turn on syntax colouring for each part and decide which colour Smultron should use. See Syntax Colouring for a description of what the different parts are.

### Only colour till the end of the line if it can't find closing tag:

Only continue to colour till the end of the line instead of the rest of the document if just the start tag is found and not the closing tag in e.g. a multiline comment

### Colour multi-line strings:

Colour a string even if it has line-breaks in it.

# SYNTAX DEFINITIONS:

### Use Definition:

Here you choose whether the Smultron should guess from the extension which syntax definition to use (e.g. if the extension of the document is .html it will use HTML) or if it should always use a particular syntax definition). If the document does not have an extension it tries to guess by checking the first line of the document for e.g. #!/usr/bin/perl and then maps it to the syntax definition; if it can't guess, it will use the Standard one.

### The table:

The table lists all the extensions that are mapped to each language. If you add or change an extension just double-click in the Extensions-column and change the extension (the extensions are space separated and there should be no dots). Smultron uses the first language (alphabetically) that has the extension so if many languages share the same extension make sure that no language above also has the extension.

# OPEN & SAVE:

### Open:

Whether when you choose Open to start at the folder where you last opened a document from, or start at the same folder as the current document or whether to always start at a particular folder.

### Save As:

Same as for Open but for when you choose Save As...

### Encodings:

Choose whether to always use a particular text encoding when you open a file or whether to guess the encoding of the document. Smultron guesses by trying to find “charset=” or if it can't find that, search for “encoding=” and map the encoding to what follows after that. If it can't find the encoding this way it checks for either EFBBBF, FEFF or FFFE at the beginning of the file and, if found, set the encoding to UTF-8 or UTF-16. If it can't guess by any of these means it sets it to the chosen encoding.

# ADVANCED:

## When Saving:

### Assign document to Smultron:

When a Mac OS X application saves a file it sometimes sets the Creator and Type of the document so that whenever you double-click on that document it starts with that particular application. If you choose this option Smultron will change that information so that the document will always be opened by Smultron. New documents are always saved so that they are opened by Smultron.

### Append name in "Save As", with:

If you e.g. always want to add the extension .txt to all filenames, check this box and Smultron will automatically append that to the name when the "Save As" sheet comes up.

### Line endings (when saving):

Different operating systems uses different invisible characters to denote that you want a new line. This option gets you to choose to which line ending you want when you save your document. If you don't have a particular need you can usually set it to “Leave unchanged” which leaves the line endings as it is for documents that you have opened. New documents uses the Unix standard.

## Editing

### Indent with spaces, not tabs:

Writes spaces and not a tab when the tab key is pressed. How many spaces are determined by Tab width in Appearance.

### Enable smart insert and delete:

With this option Smultron can keep track of spaces when you cut, copy and space so that you never get e.g. two spaces before a word.

### Check if document has been updated by another application:

If another application opens the current document and saves it so that the document you opened is not the same as it is now you get the choice with this option if you want to update your document or whether to ignore the changes made to the saved document.

### Use RGB rather than hex when inserting colour values:

When choosing a colour with Insert Colour... in the Action menu you can insert the colour value like this rgb(255,255,255) rather than like this #FFFFFF.

### Colour for invisible characters when shown:

The colour that the usually invisible characters have when they are shown.

## Opening

### At launch, open all documents I had open when I last quit:

This saves a list of all the documents (except for new documents that has never been saved) that are open when Smultron is closed and opens them automatically the next time Smultron starts.

### At launch, open all projects I had open when I last quit:

This saves a list of all the projects that are open when Smultron is closed and opens them automatically (including all its documents) the next time Smultron starts.

### If I choose to open a folder, open all files within it:

Opens all files within the chosen folder.

### Recursively:

Whether to open files in subfolders as well.

### Filter out documents with these extensions:

If you e.g. open a folder with some images you can filter out those extensions here so those images will not be opened.

## Miscellaneous

### Keep Smultron running after main window is closed:

If you want Smultron to reamin open even after all documents are closed. If you open a new document the main window is automatically opened.

### "All Documents" should only apply to current project:

When you have many documents open in different projects you can, if you check this option, only e.g. close the documents in the current project (and not all documents) if you choose Close All in the File menu.

### Run text:

When you choose Run Text in the Action menu the text is saved to a temporary file and then ran with this command.
Copyright (c) 2007 Peter Borg