| | 1 | [[PageOutline]] |
| | 2 | |
| | 3 | [http://http://erlide.org/ ErlIDE] is an Eclipse-based development |
| | 4 | environment, which aims to assist programming of large scale Erlang |
| | 5 | applications. In order to integrate RefactorErl into Eclipse, we are |
| | 6 | engaged in creating an Eclipse plugin based on ErlIDE, which can enable |
| | 7 | access to all the functionality provided by RefactorErl, whilst |
| | 8 | utilising ErlIDE features as well. A prototype of the Eclipse plugin is |
| | 9 | already available. |
| | 10 | |
| | 11 | = Installation = |
| | 12 | |
| | 13 | == Software requirements == |
| | 14 | * The plugin is being developed and tested in [http://www.eclipse.org/ Eclipse 3.5.2]. (It likely works with newer versions as well.) |
| | 15 | * This user interface is built upon [http://erlide.org/ ErlIDE], therefore it is required to have it with Eclipse. Inasmuch as the main structure |
| | 16 | of ErlIDE has been changed in its version |
| | 17 | ''v0.11.6.201107010651'', it is necessary to get the latest version. |
| | 18 | * Finally, you can download the plugin itself from the RefactorErl homepage. |
| | 19 | |
| | 20 | == Deployment == |
| | 21 | To install this plugin you need to download the source code from the |
| | 22 | home page of the [http://plc.inf.elte.hu/erlang/dl/ RefactorErl]. In |
| | 23 | order to generate the binaryes of the plugin you can compile it using |
| | 24 | '''''ant''''' or the compiler of Eclipse. Finally you have to copy the |
| | 25 | generated jar files into your Eclipse plugin directory. In Eclipse 3.5.x: |
| | 26 | {{{ |
| | 27 | <user home>/.eclipse/org.eclipse.platform_3.5.0_155965261/plugin |
| | 28 | }}} |
| | 29 | |
| | 30 | == Compiling the plugin in Eclipse == |
| | 31 | todo |
| | 32 | |
| | 33 | == Compile plugin using Ant == |
| | 34 | todo |
| | 35 | |
| | 36 | == Configuration == |
| | 37 | The plugin, in order to be able to access RefactorErl, has to be set |
| | 38 | up before the first usage. For the configuration dialog, go to |
| | 39 | '''Window/Preferences/RefactorErl'''. |
| | 40 | |
| | 41 | Start background process automatically:: |
| | 42 | If set, the plugin launches a new instance of the tool, otherwise an |
| | 43 | already running RefactorErl process will be used. |
| | 44 | RefactorErl directory:: |
| | 45 | The installation directory of the tool. |
| | 46 | Working directory:: |
| | 47 | A temporary directory, used to store the configuration files of |
| | 48 | RefactorErl. It is assumed to be a writable directory. |
| | 49 | Waiting time:: |
| | 50 | This parameter represents the waiting time (in seconds) after |
| | 51 | starting RefactorErl process (has to be set to greater than 1). The |
| | 52 | slower access is possible to Erlang nodes, the greater value is suggested. |
| | 53 | Synchronize workspace automatically then model changed:: |
| | 54 | If a source file has been changed, the extension automatically updates |
| | 55 | its inner representation within the tool. |
| | 56 | Reset database before full synchronization:: |
| | 57 | Resets the database and erases its contents in the case of a full |
| | 58 | synchronisation. The use of this feature is recommended for RefactorErl |
| | 59 | developers only. |
| | 60 | |
| | 61 | = Database management = |
| | 62 | todo |
| | 63 | |
| | 64 | = Executing refactoring transformations = |
| | 65 | todo |
| | 66 | |
| | 67 | = Executing semantic queries = |
| | 68 | todo |
| | 69 | |
| | 70 | = Clustering = |
| | 71 | todo |