database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-04-18 13:44:19 +03:00
Code

Rename 'gmake' to 'make' in docs and recommended commands

Browse Source 
This simplifies the docs and makes it easier to cut/paste command lines.
This commit is contained in:
Bruce Momjian 2014-02-12 17:29:19 -05:00
parent 2a2e40aaaa
commit 2fc80e8e83
23 changed files with 96 additions and 107 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
contrib/README
View File

@ -12,7 +12,7 @@ documentation.
When building from the source distribution, these modules are not When building from the source distribution, these modules are not
built automatically, unless you build the "world" target. You can built automatically, unless you build the "world" target. You can
also build and install them all by running "gmake all" and "gmake also build and install them all by running "make all" and "make
install" in this directory; or to build and install just one selected install" in this directory; or to build and install just one selected
module, do the same in that module's subdirectory. module, do the same in that module's subdirectory.

10
contrib/pg_upgrade/TESTING
View File

@ -10,7 +10,7 @@ specific to each major version of Postgres.
Here are the steps needed to create a regression database dump file: Here are the steps needed to create a regression database dump file:
1) Create and populate the regression database in the old cluster 1) Create and populate the regression database in the old cluster
This database can be created by running 'gmake installcheck' from This database can be created by running 'make installcheck' from
src/test/regression. src/test/regression.
2) Use pg_dump to dump out the regression database. Use the new 2) Use pg_dump to dump out the regression database. Use the new
@ -66,18 +66,18 @@ steps:
The shell script test.sh in this directory performs more or less this The shell script test.sh in this directory performs more or less this
procedure. You can invoke it by running procedure. You can invoke it by running
gmake check make check
or by running or by running
gmake installcheck make installcheck
if "gmake install" (or "gmake install-world") were done beforehand. if "make install" (or "make install-world") were done beforehand.
When invoked without arguments, it will run an upgrade from the When invoked without arguments, it will run an upgrade from the
version in this source tree to a new instance of the same version. To version in this source tree to a new instance of the same version. To
test an upgrade from a different version, invoke it like this: test an upgrade from a different version, invoke it like this:
gmake installcheck oldbindir=...otherversion/bin oldsrc=...somewhere/postgresql make installcheck oldbindir=...otherversion/bin oldsrc=...somewhere/postgresql
In this case, you will have to manually eyeball the resulting dump In this case, you will have to manually eyeball the resulting dump
diff for version-specific differences, as explained above. diff for version-specific differences, as explained above.

4
doc/src/sgml/Makefile
View File

