Using the CVS output visualization

For using the CVS output visualization, only few things are to do:

 

All configuration is done now. From now, executing a CVS command you chose to parse will result in a graphical presentation of the CVS output.

The checkout, update, export commands

 

For the commands checkout, update, export you will get a window like this:

You will be presented a typical Windows Explorer-like tree/list view which contains the directory structure of the CVS output. On the left side, only directories are shown while the right sides shows both directories and files along with their status (this is the letter CVS usually prints in front of a file name, e.g. 'U' or 'M'). An icon indicates the status as well. The color code:

  U - Updated

  A - Added

  R - Removed

  M - Modified

  C - Conflict

  ? - not in CVS

The columns on the right side are the following:

Name: File and directory name, relative to the currently selected folder

Description: A description of the object (e.g. file or fir)

Status: The status of the file. See the above list for possible statuses or the CVS manual for their explanation

The splitter you see in between the tree and the list view can be moved to left or right in order to change the width of the either view. This setting is stored permanently.

You can sort the list view ascendant or descendant by any column. Click the header of the column you want the list to be sorted by; a small triangle appears on the right side of column header. Subsequently clicking the same column toggles ascendant/descendant sorting. The triangle showing up means ascendant sorting, down - descendant.

Filtering/flat mode

You can use standard WinCVS filtering methods to filter the files in the CVS output window. You can also toggle the flat mode:

Flat mode: If enabled, all files are displayed along with their path: a "flat" directory structure:

File filters:

 Show modified files only

 Show added files only

 Show removed files only

 Show conflict files only

 Show all of the above

 Show unknown files only

 Hide unknown files

 

The status command

Using the status command parsing follows a different idea. Usually, you select several files and press the status button in order to see their status. If the status command parsing is enabled, the procedure changes:

  1. While being in any directory, you press the status button. CVS starts and its output is parsed.
  2. Two new columns exist in the WinCVS list view: Remote rev. and Remote status. While usually empty, the become populated after pressing the status key:

The Remote rev. column shows the newest revision available on the server. The Remote status is the current status of the file returned by the CVS status command. It can be one of the following:

 

Up-to-date

The file is identical with the latest revision in the repository for the branch in

use.

Locally Modified

You have edited the file, and not yet committed your changes.

Locally Added

You have added the file with add, and not yet committed your changes.

Locally Removed

You have removed the file with remove, and not yet committed your changes.

Needs Checkout

Someone else has committed a newer revision to the repository. The name is slightly misleading; you will ordinarily use update rather than checkout to get that newer revision.

Needs Patch

Like Needs Checkout, but the cvs server will send a patch rather than the entire file. Sending a patch or sending an entire file accomplishes the same thing.

Needs Merge

Someone else has committed a newer revision to the repository, and you have also made modifications to the file.

File had conflicts on merge

This is like Locally Modified, except that a previous update command gave a conflict. If you have not already done so, you need to resolve the conflict.

Unknown

CVS doesn't know anything about this file. For example, you have created a new file and have not run add.

You can sort the list by one of these columns in the same way as by any other - simple click on the column header.