Dev:versioning: Difference between revisions
[unchecked revision] | [unchecked revision] |
m (→Subversion repository folders: Content copied from the Assembla wiki page 'SVN_Branching_Policy') |
(URL to https://svn.railml.org/ published; Assembla removed) |
||
Line 15: | Line 15: | ||
=== Older stable releases === | === Older stable releases === | ||
Older officially released railML versions are archived at the [http://www.railml.org/ railML homepage]. Click ''Development > Download > archives'' or [http://www.railml.org | Older officially released railML versions are archived at the [http://www.railml.org/ railML homepage]. Click ''Development > Download > archives'' or [http://www.railml.org/index.php/download-archive.html this direct link]. | ||
All downloads are zip archived. | All downloads are zip archived. | ||
Line 21: | Line 21: | ||
=== Developer unstable releases === | === Developer unstable releases === | ||
Since railML 1.1 the development of railML can be publicly supervised through the public subversion repository located at [http://www.assembla.com/spaces/railML/ | Since railML 1.1 the development of railML can be publicly supervised through the public subversion repository located at [https://svn.railml.org|railML's SVN]. | ||
Please note: The old server at [http://www.assembla.com/spaces/railML/ www.assembla.com] is not longer in use since March 2014. | |||
[http://subversion.apache.org/ 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. | [http://subversion.apache.org/ 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. | ||
Line 27: | Line 28: | ||
==== Regularly downloads ==== | ==== Regularly downloads ==== | ||
If you want to keep track of all code commits, you should use an subversion client. | If you want to keep track of all code commits, you should use an subversion client. Until a new user management tool is installed at [http://www.railML.org|railML's website], the access at [https://svn.railml.org railML's SVN] is possible only for the railML coordinators. | ||
* Change to your local railML folder. | * Change to your local railML folder. | ||
* First time: checkout the current repository (all changes since version 1.1 - lasted | * First time: checkout the current repository (all changes since version 1.1 - lasted 45 seconds up to revision 611). | ||
*:<pre>svn co | *:<pre>svn co https://svn.railml.org/</pre> | ||
* Further: update your local repository copy as often as you want (all recent changes since last svn update). | * Further: update your local repository copy as often as you want (all recent changes since last svn update). | ||
*:<pre>svn up | *:<pre>svn up https://svn.railml.org/</pre> | ||
You get railML files according to its [[#Subversion_repository_folders | repository folders]]. | You get railML files according to its [[#Subversion_repository_folders | repository folders]]. | ||
Line 59: | Line 60: | ||
xmlns="http://www.railml.org/schemas/2011" | xmlns="http://www.railml.org/schemas/2011" | ||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | ||
xsi:schemaLocation="http://www.railml.org/schemas/2011 | xsi:schemaLocation="http://www.railml.org/schemas/2011 https://svn.railml.org/export/416/trunk/schema/railML.xsd"> | ||
... | ... | ||
</railml> | </railml> | ||
Line 68: | Line 69: | ||
** as default namespace: {{Attr|xmlns<nowiki>="http://www.railml.org/schemas/2011"</nowiki>}} | ** as default namespace: {{Attr|xmlns<nowiki>="http://www.railml.org/schemas/2011"</nowiki>}} | ||
** as prefixed namespace: {{Attr|xmlns:rail<nowiki>="http://www.railml.org/schemas/2011</nowiki>"}} (not shown above) | ** as prefixed namespace: {{Attr|xmlns:rail<nowiki>="http://www.railml.org/schemas/2011</nowiki>"}} (not shown above) | ||
* Use the appropriate web-based Schema location at Assembla: {{Attr|xsi:schemaLocation<nowiki>="http://www.railml.org/schemas/2011 | * Use the appropriate web-based Schema location at Assembla: {{Attr|xsi:schemaLocation<nowiki>="http://www.railml.org/schemas/2011 https://svn.railml.org/export/416/trunk/schema/railML.xsd"</nowiki>}} | ||
For local validation purposes, see [[CO:catalog|Local versus web-based validation (XML catalogs and XML namespaces)]] | For local validation purposes, see [[CO:catalog|Local versus web-based validation (XML catalogs and XML namespaces)]] | ||
Line 76: | Line 77: | ||
== Supervise current development without download == | == Supervise current development without download == | ||
The public web-based Subversion repository offers public supervision of current development without downloading | The public web-based Subversion repository offers public supervision of current development without downloading files. | ||
=== List of recent code changes === | === List of recent code changes === | ||
[to be written] | |||
=== Browse the source files === | === Browse the source files === |
Revision as of 16:42, 15 December 2014
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 SVN. Please note: The old server at www.assembla.com is not longer in use since March 2014.
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. Until a new user management tool is installed at website, the access at railML's SVN is possible only for the railML coordinators.
- Change to your local railML folder.
- First time: checkout the current repository (all changes since version 1.1 - lasted 45 seconds up to revision 611).
svn co https://svn.railml.org/
- Further: update your local repository copy as often as you want (all recent changes since last svn update).
svn up https://svn.railml.org/
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 https://svn.railml.org/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 https://svn.railml.org/export/416/trunk/schema/railML.xsd"
For local validation purposes, see Local versus web-based validation (XML catalogs and XML namespaces)
For more information on how to use version numbers and namespaces, see Recommendations on version numbers.
Supervise current development without download
The public web-based Subversion repository offers public supervision of current development without downloading files.
List of recent code changes
[to be written]
Browse the source files
[to be written]
Revision log
[to be written]
Subversion repository folders
trunk
The /trunk/ directory contains the source files that the next public and stable project release is based on.
tags
The /tags/ directory contains snapshots of public and stable project versions that have been released.
branches
The /trunk/ directory contains the source files that the next public and stable project release is based on.
Back to Common overview