diff --git a/docs/src/Submakefile b/docs/src/Submakefile
index fa9acb07f26..608720b89da 100644
--- a/docs/src/Submakefile
+++ b/docs/src/Submakefile
@@ -997,8 +997,9 @@ TARGETS += manpages
 # For more information, see https://github.com/asciidoc/asciidoc/issues/44
 GENERATED_MANPAGES += $(patsubst $(DOC_DIR)/src/man/%.adoc, $(DOC_DIR)/man/%, $(wildcard $(DOC_DIR)/src/man/man?/*.adoc))
 $(DOC_DIR)/man/%: $(DOC_DIR)/src/man/%.adoc
+	$(ECHO) Making manpage `basename $@`
 	@mkdir -p `dirname $@`
-	a2x -v --doctype manpage \
+	$(Q)a2x --doctype manpage \
 		--format manpage \
 		--destination-dir `dirname $@` \
 		--xsltproc-opts="--nonet" \
diff --git a/docs/src/man/man1/halui.1.adoc b/docs/src/man/man1/halui.1.adoc
index b659e8448d7..a147a2e0dda 100644
--- a/docs/src/man/man1/halui.1.adoc
+++ b/docs/src/man/man1/halui.1.adoc
@@ -168,8 +168,8 @@ contact) connect the physical button to a HAL debounce filter first.
 **halui.mdi-command-**_XX_ bit in::
   *halui* looks for INI variables named [HALUI]MDI_COMMAND, and exports
   a pin for each command it finds. When the pin is driven TRUE, *halui*
-  runs the specified MDI command. _XX_ is a two digit number starting at
-  00. If no [HALUI]MDI_COMMAND variables are set in the INI file, no
+  runs the specified MDI command. _XX_ is a two digit number starting
+  at 00. If no [HALUI]MDI_COMMAND variables are set in the INI file, no
   halui.mdi-command-XX pins will be exported by halui.
 
 === Mist coolant
diff --git a/docs/src/man/man1/monitor-xhc-hb04.1.adoc b/docs/src/man/man1/monitor-xhc-hb04.1.adoc
index 0c763c3dfda..34c36164891 100644
--- a/docs/src/man/man1/monitor-xhc-hb04.1.adoc
+++ b/docs/src/man/man1/monitor-xhc-hb04.1.adoc
@@ -14,10 +14,9 @@ monitor-xhc-hb04 - monitors the XHC-HB04 pendant and warns of disconnection
 This script runs in the background and will pop up a message when the pendant is disconnected or reconnected.
 
 Usage is optional; if used it is specified with INI file entry:
-```
-[APPLICATIONS]
-APP = monitor-xhc-hb04
-```
+[literal]
+ [APPLICATIONS]
+ APP = monitor-xhc-hb04
 
 == SEE ALSO
 
diff --git a/docs/src/man/man1/xhc-hb04.1.adoc b/docs/src/man/man1/xhc-hb04.1.adoc
index f32a51eb7e6..54002e6f186 100644
--- a/docs/src/man/man1/xhc-hb04.1.adoc
+++ b/docs/src/man/man1/xhc-hb04.1.adoc
@@ -287,7 +287,7 @@ pins 3) connect buttons to motion.* pins
 Another script is included to monitor the pendant and report loss of USB connectivity.
 See the README and .txt files in the above directory for usage.
 
-[Note]
+=== Note
 The sim configs use the AXIS GUI but the scripts are available
 with any HAL configuration or GUI. The same scripts can be used to adapt
 the xhc-hb04 to existing configurations provided that the halui, motion,
diff --git a/src/hal/components/Submakefile b/src/hal/components/Submakefile
index d49398e1a88..19bf5602a16 100644
--- a/src/hal/components/Submakefile
+++ b/src/hal/components/Submakefile
@@ -58,7 +58,7 @@ $(COMP_MANPAGES): ../docs/man/man9/%.9: hal/components/%.comp ../bin/halcompile
 	$(ECHO) Making halcompile manpage $(notdir $@)
 	@mkdir -p $(dir $@)
 	$(Q)../bin/halcompile -U --document -o $@.new $< && preconv -r < $@.new > $@
-	$(RM) $@.new
+	$(Q)$(RM) $@.new
 
 $(COMP_DRIVER_MANPAGES): ../docs/man/man9/%.9: hal/drivers/%.comp ../bin/halcompile
 	$(ECHO) Making halcompile manpage $(notdir $@)