Settings

On the Project→Edit Settings... dialog, you can use the Settings tab to define some additional parameters that QVCS will use when working with the archives of a project.

Each field has the following meaning:

Comment Prefix:

The Comment Prefix project setting defines the comment line prefix characters that QVCS uses for files of specific types. When QVCS expands the $Log$ keyword to show revision comments, it uses the defined comment prefix characters at the beginning of each expanded log line to mark that line as a comment.

The Comment Prefix project setting is only applied when creating a QVCS archive. After a QVCS archive is created, the comment prefix characters are contained within that particular archive's settings and those are the characters that QVCS uses when it expands the $Log$ or $LogX$ keywords.

You can always change the comment prefix for an existing QVCS archive using the File→Modify Archive→Comment Prefix menu command, or the qmodhdr command line utility.

By default, QVCS recognizes the following file types (files ending with the given extension) and associates with them the comment prefix characters shown within the double quotes:

To specify a replacement for the above defaults, you can define a Comment Prefix using the following rules to format them:

• The extension (including the .) should be first.
• After the extension comes a :
• After the ':' comes the comment prefix string you wish to associate with the given extension.
• After the comment prefix comes the ~ character.
• Repeat steps 1 through 4 for as many different file extensions as you need to define or replace.

For example, to replace the comment prefix for .c and .h files with " * ", use the following:

.C: * ~.H: * ~

If you use this definition, the other file types are still recognized, and continue to use their default comment prefixes and .c and .h files will use " * " as their comment prefix instead of the default.

If a file type isn't recognized, when QVCS first creates the QVCS archive, it displays a warning message and defaults the comment prefix to four spaces.

Global Journal File Name:

The Global Journal file name names a file that QVCS will use for "global" journaling. If it's undefined, no global journaling occurs. When defined, and journaling for a QVCS archive is enabled, all changes to that archive are logged both in the local journal file and in the global journal file whose location is defined by the Global Journal file name project setting.

The global journal file is formatted differently from the local journal file: all journal entries in the global journal file fit on a single line in a comma delimited format suitable for import into a database tool.

Journal File Name:

This field defines the name of the project's local journal file. When journaling is enabled for a QVCS archive, QVCS appends a record of any operations performed on that archive in the journal file. The journal file is just a human readable text file that QVCS uses to log changes for archive files in the associated directory. QVCS never reads from this file; it exists as a convenient way for users to have a listing of the changes made to the archive files. The default name is qvcs.jou.

QVCS Archive Path:

This field defines the directory (relative to the project location) that QVCS searches to find QVCS archive files for the current project. The default and recommended value is .\

Path to temporary files:

This field defines the directory QVCS will use for its temporary files. It defaults to "C:\tmp\".

Journal file retry count:

This field defines the number of times QVCS will try to append to the journal file. Since the journal file logs the activity of QVCS changes to an archive, in a network environment it is possible to have more than one QVCS user trying to add to the journal file at the same time. When such a "collision" occurs, the QVCS utility that failed to get access to the journal file waits for a period of time, then tries to gain access again. It keeps trying for the number of times defined by whatever number you set here.

If, after trying for the number of times indicated, QVCS still fails to append to the journal file, QVCS displays an error message and the journal entry is abandoned.

The retry count defaults to 4.

Expanded copyright keyword string:

This field defines the string that QVCS will use when expanding the $Copyright$ keyword.

Use UNIX path separators in keyword expansions

This checkbox allows you to tell QVCS that it should use the '/' character as the path separator in keyword expansions instead of the '\' character. This is useful for Java developers in particular, since the Java compiler treats the '\u' sequence as an error even if it appears within a comment.

Use UNIX end-of-line character in Log expansion

This checkbox allows you to tell QVCS that it should use just a linefeed character instead of a carriage return-linefeed combination to mark the end of a line when it expands the $Log$ or $LogX$ keywords and when it creates text report files.

Edit Project Settings Dialog

General

Settings

QVCS Attributes