endgroup - 2023.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2023-05-16
Version
2023.1 English

End a set of commands that can be undone/redone as a group

Syntax

endgroup [‑quiet] [‑verbose]

Usage

Name Description
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution

Categories

GUIControl

Description

Ends a sequence of commands that can be undone or redone as a series. Use startgroup to start the sequence of commands.

You can have multiple command groups to undo or redo, but you cannot nest command groups. You must use endgroup to end a command sequence before using startgroup to create a new command sequence.

Tip: The startgroup/endgroup commands are provided to support sequences of related commands that can be undone via the undo command, or redone if needed using the redo command. However, some Tcl commands can trigger an endgroup unexpectedly, and certain commands do not support either UNDO or REDO. The limitations are not fully defined.

Arguments

-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

Examples

The following example defines a startgroup, executes a sequence of related commands, and then executes the endgroup. This sequence of commands can be undone as a group:

startgroup
create_pblock pblock_wbArbEngine
create_pblock pblock_usbEng
add_cells_to_pblock pblock_wbArbEngine \
   [get_cells [list wbArbEngine]] -clear_locs
add_cells_to_pblock pblock_usbEng \
   [get_cells [list usbEngine1/usbEngineSRAM]] -clear_locs
endgroup

See Also