Rejig path calculations.\nMove reset target to Perl.\n

1 files changed, 39 insertions, 1 deletions

diff --git a/README.md b/README.md
index e976748..f086c92 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,45 @@ still find [what
 documentation](http://mjo.tc/atelier/2009/02/arduino-cli.html
 "Documentation") exists.
 
-If you're using Debian or Ubuntu, you can find this in the arduino-core package.
+If you're using Debian or Ubuntu, you can find this in the
+arduino-core package.
+
+# Important Changes, 2012-04-29
+
+I've rejigged the path calculations so that:
+
+1. Few, if any paths, need to specified in the project specific Makefiles.
+
+1. The paths can be grabber from the environment e.g. set up in a user's .bashrc.
+
+1. It should be easier to move between e.g. Mac and Linux.
+
+I'm indebted to Christopher Peplin for making me think about this, and indeed for
+contributing code which did similar things in different ways.
+
+The upshot of all this is that you'll need to set up some variables if you want 
+this to work:
+
+On the Mac you might want to set:
+
+    ARDUINO_DIR   = /Applications/Arduino.app/Contents/Resources/Java
+    ARDMK_DIR     = /usr/local
+
+On Linux, you might prefer:
+
+    ARDUINO_DIR   = /usr/share/arduino
+    ARDMK_DIR     = /usr/local
+    AVR_TOOLS_DIR = /usr
+
+The Makefile also delegates resetting the board to a short Perl program.
+You'll need to install Device::SerialPort to use it though. On Debian or 
+Ubuntu do
+
+       apt-get install libdevice-serial-perl
+
+On other systems
+
+       cpanm Device::SerialPort
 
 ## User Libraries