[xen staging] docs: Minor build improvements

[patchbot@xxxxxxx]

commit 10ea4e417b4655f3550b6e9645f7f2bad08dba13
Author:     Andrew Cooper <andrew.cooper3@xxxxxxxxxx>
AuthorDate: Mon Jun 8 18:12:44 2020 +0100
Commit:     Andrew Cooper <andrew.cooper3@xxxxxxxxxx>
CommitDate: Thu Jun 11 17:19:26 2020 +0100

    docs: Minor build improvements
    
    Don't use "set -x" for the figs rule.  It doesn't take effect in the 
recursive
    make environment.
    
    Turn the HTML manpage comments into makefile comments, not shell comments.
    This saves 3x shell invocations per manpage.
    
    Signed-off-by: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>
    Acked-by: Jan Beulich <jbeulich@xxxxxxxx>
    Release-acked-by: Paul Durrant <paul@xxxxxxx>
---
 docs/Makefile | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 3eae2dae60..8de1efb6f5 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -58,7 +58,7 @@ txt: $(DOC_TXT)
 .PHONY: figs
 figs:
 ifneq ($(FIG2DEV),)
-       set -x; $(MAKE) -C figs
+       $(MAKE) -C figs
 else
        @echo "fig2dev (transfig) not installed; skipping figs."
 endif
@@ -105,12 +105,12 @@ else
 endif
 
 # HTML manpages
+# sed used to fix up links between man-pages
+# 1) L<xl(1)> -> L<xl(1)|relative:xl.1.html>
+# 2) <a href="relative:xl.1.html"> -> <a href="xl.1.html">
 html/man/%.$(1).html: man/%.$(1).pod Makefile
 ifneq ($(POD2HTML),)
        @$(INSTALL_DIR) $$(@D)
-       # Fix up links between man-pages
-       # 1) L<xl(1)> -> L<xl(1)|relative:xl.1.html>
-       # 2) <a href="relative:xl.1.html"> -> <a href="xl.1.html">
        sed -r -e 's%L<([^>]+)\(([1-9])\)>%L<\1(\2)|relative:\1.\2.html>%g' $$< 
| \
                $(POD2HTML) | \
                sed -r -e 's%( href=")relative:%\1%g' > $$@
--
generated by git-patchbot for /home/xen/git/xen.git#staging