Subversion (SVN)

From UntangleWiki

To check out the latest Untangle source, run this checkout command:

svn co svn://svn.untangle.com/trunk/src

This will "check out" all of the source files.

Alternatively, to get the entire codebase:

svn co svn://svn.untangle.com/trunk

This includes all source files and packages, which you most likely do not need. Warning: this is big.

To update your working copy later, go into the directory and run this command:

svn update

This will update all your files to the latest version.

Contributing Fixes and Enhancements

We encourage you to raise issues, report problems and request enhancements on our forums and in our bug tracking database. We also welcome submitted code ranging from bug fixes to substantial new features for possible inclusion into our Untangle product suite. Submissions must be accompanied by an signed contributors agreement.

How to Contribute

• File a bug in our bug tracking system
• Submit your code changes
  

This command will show you what files you've changed:

svn status

And this will output a line-by-line description of all the changes in a format that makes it easy for us to incorporate:

svn diff

You can output this to an appropriately named file (please use the bug number) by using redirection:

svn diff > bug123_patch.txt

Submit your code changes as an attachment to the bug.

• Submit a signed Contributor Agreement

In order for us to accept a contribution, you must complete our Contributor Agreement. This file is in PDF format. (On purpose, we need a format not intended for modification.) Print it, mourn the loss of a tree, fill it out and sign it. You can return it to us by scanning the signed form and e-mailing it to dev@untangle.com, FAXing it to 650-345-3788, or sending it in the mail to the address listed on the form.