create_revision (::quartus::project)

Tcl Package and Version

Syntax

create_revision [-h | -help] [-long_help] [-based_on <revision_name> ] [-copy_results] [-new_rev_type <revision_type> ] [-root_partition_qdb_file <qdb_file> ] [-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

-new_rev_type <revision_type>

The type of the newly created revision

-root_partition_qdb_file <qdb_file>

The Partition Database (.qdb) file for the root partition

-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: Unable to create a new 'Persona Implementation' revision based on an existing 'Persona Implementation' revision. Specify another revision type or change the base revision.

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.

Tcl Package and Version	Belongs to ::quartus::project 6.0
Syntax	`create_revision [-h \| -help] [-long_help]` `[-based_on` <revision_name> `]` `[-copy_results]` `[-new_rev_type` <revision_type> `]` `[-root_partition_qdb_file` <qdb_file> `]` `[-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
	`-new_rev_type` <revision_type>		The type of the newly created revision
	`-root_partition_qdb_file` <qdb_file>		The Partition Database (.qdb) file for the root partition
	`-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: Unable to create a new 'Persona Implementation' revision based on an existing 'Persona Implementation' revision. Specify another revision type or change the base revision.
	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.