Use this command to perform advanced update operations like switching to other branches or tags, reverting files. For day-to-day use we recommend to take the simple Update command. To merge explicitely between branches, use the separate Merge command.
Use the Default (keep sticky) option to not switch to a different tag, branch or revision.
Use the Main trunk's head (reset sticky) option to fetch the latest revisions in the main trunk with their default keyword-substitution mode. Usually this option is used after working in a branch to switch back to the main trunk.
Use the Retrieve Tag/Branch (new sticky) option to either switch to a tag or branch. Clicking the ellipsis button right beside the input field, lets you open the Tag Browser to select the tag or branch to switch to.
Use the Retrieve Revision (new sticky) to retrieve individual revisions of your files. This option is useful in combination with the Revert To option on the Advanced Options page to revert back to old revisions (see description below for further details).
Select the Before Date (new sticky) option to get the project state at the specified time (several date-formats are supported by the CVS server, the most straight-forward ist "yyyy-mm-dd hh:mm:ss"). To get the project state at a certain time in a branch, you also need to select the Retrieve Tag/Branch option above and enter/select the wanted branch.
Select Recurse into subdirectories when updating a directory, if you want to process the selected directory and subdirectories, too.
Select Create new directories when updating a directory, if you want to get new directories in the repository automatically created.
Select Prune empty directories when updating a directory, if you do not want empty CVS-controlled directories remaining.
Note |
CVS does not support the removing of directories. You only have the possibility to remove files from directories. But you can let SmartCVS automatically remove empty, CVS-controlled (sub-)directories while updating. This is a little bit odd, but it works. |
Select Don't change anything (check what would happen) to test, what files will be added, removed or updated. No local change will be made with this option selected.
Select Get clean copy (revert local changes) if you want your locally changes overridden with a plain copy from the repository.
Select Revert To (to overwrite revisions in the repository) if you have committed erroneous revisions into the repository and want to overwrite them easily (makes sense only in combination with the sticky Date/Revision or Tag option from the Standard Options' page). If this option is selected, the files are fetched from the repository without changing the local revision or options (so, as you would have modified the file's content locally). This option even works for binary files and whole directories.
Example |
You have accidently committed a revision 1.4. The latest valid revision is 1.3. |
If you need to override the file's default keyword substitution mode for your local project, enable Override default keyword substitution and select the keyword substitution mode you need.