1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
Running ``autogen.pl``
======================
You can now run PMIx's top-level ``autogen.pl`` script. This script
will invoke the GNU Autoconf, Automake, and Libtool commands in the
proper order and do a bunch of component discovery and housekeeping to
setup to run PMIx's top-level ``configure`` script.
Running ``autogen.pl`` may take a few minutes, depending on your
system. It's not very exciting to watch.
If you have a multi-processor system, enabling the multi-threaded
behavior in Automake 1.11 (or newer) can result in ``autogen.pl``
running faster. Do this by setting the ``AUTOMAKE_JOBS`` environment
variable to the number of processors (threads) that you want it to use
before invoking ``autogen.pl``. For example (you can put this in your
shell startup files)::
# For bash/sh/zsh:
export AUTOMAKE_JOBS=4
# For csh/tcsh:
set AUTOMAKE_JOBS 4
.. important:: ``autogen.pl`` will fail and report an error if you
forgot to install the required submodule prior to running the
autogen script. You can either do this by adding the ``--recursive``
flag to your Git ``clone`` command, or by manually populating the
submodule by running:
.. code-block:: sh
shell$ git submodule update --init
prior to executing ``autogen.pl``.
.. important:: You generally need to run ``autogen.pl`` whenever the
top-level file ``configure.ac`` changes, or any files in the
``config/`` or ``<project>/config/`` directories change (these
directories are where a lot of "include" files for PMIx's
``configure`` script live).
.. note:: You do *NOT* need to re-run ``autogen.pl`` if you modify a
``Makefile.am``.
|
