SVN
From Lanius CMS Wiki
Contents |
Subversion (SVN)
SVN (Subversion) is a tool used by many software developers to manage changes within their source code tree; it is an open source version control system. It allows users to keep track of changes made over time to any type of electronic data; typical uses are versioning source code, web pages or design documents. Read more at Subversion article.
You can browse the current SVN tree using the following addresses:
- http://laniuscms.svn.sourceforge.net/viewvc/laniuscms/
- http://svn.laniuscms.org/ (redirects to above URL)
Repository structure
This is the topmost outline of our current SVN repository:
- core - master Lanius CMS source code
- addons - all addon packages grouped by type
- tools - sparse tools and utilities
- drafts - source code drafts for future versions
Sub-structure
The core and addons directories contain three subdirectories:
- trunk - the current under development source code
- tags - previously released versions of the software package
- branches - other development versions, alternative to trunk
Client software
- TortoiseSVN for Windows
- RapidSVN (multiplatform)
How to checkout
Create a new directory (for example c:/inetpub/wwwroot under Windows), right click and perform a checkout from the following URL
https://laniuscms.svn.sourceforge.net/svnroot/laniuscms/core/trunk/
If you are using a unix/linux system the command line syntax is
svn co https://laniuscms.svn.sourceforge.net/svnroot/laniuscms/core/trunk/ laniuscms
If you do not want to checkout the Lanius CMS source code but some other package instead, change the last part accordingly.
Example:
https://laniuscms.svn.sourceforge.net/svnroot/laniuscms/addons/languages/it/
Logging in
You will not need any login credentials to login to our public SourceForge.net SVN repository.
Bug hunting
Use our issue tracker for your bug reports and your patches; but always be sure that you are working with the latest SVN revision!
See also Testing.
Developing
If you are going to actively contribute then ask to be given write permissions to the Lanius CMS repository in order to add your changes directly into the main trunk.
Commit rules
If you are using Subversion only to get the files, you will not need to read and understand the commit rules.
- Do not commit copyrighted material! Committed code and material must be compatible with the GPL version 2 license
- Always update before beginning your edit session
- Test your modifications before committing to the trunk
- Always commit when finishing your edit session
- Use descriptive log lines and start each line with an asterisk '*' (theoretically, for each edited file you should summarize the changes in functions' behaviours or user interface or fixes)
- Update also /core/trunk/version.php revision number if you have fixed a bug or implemented a feature
External Links
- http://svnbook.red-bean.com/ - a great online SVN book
- http://subversion.tigris.org/ - the official Subversion website
- http://tortoisesvn.sourceforge.net/downloads - download location for TortoiseSVN
- http://rapidsvn.sourceforge.net/downloads - download location for RapidSVN

