Developer Guide: Obtaining the Pluto 1.0.1 Source Code

There are several reasons why you may want to have access to the Pluto source code. Some may want to participate in the development of Pluto by submiting patches. Others may want to utilize Pluto as a reference implementation to clarify the Portlet Specification. Whatever the reason, there are two ways to access the source code:

  1. Downloading the most recent Source Distribution is the easiest way to access the source. Of course, because this method is reliant on releases, you may not have the most recent source. That said, you do have a better chance at recieving a more stable codebase if you are using a distribution.
  2. Using Subversion to checkout the absolute up-to-date version of the code is the best way to retrieve the source code. If you plan to submit patches, we ask that you use the Subversion Trunk to create your diffs.

Downloading the Source Distribution

See the download instructions

Using Subversion

The Pluto project uses the Subversion version control system. If you're new to Subversion, you can check out the online book about Subversion. Note that we are currently using Subversion 1.1.x (there are separate versions of the book covering 1.0 and 1.1).

Web Access to Subversion

If you just want to browse the Pluto 1.0.1 source code, you can use the ViewCVS web interface to Subversion. This is current at all times.

Normal Subversion Access

Anyone can check code out of Subversion anonymously. However, you need to specify a username and password in order to update the Subversion repository, and only Pluto committers have the permissions to do that. We run Subversion over standard HTTPS, so hopefully you won't have problems with intervening firewalls.

Check out from Subversion

Again, anyone can do this. To check out Pluto 1.0.1 (general release) to a directory called 'pluto' use this command: 

svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/release-1.0.1/ pluto

To check out Pluto 1.0.1 (bug fix version) use this command: 

svn checkout https://svn.apache.org/repos/asf/portals/pluto/branches/pluto-1.0.2/ pluto

This code base will become Pluto 1.0.2 if we feel necessary to release a new version.