Dev:versioning

From railML 2 Wiki
Revision as of 22:58, 13 April 2012 by RailML Superseded Users (talk | contribs) ('Exchange a railML file based on unstable schemas' added)
Jump to navigation Jump to search

Download railML

Current stable release

In order to get the current stable railML package, click Download released version on the railML homepage.

The package consists of an zip archive containing:

  • XML Schema files in schema folder
  • XML example files in examples folder
  • HTML documentation in documentation folder

Current stable release is railML 2.1.

Older stable releases

Older officially released railML versions are archived at the railML homepage. Click Development > Download > archives or this direct link.

All downloads are zip archived.

Developer unstable releases

Since railML 1.1 the development of railML can be publicly supervised through the public subversion repository located at Assembla.

Subversion is an open source version control system. All code changes are registered with date and time together with its commiter and a commit log message.

Regularly downloads

If you want to keep track of all code commits, you should use an subversion client. See Assembla hints for subversion client software.

  • Change to your local railML folder.
  • First time: checkout the current repository (all changes since version 1.1 - lasted 21 seconds up to revision 377).
    svn co http://svn2.assembla.com/svn/railML/
  • Further: update your local repository copy as often as you want (all recent changes since last svn update).
    svn up http://svn2.assembla.com/svn/railML/

You get railML files according to its repository folders.

Most recent snapshot

If you don't run an subversion client, you can nevertheless get a copy of the most recent developer version.

Simply click Developer version on the railML homepage to download an zip archive of repositories' trunk folder.

The zip archive contains:

  • Current XML Schema files in schema folder
  • Current XML example files in examples folder
  • Current defect XML sample files for semantic validation purposes in defectSamples folder
  • blank documentation folder

Exchange a railML file based on unstable schemas

The following XML fragment shows how to exchange railML files using unstable railML schemas.

<?xml version="1.0" encoding="UTF-8"?>
<railml version="2.1r416"
  xmlns="http://www.railml.org/schemas/2011" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.railml.org/schemas/2011 http://trac.assembla.com/railML/export/416/trunk/schema/railML.xsd">
  ...
</railml>
  • Use the last released version number plus the current SVN number: version="2.1r416"
  • Use the last released namespace
    • as default namespace: xmlns="http://www.railml.org/schemas/2011"
    • as prefixed namespace: xmlns:rail="http://www.railml.org/schemas/2011" (not shown above)
  • Use the appropriate web-based Schema location at Assembla: xsi:schemaLocation="http://www.railml.org/schemas/2011 http://trac.assembla.com/railML/export/416/trunk/schema/railML.xsd"

For local validation purposes, see Local versus web-based validation (XML catalogs and XML namespaces)

Supervise current development without download

The public web-based Subversion repository offers public supervision of current development without downloading some file.

List of recent code changes

Assembla provides a Stream tab to show a list of recent code commits, you can profile the output with the Filter on the righten side. Just have a look what the coordinators commited last time.

The same code commits are listed in the Assembla Trac Timeline view which can be profiled with parameters of the grey box at righten side: choose Repository checkins.

Browse the source files

[to be written]

Revision log

[to be written]

Subversion repository folders

[to be written]

branches

[to be written]

tags

[to be written]

trunk

[to be written]

Back to Common overview