| | 1 | [[PageOutline]] |
| | 2 | |
| | 3 | = Wx interface |
| | 4 | |
| | 5 | The RefactorErl has a Wx based user interface which is a standard desktop application. It provides a convenient way to access the functionalities of the tool |
| | 6 | and offers even more opportunities to ease code grokking. |
| | 7 | Its main features are the following: |
| | 8 | |
| | 9 | * Database management |
| | 10 | * Semantic queries and skeletons |
| | 11 | * Dependency graphs |
| | 12 | * Duplicated code analisys |
| | 13 | * Code investigations |
| | 14 | |
| | 15 | == Installation |
| | 16 | |
| | 17 | To use the Wx Interface, the Wx application needs to be installed on the computer. Wx is part of Erlang/OTP. |
| | 18 | To be able to drawn dependency graphs the GraphViz software is needed, the newest version of which can be downloaded from the following location: |
| | 19 | http://www.graphviz.org |
| | 20 | |
| | 21 | == Starting up |
| | 22 | |
| | 23 | We can start the interface either with the {{{referl}}} script using the {{{-wx}}} option, or from a running !RefactorErl shell. |
| | 24 | When using RefactorErl shell it is possible to pass a user name to the interface. This user name will be used when saving queries, skeletons, investigations. |
| | 25 | This way it is possible to store and grokking data made by different users. |
| | 26 | |
| | 27 | Startup examples: |
| | 28 | {{{ |
| | 29 | bin/referl -wx |
| | 30 | }}} |
| | 31 | |
| | 32 | {{{ |
| | 33 | #!erlang |
| | 34 | ri:start_wx("myUserNameAsAstring"). |
| | 35 | }}} |
| | 36 | |
| | 37 | ...or without a user name (the default user name - the node name - will be used) : |
| | 38 | |
| | 39 | {{{ |
| | 40 | #!erlang |
| | 41 | ri:start_wx(). |
| | 42 | }}} |
| | 43 | |
| | 44 | == Shutting down |
| | 45 | |
| | 46 | You can shut down the Wx Interface using the X button (usually at the upper-right corner of the window). |
| | 47 | |
| | 48 | == The Wx Interface and its main parts |
| | 49 | |
| | 50 | The Wx interface is a standard desktop application. It contains of five tabs and a status bar where RefactorErl status information is shown (e. g. the status |
| | 51 | of file adding). The mentioned tabs are the following: |
| | 52 | |
| | 53 | * File browser [wiki:WxInterface/FBrowser File browser] |
| | 54 | * Queries [wiki:WxInterface/Queries Dependency examinations] |
| | 55 | * Dependency graph [wiki:WxInterface/DepG Dependency graph] |
| | 56 | * Duplicated code [wiki:WxInterface/DupCode Duplicated code] |
| | 57 | * Investigations [wiki:WxInterface/Investigations Investigations] |
| | 58 | |
| | 59 | There are some important information messages which are shown to the user as dialog windows. (e. g. Duplicated code analisys finished) |