aboutsummaryrefslogtreecommitdiff
path: root/HACKING
diff options
context:
space:
mode:
authorØyvind Harboe <oyvind.harboe@zylin.com>2011-03-30 13:08:39 +0200
committerØyvind Harboe <oyvind.harboe@zylin.com>2011-03-30 15:58:11 +0200
commit3e839915609f207439fd7dfe32d95acb025770ab (patch)
tree0188a27c5efb08c621d04ecad60dbf805cde76d1 /HACKING
parent56f705525cd64b78d34edc3012790ecf01025073 (diff)
docs: add HACKING file to help users get started with patches
Signed-off-by: Øyvind Harboe <oyvind.harboe@zylin.com>
Diffstat (limited to 'HACKING')
-rw-r--r--HACKING49
1 files changed, 49 insertions, 0 deletions
diff --git a/HACKING b/HACKING
new file mode 100644
index 00000000..5718798d
--- /dev/null
+++ b/HACKING
@@ -0,0 +1,49 @@
+Submitting patches to the OpenOCD mailing list:
+
+By the time you have read this, one supposes that
+you have figured out how to clone the OpenOCD git
+repository.
+
+Below is a basic workflow and specific instructions
+to get you going with git and patches.
+
+0. Clone the git repository, rather than just
+download the source.
+
+git clone git://openocd.git.sourceforge.net/gitroot/openocd/openocd
+
+or if you have problems with the "git:" protocol, use
+the slower http protocol:
+
+git clone http://repo.or.cz/r/openocd.git
+
+1. Set up git with your name and email:
+
+git config --global user.name "John Smith"
+git config --global user.email "john@smith.org"
+
+2. Work on your patches. Split the work into
+multiple small patches that can be reviewed and
+applied seperately and safely to the OpenOCD
+repository.
+
+while(!done) {
+ work - edit files using your favorite editor.
+ run "git commit -a" to commit all changes.
+}
+
+TIP! use "git add ." before commit to add new files.
+
+3. Next you need to make sure that your patches
+are on top of the latest stuff on the server and
+that there are no conflicts.
+
+git pull --rebase
+
+4. Generate the patch files. This will generate
+patches for all commits that are on top of
+the latest stuff on the server:
+
+git format-patch origin/master
+
+5. Email the patches to openocd-development@lists.berlios.de