Attempt to make devtest_testenv docs work better.

Based on a mammoth IRC conversation...

Change-Id: I818568e813dff73ad707e9fa8e3af94a98244d84

scripts/devtest.sh

@@ -147,6 +147,7 @@ $(dirname $0)/devtest_setup.sh $CONTINUE
 ##    ::
 
 if [ "$TRIPLEO_CLEANUP" = "1" ]; then #nodocs
+#XXX: When updating, also update the header in devtest_testenv.sh #nodocs
 devtest_testenv.sh $TE_DATAFILE
 fi #nodocs
 

scripts/devtest_testenv.sh

@@ -32,7 +32,19 @@ while true ; do
     esac
 done
 
+### --include
+## devtest_testenv
+## ===============
+
+#XXX: When updating, sync with the call in devtest.sh #nodocs
+
+## This script is usually called from devtest.sh as
+## devtest_testenv.sh $TE_DATAFILE
+## ::
+
 JSONFILE=${1:-''}
+
+### --end
 EXTRA_ARGS=${2:-''}
 
 if [ -z "$JSONFILE" -o -n "$EXTRA_ARGS" ]; then
@@ -40,8 +52,6 @@ if [ -z "$JSONFILE" -o -n "$EXTRA_ARGS" ]; then
 fi
 
 ### --include
-## devtest_testenv
-## ===============
 
 ## #. Configure a network for your test environment.
 ##    This configures an openvswitch bridge and teaches libvirt about it.