Retrieving a Project's Revision

Top  Previous  Next

The check-out and update commands are used to retrieve a working copy of the project. The Retrieve revision command is used to retrieve a "frozen" revision (such as a milestone) to an alternative folder. This alternative folder may have many uses, e.g. during the production of the product, for a QA group area, a copy for technical writers, and a reference copy for technical support. You can retrieve a project revision by specifying its milestone name.

To retrieve a project revision:

1.

Open the Milestone Library (refer to Using the Milestone Library in Working with Project Milestones).

2.

Select the milestone.

3.

From the Milestone action field drop-down list, select Retrieve revision.

4.

Click Go!.

OR

1. Open the Document Explorer (refer to Using the Document Explorer Tool).

2.

From the Milestones menu click Retrieve Current.

The Retrieve Milestone dialog box appears:

The Retrieve Milestone dialog box includes the following properties:

·

Project – The project name. This is a read-only field.

·

Milestone – The milestone to retrieve.

·

Latest Revision – The latest versions of all project documents are retrieved.

·

Milestone – Select the milestone you wish to retrieve.

·

You may add a new milestone using the Add button. Refer to Creating a New Milestone in the previous section.

·

Output folder – Specify the destination root for the retrieve operation. Click to browse to the desired folder.

·

Retrieve filter – Filter the retrieved files according to state. (Pro edition only)

·

Matching State – Check this option if you wish to use the filter. Select a workflow state from the drop down menu by which you wish to filter the documents.

·

Higher states match as well – Setting this option will include documents with states same or higher than the selected state. When this option is clear, only documents with the same state are included.

·

Retrieve top revision that matches – Check this option to retrieve the top revision that matches the state filter. If the revision of the document in the milestone does not match the state filter, previous revisions are searched for a match. For example, you may use this feature if you wish to retrieve the latest approved revision of a document.

·

It is possible to see which of the documents will not be retrieved with the current filter settings, by clicking the Report non-matching button.

·

Output files options – To set output files options, click the following:

·

Set read-only – Clear this option to produce output files with read-write permission.

·

Set modification time to current time – Clear this option to produce output files with a modification time identical to the files' original check-in time. This feature is useful if you want to perform a folder comparison. However, it should be used with caution since it may "confuse" compilers or project build tools (i.e., the "make" utility).

·

Use UNIX line-break sequence – By default, CS-RCS produces working files using the DOS/Windows line-break sequence conventions. Check this option to produce output files with the UNIX line-break sequence conventions. This feature is useful if you wish to use UNIX tools to process the output files.

Click OK to retrieve a project revision.