The Mark Command

The Mark Command

Top Previous Next

Purpose: To mark a current revision of the files. Use this command to "freeze" the current status whenever your project reaches a milestone.
Syntax: CSRCS Mark [command-switches] "file1" ["file2" …]
Abbreviation: mr
Switches:
   /s – Handles files in the specified directory and all sub-directories.
   /p"ProjectName" – Performs operations on all files in the project.
   /nname – Marks current revisions with a symbolic name.
   /m"message" – Uses a message to describe the checked-in modified files.
   /tstate – Assigns a state to the current revision.
   /rrev – Changes the current revision number to the specified revision number.
   /q – Quiet mode. Does not display the dialog box and status messages.
Exit code: 0 – success; 1 – otherwise.

Notes:

A state is an identifier used to categorize the revision. A useful set of states is Exp (experimental, the default), Stab (stable), and Rel (released). The revision state is listed in the RLOG report and expanded by the $State , $Id and $Header keywords.

You may optionally assign a new revision number (e.g., 2.0) to register the milestone. Since symbolic names provide the same benefits, this feature is redundant and provided for compatibility reasons only. If you use this feature, force the new version number for new files added to the archive. To do this, from the Project Advanced tab, set the Define new file parameters to True, and then specify the initial revision when you add the file to the Repository (right click on the file, and click Add to RCS).