From 3e839915609f207439fd7dfe32d95acb025770ab Mon Sep 17 00:00:00 2001 From: Øyvind Harboe Date: Wed, 30 Mar 2011 13:08:39 +0200 Subject: docs: add HACKING file to help users get started with patches MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Øyvind Harboe --- HACKING | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 HACKING (limited to 'HACKING') 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 -- cgit v1.2.3