Commit 8694a1ce authored by Tom Lane's avatar Tom Lane

Document need to clear MAKELEVEL when invoking PG build from a makefile.

Since commit 3b8f6e75, failure to do this would lead to
submake-generated-headers not doing anything, so that references to
generated or symlinked headers would fail.  Previous to that, the
omission only led to temp-install not doing anything, which apparently
affects many fewer people (doesn't anybody use "make check" in their
build rules??).  Hence, backpatch to v11 but not further.

Per complaints from Christoph Berg, Jakob Egger, and others.
parent b284262e
...@@ -1599,12 +1599,13 @@ su - postgres ...@@ -1599,12 +1599,13 @@ su - postgres
<title>Build</title> <title>Build</title>
<para> <para>
To start the build, type: To start the build, type either of:
<screen> <screen>
<userinput>make</userinput> <userinput>make</userinput>
<userinput>make all</userinput>
</screen> </screen>
(Remember to use <acronym>GNU</acronym> <application>make</application>.) The build (Remember to use <acronym>GNU</acronym> <application>make</application>.)
will take a few minutes depending on your The build will take a few minutes depending on your
hardware. The last line displayed should be: hardware. The last line displayed should be:
<screen> <screen>
All of PostgreSQL successfully made. Ready to install. All of PostgreSQL successfully made. Ready to install.
...@@ -1623,6 +1624,18 @@ All of PostgreSQL successfully made. Ready to install. ...@@ -1623,6 +1624,18 @@ All of PostgreSQL successfully made. Ready to install.
PostgreSQL, contrib, and documentation successfully made. Ready to install. PostgreSQL, contrib, and documentation successfully made. Ready to install.
</screen> </screen>
</para> </para>
<para>
If you want to invoke the build from another makefile rather than
manually, you must unset <varname>MAKELEVEL</varname> or set it to zero,
for instance like this:
<programlisting>
build-postgresql:
$(MAKE) -C postgresql MAKELEVEL=0 all
</programlisting>
Failure to do that can lead to strange error messages, typically about
missing header files.
</para>
</step> </step>
<step> <step>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment