From 2133834dda885b72fd2ecf62c30ad466b9aa0361 Mon Sep 17 00:00:00 2001
From: Ian Barwick <ian@2ndquadrant.com>
Date: Wed, 27 Dec 2017 10:05:44 +0900
Subject: [PATCH] doc: update documentation build instructions

Describe how to build documentation as a single file, and also note
requirement to build against 9.6 or earlier.
---
 doc/install-source.sgml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/install-source.sgml b/doc/install-source.sgml
index 8cee51a7..255f10ea 100644
--- a/doc/install-source.sgml
+++ b/doc/install-source.sgml
@@ -155,6 +155,20 @@
      The generated HTML files will be placed in the <filename>doc/html</filename>
      subdirectory of your source tree.
    </para>
+
+   <para>
+     To build the documentation as a single HTML file, execute:
+   <programlisting>
+    cd doc/ && make repmgr.html</programlisting>
+   </para>
+
+   <note>
+     <simpara>
+       Due to changes in PostgreSQL's documentation build system from PostgreSQL 10,
+       the documentation can currently only be built agains PostgreSQL 9.6 or earlier.
+       This limitation will be fixed when time and resources permit.
+     </simpara>
+   </note>
  </sect2>