Index: tools/gdb/README
===================================================================
--- tools/gdb/README	(revision 1cfdee94f316eb368ff361b58a931a686ee54aba)
+++ tools/gdb/README	(revision 1cfdee94f316eb368ff361b58a931a686ee54aba)
@@ -0,0 +1,19 @@
+These instructions assume the install <prefix> for uC++ is /usr/local/u++-7.0.0.
+If installed elsewhere, change <prefix>.
+
+Copy <prefix>/.gdbinit to your home directory. If installed elsewhere, change
+the <prefix> within .gdbinit. Thereafter, gdb automatically loads the .gdbinit
+file from the home directory making the following new gdb commands available.
+
+New commands:
+
+    clusters                        : print all clusters
+    processors                      : print all processors on all clusters
+    processors  <clusterName>       : print all processors on cluster
+    task                            : print userCluster tasks, application tasks only
+    task <clusterName>              : print cluster tasks, application tasks only
+    task all                        : print all clusters, all tasks
+    task <id>                       : switch stack to task id on userCluster
+    task 0x<address>	            : switch stack to task on any cluster
+    task <id> <clusterName>         : switch stack to task on specified cluster
+    prevtask                        : return to last switched task