Updated to upcoming 23.09

git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@2393 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
eifops
2023-09-25 09:13:12 +00:00
parent 246745930d
commit e2bb303f94
2975 changed files with 63910 additions and 342 deletions

View File

@@ -0,0 +1,15 @@
[[Property:title|Changing the default history size]]
[[Property:weight|4]]
[[Property:uuid|d83e13f7-bdc7-a938-e979-da67e0e521d4]]
By default, there may not be more than 10 items in the history of a development window. It means that combo boxes in the [[Main address bar|address bar]] will let you choose between at most 10 possibilities. You can change this number.
To do so, use the [[Preference window overview|preference window]] : select '''Preferences''' in the '''Tools''' menu. Then in the preferences tree, select the "Browsing tools "sub-category in the "Tools" category. On the right part of the window, a list of preferences will appear, including "number of items displayed in the history combo boxes". Click on this item and enter the new value.
Click on '''save and exit''' to complete the change.
{{seealso|<br/>
[[Preference window overview|Preference window description]] <br/>
[[EiffelStudio preferences]] }}

View File

@@ -0,0 +1,9 @@
[[Property:title|Changing texts display]]
[[Property:weight|1]]
[[Property:uuid|b7c1cbac-975b-c6e6-050b-e48b61732a57]]
By modifying [[EiffelStudio preferences]], you can change the font and the colors used to display texts in the editor. For more information, refer to EiffelStudio [[Interface|graphical preferences reference]] .
{{seealso|<br/>
[[Customizing class text views|Customizing formatted output]] }}

View File

@@ -0,0 +1,15 @@
[[Property:title|Choosing classes to be ignored in BON diagrams]]
[[Property:weight|5]]
[[Property:uuid|18dcc14f-2ad0-3f3b-4b2e-fc9251035b6f]]
Every class in your system inherits from <eiffel>ANY</eiffel>. <eiffel>INTEGER</eiffel>, like other classes that represent basic types, is very often a supplier of the classes the user wrote. It may therefore not be interesting to display classes such as <eiffel>ANY</eiffel> or <eiffel>INTEGER</eiffel> in [[Diagram tool|BON diagrams]].
EiffelStudio allows you to customize a list of classes that it has to ignore when it creates diagrams. This list is stored in the [[EiffelStudio preferences]] . To modify it, first open the [[Preference window overview|preferences window]] by choosing '''Preferences...''' in the '''Tools''' menu. Select then the "context tool" sub-category of the "Tools" category in the preferences tree. On the right, you will then see a table of preferences, which includes "Show ALL classes in the diagram" and "Names of classes that should not appear in generated diagrams". If "Show ALL classes in the diagram" is not False, click on it and set it to False. Then click on "Names of classes that should not appear in generated diagrams" and edit the list. Class names must be separated by semicolons.
After modifying the list, click on '''save and exit''' to complete the change.
{{seealso|<br/>
[[Preference window overview|Preference window description]] <br/>
[[EiffelStudio preferences]] }}

View File

@@ -0,0 +1,15 @@
[[Property:title|Configuring an external editor]]
[[Property:weight|7]]
[[Property:uuid|15ecd536-139b-e880-d199-9c54aa88c892]]
By clicking on, or by [[Pick-and-drop mechanism|dropping a pebble]] on the external editor toolbar button( [[Image:command-send-to-external-editor-icon]] ), you can launch an external editor. By default, this editor is VI on Unix and Notepad on Windows. You can tell EiffelStudio to launch another editor by editing the preferences.
To do so, first open the [[Preferences Reference|preferences window]] by choosing '''Preferences...''' in the '''Tools''' menu. Select then the "Global preferences" category in the preferences tree. Click on "Command used to launch an external editor" and modify the command line so that it calls your favorite editor. You can use keywords that represent the filename ($target)and the line number ($line) as is explained in the [[Preferences Reference|preferences reference]] .
After modifying the command line, click on '''save and exit''' to complete the change.
{{seealso|<br/>
[[Preferences Reference|Preference window description]] <br/>
[[EiffelStudio preferences]] }}

View File

@@ -0,0 +1,18 @@
[[Property:title|Customizing class text views]]
[[Property:weight|6]]
[[Property:uuid|386c40f1-3427-cf1c-1043-46aeac1bc3c5]]
It is possible in EiffelStudio to customize some properties of [[Formatted information about compiled classes and features|class text views]] (other than basic texts) displayed in the editor or class and feature tabs of the context tool. Besides [[Changing texts display|graphical appearance]], you may modify:
* the order of <code>feature</code> clauses.
* the type of callers and suppliers displayed in the corresponding views.
* the views that are selected by default.
* the <code>note</code> clauses that should not be displayed.
These properties are set in the [[EiffelStudio preferences]]. You can modify them in the [[Preference window overview|preferences window]]. To open this window, select '''Preferences...''' in the '''Tool''' menu. Then select the "Context tool" sub-category of the "Tools" category in the preferences tree. Click then on a preference on the right to modify its value.
Click on '''save and exit''' to complete the changes.
{{seealso|<br/>
[[Preference window overview|Preference window description]] <br/>
[[EiffelStudio preferences]] }}

