Subversion
From RFID Guardian
Contents |
Checkout of a source tree
The RFID Guardian software is stored in Subversion repositories. Most repositories are publicly readable. You get the software by checking out a local copy using a subversion command line client.
BEWARE: Windows users must not use a native Windows SVN client, like TortoiseSVN. It mangles line endings and makes the source uncompilable.
Stability
The main branch of the repository is a development branch, and it may be subject to frequent and vehement changes, although the development team is encouraged to create a private branch for large changes. It is not even impossible that a version in the repository will not build. The RFID Guardian team will create stable versions as subversion tags.
Changes you made
When you change the software and you want to contribute your changes to the public tree, there are two possibilities. Either you send in your patches, and the RFID Guardian team will apply them (after review); or you become a member of the development team and gain write acces, so you can commit directly to the repository. In both cases, please follow the coding style guidelines.
Write access
If are a developer with write access to a repository, you must be extremely careful in committing anything to the repository. Please follow these guidelines:
- don't change anything in files (code, documentation, everything) that was written by somebody else, unless you have reached agreement with the author on your changes;
- don't ever commit anything that is generated; think .o, .obj, .a, .dll, .dvi, .ps, .pdf, .class, .jar, and so on; commit the sources from which the thing is generated, together with a Makefile or a build.xml or a shell script;
- don't change anything to reflect your 'better taste', like indentation and layout, local names etc;
- read up on Subversion, see the documentation in the Subversion site;
- follow the coding style guidelines
