This section gives an overview of the various options SmartGit can be started with. These options should be given as parameters to the SmartGit launcher. The launcher to be used depends on your platform:
bin\smartgitc.exe. The first one is meant for regular usage, while the second one will print additional information on the console while the program runs.
- Mac OS X
In the following, we'll use
smartgitc.exe as an example to explain the available options. Substitute it with the respective launcher for your platform if you're not using Windows.
There may be additional options available that mainly serve debugging purposes and are therefore not documented here.
Options "-?" and "--help"
With either of the two following commands you can print all command-line options on the console that are specifically supported by the version of SmartGit you're using:
On Windows, make sure to call
smartgitc.exe (with 'c' on the end), otherwise when calling
smartgit.exe this parameter has no effect, since the SmartGit process won't be attached to any console to print the help output to.
This option sets the current working directory, which affects the path given in the
blame option (see below) as follows:
- If the
blameoptions are specified without their own path arguments, the path given with the
cwdoption will be used as argument for
- If the
blameoptions are specified with relative paths, these relative paths will be resolved against the path given with the
- If the
blameoptions are specified with absolute paths, the path given with the
cwdoption is ignored.
The path given with the
cwd option must be an absolute path. If the path is relative, it will be ignored.
This option launches SmartGit and opens the repository in the specified location.
This option opens SmartGit's Log window for the repository or file in the specified location. The main window is not opened.
This option opens SmartGit's Blame window for the specified file.
When adding a colon with the line number at the file end, it will scroll to the specified line.
This option opens the built-in DeepGit for the specified file. When adding a colon with the line number at the file end, it will scroll to the specified line.
This option can be optionally specified in addition to "--log" and defines the anchor commit of the Log. The anchor commit will be made visible and preselected in the Commits view.
Use this option to create the file
own.theme in the SmartGit settings directory (the exact file path is displayed) as starting base for creating a SmartGit theme. You can rename or move the file.
The file contains key=value lines, a leading # comments out the line. The most keys should be self-explaining. The value usually is a color defined as
#rrggbb using hexadecimal values, but it also can be name of another key which makes it easier to create a couple of named colors instead of having to write the same
#rrggbb value for different controls. inherit means to inherit the color from the parent control, default forces the control to use its default color from the operating system. You can SmartGit tell to load this file by selecting it in the preferences:
To create a theme that uses a green background color for selection, uncomment the line
by removing the leading # and change the value to a green value:
and restart SmartGit.