| | 1 | == Introduction == |
| | 2 | |
| | 3 | Cobra is an open source project under the MIT license. Using Cobra out of the source code repository is: |
| | 4 | |
| | 5 | * Safe, because Cobra accumulates stability through an automated regression suite, currently containing over 700 test programs. |
| | 6 | * Easy, because there is an "install-from-workspace" script available to build Cobra correctly and install it into your system. |
| | 7 | * Rewarding, because you get to use the latest features. You'll see new features and fixes discussed in the [http://cobra-language.com/forums/viewforum.php?f=4 forum] after which you can update your workspace and run the installer again. |
| | 8 | |
| | 9 | == How To == |
| | 10 | |
| | 11 | On Windows, to run the installer for the first time, you do the following. On Vista, you may need to run as admin or power user. |
| | 12 | {{{ |
| | 13 | > svn co http://cobra-language.com/svn/cobra/trunk/ cobra-workspace |
| | 14 | > cd cobra-workspace/Source |
| | 15 | > install-from-workspace |
| | 16 | }}} |
| | 17 | |
| | 18 | On Mac/Linux/Unix: |
| | 19 | {{{ |
| | 20 | $ svn co http://cobra-language.com/svn/cobra/trunk/ cobra-workspace |
| | 21 | $ cd cobra-workspace/Source |
| | 22 | $ sudo ./install-from-workspace |
| | 23 | }}} |
| | 24 | |
| | 25 | The output will give you information about installation location and PATH. If your PATH already contained a `cobra.bat` or `cobra` script, it will be updated to point to the latest installation. |
| | 26 | |
| | 27 | If you already have a workspace, start this with before running the installer: |
| | 28 | {{{ |
| | 29 | cd cobra-workspace |
| | 30 | svn up |
| | 31 | cd Source |
| | 32 | }}} |
| | 33 | |
| | 34 | ...on any platform. Then run the installer. |
| | 35 | |
| | 36 | Additional notes: |
| | 37 | |
| | 38 | * It is safe to run the install script multiple times. |
| | 39 | * It is safe to remove the workspace afterwards if you need the space. |
| | 40 | * Of course, you can use a Subversion client other than the command line one. |
| | 41 | |
| | 42 | == Recreating the Workspace == |
| | 43 | |
| | 44 | You may need to recreate the exact same version of the workspace on another machine to ensure that you have an identical version of Cobra. First, get the exact revision number of the original workspace: |
| | 45 | |
| | 46 | {{{ |
| | 47 | svn info |
| | 48 | >svn info |
| | 49 | Path: . |
| | 50 | URL: http://cobra-language.com/svn/cobra/trunk |
| | 51 | Repository Root: http://cobra-language.com/svn |
| | 52 | Repository UUID: 30746285-aa12-4141-907f-d1d40c2173e5 |
| | 53 | Revision: 1780 |
| | 54 | Node Kind: directory |
| | 55 | Schedule: normal |
| | 56 | Last Changed Author: Chuck.Esterbrook |
| | 57 | Last Changed Rev: 1780 |
| | 58 | Last Changed Date: 2008-11-24 22:08:11 -0800 (Mon, 24 Nov 2008) |
| | 59 | }}} |
| | 60 | |
| | 61 | Notice the second to last line gives the revision: |
| | 62 | {{{ |
| | 63 | Last Changed Rev: 1780 |
| | 64 | }}} |
| | 65 | |
| | 66 | Now on the other machine you can check out exactly that revision: |
| | 67 | {{{ |
| | 68 | svn co -r 1780 http://cobra-language.com/svn/cobra/trunk/ cobra-workspace |
| | 69 | cd cobra-workspace |
| | 70 | svn info |
| | 71 | }}} |
| | 72 | |
| | 73 | == See Also == |
| | 74 | |
| | 75 | * [http://cobra-language.com/source/ Source] |
| | 76 | * [http://subversion.tigris.org/ subversion.tigris.org] |
