Patches

From BRL-CAD
Revision as of 20:24, 19 November 2012 by Popescu.andrei1991 (talk | contribs) (How to Submit a patch)

How to create, edit or apply a patch

Prerequisites

To handle and apply patches, BRL-CAD uses Subversion.

You will need to install Subversion (Often abbreviated as svn).

If you're on a Debian/Ubuntu system you can get it by running:

sudo apt-get install subversion

You can obtain the latest version of BRL-CAD by running:

svn checkout https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad

If you are in the folder where the "brlcad" folder is and you run that command, svn will only download updated/modified files.


How to create a patch

In order to submit a patch it is important to have the latest version of BRL-CAD. After you have done that, you get into the brlcad directory and run

svn diff > ~/first.patch

This will create the patch file in your user's home. The patch is in text format and you can read it to make sure it contains what was intended.

How to Submit a patch

To submit a patch to the BRL-CAD tracker you must first create a sourceforge account. Of course, if you have one already, you don't need to create another.

Now, you can submit your patch on the BRL-CAD tracker by clicking "Add new".

You should use the description field to explain what you did there and, if necessary, what isn't working.

Be sure to check out the extensive Documentation and Main_Page for tutorials and Contributor Quickies for ways to get involved!