View File

@@ -0,0 +1,103 @@
[[Property:title|Customizing EiffelStudio for Subversion commands]]
[[Property:weight|8]]
[[Property:uuid|83a8ca76-d714-db60-f697-ae48b161161a]]
==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]] ).
==Defining commands for TortoiseSVN==
If you are using the TortoiseSVN GUI client for Subversion on Microsoft Windows, you may prefer to have TortoiseSVN execute the Subversion commands for you from EiffelStudio. You can do this by starting '''tortoiseproc.exe''', and providing the specifics for each command as shown in [http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-automation.html Appendix D of the TortoiseSVN documentation].
Some common Subversion command invocations are shown with their respective command lines below:
{| border="1"
|-
| '''Subversion command'''
| '''Command line'''
|-
| revert
| start tortoiseproc /command:revert /path:"$file_name" /notempfile
|-
| commit
| start tortoiseproc /command:commit /path:"$file_name" /notempfile
|-
| log
| start tortoiseproc /command:log /path:"$file_name" /notempfile
|-
| diff
| start tortoiseproc /command:diff /path:"$file_name" /notempfile
|}

View File

@@ -0,0 +1,13 @@
[[Property:title|Customizing toolbars]]
[[Property:weight|2]]
[[Property:uuid|583811a0-abcc-e26f-60e9-0cd6d4f9a8a8]]
There may be up to 26 buttons in the [[Main toolbars|standard toolbar]] and up to 17 in the [[Main toolbars|project toolbar]] . All those buttons are not shown by default though. Only 16 icons are displayed in the default standard toolbar for instance.
It is possible to choose which button are shown and in which order they appear in the toolbars. To do so, use [[Toolbar customization|toolbar customization]] windows. they appear when you choose '''Customize standard toolbar...''' or '''Customize project toolbar...''' in the toolbars sub-menu of the View menu or in the contextual menu of the toolbars (which is displayed when you right-click in the empty space on the right of the toolbars).
{{seealso|<br/>
[[Main toolbars|The toolbars and their buttons]] <br/>
[[Toolbar customization|Toolbars customization windows]] }}

View File

@@ -0,0 +1,5 @@
[[Property:title|Customizing EiffelStudio]]
[[Property:weight|8]]
[[Property:uuid|6f4b9558-38bc-1350-ce61-5f58d7032646]]

View File

@@ -0,0 +1,19 @@
[[Property:title|Making the context tool independent from the editor]]
[[Property:weight|3]]
[[Property:uuid|895ca03f-b14c-e0c5-f3e7-6757b47f5bc3]]
{{UpdateNeeded}}
By default, the [[EiffelStudio Editor]] and the [[EiffelStudio window overview|context tool]] are [[Centering tools on a component|centered]] on the same cluster, class or feature. It is possible to make the context tool independent from the editor. It has then its own address bar and can display information on a totally different component than the one on which the editor is centered.
To do so, click on or select '''Isolate context tool''' in the '''View''' menu. To go back to the previous configuration, click on the same icon again or select '''Merge context tool''' in the '''View''' menu.
You can also modify the [[EiffelStudio preferences]] so that next time a window is opened, its context tool will be automatically independent: open the [[Preference window overview|preferences window]] by choosing '''Preferences...''' in the '''Tools''' menu. Select then the "context tool" sub-category in the "Tools" of the preferences tree. Lastly click on "Share addresses between the editor and the context tool" and set it to '''False'''. <br/>
Click on save and exit to complete the change.
{{seealso|<br/>
[[Preference window overview]] <br/>
[[EiffelStudio preferences]] }}

View File

@@ -0,0 +1,10 @@
[[Property:title|Setting the editor behavior]]
[[Property:weight|0]]
[[Property:uuid|ff77b886-4a47-2ba4-eac7-ae051934a3f5]]
Some of the [[EiffelStudio Editor]] properties are customizable. [[Automatic completion]], for instance, can be partially or totally disabled, and inserted strings can be defined by the user. Some accelerators are customizable too. For more information, please refer to the [[Editor Preferences|editor preferences reference]] .
{{seealso|<br/>
[[Changing texts display|Text colors and font customization.]] }}