From de6021d191cfa97921faad4eae57c03a75a1df93 Mon Sep 17 00:00:00 2001
From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Fri, 2 Feb 2018 14:00:55 -0700
Subject: [PATCH] List for each tutorial what others it depends on.

---
 doc/doxygen/scripts/make_step.pl | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/doc/doxygen/scripts/make_step.pl b/doc/doxygen/scripts/make_step.pl
index 36907f9e89..e1269c3c9c 100644
--- a/doc/doxygen/scripts/make_step.pl
+++ b/doc/doxygen/scripts/make_step.pl
@@ -27,7 +27,26 @@ $cmake_source_dir=$ARGV[1];
 print
 "/**
   * \@page $step_underscore The $step tutorial program
-\@htmlonly
+";
+
+open BF, "$cmake_source_dir/examples/$step/doc/builds-on"
+    or die "Can't open builds-on file $cmake_source_dir/examples/$step/doc/builds-on";
+my $buildson = <BF>;
+close BF;
+chop $buildson;
+
+# At the very top, print which other programs this one builds on. The
+# filter script will replace occurrences of step-XX by the appropriate
+# links.
+if ($buildson ne "")
+{
+    $buildson =~ s/ /, /g;
+    print "This tutorial depends on $buildson.\n\n";
+}
+
+# then show the table of contents
+print
+"\@htmlonly
 <table class=\"tutorial\" width=\"50%\">
 <tr><th colspan=\"2\"><b><small>Table of contents</small></b></th></tr>
 <tr><td width=\"50%\" valign=\"top\">
-- 
2.39.5