Special files

SmartCVS is designed to be run in a multi-user-environment. This means, that it only reads from the installation directory. All files that aren't project files, are stored in your home directory ($HOME on Unix/Linux and %USERPROFILE% on Windows NT/2000/XP). In the following, $HOME denotes the home directory and the forward-slashes denote file-separators.

Where SmartCVS stores its settings?

By default, SmartCVS stores its settings in the directory $HOME/.smartcvs/, but you are free to let it store them anywhere else. To do so, set the JAVA-system property "smartcvs.home" to the appropriate path. How to do this, depends on how you start SmartCVS:

Windows-launcher

In the file smartcvs.cfg (bin-directory of your SmartCVS installation), you will find a similar line:
#vmoption=-Dsmartcvs.home=${user.home}\.smartcvs2
To activate this option, remove the # (comment) sign and insert the appropriate path right beside the right '='.

Command-line launcher

For the normal JAVA-launcher, add the command line option
-Dsmartcvs.home=<path>
where you replace <path> by the desired path.

In the path itself, you can use Java-system properties, like the above example shows.

In the following $SMARTCVS_HOME is used for this path. If this path does not when starting SmartCVS, it will be created automatically.

$SMARTCVS_HOME/settings.xml

This file contains the persistent settings of SmartCVS.

$SMARTCVS_HOME/projects.xml

This file contains the project definitions, including their settings.

$SMARTCVS_HOME/repositories.xml

This file contains the repositories profiles.

$SMARTCVS_HOME/passwords.xml

This file contains repository passwords.

$SMARTCVS_HOME/log4j-log.txt

This is the session-log-file. For each start of SmartCVS it will be overwritten.

In case of unexpected behaviour or if SmartCVS detects a bug, close SmartCVS and have a look at this file. It may contain stacktraces and system specific information that allows us to fix problems easier. In this case, please send us this file in combination with a description, what you've done, so we can reproduce the problem.

$SMARTCVS_HOME/license

This is the optional license file used for the Professional (demo) version. If absent, SmartCVS runs in Foundation mode. For more details about the license, have a look here.

$HOME/.cvsignore

This file may contain file patterns for files that should be globally ignored (affect each project). It can be extended by the Ignore command.

  Important: SmartCVS expects one file pattern per line in the .cvsignore files. Hence it can handle also file patterns with spaces in the file name.