diff options
Diffstat (limited to '')
| -rw-r--r-- | makeenv.5 | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/makeenv.5 b/makeenv.5 new file mode 100644 index 0000000..1b30120 --- /dev/null +++ b/makeenv.5 @@ -0,0 +1,54 @@ +.TH MAKEENV 1 MAKEENV +.SH NAME +makeenv - Environment for make(1) via makeenv(1) +.SH SYNPOSIS +.RB .makeenv +.SH DESCRIPTION +The +.B makeenv +file specifies macros, environment variables and +.BR make (1) +options that should be used when the +.BR make (1) +utility is executed via the +.BR makeenv (1) +utility. It can also be used to specify targets +that should also be built. +.PP +The +.B makeenv +file is intepreted line by line, discarding any line +that is empty or otherwise blank or whose first non-blank +character is the hash sign +.RB ( # ). +.PP +Lines starting with a dash +.RB ( - ) +as its first non-blank character are interpreted as options +that shall be used, the line is split at each whitespace, +and the empty tokes are discarded and the remaining tokens +put in the command line. Note that it is impossible to have +whitespace in an argument as it will split the argument into +two arguments. +.PP +The remaining lines are parsed as macros if they contain +an equals sign +.RB ( = ) +and as targets otherwise. Target lines are separated by +whitespace and each non-empty token is added into the command +line as target. Line that are interpreted as macro lines +have leading and trailing white space removed, and any +sequence of whitespace around it's first equals sign +.RB ( = ) +removed. +.SH NOTES +Targets listed in the +.B makeenv +are only guaranteed to be run before targets listed in +the command line if a POSIX conforming implementation +of the +.BR make (1) +utility is used without parallelism turn on. +.SH SEE ALSO +.BR makeenv (1), +.BR make (1) |