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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!--
$FreeBSD$
-->
<glossary id="glossary">
<title>Glossary of Jargon</title>
<glossentry>
<glossterm>attribute</glossterm>
<glossdef>
<para>A property given to a target that causes
<application>PMake</application> to treat it differently.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm id="cmdscript">command script</glossterm>
<glossdef>
<para>The lines immediately following a dependency line that specify
commands to execute to create each of the targets on the dependency
line. Each line in the command script must begin with a tab.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>command-line variable</glossterm>
<glossdef>
<para>A variable defined in an argument when
<application>PMake</application> is first executed.
Overrides all assignments to the same variable name in the
makefile.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>conditional</glossterm>
<glossdef>
<para>A construct much like that used in C that allows a makefile to be
configured on the fly based on the local environment, or on what is
being made by that invocation of <application>PMake</application>.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>creation script</glossterm>
<glossdef>
<para>Commands used to create a target.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>dependency</glossterm>
<glossdef>
<para>The relationship between a source and a target. This comes in
three flavors, as indicated by the operator between the target and the
source. <literal>:</literal> gives a straight time-wise dependency
(if the target is older than the source, the target is out-of-date),
while <literal>!</literal> provides simply an ordering and always
considers the target out-of-date. <literal>::</literal> is much like
<literal>:</literal>, save it creates multiple instances of a target
each of which depends on its own list of sources.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>dynamic source</glossterm>
<glossdef>
<para>This refers to a source that has a local variable invocation in
it. It allows a single dependency line to specify a different source
for each target on the line.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>global variable</glossterm>
<glossdef>
<para>Any variable defined in a makefile. Takes precedence over
variables defined in the environment, but not over command-line or
local variables.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>input graph</glossterm>
<glossdef>
<para>What <application>PMake</application> constructs from a makefile.
Consists of nodes made of the targets in the makefile, and the links
between them (the dependencies). The links are directed (from source
to target) and there may not be any cycles (loops) in the graph.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>local variable</glossterm>
<glossdef>
<para>A variable defined by <application>PMake</application> visible
only in a target's shell script.
There are seven local variables, not all of which are defined for
every target: <makevar>.TARGET</makevar>, <makevar>.ALLSRC</makevar>,
<makevar>.OODATE</makevar>, <makevar>.PREFIX</makevar>,
<makevar>.IMPSRC</makevar>, <makevar>.ARCHIVE</makevar>, and
<makevar>.MEMBER</makevar>.
<makevar>.TARGET</makevar>, <makevar>.PREFIX</makevar>,
<makevar>.ARCHIVE</makevar>, and <makevar>.MEMBER</makevar>
may be used on dependency lines to create
<quote>dynamic sources</quote>.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>makefile</glossterm>
<glossdef>
<para>A file that describes how a system is built. If you do not know
what it is after reading this tutorial…</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>modifier</glossterm>
<glossdef>
<para>A letter, following a colon, used to alter how a variable is
expanded. It has no effect on the variable itself.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>operator</glossterm>
<glossdef>
<para>What separates a source from a target (on a dependency line) and
specifies the relationship between the two. There are three:
<literal>:</literal>, <literal>::</literal>,
and <literal>!</literal>.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>search path</glossterm>
<glossdef>
<para>A list of directories in which a file should be sought.
<application>PMake</application>'s view of the contents of directories
in a search path does not change once the makefile has been read.
A file is sought on a search path only if it is exclusively a
source.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>shell</glossterm>
<glossdef>
<para>A program to which commands are passed in order to create
targets.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>source</glossterm>
<glossdef>
<para>Anything to the right of an operator on a dependency line.
Targets on the dependency line are usually created
from the sources.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>special target</glossterm>
<glossdef>
<para>A target that causes <application>PMake</application> to do
special things when it is encountered.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>suffix</glossterm>
<glossdef>
<para>The tail end of a file name. Usually begins with a period, like
<filename>.c</filename> or <filename>.ms</filename>.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>target</glossterm>
<glossdef>
<para>A word to the left of the operator on a dependency line.
More generally, any file that <application>PMake</application> might
create. A file may be (and often is) both a target and a source (what
it is depends on how <application>PMake</application> is looking at it
at the time – sort of like the wave/particle duality of light,
you know).</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>transformation rule</glossterm>
<glossdef>
<para>A special construct in a makefile that specifies how to create a
file of one type from a file of another, as indicated by their
suffixes.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>variable expansion</glossterm>
<glossdef>
<para>The process of substituting the value of a variable for a
reference to it. Expansion may be altered by means of modifiers.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>variable</glossterm>
<glossdef>
<para>A place in which to store text that may be retrieved later.
Also used to define the local environment.
Conditionals exist that test whether a variable is defined or not.</para>
</glossdef>
</glossentry>
</glossary>
|
