== Subversion Source Control System ==

MacPorts uses [http://subversion.tigris.org Subversion] as its version control system. Subversion documentation is available through the [http://svnbook.red-bean.com/ online Subversion Book]. The Subversion command line client svn is shipped with Apple's Mac OS X Leopard, and available through MacPorts on earlier Mac OS X versions. There is also a Subversion installation available in binary form from [http://www.macosforge.org/subversion.html MacOSForge]. Subversion GUI clients are built in to [http://www.apple.com/xcode XCode] and [http://www.bbedit.com BBEdit].

== Browsing the MacPorts Sources Online ==

You may browse the MacPorts Subversion sources online in one of three ways:

 1. Via the [http://trac.macosforge.org/projects/macports/browser Trac source code browser]
 1. Directly through Subversion via its underlying [http://svn.macosforge.org/repository/macports/ http support].
 1. You may also directly access the Subversion respository through a WebDav client such as the Mac OS X Finder. (Select Connect to Server… and paste in the URL http://svn.macosforge.org/repository/macports/).


== Checking out MacPorts sources using Subversion ==

To checkout the sources with Subversion:

{{{
# Checkout the macports trunk
svn checkout http://svn.macports.org/repository/macports/trunk macports-trunk
}}}

When committing to the repository for the first time, subversion will use your local account name as the username for svn.macports.org. This is almost certainly the wrong username, so you can either hit enter when it says "password for 'local-user-name':" and then enter the correct alias@macports.org when it prompts for username, or you can pass --username to svn like the following example:

{{{
svn ci . -m 'log message' --username alias@macports.org
}}}

After the first commit with the correct username and password, subversion will cache this information (in ~/.subversion/).