# Source Repository

## Modules

XStream project consists of several modules:

1. xstream - the core module
2. xstream-benchmark - the benchmark tool
3. xstream-distribution - the module contains the documentation and assembles the src and bin distributions

When you checkout the trunk you'll get all the modules, but you can just add the module you are interested in to the URL, e.g.

    svn co http://svn.codehaus.org/xstream/trunk/[module]

to checkout out the single module separately.

## Browser

You can use the browser to navigate within the sources online with the help of the FishEye installation on Codehaus.

## Subversion

XStream uses Subversion as the SCM. See Subversion website for details and documentation on IDE integration.

## Svnserve Access

Svnserve access is via a specific port (Codehaus uses the default 3690). This is often not allowed by corporate firewalls.

### Anonymous Access

    svn co svn://svn.xstream.codehaus.org/xstream/trunk

## WebDav Access

WebDav is an alternative access protocol supported by SVN and being http-based is often allowed by corporate firewalls.

### Anonymous Access

    svn co http://svn.codehaus.org/xstream/trunk

You might also use this URL to browse the repository in a simple manner.

### Committer Access

    svn co https://svn.codehaus.org/xstream/trunk

This access protocol is available to all, but only developers can commit changes.

Developers require a LDAP password for Codehaus username (contact Bob at the Haus to get assigned a password if you don't have one).

To test https commit access, one may e.g.:

    svn co https://svn.codehaus.org/xstream/trunk xstream
    cd xstream
    echo "test" > TEST
    svn add TEST
    svn commit --username username --password your-password --message "Testing https"

Note: you only need to specify username and password once per client.

# Software

- About XStream
- News
- Change History
- About Versioning

# Evaluating XStream

- Two Minute Tutorial
- Object references
- Tweaking the Output
- License
- Download
- References
- Statistics

# Using XStream

- Architecture Overview
- Converters
- Frequently Asked Questions
- Users' Mailing List
- JavaDoc Core
- JavaDoc Benchmark
- Reporting Issues

# Tutorials

- Two Minute Tutorial
- Alias Tutorial
- Annotations Tutorial
- Converter Tutorial
- Object Streams Tutorial
- Persistence API Tutorial
- JSON Tutorial

# Developing XStream

- How to Contribute
- Developers' Mailing List
- Development Team
- Source Repository
- Continuous Integration