How to submit code

From SlateWiki

Slate uses the distributed version control system DARCS (http://www.darcs.net/), based on the transmission of patches between peers.

Here are some guidelines for sending patches, technical and otherwise:

  • It is preferred that you use Darcs, which is how we manage source and has its own commands to create and email patches. If you have a regular diff or patch, those can also be used, but are more susceptible to external changes and may break easily.
  • However, Darcs is not without issues, and is sensitive to things like character encodings and line endings as you pass a patch file through email. The recommendation is to use the darcs send -o filename option and then attach filename as a binary file. Depending on your email client, sending it as a non- inline attachment may do this, or you may need to put it in a .zip file.
  • Also, the alpha branch maintains some extra facilities that have little to do with the actual source, like the kernel images, and probably eventually a source database or other databases of some kind, so instead please create a patch while working from the main repository. If you don't want to work in main, then just use alpha and migrate over the changes/files when you're ready to transmit them.

We'll try to make it easier in the future, and hope that Darcs becomes even easier to use in this capacity than it already is, so please have patience. Thanks!