CLI Reference > Configuration Management Commands > si edit
si edit
opens a revision or working file for editing
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...
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
The si edit command is intended only for use with the CLI. It cannot be used with the Windchill RV&S API.
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 Linux, the -g or --gui option uses the EDITOR environment variable; if it is not set, then Vi is used.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
identifies the editor to be used, overriding any EDITOR environment variables or system setting.
To align Windchill RV&S’s file association behavior with Microsoft Windows Explorer, 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 Windchill RV&S 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.
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.
identifies a specific member; use spaces to specify more than one member.
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si co, si ci, si lock, si unlock, si viewrevision
Miscellaneous: diagnostics, options, preferences