From 190c1efc2667784a1313e7633be0767f20dcb671 Mon Sep 17 00:00:00 2001
From: Mark Wooding <mdw@distorted.org.uk>
Date: Sun, 10 May 2020 02:48:03 +0100
Subject: [PATCH] bin/mdw-build: Make a note of the persistent file-descriptor
 assignments.

It's a little fiddly to work out each time.
---
 bin/mdw-build | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/bin/mdw-build b/bin/mdw-build
index 45ca7f8..7c82524 100755
--- a/bin/mdw-build
+++ b/bin/mdw-build
@@ -184,6 +184,15 @@ case $jobs in 1) ;; *) makeopts="$makeopts -j$jobs" ;; esac
 ###--------------------------------------------------------------------------
 ### Utility functions.
 
+## File descriptor assignments:
+##
+##    0 -- original stdin (never touched)
+## 1, 2 -- stdout, stderr, redirected to 3 while running comamnds
+##    3 -- original stderr (verbose), or logfile (quiet); captures command
+##		output
+##    4 -- null (verbose), or logfile (quiet); primary diagnostic output
+##    5 -- orginal stderr; secondary diagnostic output (with colours)
+
 exec 3>&2 4>/dev/null 5>&2
 
 notify () {
-- 
2.11.0