@@ -13,7 +13,7 @@ pgrminclude [-v]
13
13
pgcheckdefines
14
14
check for #ifdef tests on symbols defined in files that
15
15
weren't included --- this is a necessary sanity check on
16
- pgrminclude!
16
+ pgrminclude
17
17
18
18
pgdefinecreate macro calls for all defines in the file (used by
19
19
the above routines)
@@ -22,9 +22,19 @@ It is also a good idea to sort the pg-specific include files in
22
22
alphabetic order. This is best done with a text editor. Typical usage
23
23
order would be:
24
24
25
- pgfixinclude
26
- pgcompinclude
27
- pgrminclude /src/include
28
- pgcompinclude
25
+ pgfixinclude
26
+ sort include references
27
+ run multiple times:
28
+ pgcompinclude
29
+ pgrminclude /src/include
29
30
pgrminclude /
30
31
pgcheckdefines
32
+
33
+ There is a complexity when modifying /src/include. If include file 1
34
+ includes file 2, and file 2 includes file 3, then when file 1 is
35
+ processed, it needs only file 2, not file 3. However, if later, include
36
+ file 2 is processed, and file 3 is not needed by file 2 and is removed,
37
+ file 1 might then need to include file 3. For this reason, the
38
+ pgcompinclude and pgrminclude /src/include steps must be run several
39
+ times until all includes compile cleanly.
40
+