Project Settings

The project settings affect the behaviour of various SVN commands. Contrary to the global preferences (see Preferences), the project settings only apply to an individual project. You can edit the settings of the currently opened project by Project|Settings. In the top of the dialog, the Root Path of the project is displayed.

Repository Layout

The Repository Layout defines the project's root URL (within the repository) and where the Trunk, branches and tags of the project are stored. Trunk, Branches and Tags must be specified relative to the Project Root. When using here values trunk, branches and tags, you are compatible with the SVN standard.

Example

The Subversion project itself is located at http://svn.collab.net/repos/svn/. Hence for the corresponding SmartSVN project, Project Root must be set to http://svn.collab.net/repos/svn/. Subversion's Trunk URL is http://svn.collab.net/repos/svn/trunk, i.e. trunk is the relative path and must be set for Trunk. This is similar for Tags and Branches.

The repository layout affects the presentation of URLs and various commands. Among them are the basic Switch and Merge commands from the Modify-menu and all commands related to tagging from the Tag-menu.

SmartSVN tries to automatically determine the repository layout when a project is opened for the first time. Nevertheless you should verify that the suggested layout actually matches your intended or already existing repository layout.

Text File Encoding

The text file encoding affects only the presentation of file contents, for instance when comparing a file (see Compare). These settings are not relevant for the operations of SVN commands, which generally work only on the byte-level.

With Use system's default encoding, SmartSVN will automatically use the system's default encoding when displaying files. When changing the system encoding later, the project settings are automatically up-to-date.

Alternatively you can choose a fixed encoding by Use this encoding.

Refresh/Scan

The Initial Scan setting specifies, whether SmartSVN scans the Whole project or the Root directory only when opening a project.

We recommend in general to use the Whole project option, because features like searching files in the table, etc. are relying on having the whole project structure in memory.

Nevertheless, when you are working with large projects, it can be convenient to scan the file structure only on demand. This makes opening a project much faster and also requires less memory which can be crucial for really large projects.

Working Copy

The option (Re)set to Commit-Times after manipulating local files advises SmartSVN to always set a local file's time to its internal SVN property commit-time. Especially in case of an updating command (see Updating), this option is convenient to get the actual change time of a file and not the local update time.

Apply auto-props from SVN 'config' file to added files advises SmartSVN to use the auto-props from the SVN 'config' file, which is located in the Subversion directory beyond your home directory. These auto-props will also override other project defaults, like Default EOL Style, explained below.

Global Ignores

The Global Ignores define which files/directories should in general be ignored within the current project. This is contrary to local ignores (see Edit Ignore Patterns), which are only related to a specific directory. You can completely deactivate Global Ignores by Deactivated. With Use from SVN 'config' file, the same ignore patterns will be used as by the command line client. To be independent of the command line client, you can enter your own patterns by Use following patterns (separated with commas). The Patterns are file name patterns, where '*' and '?' are wildcard symbols, interpreted in the usual way.

Default EOL Style

This option specifies the EOL style default, which is used when adding a file (Add). For more details refer to Change EOL Style.

Default 'Needs Lock'

This option specifies the 'Needs Lock' default, which is used when adding a file (Add). With No file, the 'Needs Lock' property will be set to no file. With Binary files the property will only be set to files, which have been detected to have binary content. With Every file the property will be set to every file.

Default Keyword Subst.

This option specifies the Keyword Substitution default, which is used when adding a file (Add). For more details refer to Change Keyword Substitution.

TMate

Refer to TMate for further details.

Default Settings

Projects are created by various commands. For reasons of simplicity, in most of these cases, there is no configuration possibility for the corresponding project settings. Therefore you can specify default project settings (template settings), which will be applied to every newly created project. With Project|Default Settings you can configure the same properties as for a concrete project, except of the Repository Layout which always depends on the specific project.