[Xen-changelog] [xen-unstable] docs/html/: Arrange for automatic build of hypercall docs

[Xen patchbot-unstable <patchbot@xxxxxxx>]

# HG changeset patch
# User Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
# Date 1322581688 0
# Node ID b264a2618f6cb3cdf67b1a786fa14193fcccb8e6
# Parent  f261080dca92d3df04fc7389fb904d432162f49b
docs/html/: Arrange for automatic build of hypercall docs

- Use index.html rather than a stamp file.
- Automatically generate dependencies.
- Wire into the docs build system

Signed-off-by: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
Acked-by: Ian Campbell <ian.campbell@xxxxxxxxxx>
Committed-by: Ian Jackson <Ian.Jackson@xxxxxxxxxxxxx>
---


diff -r f261080dca92 -r b264a2618f6c docs/Makefile
--- a/docs/Makefile     Tue Nov 29 15:48:07 2011 +0000
+++ b/docs/Makefile     Tue Nov 29 15:48:08 2011 +0000
@@ -18,7 +18,8 @@
                   $(patsubst %.markdown,html/%.html,$(DOC_MARKDOWN)) \
                   $(patsubst man/%.pod.1,html/man/%.1.html,$(DOC_MAN1SRC)) \
                   $(patsubst man/%.pod.5,html/man/%.5.html,$(DOC_MAN5SRC)) \
-                  $(patsubst %.txt,html/%.txt,$(wildcard misc/*.txt))
+                  $(patsubst %.txt,html/%.txt,$(wildcard misc/*.txt)) \
+                  html/hypercall/index.html
 DOC_TXT         := $(patsubst %.txt,txt/%.txt,$(wildcard misc/*.txt)) \
                   $(patsubst %.markdown,txt/%.txt,$(DOC_MARKDOWN)) \
                   $(patsubst man/%.pod.1,txt/man/%.1.txt,$(DOC_MAN1SRC)) \
@@ -154,13 +155,15 @@
        $(POD2HTML) --infile=$< --outfile=$@.tmp
        $(call move-if-changed,$@.tmp,$@)
 
-html/hypercall/stamp:
+html/hypercall/index.html: ./xen-headers
+       rm -rf $(@D)
        @$(INSTALL_DIR) $(@D)
        ./xen-headers -O $(@D) \
                -T 'arch-x86_64 - Xen public headers' \
                -X arch-ia64 -X arch-x86_32 -X xen-x86_32 \
                ../xen include/public include/xen/errno.h
-       touch $@
+
+-include html/hypercall/.deps
 
 txt/%.txt: %.txt
        $(INSTALL_DIR) $(@D)
diff -r f261080dca92 -r b264a2618f6c docs/xen-headers
--- a/docs/xen-headers  Tue Nov 29 15:48:07 2011 +0000
+++ b/docs/xen-headers  Tue Nov 29 15:48:08 2011 +0000
@@ -325,6 +325,12 @@
 }
 
 foreach $pass (qw(1 2)) {
+    my $depspath = "$outdir/.deps";
+    my $depsout;
+    if ($pass==2) {
+       $depsout = new IO::File "$depspath.new", 'w' or die $!;
+    }
+
     find({ wanted => 
               sub {
                   return unless m/\.h$/;
@@ -341,11 +347,19 @@
                   $leaf_opath = $leaf;
                   $leaf_opath =~ s#/#,#g;
                   $leaf_opath .= ".html";
+                  print $depsout "$outdir/index.html: $File::Find::name\n"
+                      or die $!
+                      if $pass==2;
                   process_file($File::Find::name, $outdir.'/'.$leaf_opath);
           },
           no_chdir => 1,
         },
         map { "$basedir/$_" } @indirs);
+
+    if ($pass==2) {
+       close $depsout or die $!;
+       rename "$depspath.new", "$depspath" or die $!;
+    }
 }
 
 output_index();

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-changelog