Merge tag 'upstream/2.3.1'

Upstream version 2.3.1

1 files changed, 529 insertions, 0 deletions

diff --git a/doc/design/engine.svg b/doc/design/engine.svg
new file mode 100644
index 0000000..2ed9bcc
--- /dev/null
+++ b/doc/design/engine.svg
@@ -0,0 +1,529 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   version="1.1"
+   width="8.5in"
+   height="7.5999999in"
+   viewBox="1188 1638 10224 9174"
+   id="svg3034">
+  <metadata
+     id="metadata3230">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <defs
+     id="defs3228" />
+  <g
+     id="g3036"
+     style="fill:none;stroke-width:0.025in">
+    <rect
+       width="1500"
+       height="600"
+       rx="0"
+       x="2100"
+       y="8700"
+       id="rect3038"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1950"
+       height="600"
+       rx="0"
+       x="7050"
+       y="6900"
+       id="rect3040"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1950"
+       height="600"
+       rx="0"
+       x="9450"
+       y="6900"
+       id="rect3042"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1200"
+       height="600"
+       rx="0"
+       x="1200"
+       y="4200"
+       id="rect3044"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1200"
+       height="600"
+       rx="0"
+       x="2400"
+       y="3300"
+       id="rect3046"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1800"
+       height="600"
+       rx="0"
+       x="8700"
+       y="1650"
+       id="rect3048"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1800"
+       height="600"
+       rx="0"
+       x="1500"
+       y="1650"
+       id="rect3050"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1500"
+       height="600"
+       rx="0"
+       x="7800"
+       y="8700"
+       id="rect3052"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="900"
+       height="600"
+       rx="0"
+       x="1500"
+       y="10200"
+       id="rect3054"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="900"
+       height="600"
+       rx="0"
+       x="3300"
+       y="10200"
+       id="rect3056"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1200"
+       height="600"
+       rx="0"
+       x="6000"
+       y="10200"
+       id="rect3058"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1500"
+       height="600"
+       rx="0"
+       x="7800"
+       y="10200"
+       id="rect3060"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="1200"
+       height="600"
+       rx="0"
+       x="9900"
+       y="10200"
+       id="rect3062"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="6825,5175 6900,5100 6975,5175 6900,5250 6900,5250 "
+       id="polygon3064"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="6225,5175 6300,5100 6375,5175 6300,5250 6300,5250 "
+       id="polygon3066"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="5625,5175 5700,5100 5775,5175 5700,5250 5700,5250 "
+       id="polygon3068"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <rect
+       width="2400"
+       height="2400"
+       rx="0"
+       x="4800"
+       y="2700"
+       id="rect3070"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="5025,5250 5175,5250 5100,5100 5100,5100 "
+       id="polygon3072"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="6300,5250 6300,5700 8400,5700 8400,4200 7216,4200 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3074" />
+    <polyline
+       points="7322 4170 7202 4200 7322 4230 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3076" />
+    <polyline
+       points="5700,5250 5700,6000 9000,6000 9000,3600 7216,3600 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3078" />
+    <polyline
+       points="7322 3570 7202 3600 7322 3630 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3080" />
+    <polyline
+       points="5100,5250 5100,8100 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3082" />
+    <polygon
+       points="4650,3600 4725,3525 4800,3600 4725,3675 4725,3675 "
+       id="polygon3084"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="4650,4500 4725,4425 4800,4500 4725,4575 4725,4575 "
+       id="polygon3086"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="4650,3600 3616,3600 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3088" />
+    <polyline
+       points="3722 3570 3602 3600 3722 3630 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3090" />
+    <polyline
+       points="4650,4500 2416,4500 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3092" />
+    <polyline
+       points="2522 4470 2402 4500 2522 4530 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3094" />
+    <polyline
+       points="1800,2400 1800,4183 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3096" />
+    <polyline
+       points="1770 4078 1800 4198 1830 4078 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3098" />
+    <polyline
+       points="3000,2400 3000,3283 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3100" />
+    <polyline
+       points="2970 3178 3000 3298 3030 3178 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3102" />
+    <polyline
+       points="5850,1950 5850,2700 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40"
+       id="polyline3104" />
+    <polygon
+       points="2925,2325 3000,2250 3075,2325 3000,2400 3000,2400 "
+       id="polygon3106"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polygon
+       points="1725,2325 1800,2250 1875,2325 1800,2400 1800,2400 "
+       id="polygon3108"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="3300,1950 8700,1950 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3110" />
+    <polyline
+       points="9600,2400 9600,6600 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3112" />
+    <polyline
+       points="7950,6900 7950,6600 10350,6600 10350,6900 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3114" />
+    <polygon
+       points="9525,2400 9675,2400 9600,2250 9600,2250 "
+       id="polygon3116"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="4800,3000 7200,3000 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3118" />
+    <polyline
+       points="4800,3300 7200,3300 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3120" />
+    <polygon
+       points="2775,9450 2925,9450 2850,9300 2850,9300 "
+       id="polygon3122"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="2100,10200 2100,9900 3750,9900 3750,10200 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3124" />
+    <polyline
+       points="6600,10200 6600,9900 10500,9900 10500,10200 10500,10125 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3126" />
+    <polyline
+       points="2850,9450 2850,9900 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3128" />
+    <polyline
+       points="8475,9450 8475,10200 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3130" />
+    <polygon
+       points="8400,9450 8550,9450 8475,9300 8475,9300 "
+       id="polygon3132"
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" />
+    <polyline
+       points="2775,6825 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3134" />
+    <polyline
+       points="1800,10200 1800,9000 2083,9000 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3136" />
+    <polyline
+       points="1978 9030 2098 9000 1978 8970 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3138" />
+    <polyline
+       points="9900,10500 9316,10500 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3140" />
+    <polyline
+       points="9422 10470 9302 10500 9422 10530 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3142" />
+    <polyline
+       points="7800,10500 7216,10500 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3144" />
+    <polyline
+       points="7322 10470 7202 10500 7322 10530 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3146" />
+    <polyline
+       points="2850,8700 2850,8100 8550,8100 8550,8700 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3148" />
+    <polyline
+       points="10350,7500 10350,9000 9316,9000 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40"
+       id="polyline3150" />
+    <polyline
+       points="9422 8970 9302 9000 9422 9030 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3152" />
+    <polyline
+       points="7050,7200 2400,7200 2400,8683 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40"
+       id="polyline3154" />
+    <polyline
+       points="2370 8578 2400 8698 2430 8578 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3156" />
+    <polyline
+       points="6900,5250 6900,5400 7800,5400 7800,4800 7216,4800 "
+       style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+       id="polyline3158" />
+    <polyline
+       points="7322 4770 7202 4800 7322 4830 "
+       style="stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+       id="polyline3160" />
+    <text
+       x="2400"
+       y="9075"
+       id="text3162"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Node.FS</text>
+    <text
+       x="7200"
+       y="7275"
+       id="text3164"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Intercessor.FS</text>
+    <text
+       x="9600"
+       y="7275"
+       id="text3166"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Intercessor.DB</text>
+    <text
+       x="1350"
+       y="4575"
+       id="text3168"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Scanner</text>
+    <text
+       x="2625"
+       y="3675"
+       id="text3170"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Builder</text>
+    <text
+       x="9000"
+       y="2025"
+       id="text3172"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Intercessor</text>
+    <text
+       x="1725"
+       y="2025"
+       id="text3174"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Environment</text>
+    <text
+       x="8100"
+       y="9075"
+       id="text3176"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Node.DB</text>
+    <text
+       x="1800"
+       y="10575"
+       id="text3178"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Dir</text>
+    <text
+       x="3600"
+       y="10575"
+       id="text3180"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">File</text>
+    <text
+       x="6300"
+       y="10575"
+       id="text3182"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Table</text>
+    <text
+       x="8100"
+       y="10575"
+       id="text3184"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Record</text>
+    <text
+       x="10200"
+       y="10575"
+       id="text3186"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Field</text>
+    <text
+       x="4950"
+       y="2925"
+       id="text3188"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Helvetica">Node</text>
+    <text
+       x="7350"
+       y="3525"
+       id="text3190"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">dependency</text>
+    <text
+       x="7425"
+       y="3825"
+       id="text3192"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">*</text>
+    <text
+       x="7350"
+       y="4125"
+       id="text3194"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">srcnode</text>
+    <text
+       x="7425"
+       y="4425"
+       id="text3196"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">1</text>
+    <text
+       x="7350"
+       y="4725"
+       id="text3198"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">repnode</text>
+    <text
+       x="7425"
+       y="5025"
+       id="text3200"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">1</text>
+    <text
+       x="2550"
+       y="4725"
+       id="text3202"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">0..1</text>
+    <text
+       x="3750"
+       y="3825"
+       id="text3204"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">0..1</text>
+    <text
+       x="1875"
+       y="4050"
+       id="text3206"
+       xml:space="preserve"
+       style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">*</text>
+    <text
+       x="3075"
+       y="3150"
+       id="text3208"
+       xml:space="preserve"
+       style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">*</text>
+    <text
+       x="5100"
+       y="3750"
+       id="text3210"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">build()</text>
+    <text
+       x="5100"
+       y="4260"
+       id="text3212"
+       xml:space="preserve"
+       style="font-size:168px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">scan()</text>
+    <text
+       x="9750"
+       y="10725"
+       id="text3214"
+       xml:space="preserve"
+       style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">1</text>
+    <text
+       x="1650"
+       y="10125"
+       id="text3216"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">1</text>
+    <text
+       x="1875"
+       y="9225"
+       id="text3218"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">*</text>
+    <text
+       x="7650"
+       y="10725"
+       id="text3220"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">1</text>
+    <text
+       x="7275"
+       y="10725"
+       id="text3222"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">*</text>
+    <text
+       x="9375"
+       y="10725"
+       id="text3224"
+       xml:space="preserve"
+       style="font-size:120px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Helvetica">*</text>
+  </g>
+</svg>