Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

4.1.28.44. set_current_revision (::quartus::project)

The following table displays information for the set_current_revision Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax set_current_revision [-h | -help] [-long_help] [-force] <revision_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-force Option to open the revision and overwrite the compilation database if the database version is incompatible.
<revision_name> Revision name
Description
Sets the specified revision name as the current revision.  All
assignments created or modified during an open project will also be
saved to the Quartus Prime Settings File (.qsf).

In 8.1 or later versions of Quartus Prime software, set_current_revision
gives an error when the compilation database version is not
compatible with the current version of Quartus Prime software.
You may specify the "-force" option to avoid the error
and overwrite the database.
Example Usage
## Sets "auto_max" as the current revision 
set_current_revision auto_max
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 WARNING: Revision is already the current revision: <string>. No action is required.
TCL_ERROR 1 ERROR: You must open a project before you can use this command.
TCL_ERROR 1 ERROR: Revision file does not exist: <string>.qsf. Use delete_revision to delete the revision from the current project. Then use create_revision to create the revision and its .qsf before setting <string> as the current revision.
TCL_ERROR 1 ERROR: Revision is not included in the current project: <string> . Use the create_revision command to create the revision.