create_revision (::quartus::project)

The following table displays information for the create_revision Tcl command:

Tcl Package and Version

Belongs to ::quartus::project 4.0

Syntax create_revision [-h | -help] [-long_help] [-based_on <revision_name> ] [-copy_results] [-set_current]
 
<revision_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-based_on <revision_name> Revision name on which new revision bases its settings
-copy_results Option to copy results from "based_on" revision
-set_current Option to set new revision as current revision
<revision_name> Revision name
Description
Creates the specified revision. If the revision is not 
included in the current project, a new revision is 
created in the project with default settings. 

If you specify the "-set_current" option, this command 
sets the newly created revision as the current revision.

If you specify the "-based_on" option, the command creates 
a new revision in the project based on the settings of the 
based-on revision specified by the option.
Example Usage
## Create a new revision called "tmp"
create_revision tmp

## Create a new revision called "tmp"
## and set it as the current revision
create_revision tmp -set_current
## This method is the same as 
create_revision tmp
set_current_revision tmp

## Create a new revision called "speed_ch"
## with settings based on "chiptrip"
## and set it as the current revision
create_revision speed_ch -based_on chiptrip -set_current
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: Based-on revision is not included in the current project: <string>. Make sure the based-on revision name is spelled correctly and included in the current project.
TCL_ERROR 1 ERROR: Can't create revision because the current project uses the device family: <string>. Change the device family or create the revision in another project that uses a different device family.
TCL_ERROR 1 ERROR: Can't create file: <string>. Make sure you have permission to write to the specified file.
TCL_ERROR 1 ERROR: Can't create revision: <string>. Specify a legal revision name.
TCL_ERROR 1 ERROR: Can't remove file: <string>. Make sure the file is not read-only and you have permission to write to the specified file.
TCL_ERROR 1 ERROR: You must open a project before you can use this command.
TCL_ERROR 1 ERROR: Didn't create revision because it is already included in current project: <string>. If you want a new revision, specify a different revision name.