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 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.
Miscellaneous
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.
Indent width
This sets how wide an indent should be; it calculates the width by checking the width of the number of spaces you state here in the current font.
Documents List
Show full path of document
If you want the full path of the document to appear in the documents list.
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.
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...
At Startup
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 (and not in a saved project) when Smultron is closed and opens them automatically the next time Smultron starts. If there are documents in more than one unsaved project all those are collected into one project the next time Smultron starts.
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.
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.
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.
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.
REALLY ADVANCED
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.
Tab stops
Whether you want to use tab stops or not, i.e. if it should calculate how many spaces are needed to get to the next stop, which is defined by "Tab Width", instead it will insert a fixed number of spaces when pressing tab (if one has chosen to insert spaces instead of a tab when indenting).
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.
Auto-insert a closing )
Automatically inserts a ) when you write a (.
Auto-insert a closing }
Automatically inserts a } when you write a {.
Highlight current line
Changes the background colour of the current line so it is more easily seen.
Colour for invisible characters when shown
The colour that the usually invisible characters have when they are shown.
Opening
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.
Preview Parser
When the preview is shown this setting decides what is used to interpret the code into the seen preview.
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.