Personal tools
You are here: Home Documentation How to submit patches
Document Actions

How to submit patches

Creating and submitting patches

Creating patches

The preferred format for submitted patches is the file produced by running:

$ svn diff > patchfile.diff

in the root directory of the Subversion project you have been modifying.

It is of course given that you fetch the source code through Subversion if you use this method. Please incorporate the latest updates from the Subversion server by running:

$ svn up

before creating the patch.

If you did not fetch Coin through Subversion but have modified a source code directory structure that came from a source code archive file (.tar.gz), you can produce a diff by e.g. renaming the root directory to archive-name-mod, unpack the original archive once more, and run:

$ diff -r -u archive-name archive-name-mod

from the directory you unpacked the source archives in. Also for this method, ensure the modified source directory structure is clean by running make for the "distclean" rule.

Submitting patches

First of all, any patch we receive should be accompanied by a detailed, concise description of what the patch does.

You should send your patches to coin-patches@sim.no.

How to submit contributions

Contributions are separate systems that use Coin3D, but isn't an integral part of Coin. An example would be a 3D model viewer based on Coin3D.

Please contact coin-support@coin3d.org if you would like to submit a contribution. We will place them under contrib/ in the Coin directory. The authors of the contributions keep all rights to their contributions.