si edit
opens a revision or working file for editing
Synopsis
si edit [--editor=value] [(-r rev|--revision=rev)] [--[no]systemEditor] [--filter=filteroptions] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--[no]failOnAmbiguousProject] [--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 edit opens a current, former, or deferred member revision for editing. For example,
si edit c:/Documentation/Man_Pages/xml_man/si_add.1.xml
In a Sandbox, by default not specifying the -r option edits the working file.
If this command is invoked in the CLI mode (that is, no -g or --gui option is used), then the EDITOR environment variable is used and runs with the name of the temporary file containing the requested revision. If the EDITOR variable is not set, or if the -g or --gui option is used, a system-specific method is used. In particular, on WIN32-based systems, the operating system is instructed to open the file and does so based on the extension association. Under UNIX, the -g or --gui option uses the EDITOR environment variable; if it is not set, then Vi is used.
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.
• --editor=value
identifies the editor to be used, overriding any EDITOR environment variables or system setting.
|
|
To align Integrity Lifecycle Manager’s file association behavior with Windows Explorer on Microsoft Windows 7 or later, PTC recommends specifying explorer.exe as the editor instead of using system’s default editor. This ensures that when you double-click a file in Integrity Lifecycle Manager or Windows Explorer, the file opens in the same application.
If required, you can change the default program that is associated with a file type in Microsoft Windows to open or edit a file. For more information about file types and their association with programs in Microsoft Windows, see the Microsoft product documentation.
|
• --[no]systemEditor
controls whether to use the system editor, set through
si setprefs. If set, this overrides any editor setting if
-g or
--gui is given. This is used to temporarily override the preference system.
• 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
