readme.sh

 #!/bin/sh
+# vim:ff=unix tw=80 ts=4 sw=4 ai expandtab
 
-echo "\
-<!-- The \`readme.sh\` Bourne shell script in the project's root directory
-     generates this document. The next execution of the script will overwrite
-     any changes to this document.  Please edit and execute the script in order
-     to change this document. -->
-" > README.md
+set -e ;
+set -u ;
+
+exec 1> README.md ;
+
+echo_stdin(){
+
+    while IFS="" read -r line ;
+    do  
+        echo "${line}" ;
+    done ;
+
+    return 0 ;
+
+}
+
+_WARNING="\
+The \`readme.sh\` shell script in the project's root generates this document
+Please edit \`main.yaml\` and execute \`readme.sh\` in order to change this
+document." ;
+
+echo_stdin <<- __END_OF_STDIN__
+<!--
+${_WARNING}
+-->
+
+$(./kvm_tool help)
+
+readme.sh
+---------
+
+${_WARNING}
+__END_OF_STDIN__
+
+exit 0 ;
 
-./kvm_tool help >> README.md