Difference between revisions of "Patches"

From BRL-CAD
(Guide on how to make and submit a svn patch)
 
(How to Submit a patch)
Line 35: Line 35:
 
To submit a patch to the BRL-CAD tracker you must first create
 
To submit a patch to the BRL-CAD tracker you must first create
 
a [http://sourceforge.net/ sourceforge account].
 
a [http://sourceforge.net/ sourceforge account].
Of course, if you have one already, you don't need to create another.
+
Of course, if you have one already, you don't need to create another.
  
 
Now, you can submit your patch on the [http://sourceforge.net/tracker/?group_id=105292&atid=640804 BRL-CAD tracker] by clicking "Add new".  
 
Now, you can submit your patch on the [http://sourceforge.net/tracker/?group_id=105292&atid=640804 BRL-CAD tracker] by clicking "Add new".  

Revision as of 21:24, 19 November 2012

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!