mirror of
https://github.com/EiffelSoftware/eiffel-org.git
synced 2025-12-08 15:52:26 +01:00
64500f901e
Date:2009-11-17T18:05:58.000000Z git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@358 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
80 lines
3.5 KiB
Plaintext
80 lines
3.5 KiB
Plaintext
[[Property:title|Customizing EiffelStudio for Subversion commands]]
|
|
[[Property:weight|8]]
|
|
[[Property:uuid|83a8ca76-d714-db60-f697-ae48b161161a]]
|
|
{{underconstruction}}
|
|
|
|
|
|
==Overview==
|
|
|
|
By configuring external commands, you can set up EiffelStudio to execute a few basic commands for Subversion or other source code management (SCM) systems. Source code management systems, sometimes called revision control or version control systems are often used as part of a software configuration management strategy to track and control changes to software and its supporting documents.
|
|
|
|
|
|
==Defining external commands==
|
|
|
|
You can define external commands by using the [[External commands editor dialog|external commands editor dialog]]. Then you can execute those commands through the '''Tools''' menu or with keyboard shortcuts.
|
|
|
|
|
|
===Defining a Subversion command===
|
|
|
|
|
|
{{note|The notation used in the examples on this page will work for Microsoft Windows. Other platforms may require different command formats.}}
|
|
|
|
|
|
Suppose that you want to add an external command to EiffelStudio to Subversion's ''update'' command (''update'' brings your working copy up-to-date with the repository). You can define a command with an appropriate name, say ''svn update'', as shown below.
|
|
|
|
|
|
[[Image:subversion-update-command-01|define svn update]]
|
|
|
|
|
|
The command line:
|
|
<code /lang="text">
|
|
svn up $file_name
|
|
</code>
|
|
invokes Subversion and executes the ''update'' command. The placeholder '''$file_name''' substitutes the name of the file associated with the class currently targeted in the editor pane. So if you were editing class <code>MY_CLASS</code> which exists in file <code>my_class.e</code>, then that file name would be used in the Subversion update command executed.
|
|
|
|
Once the command is defined, it will be accessible through EiffelStudio's Tools menu, either by selecting it explicitly or by using its associated keyboard short cut, <code>Alt+0</code>, in the case of this example.
|
|
|
|
|
|
[[Image:subversion-update-in-tools-menu|Subversion update command in the tools menu]]
|
|
|
|
|
|
===Other Subversion commands===
|
|
|
|
You can use this same technique to add external commands for other Subversion commands that require only a basic form. For example, to create a command that will add the file for the currently edited class to the repository, add a new external command with the command line:
|
|
<code lang="text">
|
|
svn add $file_name
|
|
</code>
|
|
|
|
or, to revert local changes to the file associated with the class which is currently the target of the editor:
|
|
<code lang="text">
|
|
svn revert $file_name
|
|
</code>
|
|
|
|
===The option to confirm execution of a command===
|
|
|
|
It's possible that in some cases, for example that of ''svn revert'', you might want to have the command provide you with a chance to back out of the deal before the command actually executes. You can do this by adding a little more to the command line:
|
|
|
|
|
|
[[Image:subversion-update-command-02|Confirmable svn update command]]
|
|
|
|
|
|
Here the command line:
|
|
|
|
<code /lang="text">
|
|
echo Revert changes to $class_name? && pause && svn revert $file_name
|
|
</code>
|
|
|
|
first asks for confirmation before executing the command.
|
|
|
|
When you execute this command you will see the confirmation prompt in EiffelStudio's [[Console tool|Console tool]]:
|
|
|
|
|
|
[[Image:subversion-update-console-tool|Subversion update command with confirmation]]
|
|
|
|
|
|
If you choose to execute the command, then just press <code>return</code>. If you have second thoughts and want to cancel the command, then do so by clicking the Console tool's stop button ( [[Image:metrics-tool--debug-stop-icon|Stop command]] ).
|
|
|
|
|
|
|
|
|