CVS Files

From e107 Wiki
Jump to: navigation, search

e107 Wiki: English | Русский | Deutsch | Français | Magyar | Português | Български | Česky | Nederlands | Ελληνικά | Italiano | Norske | Polska | Slovenščina | Español | Svenska | Translate: Wiki | Page

logo_wiki.png

Current Release 1.0.4 | e107.org | Download | Changelog | Forum | Plugins | Themes | RSS Feed of Latest Changes | Atom Feed of Latest Changes


Development part of the e107 handbook
Main page > I : First Aid > II : Development > III : Administration > IV : How To's > V : Plugin Writing > VI : Theming & Shortcodes


Developer Information
Release Information

As of 9 February 2010 CVS was replaced with SVN. The old CVS files have been marked read only and the following information is in place while everything is updated.

Development of E107 is controlled using a system called SVN, which logs file versions and enables the changes between versions to be identified. It allows access to not only the latest version of each file, but all previous versions. There is a link to the SVN on the main E107 site.

It may be necessary to obtain files from SVN for various reasons - typically to fix a bug which is important on a particular site. However, be warned:

  • The files in SVN may be an 'interim' state which could break your site. (This is very likely to be the case if a major update is in progress - for example, at the time of writing this, application of SVN updates from the 0.7 'branch' to version 0.7.24 will probably work OK, but any attempt to use the 2.0 SVN files is pretty much guaranteed to break your siteuntil it's at least at 'Beta release' stage.)
  • The changes may cause different problems.
  • You cannot always 'cherry pick' the files you need to solve a problem - you may need multiple files which have been modified to work together.

In short:

 Don't update your live site from the SVN unless you really need to!
 Make sure you can roll back the changes if they don't work
 Test on a private site first.

Direct access of SVN requires an appropriate client like Tortoisesvn.

To simplify updates, one or two users produce 'compilations' of all the changes since the last stable release, which can be downloaded as a single zip file. On some occasions there is also a 'semi-stable' update pack available, containing all updates up to a point where the files in SVN appeared to be stable. Information on this can be found within the forums and in e107 Downloads.


Accessing SVN from a Unix Machine

(Thanks to MrNiceGuy for this information)

1. Log into your shell.

2. Type: 'export SVNROOT=:pserver:anonymous@e107.svn.sourceforge.net:/svnroot/e107'.

3. Type 'cvs login'.

4. Press <enter> when prompted for a password.

5. In your home dir, type 'cvs checkout e107_0.7'

6. In ~/e107_0.7, you should have a copy of the latest SVN version of e107.

Notes:

o You can 'svn logout', but you don't need to.

o You don't need to go through this whole process every time. If you want to get a SVN version of e107 at a later time, you can just 'cd ~/e107_0.7' and type 'svn update -CdAP'.

o If you experience errors when using 'export', you might be using tclsh as a shell. If so, try using the command 'setenv' instead of 'export':

 setenv SVNROOT :-pserver:anonymous@e107.svn.sourceforge.net:/svnroot/e107 


Accessing SVN from a Windows Machine

If you are working from a Windows Machine one of the easiest ways to check out the sources is Tortoise. Download and install TortoiseSVN from TortoiseSVN. You need to restart Windows.

Go to the directory where you want to download, right click and select 'SVN Checkout...' from the context menu.

In the opened window set the parameters like in the screenshot: Tortoise1.gif

The parameters are:

protocol: pserver
server: e107.cvs.sourceforge.net
Repository folder: /cvsroot/e107
User name: anonymous

After that click on 'Fetch list' (right hand bottom of screen). After a while the Modules list is populated. Choose one, and click on OK to start the check out.

The modules you may want are:

  • e107_1.0 - the latest for version 1.0 (the current major version)
  • e107_2.0 - the latest for version 2.0, which is in development
  • e107_langpacks - the language packs


Once you have set up your repository and downloaded all the files, you can update by simply right clicking on the directory and selecting 'SVN Update'. Only the files which have changed will be downloaded.


Downloading a SVN Zip File

SVN packages are also available to download from e107.org, check the dates and use at your own risk.