| 1 | |
|---|
| 2 | This is the offical README file for the game project |
|---|
| 3 | |
|---|
| 4 | -------------------------------------------------------- |
|---|
| 5 | orxOnox |
|---|
| 6 | -------------------------------------------------------- |
|---|
| 7 | |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | |
|---|
| 11 | 1.Manifesto: |
|---|
| 12 | ---------- |
|---|
| 13 | Orxonox is a open-source vertical scroller game programed |
|---|
| 14 | in c++ and OpenGL. |
|---|
| 15 | If we manage to be sober enough, this game shall definitly |
|---|
| 16 | become _the_ open-source vertical scrolle ever. |
|---|
| 17 | |
|---|
| 18 | |
|---|
| 19 | 2.Overview: |
|---|
| 20 | --------- |
|---|
| 21 | 1.Manifesto |
|---|
| 22 | 2.Overview |
|---|
| 23 | 3.Contributing To The Project |
|---|
| 24 | |
|---|
| 25 | |
|---|
| 26 | 3.Contributing To The project: |
|---|
| 27 | ------------------------------ |
|---|
| 28 | People who want to help us working on orxonox are always |
|---|
| 29 | welcome:) Feel free to chip in anything you like. Wine, beer, |
|---|
| 30 | coffee... If you like to help us programming orxonox, you: |
|---|
| 31 | - join the developer community mailing lists |
|---|
| 32 | - read this README file |
|---|
| 33 | then you have multiple ways to get started. |
|---|
| 34 | a) Read the hole source code and choose a topic you like |
|---|
| 35 | b) check the TODO file to get a knowledge of what we need |
|---|
| 36 | c) ask us for more information |
|---|
| 37 | To get more informations about programming and project specs |
|---|
| 38 | read the programming sections below. |
|---|
| 39 | |
|---|
| 40 | To start programming on orxonox you first have to download the |
|---|
| 41 | newest svn tree of orxonox. You can do this by enterning following |
|---|
| 42 | lines in the linux console (ensure svn to be installed with ssl |
|---|
| 43 | support enabled): |
|---|
| 44 | |
|---|
| 45 | svn co https://open.datacore.ch/pw/orxonox orxonox |
|---|
| 46 | |
|---|
| 47 | If you haven't got ssl support in you svn tool, recompile it |
|---|
| 48 | ./configure --with-ssl |
|---|
| 49 | make |
|---|
| 50 | make install |
|---|
| 51 | |
|---|
| 52 | |
|---|
| 53 | Howto C++ Programming: |
|---|
| 54 | ------------------------ |
|---|
| 55 | If you are new to c/c++ programming, this project is probably |
|---|
| 56 | not the best starting place to learn it. For you and the rest who |
|---|
| 57 | need "refreshment" check out these guides: |
|---|
| 58 | |
|---|
| 59 | www.cplusplus.com/doc/tutorial |
|---|
| 60 | www.4p8.com/eric.brasseur/cppcen.html |
|---|
| 61 | |
|---|
| 62 | |
|---|
| 63 | Howto SVN: |
|---|
| 64 | ---------- |
|---|
| 65 | For a more complete guide about this topic read the documentation |
|---|
| 66 | avaiable at subversion.tigris.org. |
|---|
| 67 | |
|---|
| 68 | SVN (=subversion) is a version control program similar to CVS but |
|---|
| 69 | newer. This program enables us to work all at the same program at |
|---|
| 70 | the same time - tricky. |
|---|
| 71 | |
|---|
| 72 | subversion checkout https://open.datacore.ch/pw/orxonox orxonox |
|---|
| 73 | same as: subversion co https://open.datacore.... |
|---|
| 74 | |
|---|
| 75 | this makes a directory orxonox at your current place in and gets |
|---|
| 76 | the hole brand new source code from the server. |
|---|
| 77 | |
|---|
| 78 | now you can work. Remember to use 'svn copy instead of 'cp', |
|---|
| 79 | 'svn mv' instead of 'mv', 'svn rm' instead of 'rm'... - you got it |
|---|
| 80 | I think. |
|---|
| 81 | After you have made your changes to the files enter |
|---|
| 82 | svn status |
|---|
| 83 | or with more details: svn status -vv |
|---|
| 84 | which will show you the changes you did locally on your computer. |
|---|
| 85 | svn diff |
|---|
| 86 | is similar but shows you all the changes in detail. |
|---|
| 87 | |
|---|
| 88 | svn diff > patchfile |
|---|
| 89 | the patchfile you can use later in conjunction with the patch program. |
|---|
| 90 | You could, for example, email this patchfile to another developer for |
|---|
| 91 | review or testing prior to commit. |
|---|
| 92 | |
|---|
| 93 | To add a new file type |
|---|
| 94 | svn add <filename> |
|---|
| 95 | and to publish all your changes type |
|---|
| 96 | svn commit |
|---|
| 97 | which will open a text program to show you a list of changes that will |
|---|
| 98 | be committed. Delete the line beginning with '--', this will put all |
|---|
| 99 | your changes to the orxonox server. |
|---|
| 100 | |
|---|
| 101 | If you accidently make a change you like to revert, you just can do this |
|---|
| 102 | by typing: |
|---|
| 103 | svn revert <filename> |
|---|
| 104 | |
|---|
