Add File (see also)

You use the Add File operation to create a QVCS archive file for the specified work file, thereby placing it under version control and adding it to the project. Files without an associated QVCS archive are marked with the graphic.

To add the file to the project and create an associated archive file, click the Add File toolbar button. This will bring up the Add File to Project dialog, which by default creates the archive with the default attributes associated with the project and checks the file in as the "Initial revision" 1.0. You can use the Advanced options to change various initial settings for the archive, and to check it out immediately after creation of the archive file if you wish to make edits right away. When you add a file, you become the owner of the associated archive.

Add File to Project Dialog

This is the dialog which appears when you click the Add File toolbar button.

Each field has the following meanings:

From the work file:

This field identifies the full path name of the work file that QVCS will use to create a QVCS archive. It's read-only, and is filled in with the name of the file selected from the file list pane. To change it, you must click on the [...] button. For multi-file operations, this field displays the directory where QVCS will look for the work files instead of the individual work file name.

Create the archive:

This field identifies the QVCS archive file that QVCS will create. This field is read-only, and shown as a sanity check so you can verify that the operation will create the QVCS archive in the location that you expect. For multi-file operations, this field displays the QVCS archive directory instead of the individual archive name.

Enter a description of this module:

Use this edit field to enter the description of this file. Note that this is a module description, not a revision description. The revision description for all first revisions is "Initial revision." For multi-file operations, the description you enter will apply to all the selected files. Use the Next and Prev buttons to alternate among the most recently used descriptions.

Check out immediately

Enabling this check box will check out the file immediately after creation of the archive.

Attributes

The attribute check boxes are initialized to the default values associated with the active project. You can override these defaults by changing any attributes that you wish to be different.

Define Comment Prefix:

Enable this checkbox and fill in the associated edit box if you want to define a comment prefix for this file that is different than the comment prefix normally associated with this file extension. The comment prefix value you define is only used if you enable keyword expansion and you use the $Log$ or $LogX$ keyword. When expanding the Log or LogX keyword, QVCS uses the comment prefix to define the characters that will act as the prefix on the expanded lines of the Log. This value can be changed after the archive file has been created, so it is not critical that you get its definition correct here.

Apply Label:

Enable this checkbox and fill in the associated edit box with a label string if you want to apply a label to the initial revision of the QVCS archive.

Float Label

This checkbox is disabled unless you are applying a label. If you enable the "Float Label" option, the label you define will become a floating label always associated with the tip revision of the trunk (the development path beginning with the initial revision created when you add the file to the project).

Toolbar Operations

Get

Check Out

Add

Check In

Undo Check-out

Lock

Label

File Groups

Sort Revisions

Filter Revisions

Filter Files

Compare

See also: the corresponding qput command line utility.