composite: make 'watch' more usable and add a small documentation

README.md

@@ -462,6 +462,12 @@ A fully contained nightly build for the system is invoked using:
 
     # make nightly
 
+When nightly builds are being run you can get a brief report of
+the latest one for each build step or select a build step to either
+view the file or watch it run in real time:
+
+    # make watch[-<step>]
+
 To allow the nightly build to build both release and development packages
 use:
 

composite/watch.sh

@@ -36,11 +36,27 @@ if [ -z "${CURRENTDIR}" ]; then
 fi
 
 if [ -z "${LOGSTEP}" ]; then
-	find ${CURRENTDIR} -name "*.log"
-	return
+	echo nightly build $(basename ${CURRENTDIR})
+	echo ==========================
+	for CURRENTLOG in $(find -s ${CURRENTDIR} -name "*.log"); do
+		CURRENTRET=running
+		if [ -f ${CURRENTLOG}.ok ]; then
+			CURRENTRET=ok
+		elif [ -f ${CURRENTLOG}.err ]; then
+			CURRENTRET=error
+		fi
+		CURRENTLOG=${CURRENTLOG#"${CURRENTDIR}/"}
+		CURRENTLOG=${CURRENTLOG%.log}
+		CURRENTLOG=${CURRENTLOG#*-}
+		echo ${CURRENTLOG}: ${CURRENTRET}
+	done
+else
+	for CURRENTLOG in $(find ${CURRENTDIR} -name "??-${LOGSTEP}.log"); do
+		if [ -f ${CURRENTLOG}.ok -o -f ${CURRENTLOG}.err ]; then
+			less ${CURRENTLOG}
+		else
+			tail -f ${CURRENTLOG}
+		fi
+		break
+	done
 fi
-
-for CURRENTLOG in $(find ${CURRENTDIR} -name "??-${LOGSTEP}.log"); do
-	tail -f ${CURRENTLOG}
-	break
-done