Add target to build HTML documentation as single page

petere · petere · commit 7de38696c440 · 2010-06-12T09:55:12.000Z
diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile
@@ -2,7 +2,7 @@
 #
 # PostgreSQL documentation makefile
 #
-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.143 2010/05/13 11:49:47 petere Exp $
+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.144 2010/06/12 09:55:12 petere Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -104,6 +104,10 @@ html-stamp: postgres.sgml $(ALLSGML) stylesheet.dsl
 	cp $(srcdir)/stylesheet.css html/
 	touch $@
 
+# single-page HTML
+postgres.html: postgres.sgml $(ALLSGML) stylesheet.dsl
+	$(JADE.html.call) -V nochunks -V rootchunk -V '(define %root-filename% #f)' -V '(define use-output-dir #f)' -i include-index $<
+
 HTML.index: postgres.sgml $(ALMOSTALLSGML) stylesheet.dsl
 	@$(MKDIR_P) html
 	$(JADE.html.call) -V html-index $<
@@ -351,6 +355,8 @@ clean:
 # text --- these are shipped, but not in this directory
 	rm -f INSTALL HISTORY regress_README
 	rm -f INSTALL.html HISTORY.html regress_README.html
+# other HTML
+	rm -f postgres.html
 # print
 	rm -f *.rtf *.tex-ps *.tex-pdf *.dvi *.aux *.log *.ps *.pdf *.out *.fot
 # index
diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.84 2010/05/31 22:42:59 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.85 2010/06/12 09:55:12 petere Exp $ -->
 
 <appendix id="docguide">
  <title>Documentation</title>
@@ -564,6 +564,13 @@ checking for osx... osx
     proof-read the output, use <literal>draft</>:
 <screen>
 <prompt>doc/src/sgml$ </prompt><userinput>gmake draft</userinput>
+</screen>
+   </para>
+
+   <para>
+    To build the documentation as a single HTML page, use:
+<screen>
+<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres.html</userinput>
 </screen>
    </para>
  </sect2>
