The program reads its configuration from the file /etc/vcsync.conf
(the exact location can be changed at compilation time). Since most of
the settings can be given in the command line, this file is optional
and it is not considered an error if it does not exist (the warning
about the fact is displayed if
vcsync is run with the
debugging level 1 or higher, though). An alternative configuration
file can be specified using the -c (--config)
command line option.
The file consists of statements terminated with semicolons. White-space characters (space, horizontal and vertical tabulation, newline, form-feed) are ignored, except as they serve to separate the tokens. Empty lines and comments are ignored. There are two kinds of comments: single-line and multi-line. Single-line comments start with ‘#’ or ‘//’ and continue to the end of the line. Multi-line or C-style comments start with the two characters ‘/*’ and continue until the first occurrence of ‘*/’.
For a detailed discussion of the configuration file syntax,
Configuration file syntax. In the sections that follow, we will
describe the statements understood by
vcsync. Whenever a
command line option exists that overrides a given configuration
statement, that option will be listed with the statement in question.
|• Synchronization settings|
|• Disabling synchronization|
|• The .checkoutrc file|
|• Named configurations|
|• VCS detection|
|• Logging and debugging|