Developer Guide: Obtaining the 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.

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 distiribution.

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 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. You only 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. Use a command like:

svn checkout https://svn.apache.org/repos/asf/portals/pluto/trunk/ pluto

Commit Changes to Subversion

Any Pluto committer should have a shell account on svn.apache.org. Before you can commit, you'll need to set a Subversion password for yourself. To do that, log in to svn.apache.org and run the command svnpasswd.

Once your password is set, you can use a command like this to commit:

svn commit

If Subversion can't figure out your username, you can tell it explicitly:

svn --username you commit

Subversion will prompt you for a password, and once you enter it once, it will remember it for you. Note this is the password you configured with svnpasswd, not your shell or other password.

Thanks to The Geronimo group for these docs.