Make.8.in


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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

.TH Make 8 "" "Make #VERSION#" ""
.SH NAME
Make \- somewhat more powerfull alternative to make
.SH SYNOPSIS
\fBMake [options]\fP
.SH DESCRIPTION
\fBMake\fP checks currentness of compiled files and generates commands for compilation of outdated files as specified by regex-aware rules.
.SH OPTIONS
.TP
.B "\-A, \-\-Ausgabe Ausgabedatei"
store commands in \fIAusgabedatei\fP
.TP
.B "\-H, \-\-Hilfe"
display help screen
.TP
.B "\-W, \-\-Watte"
just print what would be done
.TP
.B "\-D, \-\-Datei Machdatei"
read rules from \fIMachdatei\fP
.TP
.B "\-P, \-\-Prüfsummen Prüfsummendatei"
read/store checksums in \fIPrüfsummendatei\fP
.TP
.B "\-a, \-\-alleSummenErneuern"
refresh all checksums
.TP
.B "\-u, \-\-unsicher"
accept running jobs outside of directory of \fIAusgabedatei\fP or \fIPrüfsummendatei\fP
.SH SYNTAX
Empty lines and lines beginning with \fB#\fP are ignored.
.PP
The file starts with definition of files:
.TP
.B "/path/to/files"
add these files to currentness control
.TP
.B "-r /path/to/files"
recursively add these files and directories to currentness control
.PP
The rest of the file consists of compilation rules, each consisting of two consecutive lines:
.TP
The \fBfirst\fP line is a regex-aware rule for identifying dependencies and must not start with a space or tab.
.TP
.B ">1 target:sourceRegEx"
Each (set of) \fItarget\fP(s) is generated by a separate command, possibly involving many source files matching \fIsourceRegEx\fP.
.TP
.B ">n target:sourceRegEx"
All \fItarget\fPs are generated by a single command, possibly involving many source files matching \fIsourceRegEx\fP.
.TP
The \fBfollowing\fP line(s) contain(s) commands to refresh the targets and must start with a space or tab.
The \fBlast\fP line of these must end on \fB;\fP.
.SH SUBSTITUTIONS
Some substitutions and macros are recognized:
.TP
.B "%nurmit'filePart'"
only apply rule / generate target name from source file if name of source file contains \fIfilePart\fP
.TP
.B "%nurohne'filePart'"
opposite of \fB%nurmit'filePart'\fP
.TP
.B "%in"
file name and path of source file
.TP
.B "%ifile"
file name of source file
.TP
.B "%basename"
file name of source file without extension(s)
.TP
.B "%dirname(number)"
last \fInumber\fP components of path so source file
.TP
.B "%dirname"
path so source file.
Identical to \fB%basedir(0)\fP.
.TP
.B "%DIRNAME"
path to \fIMachdatei\fP
.TP
.B "%num'string'"
last decimal number in \fIstring\fP.
E.g. \fB%num'abc123def456ghi'\fP becomes \fB456\fP.
.SH AUTHOR
.nf
Erich Eckner <opensource at eckner dot net>
.fi