summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Dunstan <andrew@dunslane.net>2021-07-01 14:51:54 -0400
committerAndrew Dunstan <andrew@dunslane.net>2021-07-01 15:11:53 -0400
commitcbd5d7c852dcab56c7907ba07d45ef97eb28e158 (patch)
tree76b07527962ab6af0bbcbaae7483f16c1192eb07
parentd173a469922074778cbfecbebcb5020b10c03b0f (diff)
Add new make targets world-bin and install-world-bin
These are the same as world and install-world respectively, but without building or installing the documentation. There are many reasons for wanting to be able to do this, including speed, lack of documentation building tools, and wanting to build other formats of the documentation. Plans for simplifying the buildfarm client code include using these targets. Backpatch to all live branches. Discussion: https://postgr.es/m/6a421136-d462-b043-a8eb-e75b2861f3df@dunslane.net
-rw-r--r--GNUmakefile.in10
-rw-r--r--doc/src/sgml/installation.sgml15
2 files changed, 25 insertions, 0 deletions
diff --git a/GNUmakefile.in b/GNUmakefile.in
index b97d75e6c2e..30066ee279f 100644
--- a/GNUmakefile.in
+++ b/GNUmakefile.in
@@ -23,6 +23,11 @@ world:
# build src/ before contrib/
world-contrib-recurse: world-src-recurse
+$(call recurse,world-bin,src config contrib,all)
+
+# build src/ before contrib/
+world-bin-contrib-recurse: world-bin-src-recurse
+
html man:
$(MAKE) -C doc $@
@@ -39,6 +44,11 @@ install-world:
# build src/ before contrib/
install-world-contrib-recurse: install-world-src-recurse
+$(call recurse,install-world-bin,src config contrib,install)
+
+# build src/ before contrib/
+install-world-bin-contrib-recurse: install-world-bin-src-recurse
+
$(call recurse,installdirs uninstall coverage init-po update-po,doc src config)
$(call recurse,distprep,doc src config contrib)
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 6b6adf736a5..4d4f13b4987 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1549,6 +1549,15 @@ All of PostgreSQL successfully made. Ready to install.
PostgreSQL, contrib, and documentation successfully made. Ready to install.
</screen>
</para>
+
+ <para>
+ If you want to build everything that can be built, including the
+ additional modules (<filename>contrib</filename>), but without
+ the documentation, type instead:
+<screen>
+<userinput>make world-bin</userinput>
+</screen>
+ </para>
</step>
<step>
@@ -1619,6 +1628,12 @@ PostgreSQL, contrib, and documentation successfully made. Ready to install.
</para>
<para>
+ If you built the world without the documentation above, type instead:
+<screen>
+<userinput>make install-world-bin</userinput>
+ </para>
+
+ <para>
You can use <literal>make install-strip</literal> instead of
<literal>make install</literal> to strip the executable files and
libraries as they are installed. This will save some space. If