pi release

Command help

> pi release -h
Usage: pi release [-h] [--args ARGS] [--description DESCRIPTION]
                  [--hier | --allow-from-old | --from-filelist FILE | --revision REVISION]
                  [--ignore-open]
                  [ip]

Description: Make a new release. If no IP Line is specified and the release
command is run from within a Workspace, only the top level IP in the Workspace
will be released. None of the resources of the specified IP will be released.
May only run from outside of any Workspace with the '--from-filelist' or '--
revision' options, in which case the IP Line identifier must be specified.

Positional arguments:
  ip                    The IP Line identifier. If the release command is run
                        from within a Workspace, the default is the Line of
                        the top IP of the Workspace. With a partial identifier
                        of the form 'LIB.IP' without a Line, the identifier
                        expands to whichever Line of the IP is present in the
                        Workspace. When '--from-filelist' or '--revision' is
                        used, the fully expanded IP Line identifier must be
                        provided.

Optional arguments:
  --allow-from-old      Allow release even if the IPV in the Workspace is not
                        the latest release (not allowed with '--hier').
  --allow-modified      Allow release when workspace has 'added' or 'removed'
                        resources.
  --args ARGS           Arguments passed to the hooks.
  --description DESCRIPTION, -m DESCRIPTION, -d DESCRIPTION
                        Short description of the release.
	  	   --from-filelist FILE  Release with a user-supplied filelist. This option
                        cannot be used with '--allow-from-old', or '--hier'. 
                        The '--revision' option must be used with P4Stream   
                        IPs to specify the stream spec changelist to be captured
                        along with the P4Stream filelist, but it may not
                        be used with "--from-filelist" for other dm types. An IP Line
                        identifier must be specified.
  --hier                Perform a hierarchical release of the entire
                        Workspace. If an IP Line identifier is passed to the
                        command, it will be ignored.
  --ignore-open, -i     Ignore open files (local changes).
  --revision REVISION   Create a revision release with user-supplied revision
                        or changelist number. Cannot be used with the options
                        '--allow-from-old', '--hier' or '--from-filelist' (except for P4Stream
                        "--from-filelist" releases - see above) and
                        an IP Line identifier must be specified.
  -h, --help            Show this help message and exit

Example

> pi release --hier -m "new tutorial release"
Successfully created 'tutorial.bist_sram@2.TRUNK'.
Successfully created 'tutorial.dbuf@2.TRUNK'.
Successfully created 'tutorial.cpu@3.TRUNK'.
Successfully created 'tutorial.interface@2.TRUNK'.
Successfully created 'tutorial.t0@2.TRUNK'.
Successfully created 'tutorial.padring@6.TRUNK'.
Successfully created 'tutorial.rxtx@2.TRUNK'.
Successfully created 'tutorial.sys_bus@2.TRUNK'.
Successfully created 'tutorial.rx_channel@2.TRUNK'.
Successfully created 'tutorial.clk_mux@2.TRUNK'.
Successfully created 'tutorial.t1@2.TRUNK'.
Successfully created 'tutorial.timers@2.TRUNK'.
Successfully created 'tutorial.flash_if@2.TRUNK'.
Successfully created 'tutorial.events_if@2.TRUNK'.
Successfully created 'tutorial.flash@2.TRUNK'.
Successfully created 'tutorial.digital_top@2.TRUNK'.
Successfully created 'tutorial.tutorial@6.TRUNK'.