si deleterevision
permanently deletes a revision from a member
Synopsis
si deleterevision [--[no]confirm] [--[no]confirminuse] [-f] [--range=value] [(-R|--[no|confirm]recurse)] [--filter=filteroptions] [(-P project|--project=project)] [--[no]failOnAmbiguousProject] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] member...
Description
si deleterevision deletes an archived revision of a project member. For example,
si deleterevision --range=1.2-1.5 --confirm --confirminuse c:/Documentation/Man_Pages/xml_man/si_add.1.xml
deletes revisions 1.2, 1.3, 1.4, and 1.5 from the archive xml_man without prompting to confirm to the user if the revisions are in use in other projects.
|
|
It is recommended that you never delete a revision. Since historical versions of projects may still point at the deleted revision, it may become impossible to recreate old projects.
|
Options
This command takes the universal options available to all
si commands, as well as some general options. See the
options reference page for descriptions.
• --[no]confirm
controls the display of confirmation messages.
• --[no]confirminuse
controls whether Integrity Lifecycle Manager warns you about deleting the revision if it is used in other projects. If the revision is used in other projects, Integrity Lifecycle Manager warns you that deleting the selected revision will break the listed items. This option is valid only with the database repository.
• -f
forces the revision to be deleted, without any confirmation message.
• --range=value
specifies a range of revision numbers. The format of value for a single revision is simply the revision number itself. Separate multiple non sequential revisions with a comma, and use a dash to indicate a sequential range, for example, 1.2-1.5.
You may also prefix or append a dash to a single revision number, meaning you want to delete from 1.1 to the specified revision, or from the specified revision to the tip. For example, you would specify -1.6 to delete revisions 1.1 to 1.6. Or you could specify 1.2- to delete revisions 1.2 to the tip revision, whatever it may be.
The revisions are deleted in order from the highest revision to the lowest.
• member...
identifies a specific member; use spaces to specify more than one member.
Diagnostics
See the
diagnostics reference page for possible exit status values.
Preferences
Using
si setprefs or
si viewprefs, you are able to set or view the preference keys for this command.
See Also
