YETUS-386. document --html-report-file and clean up htmlout's comments
Signed-off-by: Allen Wittenauer <aw@apache.org>
diff --git a/asf-site-src/source/documentation/in-progress/precommit-qbt.md b/asf-site-src/source/documentation/in-progress/precommit-qbt.md
index 2cb8036..3e8f578 100644
--- a/asf-site-src/source/documentation/in-progress/precommit-qbt.md
+++ b/asf-site-src/source/documentation/in-progress/precommit-qbt.md
@@ -35,3 +35,30 @@
```
${FILE,path="<report-file-path>"}
```
+
+For something a bit more structured, there is also the `--html-report-file`
+option. Using this output, again with Jenkins' email-ext plug-in, it is
+possible to build some very nice looking output that is easily customized:
+
+```
+<html>
+<head>
+<style>
+table {
+ border-collapse: collapse;
+}
+table, th, td {
+ border: 1px solid black;
+}
+tr:nth-child(even){background-color: #f2f2f2}
+</style>
+</head>
+<body>
+<p>See the <a href="${BUILD_URL}">Jenkins Build</a> for more information.</p>
+<p>${CHANGES, format="<div>[%d] (%a) %m</div>"}</p>
+<p></p>
+${FILE,path="<report-file-path>"}
+</body></html>
+```
+
+NOTE: Be aware that ASF mailing lists do not allow HTML formatted email.
diff --git a/precommit/test-patch.d/htmlout.sh b/precommit/test-patch.d/htmlout.sh
index 29af898..bf6d06e 100755
--- a/precommit/test-patch.d/htmlout.sh
+++ b/precommit/test-patch.d/htmlout.sh
@@ -14,8 +14,6 @@
# See the License for the specific language governing permissions and
# limitations under the License.
-# This bug system provides github integration
-
add_bugsystem htmlout
## @description Usage info for htmlout plugin