@ -234,9 +234,9 @@ INSTALL.html: standalone-install.sgml installation.sgml version.sgml
## XSLT processing ## XSLT processing
## ##
# For obscure reasons, gmake 3.81 complains about circular dependencies # For obscure reasons, GNU make 3.81 complains about circular dependencies
# if we try to do "make all" in a VPATH build without the explicit # if we try to do "make all" in a VPATH build without the explicit
# $(srcdir) on the postgres.sgml dependency in this rule. gmake bug? # $(srcdir) on the postgres.sgml dependency in this rule. GNU make bug?
postgres.xml: $(srcdir)/postgres.sgml $(ALMOSTALLSGML) postgres.xml: $(srcdir)/postgres.sgml $(ALMOSTALLSGML)
$(OSX) -D. -x lower -i include-xslt-index $< >postgres.xmltmp $(OSX) -D. -x lower -i include-xslt-index $< >postgres.xmltmp
$(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \ $(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \

8
doc/src/sgml/contrib.sgml
View File

@ -26,8 +26,8 @@
(see <xref linkend="build">). (see <xref linkend="build">).
You can build and install all of them by running: You can build and install all of them by running:
<screen> <screen>
<userinput>gmake</userinput> <userinput>make</userinput>
<userinput>gmake install</userinput> <userinput>make install</userinput>
</screen> </screen>
in the <literal>contrib</literal> directory of a configured source tree; in the <literal>contrib</literal> directory of a configured source tree;
or to build and install or to build and install
@ -35,11 +35,11 @@
Many of the modules have regression tests, which can be executed by Many of the modules have regression tests, which can be executed by
running: running:
<screen> <screen>
<userinput>gmake check</userinput> <userinput>make check</userinput>
</screen> </screen>
before installation or before installation or
<screen> <screen>
<userinput>gmake installcheck</userinput> <userinput>make installcheck</userinput>
</screen> </screen>
once you have a <productname>PostgreSQL</> server running. once you have a <productname>PostgreSQL</> server running.
</para> </para>

22
doc/src/sgml/docguide.sgml
View File

@ -581,7 +581,7 @@ checking for osx... osx
<para> <para>
To build the <acronym>HTML</acronym> version of the documentation: To build the <acronym>HTML</acronym> version of the documentation:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake html</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make html</userinput>
</screen> </screen>
This is also the default target. The output appears in the This is also the default target. The output appears in the
subdirectory <filename>html</filename>. subdirectory <filename>html</filename>.
@ -592,14 +592,14 @@ checking for osx... osx
stages. If you do not care about the index, and just want to stages. If you do not care about the index, and just want to
proof-read the output, use <literal>draft</>: proof-read the output, use <literal>draft</>:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake draft</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make draft</userinput>
</screen> </screen>
</para> </para>
<para> <para>
To build the documentation as a single HTML page, use: To build the documentation as a single HTML page, use:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres.html</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres.html</userinput>
</screen> </screen>
</para> </para>
</sect2> </sect2>
@ -616,7 +616,7 @@ checking for osx... osx
pages, use the commands: pages, use the commands:
<programlisting> <programlisting>
cd doc/src/sgml cd doc/src/sgml
gmake man make man
</programlisting> </programlisting>
</para> </para>
</sect2> </sect2>
@ -634,11 +634,11 @@ gmake man
<para> <para>
To generate PostScript via <acronym>DVI</acronym> in A4 format: To generate PostScript via <acronym>DVI</acronym> in A4 format:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres-A4.ps</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres-A4.ps</userinput>
</screen> </screen>
In U.S. letter format: In U.S. letter format:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres-US.ps</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres-US.ps</userinput>
</screen> </screen>
</para> </para>
</listitem> </listitem>
@ -647,11 +647,11 @@ gmake man
<para> <para>
To make a <acronym>PDF</acronym>: To make a <acronym>PDF</acronym>:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres-A4.pdf</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres-A4.pdf</userinput>
</screen> </screen>
or: or:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres-US.pdf</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres-US.pdf</userinput>
</screen> </screen>
(Of course you can also make a <acronym>PDF</acronym> version (Of course you can also make a <acronym>PDF</acronym> version
from the PostScript, but if you generate <acronym>PDF</acronym> from the PostScript, but if you generate <acronym>PDF</acronym>
@ -741,7 +741,7 @@ save_size.pdfjadetex = 15000
<para> <para>
Generate the <acronym>RTF</acronym> version by typing: Generate the <acronym>RTF</acronym> version by typing:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres.rtf</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make postgres.rtf</userinput>
</screen> </screen>
</para> </para>
</step> </step>
@ -948,7 +948,7 @@ save_size.pdfjadetex = 15000
corresponds to <xref linkend="installation">, with some minor corresponds to <xref linkend="installation">, with some minor
changes to account for the different context. To recreate the changes to account for the different context. To recreate the
file, change to the directory <filename>doc/src/sgml</filename> file, change to the directory <filename>doc/src/sgml</filename>
and enter <userinput>gmake INSTALL</userinput>. and enter <userinput>make INSTALL</userinput>.
</para> </para>
<para> <para>
@ -966,7 +966,7 @@ save_size.pdfjadetex = 15000
method to just check the correct syntax of the documentation method to just check the correct syntax of the documentation
files, which only takes a few seconds: files, which only takes a few seconds:
<screen> <screen>
<prompt>doc/src/sgml$ </prompt><userinput>gmake check</userinput> <prompt>doc/src/sgml$ </prompt><userinput>make check</userinput>
</screen> </screen>
</para> </para>
</sect2> </sect2>

67
doc/src/sgml/installation.sgml
View File

@ -32,9 +32,9 @@ in a standalone-ignore clause.
<para> <para>
<synopsis> <synopsis>
./configure ./configure
gmake make
su su
gmake install make install
adduser postgres adduser postgres
mkdir /usr/local/pgsql/data mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data chown postgres /usr/local/pgsql/data
@ -77,14 +77,11 @@ su - postgres
<acronym>GNU</> <application>make</> version 3.80 or newer is required; other <acronym>GNU</> <application>make</> version 3.80 or newer is required; other
<application>make</> programs or older <acronym>GNU</> <application>make</> versions will <emphasis>not</> work. <application>make</> programs or older <acronym>GNU</> <application>make</> versions will <emphasis>not</> work.
<acronym>GNU</> <application>make</> is often installed under (<acronym>GNU</> <application>make</> is sometimes installed under
the name <filename>gmake</filename>; this document will always the name <filename>gmake</filename>.) To test for <acronym>GNU</acronym>
refer to it by that name. (On some systems
<acronym>GNU</acronym> <application>make</> is the default tool with the name
<filename>make</>.) To test for <acronym>GNU</acronym>
<application>make</application> enter: <application>make</application> enter:
<screen> <screen>
<userinput>gmake --version</userinput> <userinput>make --version</userinput>
</screen> </screen>
</para> </para>
</listitem> </listitem>
@ -422,7 +419,7 @@ su - postgres
<userinput>mkdir build_dir</userinput> <userinput>mkdir build_dir</userinput>
<userinput>cd build_dir</userinput> <userinput>cd build_dir</userinput>
<userinput>/path/to/source/tree/configure [options go here]</userinput> <userinput>/path/to/source/tree/configure [options go here]</userinput>
<userinput>gmake</userinput> <userinput>make</userinput>
</screen> </screen>
</para> </para>
@ -1441,7 +1438,7 @@ su - postgres
source code lines. If you get confused while trying to debug source code lines. If you get confused while trying to debug
optimized code, recompile the specific files of interest with optimized code, recompile the specific files of interest with
<option>-O0</>. An easy way to do this is by passing an option <option>-O0</>. An easy way to do this is by passing an option
to <application>make</>: <command>gmake PROFILE=-O0 file.o</>. to <application>make</>: <command>make PROFILE=-O0 file.o</>.
</para> </para>
</note> </note>
</step> </step>
@ -1452,7 +1449,7 @@ su - postgres
<para> <para>
To start the build, type: To start the build, type:
<screen> <screen>
<userinput>gmake</userinput> <userinput>make</userinput>
</screen> </screen>
(Remember to use <acronym>GNU</> <application>make</>.) The build (Remember to use <acronym>GNU</> <application>make</>.) The build
will take a few minutes depending on your will take a few minutes depending on your
@ -1467,7 +1464,7 @@ All of PostgreSQL is successfully made. Ready to install.
documentation (HTML and man pages), and the additional modules documentation (HTML and man pages), and the additional modules
(<filename>contrib</filename>), type instead: (<filename>contrib</filename>), type instead:
<screen> <screen>
<userinput>gmake world</userinput> <userinput>make world</userinput>
</screen> </screen>
The last line displayed should be: The last line displayed should be:
<screen> <screen>
@ -1490,7 +1487,7 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
runs on your machine in the way the developers expected it runs on your machine in the way the developers expected it
to. Type: to. Type:
<screen> <screen>
<userinput>gmake check</userinput> <userinput>make check</userinput>
</screen> </screen>
(This won't work as root; do it as an unprivileged user.) (This won't work as root; do it as an unprivileged user.)
<![%standalone-include[The file <![%standalone-include[The file
@ -1518,7 +1515,7 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
<para> <para>
To install <productname>PostgreSQL</> enter: To install <productname>PostgreSQL</> enter:
<screen> <screen>
<userinput>gmake install</userinput> <userinput>make install</userinput>
</screen> </screen>
This will install files into the directories that were specified This will install files into the directories that were specified
in <xref linkend="configure">. Make sure that you have appropriate in <xref linkend="configure">. Make sure that you have appropriate
@ -1531,21 +1528,21 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
<para> <para>
To install the documentation (HTML and man pages), enter: To install the documentation (HTML and man pages), enter:
<screen> <screen>
<userinput>gmake install-docs</userinput> <userinput>make install-docs</userinput>
</screen> </screen>
</para> </para>
<para> <para>
If you built the world above, type instead: If you built the world above, type instead:
<screen> <screen>
<userinput>gmake install-world</userinput> <userinput>make install-world</userinput>
</screen> </screen>
This also installs the documentation. This also installs the documentation.
</para> </para>
<para> <para>
You can use <literal>gmake install-strip</literal> instead of You can use <literal>make install-strip</literal> instead of
<literal>gmake install</literal> to strip the executable files and <literal>make install</literal> to strip the executable files and
libraries as they are installed. This will save some space. If libraries as they are installed. This will save some space. If
you built with debugging support, stripping will effectively you built with debugging support, stripping will effectively
remove the debugging support, so it should only be done if remove the debugging support, so it should only be done if
@ -1560,7 +1557,7 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
The standard installation provides all the header files needed for client The standard installation provides all the header files needed for client
application development as well as for server-side program application development as well as for server-side program
development, such as custom functions or data types written in C. development, such as custom functions or data types written in C.
(Prior to <productname>PostgreSQL</> 8.0, a separate <literal>gmake (Prior to <productname>PostgreSQL</> 8.0, a separate <literal>make
install-all-headers</> command was needed for the latter, but this install-all-headers</> command was needed for the latter, but this
step has been folded into the standard install.) step has been folded into the standard install.)
</para> </para>
@ -1571,10 +1568,10 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
If you want to install only the client applications and If you want to install only the client applications and
interface libraries, then you can use these commands: interface libraries, then you can use these commands:
<screen> <screen>
<userinput>gmake -C src/bin install</> <userinput>make -C src/bin install</>
<userinput>gmake -C src/include install</> <userinput>make -C src/include install</>
<userinput>gmake -C src/interfaces install</> <userinput>make -C src/interfaces install</>
<userinput>gmake -C doc install</> <userinput>make -C doc install</>
</screen> </screen>
<filename>src/bin</> has a few binaries for server-only use, <filename>src/bin</> has a few binaries for server-only use,
but they are small. but they are small.
@ -1586,7 +1583,7 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
<formalpara> <formalpara>
<title>Uninstallation:</title> <title>Uninstallation:</title>
<para> <para>
To undo the installation use the command <command>gmake To undo the installation use the command <command>make
uninstall</>. However, this will not remove any created directories. uninstall</>. However, this will not remove any created directories.
</para> </para>
</formalpara> </formalpara>
@ -1596,11 +1593,11 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
<para> <para>
After the installation you can free disk space by removing the built After the installation you can free disk space by removing the built
files from the source tree with the command <command>gmake files from the source tree with the command <command>make
clean</>. This will preserve the files made by the <command>configure</command> clean</>. This will preserve the files made by the <command>configure</command>
program, so that you can rebuild everything with <command>gmake</> program, so that you can rebuild everything with <command>make</>
later on. To reset the source tree to the state in which it was later on. To reset the source tree to the state in which it was
distributed, use <command>gmake distclean</>. If you are going to distributed, use <command>make distclean</>. If you are going to
build for several platforms within the same source tree you must do build for several platforms within the same source tree you must do
this and re-configure for each platform. (Alternatively, use this and re-configure for each platform. (Alternatively, use
a separate build tree for each platform, so that the source tree a separate build tree for each platform, so that the source tree
@ -1612,7 +1609,7 @@ PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
If you perform a build and then discover that your <command>configure</> If you perform a build and then discover that your <command>configure</>
options were wrong, or if you change anything that <command>configure</> options were wrong, or if you change anything that <command>configure</>
investigates (for example, software upgrades), then it's a good investigates (for example, software upgrades), then it's a good
idea to do <command>gmake distclean</> before reconfiguring and idea to do <command>make distclean</> before reconfiguring and
rebuilding. Without this, your changes in configuration choices rebuilding. Without this, your changes in configuration choices
might not propagate everywhere they need to. might not propagate everywhere they need to.
</para> </para>
@ -1904,7 +1901,7 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
<listitem> <listitem>
<para> <para>
Run the regression tests against the installed server (using Run the regression tests against the installed server (using
<command>gmake installcheck</command>). If you didn't run the <command>make installcheck</command>). If you didn't run the
tests before installation, you should definitely do it now. This tests before installation, you should definitely do it now. This
is also explained in the documentation. is also explained in the documentation.
</para> </para>
@ -2358,12 +2355,6 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
</para> </para>
</listitem> </listitem>
<listitem>
<para>
The GNU make command is called <command>make</command>, not <command>gmake</command>.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
The <command>adduser</command> command is not supported; use The <command>adduser</command> command is not supported; use
@ -2647,9 +2638,7 @@ PHSS_30849 s700_800 u2comp/be/plugin library Patch
<para> <para>
You need to use the GNU Make program, which is on the Skunkware You need to use the GNU Make program, which is on the Skunkware
CD. By default, it installs CD. By default, it installs
as <filename>/usr/local/bin/make</filename>. To avoid confusion as <filename>/usr/local/bin/make</filename>.
with the SCO <filename>make</filename> program, you may want to rename GNU <filename>make</filename> to
<filename>gmake</filename>.
</para> </para>
<para> <para>
@ -2902,7 +2891,7 @@ AbortTransaction utils/probes.o
CommitTransaction utils/probes.o CommitTransaction utils/probes.o
ld: fatal: Symbol referencing errors. No output written to postgres ld: fatal: Symbol referencing errors. No output written to postgres
collect2: ld returned 1 exit status collect2: ld returned 1 exit status
gmake: *** [postgres] Error 1 make: *** [postgres] Error 1
</screen> </screen>
your DTrace installation is too old to handle probes in static your DTrace installation is too old to handle probes in static
functions. You need Solaris 10u4 or newer. functions. You need Solaris 10u4 or newer.

4
doc/src/sgml/nls.sgml
View File

@ -165,7 +165,7 @@ msgstr "another translated"
If you need to start a new translation effort, then first run the If you need to start a new translation effort, then first run the
command: command:
<programlisting> <programlisting>
gmake init-po make init-po
</programlisting> </programlisting>
This will create a file This will create a file
<filename><replaceable>progname</replaceable>.pot</filename>. <filename><replaceable>progname</replaceable>.pot</filename>.
@ -188,7 +188,7 @@ AVAIL_LANGUAGES := de fr
changed or added by the programmers. In this case you do not need changed or added by the programmers. In this case you do not need
to start from scratch. Instead, run the command: to start from scratch. Instead, run the command:
<programlisting> <programlisting>
gmake update-po make update-po
</programlisting> </programlisting>
which will create a new blank message catalog file (the pot file which will create a new blank message catalog file (the pot file
you started with) and will merge it with the existing PO files. you started with) and will merge it with the existing PO files.

2
doc/src/sgml/pgupgrade.sgml
View File

@ -246,7 +246,7 @@ mv /usr/local/pgsql /usr/local/pgsql.old
location, use the <literal>prefix</literal> variable: location, use the <literal>prefix</literal> variable:
<programlisting> <programlisting>
gmake prefix=/usr/local/pgsql.new install make prefix=/usr/local/pgsql.new install
</programlisting></para> </programlisting></para>
</step> </step>

42
doc/src/sgml/regress.sgml
View File

@ -39,7 +39,7 @@
To run the parallel regression tests after building but before installation, To run the parallel regression tests after building but before installation,
type: type:
<screen> <screen>
gmake check make check
</screen> </screen>
in the top-level directory. (Or you can change to in the top-level directory. (Or you can change to
<filename>src/test/regress</filename> and run the command there.) <filename>src/test/regress</filename> and run the command there.)
@ -69,7 +69,7 @@ gmake check
<prompt>root# </prompt><userinput>chmod -R a+w src/test/regress</userinput> <prompt>root# </prompt><userinput>chmod -R a+w src/test/regress</userinput>
<prompt>root# </prompt><userinput>su - joeuser</userinput> <prompt>root# </prompt><userinput>su - joeuser</userinput>
<prompt>joeuser$ </prompt><userinput>cd <replaceable>top-level build directory</></userinput> <prompt>joeuser$ </prompt><userinput>cd <replaceable>top-level build directory</></userinput>
<prompt>joeuser$ </prompt><userinput>gmake check</userinput> <prompt>joeuser$ </prompt><userinput>make check</userinput>
</screen> </screen>
(The only possible <quote>security risk</quote> here is that other (The only possible <quote>security risk</quote> here is that other
users might be able to alter the regression test results behind users might be able to alter the regression test results behind
@ -82,7 +82,7 @@ gmake check
<para> <para>
If you have configured <productname>PostgreSQL</productname> to install If you have configured <productname>PostgreSQL</productname> to install
into a location where an older <productname>PostgreSQL</productname> into a location where an older <productname>PostgreSQL</productname>
installation already exists, and you perform <literal>gmake check</> installation already exists, and you perform <literal>make check</>
before installing the new version, you might find that the tests fail before installing the new version, you might find that the tests fail
because the new programs try to use the already-installed shared because the new programs try to use the already-installed shared
libraries. (Typical symptoms are complaints about undefined symbols.) libraries. (Typical symptoms are complaints about undefined symbols.)
@ -103,7 +103,7 @@ gmake check
a position to raise the limit, you can cut down the degree of parallelism a position to raise the limit, you can cut down the degree of parallelism
by setting the <literal>MAX_CONNECTIONS</> parameter. For example: by setting the <literal>MAX_CONNECTIONS</> parameter. For example:
<screen> <screen>
gmake MAX_CONNECTIONS=10 check make MAX_CONNECTIONS=10 check
</screen> </screen>
runs no more than ten tests concurrently. runs no more than ten tests concurrently.
</para> </para>
@ -117,11 +117,11 @@ gmake MAX_CONNECTIONS=10 check
initialize a data area and start the initialize a data area and start the
server, <![%standalone-ignore;[as explained in <xref linkend="runtime">, ]]> then type: server, <![%standalone-ignore;[as explained in <xref linkend="runtime">, ]]> then type:
<screen> <screen>
gmake installcheck make installcheck
</screen> </screen>
or for a parallel test: or for a parallel test:
<screen> <screen>
gmake installcheck-parallel make installcheck-parallel
</screen> </screen>
The tests will expect to contact the server at the local host and the The tests will expect to contact the server at the local host and the
default port number, unless directed otherwise by <envar>PGHOST</envar> and default port number, unless directed otherwise by <envar>PGHOST</envar> and
@ -138,14 +138,14 @@ gmake installcheck-parallel
built and installed, change to the <filename>src/pl</> directory of the built and installed, change to the <filename>src/pl</> directory of the
build tree and type: build tree and type:
<screen> <screen>
gmake installcheck make installcheck
</screen> </screen>
You can also do this in any of the subdirectories of <filename>src/pl</> You can also do this in any of the subdirectories of <filename>src/pl</>
to run tests for just one procedural language. To run the tests for all to run tests for just one procedural language. To run the tests for all
<filename>contrib</> modules that have them, change to the <filename>contrib</> modules that have them, change to the
<filename>contrib</> directory of the build tree and type: <filename>contrib</> directory of the build tree and type:
<screen> <screen>
gmake installcheck make installcheck
</screen> </screen>
The <filename>contrib</> modules must have been built and installed first. The <filename>contrib</> modules must have been built and installed first.
You can also do this in a subdirectory of <filename>contrib</> to run You can also do this in a subdirectory of <filename>contrib</> to run
@ -184,7 +184,7 @@ psql -h primary -f src/test/regress/sql/hs_primary_setup.sql regression
directory: directory:
<screen> <screen>
cd src/test/regress cd src/test/regress
gmake standbycheck make standbycheck
</screen> </screen>
</para> </para>
@ -209,8 +209,8 @@ gmake standbycheck
can be useful to test different locales by setting the appropriate can be useful to test different locales by setting the appropriate
environment variables, for example: environment variables, for example:
<screen> <screen>
gmake check LANG=C make check LANG=C
gmake check LC_COLLATE=en_US.utf8 LC_CTYPE=fr_CA.utf8 make check LC_COLLATE=en_US.utf8 LC_CTYPE=fr_CA.utf8
</screen> </screen>
For implementation reasons, setting <envar>LC_ALL</envar> does not For implementation reasons, setting <envar>LC_ALL</envar> does not
work for this purpose; all the other locale-related environment work for this purpose; all the other locale-related environment
@ -227,7 +227,7 @@ gmake check LC_COLLATE=en_US.utf8 LC_CTYPE=fr_CA.utf8
You can also choose the database encoding explicitly by setting You can also choose the database encoding explicitly by setting
the variable <envar>ENCODING</envar>, for example: the variable <envar>ENCODING</envar>, for example:
<screen> <screen>
gmake check LANG=C ENCODING=EUC_JP make check LANG=C ENCODING=EUC_JP
</screen> </screen>
Setting the database encoding this way typically only makes sense Setting the database encoding this way typically only makes sense
if the locale is C; otherwise the encoding is chosen automatically if the locale is C; otherwise the encoding is chosen automatically
@ -251,11 +251,11 @@ gmake check LANG=C ENCODING=EUC_JP
files by setting the variable <envar>EXTRA_TESTS</envar>. For files by setting the variable <envar>EXTRA_TESTS</envar>. For
example, to run the <literal>numeric_big</literal> test: example, to run the <literal>numeric_big</literal> test:
<screen> <screen>
gmake check EXTRA_TESTS=numeric_big make check EXTRA_TESTS=numeric_big
</screen> </screen>
To run the collation tests: To run the collation tests:
<screen> <screen>
gmake check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8 make check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8
</screen> </screen>
The <literal>collate.linux.utf8</> test works only on Linux/glibc The <literal>collate.linux.utf8</> test works only on Linux/glibc
platforms, and only when run in a database that uses UTF-8 encoding. platforms, and only when run in a database that uses UTF-8 encoding.
@ -337,7 +337,7 @@ gmake check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8
locale-related environment variables on locale-related environment variables on
the <command>make</command> command line, for example: the <command>make</command> command line, for example:
<programlisting> <programlisting>
gmake check LANG=de_DE.utf8 make check LANG=de_DE.utf8
</programlisting> </programlisting>
(The regression test driver unsets <envar>LC_ALL</envar>, so it (The regression test driver unsets <envar>LC_ALL</envar>, so it
does not work to choose the locale using that variable.) To use does not work to choose the locale using that variable.) To use
@ -345,7 +345,7 @@ gmake check LANG=de_DE.utf8
(or set them to <literal>C</literal>) or use the following (or set them to <literal>C</literal>) or use the following
special invocation: special invocation:
<programlisting> <programlisting>
gmake check NO_LOCALE=1 make check NO_LOCALE=1
</programlisting> </programlisting>
When running the tests against an existing installation, the When running the tests against an existing installation, the
locale setup is determined by the existing installation. To locale setup is determined by the existing installation. To
@ -601,19 +601,19 @@ float8:out:i.86-.*-openbsd=float8-small-is-zero.out
A typical workflow would look like this: A typical workflow would look like this:
<screen> <screen>
./configure --enable-coverage ... OTHER OPTIONS ... ./configure --enable-coverage ... OTHER OPTIONS ...
gmake make
gmake check # or other test suite make check # or other test suite
gmake coverage-html make coverage-html
</screen> </screen>
Then point your HTML browser Then point your HTML browser
to <filename>coverage/index.html</filename>. to <filename>coverage/index.html</filename>.
The <command>gmake</command> commands also work in subdirectories. The <command>make</command> commands also work in subdirectories.
</para> </para>
<para> <para>
To reset the execution counts between test runs, run: To reset the execution counts between test runs, run:
<screen> <screen>
gmake coverage-clean make coverage-clean
</screen> </screen>
</para> </para>
</sect1> </sect1>

2
doc/src/sgml/release-8.3.sgml
View File

@ -8297,7 +8297,7 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
Support <command>gmake draft</command> when building the Support <command>make draft</command> when building the
<acronym>SGML</> documentation (Bruce) <acronym>SGML</> documentation (Bruce)
</para> </para>

2
doc/src/sgml/release-9.2.sgml
View File

@ -5434,7 +5434,7 @@
</para> </para>
<para> <para>
Use <command>gmake STYLE=website draft</>. Use <command>make STYLE=website draft</>.
</para> </para>
</listitem> </listitem>

2
src/backend/port/ipc_test.c
View File

@ -10,7 +10,7 @@
* USE_xxx_SEMAPHORES and USE_xxx_SHARED_MEMORY settings you want. * USE_xxx_SEMAPHORES and USE_xxx_SHARED_MEMORY settings you want.
* Also, adjust the pg_sema.c and pg_shmem.c symlinks in * Also, adjust the pg_sema.c and pg_shmem.c symlinks in
* src/backend/port/ if needed. * src/backend/port/ if needed.
* 2. In src/backend/port/, do "gmake ipc_test". * 2. In src/backend/port/, do "make ipc_test".
* 3. Run ipc_test and see if it works. * 3. Run ipc_test and see if it works.
* 4. If it seems to work, try building the whole system and running * 4. If it seems to work, try building the whole system and running
* the parallel regression tests for a more complete test. * the parallel regression tests for a more complete test.

2
src/interfaces/ecpg/Makefile
View File

@ -4,7 +4,7 @@ include $(top_builddir)/src/Makefile.global
SUBDIRS = include pgtypeslib ecpglib compatlib preproc SUBDIRS = include pgtypeslib ecpglib compatlib preproc
# Suppress parallel build of subdirectories to avoid a bug in gmake 3.82, cf # Suppress parallel build of subdirectories to avoid a bug in GNU make 3.82, cf
# http://savannah.gnu.org/bugs/?30653 # http://savannah.gnu.org/bugs/?30653
# https://bugzilla.redhat.com/show_bug.cgi?id=835424 # https://bugzilla.redhat.com/show_bug.cgi?id=835424
# (There are some other parallelism bugs in the subdirectory makefiles # (There are some other parallelism bugs in the subdirectory makefiles

2
src/interfaces/ecpg/preproc/Makefile
View File

@ -30,7 +30,7 @@ OBJS= preproc.o type.o ecpg.o output.o parser.o \
keywords.o c_keywords.o ecpg_keywords.o kwlookup.o ../ecpglib/typename.o descriptor.o variable.o \ keywords.o c_keywords.o ecpg_keywords.o kwlookup.o ../ecpglib/typename.o descriptor.o variable.o \
$(WIN32RES) $(WIN32RES)
# Suppress parallel build to avoid a bug in gmake 3.82 # Suppress parallel build to avoid a bug in GNU make 3.82
# (see comments in ../Makefile) # (see comments in ../Makefile)
ifeq ($(MAKE_VERSION),3.82) ifeq ($(MAKE_VERSION),3.82)
.NOTPARALLEL: .NOTPARALLEL:

2
src/pl/plperl/README
View File

@ -2,7 +2,7 @@ src/pl/plperl/README
PL/Perl allows you to write PostgreSQL functions and procedures in PL/Perl allows you to write PostgreSQL functions and procedures in
Perl. To include PL/Perl in the build use './configure --with-perl'. Perl. To include PL/Perl in the build use './configure --with-perl'.
To build from this directory use 'gmake all; gmake install'. libperl To build from this directory use 'make all; make install'. libperl
must have been built as a shared library, which is usually not the must have been built as a shared library, which is usually not the
case in standard installations. case in standard installations.

4
src/test/isolation/README
View File

@ -14,7 +14,7 @@ behaviors have been added as well.
To run the tests, you need to have a server running at the default port To run the tests, you need to have a server running at the default port
expected by libpq. (You can set PGPORT and so forth in your environment expected by libpq. (You can set PGPORT and so forth in your environment
to control this.) Then run to control this.) Then run
gmake installcheck make installcheck
To run just specific test(s), you can do something like To run just specific test(s), you can do something like
./pg_isolation_regress fk-contention fk-deadlock ./pg_isolation_regress fk-contention fk-deadlock
(look into the specs/ subdirectory to see the available tests). (look into the specs/ subdirectory to see the available tests).
@ -22,7 +22,7 @@ To run just specific test(s), you can do something like
The prepared-transactions test requires the server's The prepared-transactions test requires the server's
max_prepared_transactions parameter to be set to at least 3; therefore it max_prepared_transactions parameter to be set to at least 3; therefore it
is not run by default. To include it in the test run, use is not run by default. To include it in the test run, use
gmake installcheck-prepared-txns make installcheck-prepared-txns
To define tests with overlapping transactions, we use test specification To define tests with overlapping transactions, we use test specification
files with a custom syntax, which is described in the next section. To add files with a custom syntax, which is described in the next section. To add

4
src/test/locale/README
View File

@ -9,9 +9,9 @@ locale data. Then there are test-sort.pl and test-sort.py that test
collating. collating.
To run a test for some locale run To run a test for some locale run
gmake check-$locale make check-$locale
for example for example
gmake check-koi8-r make check-koi8-r
Currently, there are only tests for a few locales available. The script Currently, there are only tests for a few locales available. The script
'runall' calls test-ctype to test libc and locale data, test-sort.pl 'runall' calls test-ctype to test libc and locale data, test-sort.pl

4
src/test/regress/regressplans.sh
View File

@ -26,8 +26,8 @@
# efficient available query plans! Have patience. # efficient available query plans! Have patience.
# Select make to use --- default gmake, can be overridden by env var # Select make to use --- default 'make', can be overridden by env var
MAKE="${MAKE:-gmake}" MAKE="${MAKE:-make}"
# If PGOPTIONS is already defined, we'll add the -f switches to it. # If PGOPTIONS is already defined, we'll add the -f switches to it.
PGOPTIONS="${PGOPTIONS:-}" PGOPTIONS="${PGOPTIONS:-}"

4
src/timezone/Makefile
View File

@ -40,8 +40,8 @@ endif
# We could do this test in the action section: # We could do this test in the action section:
# $(if $(ZIC),$(ZIC),./zic) # $(if $(ZIC),$(ZIC),./zic)
# but gmake versions <= 3.78.1 or perhaps later have a bug # but GNU make versions <= 3.78.1 or perhaps later have a bug
# that causes a segfault; gmake 3.81 or later fixes this. # that causes a segfault; GNU make 3.81 or later fixes this.
ifeq (,$(ZIC)) ifeq (,$(ZIC))
ZIC= ./zic ZIC= ./zic
endif endif

2
src/timezone/README
View File

@ -27,7 +27,7 @@ effort is needed to update the time zone abbreviation lists under tznames/.
These need to be changed whenever new abbreviations are invented or the These need to be changed whenever new abbreviations are invented or the
UTC offset associated with an existing abbreviation changes. To detect UTC offset associated with an existing abbreviation changes. To detect
if this has happened, after installing new files under data/ do if this has happened, after installing new files under data/ do
gmake abbrevs.txt make abbrevs.txt
which will produce a file showing all abbreviations that are in current which will produce a file showing all abbreviations that are in current
use according to the data/ files. Compare this to known_abbrevs.txt, use according to the data/ files. Compare this to known_abbrevs.txt,
which is the list that existed last time the tznames/ files were updated. which is the list that existed last time the tznames/ files were updated.

8
src/tools/pgindent/README
View File

@ -12,7 +12,7 @@ This can format all PostgreSQL *.c and *.h files, but excludes *.y, and
4) Remove all derived files (pgindent has trouble with one of the flex macros): 4) Remove all derived files (pgindent has trouble with one of the flex macros):
gmake maintainer-clean make maintainer-clean
Or: Or:
@ -47,10 +47,10 @@ This can format all PostgreSQL *.c and *.h files, but excludes *.y, and
# stop is only necessary if it's going to install in a location with an # stop is only necessary if it's going to install in a location with an
# already running server # already running server
pg_ctl stop pg_ctl stop
gmake -C src install make -C src install
gmake -C contrib install make -C contrib install
pg_ctl start pg_ctl start
gmake installcheck-world make installcheck-world
10) Remove Perl backup files after testing 10) Remove Perl backup files after testing

2
src/tutorial/Makefile
View File

@ -5,7 +5,7 @@
# #
# By default, this builds against an existing PostgreSQL installation # By default, this builds against an existing PostgreSQL installation
# (the one identified by whichever pg_config is first in your path). # (the one identified by whichever pg_config is first in your path).
# Within a configured source tree, you can say "gmake NO_PGXS=1 all" # Within a configured source tree, you can say "make NO_PGXS=1 all"
# to build using the surrounding source tree. # to build using the surrounding source tree.
# #
# IDENTIFICATION # IDENTIFICATION

2
src/tutorial/README
View File

@ -7,7 +7,7 @@ This directory contains SQL tutorial scripts. To look at them, first do a
% make % make
to compile all the scripts and C files for the user-defined functions to compile all the scripts and C files for the user-defined functions
and types. (make needs to be GNU make --- it may be named something and types. (make needs to be GNU make --- it may be named something
different on your system, often gmake) different on your system, often 'gmake')
Then, run psql with the -s (single-step) flag: Then, run psql with the -s (single-step) flag:
% psql -s % psql -s