Add a link to the GHC API docs from the library haddock index
authorIan Lynagh <igloo@earth.li>
Mon, 13 Oct 2008 19:59:43 +0000 (19:59 +0000)
committerIan Lynagh <igloo@earth.li>
Mon, 13 Oct 2008 19:59:43 +0000 (19:59 +0000)
libraries/Makefile
libraries/gen_contents_index
libraries/prologue.txt [new file with mode: 0644]

index 01dd45b..20a7678 100644 (file)
@@ -321,6 +321,7 @@ ifeq "$(HADDOCK_DOCS)" "YES"
        $(INSTALL_DIR)                                                     $(DESTDIR)$(html_installed_root)
        $(INSTALL_DATA)   index.html doc-index*.html                       $(DESTDIR)$(html_installed_root)
        $(INSTALL_SCRIPT) gen_contents_index                               $(DESTDIR)$(html_installed_root)
+       $(INSTALL_DATA)   prologue.txt                                     $(DESTDIR)$(html_installed_root)
        # Hacks:
        $(INSTALL_DATA)   base/dist/doc/html/*/*.css $(DESTDIR)$(html_installed_root)
        $(INSTALL_DATA)   base/dist/doc/html/*/*.js $(DESTDIR)$(html_installed_root)
@@ -365,7 +366,7 @@ endif
        echo $(WHERE_AM_I)/ifBuildable/ifBuildable >> $(BIN_DIST_LIST)
        for FILE in dph/dph-prim-interface/interface/*.h dph/dph/LICENSE; do if [ -f $$FILE ]; then echo $(WHERE_AM_I)/$$FILE >> $(BIN_DIST_LIST); fi; done
 ifeq "$(HADDOCK_DOCS)" "YES"
-       for FILE in gen_contents_index index.html doc-index*.html; do echo $(WHERE_AM_I)/$$FILE >> $(BIN_DIST_LIST); done
+       for FILE in gen_contents_index prologue index.html doc-index*.html; do echo $(WHERE_AM_I)/$$FILE >> $(BIN_DIST_LIST); done
 endif
 
 $(foreach SUBDIR,$(SUBDIRS),binary-dist.library.$(SUBDIR)): \
index db84b1d..db18568 100644 (file)
@@ -27,6 +27,7 @@ done
 # Now create the combined contents and index pages
 $HADDOCK --gen-index --gen-contents -o . \
          -t "Haskell Hierarchical Libraries" \
+         -p "prologue.txt" \
          $HADDOCK_ARGS
 
 # Unhandled Windows help stuff?:
diff --git a/libraries/prologue.txt b/libraries/prologue.txt
new file mode 100644 (file)
index 0000000..abc83ba
--- /dev/null
@@ -0,0 +1,5 @@
+
+This index includes documentation for many Haskell modules.
+
+For documentation on the GHC API, see <ghc/index.html>.
+