| | 1 | = !CodeLite-1.0.35 = |
| | 2 | |
| | 3 | Cobra support is not yet intrinsic to the installation from the codelite website - we're working on that.[[BR]] |
| | 4 | The attached files below provide partial support in !CodeLite-1.0.35 for cobra language development. [[BR]] |
| | 5 | |
| | 6 | These have not been tried on !CodeLite-2. |
| | 7 | |
| | 8 | == What is supported == |
| | 9 | * Syntax colorization |
| | 10 | * Project Templates for debug, release and turbo builds of |
| | 11 | * Console: Simple cobra executable |
| | 12 | * User Templates: cobra executable |
| | 13 | * User Templates: cobra library |
| | 14 | * User Templates: cobra executable with embedded runtime |
| | 15 | * cobra builds, build error capture and parsing. |
| | 16 | * running the executable made |
| | 17 | |
| | 18 | == What is not supported (yet) == |
| | 19 | * Code structure browser |
| | 20 | * Tags-like capability |
| | 21 | * word and call completion (intellisense) |
| | 22 | * Debugger/debugging |
| | 23 | |
| | 24 | == Prerequisites == |
| | 25 | * Installed version of the cobra compiler installation. [[BR]] |
| | 26 | Specifically you will need to know the path to the compiler executable cobra.exe |
| | 27 | |
| | 28 | * gzipped tar dearchiver ( gzip, gnu tar, 7-zip, winRar) |
| | 29 | |
| | 30 | == Installation == |
| | 31 | |
| | 32 | * Download an installation binary for version 1.0.35 from the [http://codelite.org CodeLite] website. |
| | 33 | |
| | 34 | * Install it and take note of the installation directory |
| | 35 | |
| | 36 | * Download and Dearchive (untar) the files from the attachment below to a local dir. |
| | 37 | Copy the files and directories under the newly created root dir 'codelite-1.0.35-cobra' |
| | 38 | to the root of the codelite installation directory. |
| | 39 | Currently these are multiple files under three directories |
| | 40 | * config |
| | 41 | * templates |
| | 42 | * lexer |
| | 43 | |
| | 44 | * Most of the files are additional to the default codelite installation except for files in config. |
| | 45 | These copies replace the existing files in the installed config directory (they should be a superset). |
| | 46 | If you are feeling paranoid you might want to backup the originals before the copy. |
| | 47 | |
| | 48 | * Run codelite - select menubar 'Settings' item '!BuildSettings'. [[BR]] |
| | 49 | In the popup dialog that appears you should see a box on the left hand side containing a |
| | 50 | possibly expanded entry for Cobra. |
| | 51 | |
| | 52 | * You now need to tell codelite the path to the cobra compiler. |
| | 53 | * In the above dialog (menubar 'Settings'/'Build Settings...' under the cobra Tree entry click on 'Tools' |
| | 54 | The rhs of the dialog will show a form the top line of which has an entry 'Compiler Name: C:\path\to\cobra.exe' |
| | 55 | Change the path to that of your cobra compiler (fwd or back slashes are equally recognised). |
| | 56 | Press 'OK' btn to save the change. |
| | 57 | |
| | 58 | * Select from !MenuBar menu 'Settings'/'Environment Variables...'. edit the cobrac entry to specify the full path to the |
| | 59 | cobra compiler and save your changes. |
| | 60 | |
| | 61 | == Tested On == |
| | 62 | Installation Tested on Windows (XP-pre SP3). |
| | 63 | |
| | 64 | == Usage == |
| | 65 | * Workspace/New Project |
| | 66 | select type of cobra project from templates given and enter project name and path to your project directory and press OK. |
| | 67 | |
| | 68 | * In the generated project tree select the project name and add (existing) or create your cobra sources. |
| | 69 | |
| | 70 | * You;ll notice that where theres a 'resources' virtual dir made for a project theres a file 'build-file' which is a build-list file for the cobra compiler |
| | 71 | unfortunately currently you have to maintain the contents of this yourself as we cant get hold of codelites sourcelist. Just add filename entries to it as |
| | 72 | you add/create your source files. |
| | 73 | |
| | 74 | * Project Menu or keyboard to compile a single file or build all the files in a directory. Build output/errors etc should appear in the 'Output panel' |
| | 75 | |
| | 76 | == Building Cobra == |
| | 77 | |
| | 78 | As a bonus for cobra developers the second attached file 'cobrac-workspace.tar.gz' is a workspace for building cobra.[[BR]] |
| | 79 | It contains a workspace directory tree rooted on 'codelite' containig a 'cobrac' workspace which should be installed |
| | 80 | in the root of your cobra build directory (as a sibling to dirs 'Developer', 'Source', '!HowTo', etc) |
| | 81 | Giving |
| | 82 | {{{ |
| | 83 | 637 xx:...src/cobra/wkspace> lsd |
| | 84 | Developer/ |
| | 85 | HowTo/ |
| | 86 | Reusables/ |
| | 87 | Samples/ |
| | 88 | SamplesInProgress/ |
| | 89 | Source/ |
| | 90 | Supplements/ |
| | 91 | Tests/ |
| | 92 | codelite/ |
| | 93 | 638 xx:...src/cobra/wkspace> ls -1 codelite |
| | 94 | ls -1 codelite |
| | 95 | BuildAll.project |
| | 96 | Cobra.Lang.project |
| | 97 | Tests.project |
| | 98 | build-files |
| | 99 | cobra.project |
| | 100 | cobrac.project |
| | 101 | cobrac.tags |
| | 102 | cobrac.workspace |
| | 103 | lib-build-files |
| | 104 | main.cobra |
| | 105 | tags |
| | 106 | testify.project |
| | 107 | 639 xx:...src/cobra/wkspace> |
| | 108 | }}} |
| | 109 | |
| | 110 | Tell !CodeLite to open the workspace file in this directory/codelite/cobrac.workspace[[BR]] |
| | 111 | |
| | 112 | Viola - cobra compiler inna IDE. Browse, edit, build... |
| | 113 | |
| | 114 | More details on CodeliteCobraWorkspace layout |
