CLI Reference > Configuration Management Commands > si edit
  
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
* 
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.
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 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.
--[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
Commands: si co, si ci, si lock, si unlock, si viewrevision
Miscellaneous: diagnostics, options, preferences