summaryrefslogtreecommitdiffstats
path: root/Configurations/INTERNALS.Configure
blob: b28305deca4c5af1194027bc13107f5504914ad7 (plain)
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
Configure Internals
===================

[ note: this file uses markdown for formatting ]

Intro
-----

This is a collection of notes that are hopefully of interest to those
who decide to dive into Configure and what it does.  This is a living
document and anyone is encouraged to add to it and submit changes.
There's no claim for this document to be complete at any time, but it
will hopefully reach such a point in time.


----------------------------------------------------------------------

Parsing build.info files, processing conditions
-----------------------------------------------

Processing conditions in build.info files is done with the help of a
condition stack that tell if a build.info should be processed or if it
should just be skipped over.  The possible states of the stack top are
expressed in the following comment from Configure:

    # The top item of this stack has the following values
    # -2 positive already run and we found ELSE (following ELSIF should fail)
    # -1 positive already run (skip until ENDIF)
    # 0 negatives so far (if we're at a condition, check it)
    # 1 last was positive (don't skip lines until next ELSE, ELSIF or ENDIF)
    # 2 positive ELSE (following ELSIF should fail)

Ground rule is that non-condition lines are skipped over if the
stack top is > 0.  Condition lines (IF, ELSIF, ELSE and ENDIF
statements) need to be processed either way to keep track of the skip
stack states, so they are a little more intricate.

Instead of trying to describe in words, here are some example of what
the skip stack should look like after each line is processed:

Example 1:

| IF[1]                     |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
|   IF[1]                   |  1  1     |                               |
|     ... whatever ...      |           | this line is processed        |
|   ELSIF[1]                |  1 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  1 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
| ELSIF[1]                  | -1        |                               |
|   ... whatever ...        |           | this line is skipped over     |
|   IF[1]                   | -1 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[1]                | -1 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    | -1 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   | -1        |                               |
|   ... whatever ...        |           | this line is skipped over     |
| ENDIF                     |           |                               |

Example 2:

| IF[0]                     |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
|   IF[1]                   |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[1]                |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  0 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
| ELSIF[1]                  |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
|   IF[1]                   |  1  1     |                               |
|     ... whatever ...      |           | this line is processed        |
|   ELSIF[1]                |  1 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  1 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
| ENDIF                     |           |                               |

Example 3:

| IF[0]                     |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
|   IF[0]                   |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[1]                |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  0 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
| ELSIF[1]                  |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
|   IF[0]                   |  1  0     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[1]                |  1  1     |                               |
|     ... whatever ...      |           | this line is processed        |
|   ELSE                    |  1 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
| ENDIF                     |           |                               |

Example 4:

| IF[0]                     |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
|   IF[0]                   |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[0]                |  0 -1     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  0 -2     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ENDIF                   |  0        |                               |
|   ... whatever ...        |           | this line is skipped over     |
| ELSIF[1]                  |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
|   IF[0]                   |  1  0     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSIF[0]                |  1  0     |                               |
|     ... whatever ...      |           | this line is skipped over     |
|   ELSE                    |  1  2     |                               |
|     ... whatever ...      |           | this line is processed        |
|   ENDIF                   |  1        |                               |
|   ... whatever ...        |           | this line is processed        |
| ENDIF                     |           |                               |