Before you start, make sure that you have an account on submit-3.batlab.org.
 
-From your usual machine,
+From your usual machine, you want to create a temporary workspace directory on submit-3, and then archive a commit of your git clone into that directory. In this directory, we call the directory 'workspace' but it can be anything.
 
 {term}
-  % ssh submit-3.batlab.org mkdir workspace
-  % exit
-  % cd to top of clone(CONDOR_SRC)
-  % git write-tree
-  % git archive xxxxxx(hash created by git write-tree) | ssh submit-3.batlab.org cd workspace '&&' tar xf -
-For Windows execute below command,
-  % git archive xxxxxx(hash created by git write-tree) | ssh USERNAME@submit-3.batlab.org cd workspace ; tar xf -
+  ssh submit-3.batlab.org mkdir workspace
+  cd <to top of clone, usually CONDOR_SRC>
+  git write-tree
 {endterm}
+  git write-tree will print out a hash, which you will then use in the next command.  This synax for this command is slightly different between Linux and Windows.
+
+On Linux the command is
+{term}
+  git archive <hash created by git write-tree> | ssh submit-3.batlab.org cd workspace '&&' tar xf -
+{endterm}
+On Windows, the '&&' doesn't work, so use a ; instead. also you may have to supply your submit-3 username where USERNAME@ appears in the command below.
+{term}
+  git archive <hash created by git write-tree> | ssh submit-3.batlab.org cd USERNAME@submit-3.batlab.org cd workspace ; tar xf -
+{endterm}
+
 So far, this is the same as submitting a workspace build.
 
-Next, log into submit-3.batlab.org, and run the following commands
+Next, go to http://submit-3.batlab.org/results/continuous.php and choose a recent completed build to run tests against. Then run the following commands, substituting the id of the build for <runid>
 {term}
-  % cd workspace
-  % cd nmi_tools
-  % ./condor_nmi_submit --test --buildid=<runid> --workspace=../ --platforms=all --notify-fail-only --desc="A Description" --ignore-missing-platforms --test-sources-from-workspace
+  cd workspace
+  cd nmi_tools
+  ./condor_nmi_submit --test --buildid=<runid> --workspace=../ --platforms=all --notify-fail-only --desc="A Description" --ignore-missing-platforms --test-sources-from-workspace
 {endterm}
+
+You can go to http://submit-3.batlab.org/results/workspace_tests.php in a few seconds and see your test run show up. It will also be visible on the bottom of the details page for the build: http://submit-3.batlab.org/results/run-details.php?runid=<runid>
+
+You can pass additional arguments to condor_nmi_submit to alter the test configuration
+
+*: =--append-config-dir=<dir>= Copy =<dir>/testconfigappend= into the condor_tests directory before running the tests.  The test glue will then append this file to the base condor_config produced by condor_install, and before running any of the tests. Use this to make a global config change, such as turning on IPV6