diff options
author | Mattias Andrée <maandree@kth.se> | 2024-02-17 16:35:45 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2024-02-17 16:35:45 +0100 |
commit | b017b7440de21226eeb818941171ac08d12c24ac (patch) | |
tree | 5486b13b19d678c548c1e4e2e1050651e400bf7d | |
parent | Remove less important sections from README (diff) | |
download | makeenv-b017b7440de21226eeb818941171ac08d12c24ac.tar.gz makeenv-b017b7440de21226eeb818941171ac08d12c24ac.tar.bz2 makeenv-b017b7440de21226eeb818941171ac08d12c24ac.tar.xz |
Add makeenv.5
Signed-off-by: Mattias Andrée <maandree@kth.se>
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) |