VM options

Some very fundamental options, which have to be known early at startup time or which typically need not to be changed are specified by Java VM options instead of SmartSVN preferences. In addition to the default Java VM options, following options are supplied by SmartSVN.

General options

Following general purpose options are supported by SmartSVN.

smartsvn.home

This propery specifies the directory into which SmartSVN will put its configuration files. By default, this is ~/.smartsvn, where ~ denotes your home directory. On Windows, this is %USERPROFILE%, on Unix/Mac this is simply ~. The value of smartsvn.home may also contain other default Java system properties, like user.home. It may also contain the special smartsvn.installation property, which refers to the installation directory of SmartSVN.

Example

To store all settings into the subdirectory .smartsvn of SmartSVN's installation directory, you may set smartsvn.home=${smartsvn.installation}\.smartsvn.

SVN options

Following options are related to the core SVN functions.

svnkit.admindir

This option specifies the name of the directory into which Subversion's administrative files are stored. By default, this is the .svn directory.

Example

ASP.NET does not allow directories to start with a '.', as '.svn' does. Therefore, to use ASP.NET in combination with SmartSVN, you can change the administrative directory name e.g. to _svn by svnkit.admindir=_svn

smartsvn.http.timeout

This option specifies the timeout of HTTP connections. By default, this timeout is set to one hour, which gives the server enough time to respond to time-expensive requests. On the other hand, if a server is not responding at all, SmartSVN may block for one hour, until it reports the problem. This may be annoying under certain circumstances and hence can be changed by this property. The timeout value is specified in seconds.

Example

With smartsvn.http.timeout=60 you can set the HTTP connection timeout to 60 seconds.

smartsvn.default-connection-logging

With this option you can enable the connection logging by default for all commands. This can be useful when searching for connection-related problems, which occur only rarely. By default, this option is not enabled.

Example

Use smartsvn.default-connection-logging=true to enable connection logging by default.

User interface options

Following options are related to the user interface of SmartSVN.

smartsvn.lookandfeel

This property specifies the Look'n'Feel of SmartSVN. The value must be the fully qualified class name of a valid Look'n'Feel on your system.

Example

On Windows, you can change to the default Windows Look'n' feel by setting smartsvn.lookandfeel=com.sun.java.swing.plaf.windows.WindowsLookAndFeel

Note

SmartSVN's Look'n'Feel has been optimized for SmartSVN. We take no responsibility if SmartSVN looks ugly when changing the Look'n'Feel, e.g. to the above value.

smartsvn.ui.font

This property specifies the font family which is used for SmartSVN's user interface. The value must be a valid Java font name.

Example

To change the font family to Dialog, you may use smartsvn.uifont=Dialog

smartsvn.ui.fontsize

This property specifies the font size which is used for SmartSVN's user interface. The value specifies the point size of the font, which defaults to 12.

smartsvn.ui.brightness

This property specifies the brightness of menu bars, toolbar, dialog backgrounds, etc. Valid values are in the range of 0.0 to 1.0. This property is only applicable, if SmartSVN's default Look'n'Feel is used, i.e. smartsvn.lookandfeel has not been changed.

smartsvn.ui.window-background-brightness

This property specifies the brightness of the 'White' of window backgrounds, like the file table. Valid values are in the range of 0.0 to 1.0. This property is only applicable, if SmartSVN's default Look'n'Feel is used, i.e. smartsvn.lookandfeel has not been changed.

Specifying options

Depending on your operating system, VM options are specified in different ways.

Windows

Options are specified in bin/smartsvn.vmoptions within the installation directory of SmartSVN. You can specify an option by adding a new line with the option name, prefixed by -D, and appending = and the corresponding option value.

Example

Add the line

-Dsmartsvn.http.timeout=60

to set the HTTP-timeout to 60 seconds.

Unix

Options are specified e.g. in bin/smartsvn.sh within the installation directory of SmartSVN. You can specify an option by adding the option name, prefixed by -D and appending = and the corresponding option value to the execution call.

Example

Replace

$_JAVA_EXEC -classpath $_CP -Dsun.io.useCanonCaches=false -Xmx48m SmartSVN

by

$_JAVA_EXEC -classpath $_CP -Dsun.io.useCanonCaches=false -Xmx48m -Dsmartsvn.http.timeout=60 SmartSVN

to set the HTTP-timeout to 60 seconds.

Mac OS

Options are specified in Info.plist within the installation directory of SmartSVN. You can specify an option by adding the option name, prefixed by -D and appending = to the VMOptions array. These lines must be enclosed by a string-tag.

Example

Insert the line

-Dsmartsvn.http.timeout=60

to set the HTTP-timeout to 60 seconds.