| 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) |