source: orxonox.OLD/orxonox/trunk/documentation/README @ 1796

This is the offical README file for the game project

--------------------------------------------------------
                       orxOnox
--------------------------------------------------------




1.Manifesto:
----------
Orxonox is a open-source vertical scroller game programed
in c++ and OpenGL.
If we manage to be sober enough, this game shall definitly 
become _the_ open-source vertical scrolle ever.


2.Overview:
---------
1.Manifesto
2.Overview
3.Contributing To The Project


3.Contributing To The project:
------------------------------
People who want to help us working on orxonox are always
welcome:) Feel free to chip in anything you like. Wine, beer, 
coffee... If you like to help us programming orxonox, you:
- join the developer community mailing lists
- read this README file
then you have multiple ways to get started. 
a) Read the hole source code and choose a topic you like
b) check the TODO file to get a knowledge of what we need
c) ask us for more information
To get more informations about programming and project specs
read the programming sections below.

To start programming on orxonox you first have to download the 
newest svn tree of orxonox. You can do this by enterning following
lines in the linux console (ensure svn to be installed with ssl
support enabled):

svn co https://open.datacore.ch/pw/orxonox orxonox

If you haven't got ssl support in you svn tool, recompile it
./configure --with-ssl
make
make install


Howto C++ Programming:
------------------------
If you are new to c/c++ programming, this project is probably
not the best starting place to learn it. For you and the rest who 
need "refreshment" check out these guides:

www.cplusplus.com/doc/tutorial
www.4p8.com/eric.brasseur/cppcen.html


Howto SVN:
----------
For a more complete guide about this topic read the documentation
avaiable at subversion.tigris.org.

SVN (=subversion) is a version control program similar to CVS but
newer. This program enables us to work all at the same program at 
the same time - tricky.

subversion checkout https://open.datacore.ch/pw/orxonox orxonox
same as: subversion co https://open.datacore....

this makes a directory orxonox at your current place in and gets
the hole brand new source code from the server.

now you can work. Remember to use 'svn copy instead of 'cp', 
'svn mv' instead of 'mv', 'svn rm' instead of 'rm'... - you got it
I think.
After you have made your changes to the files enter
svn status
or with more details: svn status -vv
which will show you the changes you did locally on your computer.
svn diff
is similar but shows you all the changes in detail.

svn diff > patchfile
the patchfile you can use later in conjunction with the patch program.
You could, for example, email this patchfile to another developer for
review or testing prior to commit.

To add a new file type
svn add <filename>
and to publish all your changes type
svn commit
which will put all your changes to the orxonox server.

If you accidently make a change you like to revert, you just can do this
by typing:
svn revert <filename>