NAME
makeenv - Run make(1) with environment loaded from .makeenv
SYNPOSIS
makeenv [arguments] ...
DESCRIPTION
The makeenv utility opens the file .makeenv if it exists in the
current working directory and scans it for options, macros, and
targets to specify along with the provided arguments when it
executes make(1). Any macro listed in .makeenv is also put in
the environment.
After loading .makeenv and adding populating the environment,
makeenv will inspect it's environment, makeenv itself is
affected by the environment variables, which also are make(1)
macros; this if you need a specific implementation of make(1)
for a project, it can be specified in the .makeenv file.
When executng make(1), makeenv may reorder the arguments, and
will put any option listed in .makeenv at the beginning, any
macro listed in .makeenv before the macros in the arguments,
and any target listed in .makeenv before the targets in the
arguments.
makeenv is designed to be usable in place of make(1), that is,
the user can create add the alias makeenv=make in his shell,
without any adverse affect. makeenv will pass on it's arguments
as is to make(1) (or whichever utility is specified in the
environment variable MAKEENV_MAKE or the environment variable
MAKE) without validation or modifications, if the .makeenv does
not exist.
OPTIONS
The makeenv utility passes it's options to the make(1) utility
and do not act on any of the it self, however in order to
properly interleave options and operands specified in the
.makeenv file, it have to understand which options take an
argument and which do not. By default, the makeenv utility only
understands the options specified by POSIX, and the argumented
option -W (vendor options), as well as long options that start
with two dashes (--) provided that the same command line
argument contains an equals sign (=). The user can modify the
environment variables to modify how the makeenv utility
understands the options. See the section ENVIRONMENT VARIABLES
for more information. The current version only support options
that consist of a dash (-) followed by any other character and
options that start with two dashes (--), followed by at least
one character, but may not contain an equals sign (=), as these
are treated as delimiters between long options and their
associated argument.
STDIN
Not used.
INPUT FILES
None.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of
makeenv:
PATH
Default.
MAKEENV_MAKE, MAKE
The command that shall be invoked by the utility. The
environment variable MAKEENV_MAKE has precedence over
MAKE; MAKE is only used if MAKEENV_MAKE is not defined.
If neither is defined, the default value make is used.
MAKEENV_OPTS_NO_ARG
List of options that makeenv shall interpret as make(1)
options that do not have any argument. (Default is
eiknpqrSst, meaning the options -e, -i, -k, -n, -p, -q,
-r, -S, -s, and -t.)
MAKEENV_OPTS_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument. (Default is fW, meaning
the options -f and -W.)
MAKEENV_OPTS_OPT_ATTACHED_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument only if there are
additional characters after the option character in the
same command line argument. (Default is the empty
string, meaning no options.)
MAKEENV_OPTS_OPT_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument if there are additional
characters after the option character in the same
command line argument or if argument is followed
directly by another argument which does not start with
a dash (-). (Default is the empty string, meaning no
options.)
MAKEENV_LONG_OPTS_NO_ARG
List of options that makeenv shall interpret as make(1)
options that do not have any argument. (Default is
eiknpqrSst, meaning the options -e, -i, -k, -n, -p, -q,
-r, -S, -s, and -t.)
MAKEENV_OPTS_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument. (Default is fW, meaning
the options -f and -W.)
MAKEENV_OPTS_OPT_ATTACHED_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument only if there are
additional characters after the option character in
the same command line argument. (Default is the empty
string, meaning no options.)
MAKEENV_OPTS_OPT_ARG
List of options that makeenv shall interpret as make(1)
options that have an argument if there are additional
characters after the option character in the same
command line argument or if argument is followed
directly by another argument which does not start with
a dash (-). (Default is the empty string, meaning no
options.)
MAKEENV_LONG_OPTS_NO_ARG
Space-separated list of long options that makeenv shall
interpret as make(1) options that do not have any
argument unless it is followed directly by an equals
sign (=) in the same command line argument. Options
that do not start with two dashes (--) are silently
ignored. (Default is the empty string, meaning no
options.)
MAKEENV_LONG_OPTS_ARG
Space-separated list of long options that makeenv shall
interpret as make(1) options that have an argument that
must either be specified in the next command line
argument or after an equals sign (=) the shall directly
follow the option string in the same command line
argument. Options that do not start with two dashes
(--) are silently ignored. (Default is the empty string,
meaning no options.)
MAKEENV_LONG_OPTS_OPT_ARG
Space-separated list of long options that makeenv shall
interpret as make(1) options that have an argument if
it is the option string is is directly followed by
equals sign (=) in the same command line argument or if
argument is followed directly by another argument which
does not start with a dash (-). Options that do not
start with two dashes (--) are silently ignored.
(Default is the empty string, meaning no options.)
Any macro listed in .makeenv is loaded into the environment
before the utility inspects the environement.
ASYNCHRONOUS EVENTS
Default.
STDOUT
Not used.
STDERR
The standard error is used only for diagnostic messages.
OUTPUT FILES
None.
EXTENDED DESCRIPTION
None.
EXIT STATUS
If the make(1) utility is invoked, the exit status of makeenv
is the exit status of the make(1); utility otherwise, the
makeenv utility exits with one of the following values:
125 An error occurred in the makeenv utility.
126 The make(1) utility was found but could not be invoked.
127 The make(1) utility could not be found.
CONSEQUENCES OF ERRORS
Default.
FUTURE DIRECTIONS
None.
SEE ALSO
makeenv(5), make(1)
