Development
Quick Links
Hacking on PSG
PSG is Free Software: that is, the license permits you to make modifications to the source code for any purpose. If you choose to re-distribute your modified version of the source code, you must do so under the same license For full details, you may wish to read the full text of the GNU General Public License (GPL).
Creating Patches
When you're considering submitting a modification to PSG, please be nice and send us a patch instead of a full copy of your modified source code. A patch is essentially a file containing the output of the diff program run against a copy of the pristine source, and your modified source.
Here's how to hack PSG nicely:
$ tar zxvf psg-x.y.z.tar.gz $ cp -R psg-x.y.z psg-x.y.z-pristine
Now you can edit the files in psg-x.y.z/. When you're done, do this:
$ diff -r psg-x.y.z-pristine psg-x.y.z > mypatch.txt
You may wish to do your development against the version of PSG in the CVS repository, as this will often be more up-to-date as far as bugfixes and new features go. It may also be horribly broken since it's unstable code; the decision is yours.
Submission Guidelines
Please bear in mind that the developers have a fairly narrow set of aims when developing PSG, so it's possible that they will decide not to include your patch in the next release. Please don't be offended by this; it doesn't mean that they think your patch is no good, but it might not fit into the current aims of the project. Such is life.
The way to submit your patches is to e-mail them to the psg-devel mailing list for the developers to take a look at. The patch will be applied, poked, prodded and tested before a decision is made.
Translations
Guidelines for submitting translations can be found here. For a list of missing strings, click here.