Add support for remote containers

1. I've added a missing summary line to the issue description.

2. I've attached a patch.
/Please not however that I was not able to do a full Cargo build as the AbstractDocumetnBuilder module test fails, so I was only able to do some testing./

Here's a patch for CargoTask.java which I forgot to supply before.

Unfortunately, it fails the checkstyle sanity check because of a too complex boolean condition, and I don't like changing it into nested if's.

I think checkstyle is right... It's impossible to read! Not your fault I know as you have inherited something that was probably alreayd too diffiult to read...

Bit this reveals something more profound...

I personally do not like doing any if at all. So for example the fact that you have to modify several methods to write:

if (... instanceof LocalContainer)

else if (.... instance RemoteContainer=
...

suggests that there is a design problem.

Moreover the fact that the setupHomeDir() method is named with Dir means that it is for setting up a directory and not a URI.

Also, we shouldn't allow for both the uri and dir to be specified at the same time...

So I think we've made a decision that a local container is not a remote container and thus we cannot treat them as such. I'd venture that we need 2 CargoTask: CargoLocalTask and CargoRemoteTask both extending a common CargoTask. in term of XML we could continue to name the local one "<cargo>" for now and to name the remote one "<cargo-remote>".

This needs to be brought to the list and voted upon I think. Thanks.

There might be another solution - see CargoTestCase/EnvironmentTestData patch:
1. In XML: specify home as an URI
2. In CargoTask: Parse URI's scheme and assume the container to be local for "file" and remote for anything else.

WDYT?

List of use cases for Local/Remote containers and Local/Runtime configurations

Configuration interface hierarchy

We've had a vote on the Cargo dev list about how to finalize the design for Local/Remote containers and Local/Runtime configurations (see http://www.nabble.com/-cargo-dev-VOTE-LocalContainer-RemoteContainer-and-BoostrapConfiguration-RuntimeConfiguration-t369078.html).

The vote was on the following diagrams:
http://jira.codehaus.org/secure/attachment/16892/cargo-use-cases.jpg
http://jira.codehaus.org/secure/attachment/16893/cargo-configurations.jpg

I'm currently working on refactoring Cargo's core to implement it.

Done. Closing for now as all the main stuff is done.