diff options
Diffstat (limited to 'doc/python10')
-rw-r--r-- | doc/python10/MANIFEST | 12 | ||||
-rw-r--r-- | doc/python10/SConstruct | 46 | ||||
-rw-r--r-- | doc/python10/abstract.xml | 37 | ||||
-rw-r--r-- | doc/python10/acks.xml | 39 | ||||
-rw-r--r-- | doc/python10/arch.eps | 134 | ||||
-rw-r--r-- | doc/python10/arch.svg | 124 | ||||
-rw-r--r-- | doc/python10/builder.eps | 325 | ||||
-rw-r--r-- | doc/python10/builder.svg | 330 | ||||
-rw-r--r-- | doc/python10/copyright.xml | 14 | ||||
-rw-r--r-- | doc/python10/design.xml | 143 | ||||
-rw-r--r-- | doc/python10/future.xml | 39 | ||||
-rw-r--r-- | doc/python10/install.xml | 39 | ||||
-rw-r--r-- | doc/python10/intro.xml | 39 | ||||
-rw-r--r-- | doc/python10/job-task.eps | 238 | ||||
-rw-r--r-- | doc/python10/job-task.svg | 244 | ||||
-rw-r--r-- | doc/python10/main.xml | 85 | ||||
-rw-r--r-- | doc/python10/node.eps | 351 | ||||
-rw-r--r-- | doc/python10/node.svg | 414 | ||||
-rw-r--r-- | doc/python10/process.xml | 39 | ||||
-rw-r--r-- | doc/python10/scanner.eps | 168 | ||||
-rw-r--r-- | doc/python10/scanner.svg | 160 | ||||
-rw-r--r-- | doc/python10/scons.mod | 428 | ||||
-rw-r--r-- | doc/python10/sig.eps | 147 | ||||
-rw-r--r-- | doc/python10/sig.svg | 124 | ||||
-rw-r--r-- | doc/python10/summary.xml | 52 |
25 files changed, 1850 insertions, 1921 deletions
diff --git a/doc/python10/MANIFEST b/doc/python10/MANIFEST index c9484d8..5703e36 100644 --- a/doc/python10/MANIFEST +++ b/doc/python10/MANIFEST @@ -1,16 +1,14 @@ +# We don't use a wildcard for the XML files +# here, because it would pull in the created +# ones as well... abstract.xml acks.xml -arch.fig -builder.fig +*.fig copyright.xml design.xml future.xml install.xml intro.xml -job-task.fig main.xml -node.fig process.xml -scanner.fig -scons.mod -sig.fig +summary.xml diff --git a/doc/python10/SConstruct b/doc/python10/SConstruct new file mode 100644 index 0000000..c02cf5e --- /dev/null +++ b/doc/python10/SConstruct @@ -0,0 +1,46 @@ +# +# SConstruct file for building SCons documentation. +# + +# +# Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation +# +# Permission is hereby granted, free of charge, to any person obtaining +# a copy of this software and associated documentation files (the +# "Software"), to deal in the Software without restriction, including +# without limitation the rights to use, copy, modify, merge, publish, +# distribute, sublicense, and/or sell copies of the Software, and to +# permit persons to whom the Software is furnished to do so, subject to +# the following conditions: +# +# The above copyright notice and this permission notice shall be included +# in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY +# KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE +# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +import os + +env = Environment(ENV={'PATH' : os.environ['PATH']}, + tools=['docbook'], + toolpath=['../../src/engine/SCons/Tool']) + +has_pdf = False +if (env.WhereIs('fop') or + env.WhereIs('xep')): + has_pdf = True + +# +# Create document +# +env.DocbookXInclude('python10_xi.xml', 'main.xml') +env.DocbookXslt('python10.xml', 'python10_xi.xml', + xsl='../xslt/to_docbook.xslt') +env.DocbookHtml('python10.html','python10.xml') +if has_pdf: + env.DocbookPdf('python10.pdf','python10.xml') diff --git a/doc/python10/abstract.xml b/doc/python10/abstract.xml index 45b4918..22bc750 100644 --- a/doc/python10/abstract.xml +++ b/doc/python10/abstract.xml @@ -1,3 +1,38 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<abstract xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> &SCons; is a software construction tool (build tool, or make tool) @@ -30,3 +65,5 @@ and discusses future plans and directions for the tool. </para> + +</abstract> diff --git a/doc/python10/acks.xml b/doc/python10/acks.xml index 895bad7..9316ea2 100644 --- a/doc/python10/acks.xml +++ b/doc/python10/acks.xml @@ -1,3 +1,40 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-acks" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Acknowledgements</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> First, many thanks to the great group of developers who dove in right @@ -25,3 +62,5 @@ to experiment with &Cons; in the first place. </para> + +</section> diff --git a/doc/python10/arch.eps b/doc/python10/arch.eps deleted file mode 100644 index 1fdd51f..0000000 --- a/doc/python10/arch.eps +++ /dev/null @@ -1,134 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/arch.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 218 182 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 182 moveto 0 0 lineto 218 0 lineto 218 182 lineto closepath clip newpath --215.3 324.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -/Courier-Bold ff 300.00 scf sf -3825 2925 m -gs 1 -1 sc (scons) col0 sh gr -/Times-Roman ff 300.00 scf sf -3825 3225 m -gs 1 -1 sc (Script) col0 sh gr -/Times-Roman ff 300.00 scf sf -5100 4875 m -gs 1 -1 sc (Build Engine) col0 sh gr -/Courier-Bold ff 300.00 scf sf -4200 4875 m -gs 1 -1 sc (SCons) col0 sh gr -% Polyline -7.500 slw -n 3600 4200 m 7200 4200 l 7200 5400 l 3600 5400 l - cp gs col0 s gr -/Courier-Bold ff 300.00 scf sf -4725 4050 m -gs 1 -1 sc (SCons) col0 sh gr -/Times-Roman ff 300.00 scf sf -5625 4050 m -gs 1 -1 sc (API) col0 sh gr -% Polyline -n 3600 2400 m 3600 2400 l 3600 2400 l 3600 2400 l - cp gs col0 s gr -% Polyline -n 3600 2400 m 4800 2400 l 4800 3600 l 3600 3600 l - cp gs col0 s gr -% Polyline -n 3600 3600 m 7200 3600 l 7200 4200 l 3600 4200 l - cp gs col0 s gr -% Polyline - [60] 0 sd -n 6000 3600 m 7200 3600 l 7200 2400 l 6000 2400 l - cp gs col0 s gr [] 0 sd -/Times-Italic ff 300.00 scf sf -6300 2925 m -gs 1 -1 sc (other) col0 sh gr -/Times-Italic ff 300.00 scf sf -6150 3225 m -gs 1 -1 sc (interface) col0 sh gr -$F2psEnd -rs diff --git a/doc/python10/arch.svg b/doc/python10/arch.svg new file mode 100644 index 0000000..df3a8c0 --- /dev/null +++ b/doc/python10/arch.svg @@ -0,0 +1,124 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.07440476,0,0,0.07440476,-26.785704,242.18362)" + id="g3017" + style="fill:none;stroke-width:0.025in"> + <rect + width="3600" + height="1200" + rx="0" + x="3600" + y="4200" + id="rect3019" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="0" + height="0" + rx="0" + x="3600" + y="2400" + id="rect3021" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="1200" + rx="0" + x="3600" + y="2400" + id="rect3023" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="3600" + height="600" + rx="0" + x="3600" + y="3600" + id="rect3025" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="1200" + rx="0" + x="6000" + y="2400" + id="rect3027" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <text + x="3825" + y="2925" + id="text3029" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Courier">scons</text> + <text + x="3825" + y="3225" + id="text3031" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Script</text> + <text + x="5100" + y="4875" + id="text3033" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Build Engine</text> + <text + x="4200" + y="4875" + id="text3035" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Courier">SCons</text> + <text + x="4725" + y="4050" + id="text3037" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:bold;text-anchor:start;fill:#000000;font-family:Courier">SCons</text> + <text + x="5625" + y="4050" + id="text3039" + xml:space="preserve" + style="font-size:240px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">API</text> + <text + x="6300" + y="2925" + id="text3041" + xml:space="preserve" + style="font-size:240px;font-style:italic;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">other</text> + <text + x="6150" + y="3225" + id="text3043" + xml:space="preserve" + style="font-size:240px;font-style:italic;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">interface</text> + </g> + </g> +</svg> diff --git a/doc/python10/builder.eps b/doc/python10/builder.eps deleted file mode 100644 index db87afc..0000000 --- a/doc/python10/builder.eps +++ /dev/null @@ -1,325 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/builder.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 668 290 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 290 moveto 0 0 lineto 668 0 lineto 668 290 lineto closepath clip newpath --53.3 342.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/reencdict 12 dict def /ReEncode { reencdict begin -/newcodesandnames exch def /newfontname exch def /basefontname exch def -/basefontdict basefontname findfont def /newfont basefontdict maxlength dict def -basefontdict { exch dup /FID ne { dup /Encoding eq -{ exch dup length array copy newfont 3 1 roll put } -{ exch newfont 3 1 roll put } ifelse } { pop pop } ifelse } forall -newfont /FontName newfontname put newcodesandnames aload pop -128 1 255 { newfont /Encoding get exch /.notdef put } for -newcodesandnames length 2 idiv { newfont /Encoding get 3 1 roll put } repeat -newfontname newfont definefont pop end } def -/isovec [ -8#055 /minus 8#200 /grave 8#201 /acute 8#202 /circumflex 8#203 /tilde -8#204 /macron 8#205 /breve 8#206 /dotaccent 8#207 /dieresis -8#210 /ring 8#211 /cedilla 8#212 /hungarumlaut 8#213 /ogonek 8#214 /caron -8#220 /dotlessi 8#230 /oe 8#231 /OE -8#240 /space 8#241 /exclamdown 8#242 /cent 8#243 /sterling -8#244 /currency 8#245 /yen 8#246 /brokenbar 8#247 /section 8#250 /dieresis -8#251 /copyright 8#252 /ordfeminine 8#253 /guillemotleft 8#254 /logicalnot -8#255 /hyphen 8#256 /registered 8#257 /macron 8#260 /degree 8#261 /plusminus -8#262 /twosuperior 8#263 /threesuperior 8#264 /acute 8#265 /mu 8#266 /paragraph -8#267 /periodcentered 8#270 /cedilla 8#271 /onesuperior 8#272 /ordmasculine -8#273 /guillemotright 8#274 /onequarter 8#275 /onehalf -8#276 /threequarters 8#277 /questiondown 8#300 /Agrave 8#301 /Aacute -8#302 /Acircumflex 8#303 /Atilde 8#304 /Adieresis 8#305 /Aring -8#306 /AE 8#307 /Ccedilla 8#310 /Egrave 8#311 /Eacute -8#312 /Ecircumflex 8#313 /Edieresis 8#314 /Igrave 8#315 /Iacute -8#316 /Icircumflex 8#317 /Idieresis 8#320 /Eth 8#321 /Ntilde 8#322 /Ograve -8#323 /Oacute 8#324 /Ocircumflex 8#325 /Otilde 8#326 /Odieresis 8#327 /multiply -8#330 /Oslash 8#331 /Ugrave 8#332 /Uacute 8#333 /Ucircumflex -8#334 /Udieresis 8#335 /Yacute 8#336 /Thorn 8#337 /germandbls 8#340 /agrave -8#341 /aacute 8#342 /acircumflex 8#343 /atilde 8#344 /adieresis 8#345 /aring -8#346 /ae 8#347 /ccedilla 8#350 /egrave 8#351 /eacute -8#352 /ecircumflex 8#353 /edieresis 8#354 /igrave 8#355 /iacute -8#356 /icircumflex 8#357 /idieresis 8#360 /eth 8#361 /ntilde 8#362 /ograve -8#363 /oacute 8#364 /ocircumflex 8#365 /otilde 8#366 /odieresis 8#367 /divide -8#370 /oslash 8#371 /ugrave 8#372 /uacute 8#373 /ucircumflex -8#374 /udieresis 8#375 /yacute 8#376 /thorn 8#377 /ydieresis] def -/Times-Roman /Times-Roman-iso isovec ReEncode -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -% Polyline -7.500 slw -n 2700 1200 m 4500 1200 l 4500 1800 l 2700 1800 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -2925 1575 m -gs 1 -1 sc (Environment) col0 sh gr -% Polyline -n 2700 2400 m 4500 2400 l 4500 3000 l 2700 3000 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -3600 2775 m -gs 1 -1 sc (BuilderWrapper) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 2700 3600 m 4500 3600 l 4500 4200 l 2700 4200 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -3600 3975 m -gs 1 -1 sc (BuilderBase) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 8400 3600 m 9900 3600 l 9900 4200 l 8400 4200 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -9150 3975 m -gs 1 -1 sc (ActionBase) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -4650 5175 m -gs 1 -1 sc (MultiStep-) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -4650 5460 m -gs 1 -1 sc (Builder) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 3900 4800 m 5400 4800 l 5400 5700 l 3900 5700 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -2550 5175 m -gs 1 -1 sc (Composite-) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -2550 5460 m -gs 1 -1 sc (Builder) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 1800 4800 m 3300 4800 l 3300 5700 l 1800 5700 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -7050 5175 m -gs 1 -1 sc (Command) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -7050 5460 m -gs 1 -1 sc (Action) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 6300 4800 m 7800 4800 l 7800 5700 l 6300 5700 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -9150 5460 m -gs 1 -1 sc (Action) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -9150 5175 m -gs 1 -1 sc (Function) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 8400 4800 m 9900 4800 l 9900 5700 l 8400 5700 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -11250 5175 m -gs 1 -1 sc (List) dup sw pop 2 div neg 0 rm col0 sh gr -/Times-Roman-iso ff 240.00 scf sf -11250 5460 m -gs 1 -1 sc (Action) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 10500 4800 m 12000 4800 l 12000 5700 l 10500 5700 l - cp gs col0 s gr -% Polyline -n 900 2400 m 2100 2400 l 2100 3000 l 900 3000 l - cp gs col0 s gr -/Times-Roman-iso ff 240.00 scf sf -1500 2775 m -gs 1 -1 sc (Node) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 3600 4200 m 3525 4350 l 3675 4350 l - cp gs col0 s gr -% Polyline -n 3150 4800 m 3150 4500 l 4050 4500 l - 4050 4800 l gs col0 s gr -% Polyline -n 3600 4350 m - 3600 4500 l gs col0 s gr -% Polyline -n 9150 4200 m 9075 4350 l 9225 4350 l - cp gs col0 s gr -% Polyline -n 7050 4800 m 7050 4500 l 10950 4500 l - 10950 4800 l gs col0 s gr -% Polyline -n 9150 4350 m - 9150 4800 l gs col0 s gr -% Polyline -gs clippath -9885 3870 m 9885 3930 l 10036 3930 l 9916 3900 l 10036 3870 l cp -eoclip -n 11550 4650 m 11550 3900 l - 9900 3900 l gs col0 s gr gr - -% arrowhead -n 10036 3870 m 9916 3900 l 10036 3930 l 10036 3870 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -8415 3930 m 8415 3870 l 8264 3870 l 8384 3900 l 8264 3930 l cp -eoclip -n 4650 3900 m - 8400 3900 l gs col0 s gr gr - -% arrowhead -n 8264 3930 m 8384 3900 l 8264 3870 l 8264 3930 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -3930 1785 m 3870 1785 l 3870 1936 l 3900 1816 l 3930 1936 l cp -eoclip -n 3900 2250 m - 3900 1800 l gs col0 s gr gr - -% arrowhead -n 3930 1936 m 3900 1816 l 3870 1936 l 3930 1936 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -3270 2415 m 3330 2415 l 3330 2264 l 3300 2384 l 3270 2264 l cp -eoclip -n 3300 1950 m - 3300 2400 l gs col0 s gr gr - -% arrowhead -n 3270 2264 m 3300 2384 l 3330 2264 l 3270 2264 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -3570 3615 m 3630 3615 l 3630 3464 l 3600 3584 l 3570 3464 l cp -eoclip -n 3600 3150 m - 3600 3600 l gs col0 s gr gr - -% arrowhead -n 3570 3464 m 3600 3584 l 3630 3464 l 3570 3464 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4380 4185 m 4320 4185 l 4320 4336 l 4350 4216 l 4380 4336 l cp -eoclip -n 4350 4650 m - 4350 4200 l gs col0 s gr gr - -% arrowhead -n 4380 4336 m 4350 4216 l 4320 4336 l 4380 4336 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -2880 4185 m 2820 4185 l 2820 4336 l 2850 4216 l 2880 4336 l cp -eoclip -n 2850 4650 m - 2850 4200 l gs col0 s gr gr - -% arrowhead -n 2880 4336 m 2850 4216 l 2820 4336 l 2880 4336 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -2715 3930 m 2715 3870 l 2564 3870 l 2684 3900 l 2564 3930 l cp -eoclip -n 1500 3150 m 1500 3900 l - 2700 3900 l gs col0 s gr gr - -% arrowhead -n 2564 3930 m 2684 3900 l 2564 3870 l 2564 3930 l cp gs 0.00 setgray ef gr col0 s -% Polyline -n 4650 3900 m 4575 3860 l 4500 3900 l 4575 3940 l - cp gs col0 s gr -% Polyline -n 1500 3000 m 1460 3075 l 1500 3150 l 1540 3075 l - cp gs col0 s gr -% Polyline -n 3600 3000 m 3560 3075 l 3600 3150 l 3640 3075 l - cp gs col0 s gr -% Polyline -n 3300 1800 m 3260 1875 l 3300 1950 l 3340 1875 l - cp gs col0 s gr -% Polyline -n 3900 2250 m 3860 2325 l 3900 2400 l 3940 2325 l - cp gs col0 s gr -% Polyline -n 4350 4650 m 4310 4725 l 4350 4800 l 4390 4725 l - cp gs col0 s gr -% Polyline -n 2850 4650 m 2810 4725 l 2850 4800 l 2890 4725 l - cp gs col0 s gr -% Polyline -n 11550 4650 m 11510 4725 l 11550 4800 l 11590 4725 l - cp gs col0 s gr -% Polyline - [60] 0 sd -n 3600 1200 m - 3600 900 l gs col0 s gr [] 0 sd -$F2psEnd -rs diff --git a/doc/python10/builder.svg b/doc/python10/builder.svg new file mode 100644 index 0000000..5648dd6 --- /dev/null +++ b/doc/python10/builder.svg @@ -0,0 +1,330 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.07462687,0,0,0.07462687,-106.34331,286.09351)" + id="g3006" + style="fill:none;stroke-width:0.025in"> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="1200" + id="rect3008" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="2400" + id="rect3010" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="3600" + id="rect3012" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="600" + rx="0" + x="8400" + y="3600" + id="rect3014" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="900" + rx="0" + x="3900" + y="4800" + id="rect3016" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="900" + rx="0" + x="1800" + y="4800" + id="rect3018" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="900" + rx="0" + x="6300" + y="4800" + id="rect3020" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="900" + rx="0" + x="8400" + y="4800" + id="rect3022" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="900" + rx="0" + x="10500" + y="4800" + id="rect3024" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="900" + y="2400" + id="rect3026" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3600,4200 3600,4200 3525,4350 3675,4350 " + id="polygon3028" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3030" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3150,4800 3150,4500 4050,4500 4050,4800 " /> + <polyline + id="polyline3032" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3600,4350 3600,4500 " /> + <polygon + points="9150,4200 9150,4200 9075,4350 9225,4350 " + id="polygon3034" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3036" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="7050,4800 7050,4500 10950,4500 10950,4800 " /> + <polyline + id="polyline3038" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="9150,4350 9150,4800 " /> + <polyline + id="polyline3040" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="11550,4650 11550,3900 10019,3900 " /> + <polygon + points="10021,3870 10021,3870 9901,3900 10021,3930 " + id="polygon3042" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3044" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4650,3900 8280,3900 " /> + <polygon + points="8279,3930 8279,3930 8399,3900 8279,3870 " + id="polygon3046" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3048" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3900,2250 3900,1919 " /> + <polygon + points="3930,1921 3930,1921 3900,1801 3870,1921 " + id="polygon3050" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3052" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3300,1950 3300,2280 " /> + <polygon + points="3270,2279 3270,2279 3300,2399 3330,2279 " + id="polygon3054" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3056" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3600,3150 3600,3480 " /> + <polygon + points="3570,3479 3570,3479 3600,3599 3630,3479 " + id="polygon3058" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3060" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4350,4650 4350,4319 " /> + <polygon + points="4380,4321 4380,4321 4350,4201 4320,4321 " + id="polygon3062" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3064" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="2850,4650 2850,4319 " /> + <polygon + points="2880,4321 2880,4321 2850,4201 2820,4321 " + id="polygon3066" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3068" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1500,3150 1500,3900 2580,3900 " /> + <polygon + points="2579,3930 2579,3930 2699,3900 2579,3870 " + id="polygon3070" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polygon + points="4575,3940 4650,3900 4650,3900 4575,3860 4500,3900 " + id="polygon3072" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="1540,3075 1500,3000 1500,3000 1460,3075 1500,3150 " + id="polygon3074" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3640,3075 3600,3000 3600,3000 3560,3075 3600,3150 " + id="polygon3076" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3340,1875 3300,1800 3300,1800 3260,1875 3300,1950 " + id="polygon3078" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3940,2325 3900,2250 3900,2250 3860,2325 3900,2400 " + id="polygon3080" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="4390,4725 4350,4650 4350,4650 4310,4725 4350,4800 " + id="polygon3082" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="2890,4725 2850,4650 2850,4650 2810,4725 2850,4800 " + id="polygon3084" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="11590,4725 11550,4650 11550,4650 11510,4725 11550,4800 " + id="polygon3086" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3088" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="3600,1200 3600,900 " /> + <text + x="2925" + y="1575" + id="text3090" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Environment</text> + <text + x="3600" + y="2775" + id="text3092" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">BuilderWrapper</text> + <text + x="3600" + y="3975" + id="text3094" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">BuilderBase</text> + <text + x="9150" + y="3975" + id="text3096" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">ActionBase</text> + <text + x="4650" + y="5175" + id="text3098" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">MultiStep-</text> + <text + x="4650" + y="5460" + id="text3100" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Builder</text> + <text + x="2550" + y="5175" + id="text3102" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Composite-</text> + <text + x="2550" + y="5460" + id="text3104" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Builder</text> + <text + x="7050" + y="5175" + id="text3106" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Command</text> + <text + x="7050" + y="5460" + id="text3108" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Action</text> + <text + x="9150" + y="5460" + id="text3110" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Action</text> + <text + x="9150" + y="5175" + id="text3112" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Function</text> + <text + x="11250" + y="5175" + id="text3114" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">List</text> + <text + x="11250" + y="5460" + id="text3116" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Action</text> + <text + x="1500" + y="2775" + id="text3118" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Node</text> + </g> + </g> +</svg> diff --git a/doc/python10/copyright.xml b/doc/python10/copyright.xml index d141fc6..27f7e8c 100644 --- a/doc/python10/copyright.xml +++ b/doc/python10/copyright.xml @@ -1,6 +1,16 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<legalnotice xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> + <!-- - Copyright (c) 2001, 2002, 2003 Steven Knight + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the @@ -30,3 +40,5 @@ </para> </blockquote> + +</legalnotice> diff --git a/doc/python10/design.xml b/doc/python10/design.xml index 0dd5faa..7fe7853 100644 --- a/doc/python10/design.xml +++ b/doc/python10/design.xml @@ -1,22 +1,57 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-design" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Architecture</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> The &SCons; architecture consists of three layers: </para> +<figure> +<title>&SCons; architecture</title> <mediaobject> <imageobject> - <imagedata fileref="arch" format="eps" align="center"/> - </imageobject> - <imageobject> - <imagedata fileref="arch.jpg" format="jpg" align="center"/> + <imagedata fileref="arch.svg" align="center" scale="50"/> </imageobject> - <!-- PDF files? <imageobject> - <imagedata fileref="arch.pdf" align="center"/> + <imagedata fileref="arch.jpg" align="center"/> </imageobject> - --> </mediaobject> +</figure> <itemizedlist> @@ -164,19 +199,17 @@ </para> + <figure> + <title>Node subsystem</title> <mediaobject> <imageobject> - <imagedata fileref="node" format="eps" align="center"/> - </imageobject> - <imageobject> - <imagedata fileref="node.jpg" format="jpg" align="center"/> + <imagedata fileref="node.svg" align="center" scale="50"/> </imageobject> - <!-- PDF files? <imageobject> - <imagedata fileref="node.pdf" align="center"/> + <imagedata fileref="node.jpg" align="center"/> </imageobject> - --> </mediaobject> + </figure> <para> @@ -228,19 +261,17 @@ </para> + <figure> + <title>Scanner subsystem</title> <mediaobject> <imageobject> - <imagedata fileref="scanner" format="eps" align="center"/> - </imageobject> - <imageobject> - <imagedata fileref="scanner.jpg" format="jpg" align="center"/> + <imagedata fileref="scanner.svg" align="center" scale="50"/> </imageobject> - <!-- PDF files? <imageobject> - <imagedata fileref="scanner.pdf" align="center"/> + <imagedata fileref="scanner.jpg" align="center"/> </imageobject> - --> </mediaobject> + </figure> <para> @@ -270,19 +301,17 @@ </para> + <figure> + <title>Signature subsystem</title> <mediaobject> <imageobject> - <imagedata fileref="sig" format="eps" align="center"/> + <imagedata fileref="sig.svg" align="center" scale="50"/> </imageobject> <imageobject> - <imagedata fileref="sig.jpg" format="jpg" align="center"/> + <imagedata fileref="sig.jpg" align="center"/> </imageobject> - <!-- PDF files? - <imageobject> - <imagedata fileref="sig.pdf" align="center"/> - </imageobject> - --> </mediaobject> + </figure> <para> @@ -326,19 +355,17 @@ </para> + <figure> + <title>Builder subsystem</title> <mediaobject> <imageobject> - <imagedata fileref="builder" format="eps" align="center"/> - </imageobject> - <imageobject> - <imagedata fileref="builder.jpg" format="jpg" align="center"/> + <imagedata fileref="builder.svg" align="center" scale="50"/> </imageobject> - <!-- PDF files? <imageobject> - <imagedata fileref="builder.pdf" align="center"/> + <imagedata fileref="builder.jpg" align="center"/> </imageobject> - --> </mediaobject> + </figure> <para> @@ -389,19 +416,17 @@ </para> + <figure> + <title>Job/Task subsystem</title> <mediaobject> <imageobject> - <imagedata fileref="job-task" format="eps" align="center"/> + <imagedata fileref="job-task.svg" align="center" scale="50"/> </imageobject> <imageobject> - <imagedata fileref="job-task.jpg" format="jpg" align="center"/> + <imagedata fileref="job-task.jpg" align="center"/> </imageobject> - <!-- PDF files? - <imageobject> - <imagedata fileref="job-task.pdf" align="center"/> - </imageobject> - --> </mediaobject> + </figure> <para> @@ -531,8 +556,8 @@ </para> <programlisting> - env = Environment() - env_debug = Environment(CCFLAGS = '-g') +env = Environment() +env_debug = Environment(CCFLAGS = '-g') </programlisting> </section> @@ -547,7 +572,7 @@ file, a library, etc. A &Builder; object is associated with a file through an associated &consenv; method and later invoked to actually build the file. The &Builder; object will typically use - construction variables (such as &CCFLAGS;, &LIBPATH;) to influence + construction variables (such as <literal>CCFLAGS</literal>, <literal>LIBPATH</literal>) to influence the specific build execution. </para> @@ -559,7 +584,7 @@ </para> <programlisting> - bld = Builder(name = 'Program', action = "$CC -o $TARGET $SOURCES") +bld = Builder(name = 'Program', action = "$CC -o $TARGET $SOURCES") </programlisting> <para> @@ -608,8 +633,8 @@ </para> <programlisting> - bld_lib = Builder(name = 'Library', action = "$AR r $TARGET $SOURCES", - prefix = 'lib', suffix = '.a', src_suffix = '.o') +bld_lib = Builder(name = 'Library', action = "$AR r $TARGET $SOURCES", + prefix = 'lib', suffix = '.a', src_suffix = '.o') </programlisting> <para> @@ -629,13 +654,13 @@ <para> &Builder; objects are associated with a &consenv; through a - &consvar; named &BUILDERS;, a list of the &Builder; objects that + &consvar; named <literal>BUILDERS</literal>, a list of the &Builder; objects that will be available for execution through the &consenv;: </para> <programlisting> - env = Environment(BUILDERS = [ Object, Library, WebPage, Program ]) +env = Environment(BUILDERS = [ Object, Library, WebPage, Program ]) </programlisting> </section> @@ -678,13 +703,13 @@ <para> &Scanner; objects are associated with a &consenv; through a - &consvar; named &SCANNERS;, a list of the &Scanner; objects that + &consvar; named <literal>SCANNERS</literal>, a list of the &Scanner; objects that will be available through the &consenv;: </para> <programlisting> - env = Environment(SCANNERS = [ CScan, M4Scan ]) +env = Environment(SCANNERS = [ CScan, M4Scan ]) </programlisting> <para> @@ -720,7 +745,7 @@ </para> <programlisting> - BuildDir(source = 'src', build = 'bld') +BuildDir(source = 'src', build = 'bld') </programlisting> <para> @@ -738,7 +763,7 @@ </para> <programlisting> - BuildDir(source = 'src', build = 'bld', no_sources = 1) +BuildDir(source = 'src', build = 'bld', no_sources = 1) </programlisting> </section> @@ -759,7 +784,7 @@ </para> <programlisting> - Repository('/home/source/1.1', '/home/source/1.0') +Repository('/home/source/1.1', '/home/source/1.0') </programlisting> <para> @@ -785,7 +810,7 @@ </para> <programlisting> - Cache('/var/build.cache/i386') +Cache('/var/build.cache/i386') </programlisting> <para> @@ -855,7 +880,7 @@ </para> <programlisting> - source_files = 'f1.c f2.c f3.c' +source_files = 'f1.c f2.c f3.c' </programlisting> <para> @@ -867,7 +892,7 @@ </para> <programlisting> - SConscript('src/SConscript', 'lib/SConscript') +SConscript('src/SConscript', 'lib/SConscript') </programlisting> <para> @@ -896,3 +921,5 @@ </para> </section> + +</section> diff --git a/doc/python10/future.xml b/doc/python10/future.xml index 272d508..6c6b756 100644 --- a/doc/python10/future.xml +++ b/doc/python10/future.xml @@ -1,3 +1,40 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-future" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Future Directions</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> There are a number of things we would like to do to continue to @@ -168,3 +205,5 @@ </para> </section> + +</section> diff --git a/doc/python10/install.xml b/doc/python10/install.xml index d150beb..17f1e83 100644 --- a/doc/python10/install.xml +++ b/doc/python10/install.xml @@ -1,3 +1,40 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-install" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Installation</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> Initial installation of a new utility provides the first, lasting @@ -177,3 +214,5 @@ </para> </section> + +</section> diff --git a/doc/python10/intro.xml b/doc/python10/intro.xml index d3057be..79500e6 100644 --- a/doc/python10/intro.xml +++ b/doc/python10/intro.xml @@ -1,3 +1,40 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-intro" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Introduction</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> More than twenty years after its creation, the classic UNIX &Make; @@ -210,3 +247,5 @@ </para> </section> + +</section> diff --git a/doc/python10/job-task.eps b/doc/python10/job-task.eps deleted file mode 100644 index b3eeaff..0000000 --- a/doc/python10/job-task.eps +++ /dev/null @@ -1,238 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/job-task.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 416 236 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 236 moveto 0 0 lineto 416 0 lineto 416 236 lineto closepath clip newpath --35.3 342.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -% Polyline -7.500 slw -n 4200 3900 m 5100 3900 l 5100 4500 l 4200 4500 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -4650 4275 m -gs 1 -1 sc (Task) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 4200 5100 m 5100 5100 l 5100 5700 l 4200 5700 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -4650 5475 m -gs 1 -1 sc (Node) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 6300 2100 m 7200 2100 l 7200 2700 l 6300 2700 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -6750 2475 m -gs 1 -1 sc (Sig) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 6300 3300 m 7500 3300 l 7500 3900 l 6300 3900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -6900 3675 m -gs 1 -1 sc (Walker) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 4200 2100 m 5700 2100 l 5700 2700 l 4200 2700 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -4950 2475 m -gs 1 -1 sc (TaskMaster) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 2400 3300 m 3600 3300 l 3600 3900 l 2400 3900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -3000 3675 m -gs 1 -1 sc (Parallel) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 600 3300 m 1800 3300 l 1800 3900 l 600 3900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -1200 3675 m -gs 1 -1 sc (Serial) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 1200 2100 m 3000 2100 l 3000 2700 l 1200 2700 l - cp gs col0 s gr -/Times-Roman ff 255.00 scf sf -2099 2475 m -gs 1 -1 sc (Jobs) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 2700 2700 m 2660 2775 l 2700 2850 l 2740 2775 l - cp gs col0 s gr -% Polyline -n 5700 2400 m 5775 2440 l 5850 2400 l 5775 2360 l - cp gs col0 s gr -% Polyline -n 5400 2700 m 5360 2775 l 5400 2850 l 5440 2775 l - cp gs col0 s gr -% Polyline -n 4650 2700 m 4610 2775 l 4650 2850 l 4690 2775 l - cp gs col0 s gr -% Polyline -n 1500 2700 m 1460 2775 l 1500 2850 l 1540 2775 l - cp gs col0 s gr -% Polyline -n 4650 4500 m 4610 4575 l 4650 4650 l 4690 4575 l - cp gs col0 s gr -% Polyline -gs clippath -1470 3315 m 1530 3315 l 1530 3164 l 1500 3284 l 1470 3164 l cp -eoclip -n 1500 2850 m - 1500 3300 l gs col0 s gr gr - -% arrowhead -n 1470 3164 m 1500 3284 l 1530 3164 l 1470 3164 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -2670 3315 m 2730 3315 l 2730 3164 l 2700 3284 l 2670 3164 l cp -eoclip -n 2700 2850 m - 2700 3300 l gs col0 s gr gr - -% arrowhead -n 2670 3164 m 2700 3284 l 2730 3164 l 2670 3164 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4620 3915 m 4680 3915 l 4680 3764 l 4650 3884 l 4620 3764 l cp -eoclip -n 4650 2850 m - 4650 3900 l gs col0 s gr gr - -% arrowhead -n 4620 3764 m 4650 3884 l 4680 3764 l 4620 3764 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4620 5115 m 4680 5115 l 4680 4964 l 4650 5084 l 4620 4964 l cp -eoclip -n 4650 4650 m - 4650 5100 l gs col0 s gr gr - -% arrowhead -n 4620 4964 m 4650 5084 l 4680 4964 l 4620 4964 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -6315 3630 m 6315 3570 l 6164 3570 l 6284 3600 l 6164 3630 l cp -eoclip -n 5400 2850 m 5400 3600 l - 6300 3600 l gs col0 s gr gr - -% arrowhead -n 6164 3630 m 6284 3600 l 6164 3570 l 6164 3630 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -6315 2430 m 6315 2370 l 6164 2370 l 6284 2400 l 6164 2430 l cp -eoclip -n 5850 2400 m - 6300 2400 l gs col0 s gr gr - -% arrowhead -n 6164 2430 m 6284 2400 l 6164 2370 l 6164 2430 l cp gs 0.00 setgray ef gr col0 s -% Polyline -n 3000 2400 m 3075 2440 l 3150 2400 l 3075 2360 l - cp gs col0 s gr -% Polyline -gs clippath -4215 2430 m 4215 2370 l 4064 2370 l 4184 2400 l 4064 2430 l cp -eoclip -n 3150 2400 m - 4200 2400 l gs col0 s gr gr - -% arrowhead -n 4064 2430 m 4184 2400 l 4064 2370 l 4064 2430 l cp gs 0.00 setgray ef gr col0 s -% Polyline - [60] 0 sd -n 2100 2100 m - 2100 1800 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 4950 2100 m - 4950 1800 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 6750 2100 m - 6750 1800 l gs col0 s gr [] 0 sd -$F2psEnd -rs diff --git a/doc/python10/job-task.svg b/doc/python10/job-task.svg new file mode 100644 index 0000000..dc5fc20 --- /dev/null +++ b/doc/python10/job-task.svg @@ -0,0 +1,244 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.07538995,0,0,0.07538995,69.670703,249.64987)" + id="g3223" + style="fill:none;stroke-width:0.025in"> + <rect + width="900" + height="600" + rx="0" + x="4200" + y="3900" + id="rect3225" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="4200" + y="5100" + id="rect3227" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="6300" + y="2100" + id="rect3229" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="6300" + y="3300" + id="rect3231" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1500" + height="600" + rx="0" + x="4200" + y="2100" + id="rect3233" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="2400" + y="3300" + id="rect3235" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="600" + y="3300" + id="rect3237" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="1200" + y="2100" + id="rect3239" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="2740,2775 2700,2700 2700,2700 2660,2775 2700,2850 " + id="polygon3241" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="5775,2360 5700,2400 5700,2400 5775,2440 5850,2400 " + id="polygon3243" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="5440,2775 5400,2700 5400,2700 5360,2775 5400,2850 " + id="polygon3245" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="4690,2775 4650,2700 4650,2700 4610,2775 4650,2850 " + id="polygon3247" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="1540,2775 1500,2700 1500,2700 1460,2775 1500,2850 " + id="polygon3249" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="4690,4575 4650,4500 4650,4500 4610,4575 4650,4650 " + id="polygon3251" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3253" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1500,2850 1500,3180 " /> + <polygon + points="1470,3179 1470,3179 1500,3299 1530,3179 " + id="polygon3255" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3257" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="2700,2850 2700,3180 " /> + <polygon + points="2670,3179 2670,3179 2700,3299 2730,3179 " + id="polygon3259" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3261" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4650,2850 4650,3780 " /> + <polygon + points="4620,3779 4620,3779 4650,3899 4680,3779 " + id="polygon3263" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3265" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4650,4650 4650,4980 " /> + <polygon + points="4620,4979 4620,4979 4650,5099 4680,4979 " + id="polygon3267" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3269" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="5400,2850 5400,3600 6180,3600 " /> + <polygon + points="6179,3630 6179,3630 6299,3600 6179,3570 " + id="polygon3271" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3273" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="5850,2400 6180,2400 " /> + <polygon + points="6179,2430 6179,2430 6299,2400 6179,2370 " + id="polygon3275" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polygon + points="3075,2360 3000,2400 3000,2400 3075,2440 3150,2400 " + id="polygon3277" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3279" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3150,2400 4080,2400 " /> + <polygon + points="4079,2430 4079,2430 4199,2400 4079,2370 " + id="polygon3281" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3283" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="2100,2100 2100,1800 " /> + <polyline + id="polyline3285" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="4950,2100 4950,1800 " /> + <polyline + id="polyline3287" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="6750,2100 6750,1800 " /> + <text + x="4650" + y="4275" + id="text3289" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Task</text> + <text + x="4650" + y="5475" + id="text3291" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Node</text> + <text + x="6750" + y="2475" + id="text3293" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Sig</text> + <text + x="6900" + y="3675" + id="text3295" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Walker</text> + <text + x="4950" + y="2475" + id="text3297" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">TaskMaster</text> + <text + x="3000" + y="3675" + id="text3299" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Parallel</text> + <text + x="1200" + y="3675" + id="text3301" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Serial</text> + <text + x="2099" + y="2475" + id="text3303" + xml:space="preserve" + style="font-size:204px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Jobs</text> + </g> + </g> +</svg> diff --git a/doc/python10/main.xml b/doc/python10/main.xml index e061b90..30124ce 100644 --- a/doc/python10/main.xml +++ b/doc/python10/main.xml @@ -1,8 +1,19 @@ <?xml version="1.0"?> +<!DOCTYPE sconsdoc [ + + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; + +]> + +<article xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> + <!-- - Copyright (c) 2001, 2002, 2003 Steven Knight + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the @@ -24,26 +35,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --> - -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" -"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" -[ - - <!ENTITY % scons SYSTEM "scons.mod"> - %scons; - - <!ENTITY abstract SYSTEM "abstract.xml"> - <!ENTITY acks SYSTEM "acks.xml"> - <!ENTITY copyright SYSTEM "copyright.xml"> - <!ENTITY design SYSTEM "design.xml"> - <!ENTITY future SYSTEM "future.xml"> - <!ENTITY install SYSTEM "install.xml"> - <!ENTITY intro SYSTEM "intro.xml"> - <!ENTITY process SYSTEM "process.xml"> - -]> - -<article> + <articleinfo> <title>SCons Design and Implementation</title> @@ -81,56 +73,21 @@ </articleinfo> - <abstract> - &abstract; - </abstract> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="abstract.xml"/> - <section id="sect-intro"> - <title>Introduction</title> - &intro; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="intro.xml"/> - <section id="sect-design"> - <title>Architecture</title> - &design; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="design.xml"/> - <section id="sect-install"> - <title>Installation</title> - &install; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="install.xml"/> - <section id="sect-process"> - <title>Development Process</title> - &process; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="process.xml"/> - <section id="sect-future"> - <title>Future Directions</title> - &future; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="future.xml"/> - <section id="sect-summary"> - <title>Summary</title> - <para> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="summary.xml"/> - This paper has introduced &SCons;, a next-generation build tool - with a modular, embeddable architecture and a direct Python - interface. &SCons; has a global view of the dependencies in a source - tree, uses MD5 signatures to decide if derived files are out of date, - and automatically scans files for dependencies, all of which make &SCons; - builds exceptionally reliable. The &SCons; development methodology has - been described, notable for its emphasis on automated regression - testing to ensure a robust and reliable tool from day one. Several - future directions for &SCons; have also been discussed. - - </para> - </section> - - <section id="sect-acks"> - <title>Acknowledgements</title> - &acks; - </section> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acks.xml"/> <!-- <section id="sect-refs"> diff --git a/doc/python10/node.eps b/doc/python10/node.eps deleted file mode 100644 index 995235d..0000000 --- a/doc/python10/node.eps +++ /dev/null @@ -1,351 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/node.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 452 362 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 362 moveto 0 0 lineto 452 0 lineto 452 362 lineto closepath clip newpath -0.7 414.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -% Polyline -7.500 slw -n 2700 1200 m 4500 1200 l 4500 1800 l 2700 1800 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -2925 1575 m -gs 1 -1 sc (Environment) col0 sh gr -% Polyline -n 2700 3600 m 4500 3600 l 4500 4200 l 2700 4200 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -3375 3975 m -gs 1 -1 sc (Node) col0 sh gr -% Polyline -n 5700 1800 m 6900 1800 l 6900 2400 l 5700 2400 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -5925 2175 m -gs 1 -1 sc (Walker) col0 sh gr -% Polyline -n 2100 2400 m 3300 2400 l 3300 3000 l 2100 3000 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -2325 2775 m -gs 1 -1 sc (Builder) col0 sh gr -% Polyline -n 3900 2400 m 5100 2400 l 5100 3000 l 3900 3000 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -4125 2775 m -gs 1 -1 sc (Scanner) col0 sh gr -% Polyline -n 2400 6300 m 3300 6300 l 3300 6900 l 2400 6900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -2700 6675 m -gs 1 -1 sc (Dir) col0 sh gr -% Polyline -n 0 6300 m 900 6300 l 900 6900 l 0 6900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -150 6675 m -gs 1 -1 sc (Entry) col0 sh gr -% Polyline -n 1200 6300 m 2100 6300 l 2100 6900 l 1200 6900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -1425 6675 m -gs 1 -1 sc (File) col0 sh gr -% Polyline -n 1050 5100 m 2250 5100 l 2250 5700 l 1050 5700 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -1200 5475 m -gs 1 -1 sc (Node.FS) col0 sh gr -% Polyline -n 1650 5700 m 1575 5850 l 1725 5850 l - cp gs col0 s gr -% Polyline -n 450 6300 m 450 6000 l 2700 6000 l - 2700 6300 l gs col0 s gr -% Polyline -n 1650 6300 m - 1650 5850 l gs col0 s gr -% Polyline - [60] 0 sd -n 5100 6300 m 6300 6300 l 6300 6900 l 5100 6900 l - cp gs col0 s gr [] 0 sd -/Times-Roman ff 240.00 scf sf -5325 6675 m -gs 1 -1 sc (Record) col0 sh gr -% Polyline - [60] 0 sd -n 6600 6300 m 7500 6300 l 7500 6900 l 6600 6900 l - cp gs col0 s gr [] 0 sd -/Times-Roman ff 240.00 scf sf -6750 6675 m -gs 1 -1 sc (Field) col0 sh gr -% Polyline - [60] 0 sd -n 4950 5100 m 6150 5100 l 6150 5700 l 4950 5700 l - cp gs col0 s gr [] 0 sd -/Times-Roman ff 240.00 scf sf -5100 5475 m -gs 1 -1 sc (Node.DB) col0 sh gr -% Polyline -n 5550 5700 m 5475 5850 l 5625 5850 l - cp gs col0 s gr -% Polyline - [60] 0 sd -n 4350 6300 m 4350 6000 l 7050 6000 l - 7050 6300 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 5550 5850 m - 5550 6300 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 3900 6300 m 4800 6300 l 4800 6900 l 3900 6900 l - cp gs col0 s gr [] 0 sd -/Times-Roman ff 240.00 scf sf -4050 6675 m -gs 1 -1 sc (Table) col0 sh gr -% Polyline -n 5700 3000 m 6900 3000 l 6900 3600 l 5700 3600 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -5850 3375 m -gs 1 -1 sc (Wrapper) col0 sh gr -% Polyline -n 900 1200 m 1800 1200 l 1800 1800 l 900 1800 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -1200 1575 m -gs 1 -1 sc (FS) col0 sh gr -% Polyline -n 3600 4200 m 3525 4350 l 3675 4350 l - cp gs col0 s gr -% Polyline -n 1800 5100 m 1800 4800 l 5550 4800 l - 5550 5100 l gs col0 s gr -% Polyline -n 3600 4800 m - 3600 4350 l gs col0 s gr -% Polyline -n 4200 1800 m 4160 1875 l 4200 1950 l 4240 1875 l - cp gs col0 s gr -% Polyline -n 3000 6150 m 2960 6225 l 3000 6300 l 3040 6225 l - cp gs col0 s gr -% Polyline -n 6300 3600 m 6260 3675 l 6300 3750 l 6340 3675 l - cp gs col0 s gr -% Polyline -n 6300 2400 m 6260 2475 l 6300 2550 l 6340 2475 l - cp gs col0 s gr -% Polyline -n 3000 4200 m 2960 4275 l 3000 4350 l 3040 4275 l - cp gs col0 s gr -% Polyline -n 4200 3450 m 4160 3525 l 4200 3600 l 4240 3525 l - cp gs col0 s gr -% Polyline -n 3000 3450 m 2960 3525 l 3000 3600 l 3040 3525 l - cp gs col0 s gr -% Polyline -gs clippath -2235 5370 m 2235 5430 l 2386 5430 l 2266 5400 l 2386 5370 l cp -eoclip -n 3000 6150 m 3000 5400 l - 2250 5400 l gs col0 s gr gr - -% arrowhead -n 2386 5370 m 2266 5400 l 2386 5430 l 2386 5370 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -2715 3930 m 2715 3870 l 2564 3870 l 2684 3900 l 2564 3930 l cp -eoclip -n 3000 4350 m 3000 4500 l 1800 4500 l 1800 3900 l - 2700 3900 l gs col0 s gr gr - -% arrowhead -n 2564 3930 m 2684 3900 l 2564 3870 l 2564 3930 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4485 3870 m 4485 3930 l 4636 3930 l 4516 3900 l 4636 3870 l cp -eoclip -n 6300 3750 m 6300 3900 l - 4500 3900 l gs col0 s gr gr - -% arrowhead -n 4636 3870 m 4516 3900 l 4636 3930 l 4636 3870 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4230 2985 m 4170 2985 l 4170 3136 l 4200 3016 l 4230 3136 l cp -eoclip -n 4200 3450 m - 4200 3000 l gs col0 s gr gr - -% arrowhead -n 4230 3136 m 4200 3016 l 4170 3136 l 4230 3136 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -3030 2985 m 2970 2985 l 2970 3136 l 3000 3016 l 3030 3136 l cp -eoclip -n 3000 3450 m - 3000 3000 l gs col0 s gr gr - -% arrowhead -n 3030 3136 m 3000 3016 l 2970 3136 l 3030 3136 l cp gs 0.00 setgray ef gr col0 s -% Polyline -n 3000 1800 m 2960 1875 l 3000 1950 l 3040 1875 l - cp gs col0 s gr -% Polyline -gs clippath -2970 2415 m 3030 2415 l 3030 2264 l 3000 2384 l 2970 2264 l cp -eoclip -n 3000 1950 m - 3000 2400 l gs col0 s gr gr - -% arrowhead -n 2970 2264 m 3000 2384 l 3030 2264 l 2970 2264 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4170 2415 m 4230 2415 l 4230 2264 l 4200 2384 l 4170 2264 l cp -eoclip -n 4200 1950 m - 4200 2400 l gs col0 s gr gr - -% arrowhead -n 4170 2264 m 4200 2384 l 4230 2264 l 4170 2264 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -6270 3015 m 6330 3015 l 6330 2864 l 6300 2984 l 6270 2864 l cp -eoclip -n 6300 2550 m - 6300 3000 l gs col0 s gr gr - -% arrowhead -n 6270 2864 m 6300 2984 l 6330 2864 l 6270 2864 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -4785 6570 m 4785 6630 l 4936 6630 l 4816 6600 l 4936 6570 l cp -eoclip -n 5100 6600 m - 4800 6600 l gs col0 s gr gr - -% arrowhead -n 4936 6570 m 4816 6600 l 4936 6630 l 4936 6570 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -6285 6570 m 6285 6630 l 6436 6630 l 6316 6600 l 6436 6570 l cp -eoclip -n 6600 6600 m - 6300 6600 l gs col0 s gr gr - -% arrowhead -n 6436 6570 m 6316 6600 l 6436 6630 l 6436 6570 l cp gs 0.00 setgray ef gr col0 s -% Polyline -n 1350 1800 m 1310 1875 l 1350 1950 l 1390 1875 l - cp gs col0 s gr -% Polyline -gs clippath -1320 5115 m 1380 5115 l 1380 4964 l 1350 5084 l 1320 4964 l cp -eoclip -n 1350 1950 m - 1350 5100 l gs col0 s gr gr - -% arrowhead -n 1320 4964 m 1350 5084 l 1380 4964 l 1320 4964 l cp gs 0.00 setgray ef gr col0 s -% Polyline - [60] 0 sd -n 1350 1200 m - 1350 900 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 3600 1200 m - 3600 900 l gs col0 s gr [] 0 sd -$F2psEnd -rs diff --git a/doc/python10/node.svg b/doc/python10/node.svg new file mode 100644 index 0000000..66b6c8a --- /dev/null +++ b/doc/python10/node.svg @@ -0,0 +1,414 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.0747012,0,0,0.0747012,94.8705,241.0275)" + id="g3392" + style="fill:none;stroke-width:0.025in"> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="1200" + id="rect3394" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="3600" + id="rect3396" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="5700" + y="1800" + id="rect3398" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="2100" + y="2400" + id="rect3400" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="3900" + y="2400" + id="rect3402" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="2400" + y="6300" + id="rect3404" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="0" + y="6300" + id="rect3406" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="1200" + y="6300" + id="rect3408" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="1050" + y="5100" + id="rect3410" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="1650,5700 1650,5700 1575,5850 1725,5850 " + id="polygon3412" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3414" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="450,6300 450,6000 2700,6000 2700,6300 " /> + <polyline + id="polyline3416" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1650,6300 1650,5850 " /> + <rect + width="1200" + height="600" + rx="0" + x="5100" + y="6300" + id="rect3418" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <rect + width="900" + height="600" + rx="0" + x="6600" + y="6300" + id="rect3420" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <rect + width="1200" + height="600" + rx="0" + x="4950" + y="5100" + id="rect3422" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <polygon + points="5550,5700 5550,5700 5475,5850 5625,5850 " + id="polygon3424" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3426" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="4350,6300 4350,6000 7050,6000 7050,6300 " /> + <polyline + id="polyline3428" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="5550,5850 5550,6300 " /> + <rect + width="900" + height="600" + rx="0" + x="3900" + y="6300" + id="rect3430" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <rect + width="1200" + height="600" + rx="0" + x="5700" + y="3000" + id="rect3432" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="900" + y="1200" + id="rect3434" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3600,4200 3600,4200 3525,4350 3675,4350 " + id="polygon3436" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3438" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1800,5100 1800,4800 5550,4800 5550,5100 " /> + <polyline + id="polyline3440" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3600,4800 3600,4350 " /> + <polygon + points="4240,1875 4200,1800 4200,1800 4160,1875 4200,1950 " + id="polygon3442" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3040,6225 3000,6150 3000,6150 2960,6225 3000,6300 " + id="polygon3444" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="6340,3675 6300,3600 6300,3600 6260,3675 6300,3750 " + id="polygon3446" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="6340,2475 6300,2400 6300,2400 6260,2475 6300,2550 " + id="polygon3448" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3040,4275 3000,4200 3000,4200 2960,4275 3000,4350 " + id="polygon3450" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="4240,3525 4200,3450 4200,3450 4160,3525 4200,3600 " + id="polygon3452" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3040,3525 3000,3450 3000,3450 2960,3525 3000,3600 " + id="polygon3454" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3456" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3000,6150 3000,5400 2369,5400 " /> + <polygon + points="2371,5370 2371,5370 2251,5400 2371,5430 " + id="polygon3458" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3460" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3000,4350 3000,4500 1800,4500 1800,3900 2580,3900 " /> + <polygon + points="2579,3930 2579,3930 2699,3900 2579,3870 " + id="polygon3462" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3464" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="6300,3750 6300,3900 4619,3900 " /> + <polygon + points="4621,3870 4621,3870 4501,3900 4621,3930 " + id="polygon3466" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3468" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4200,3450 4200,3119 " /> + <polygon + points="4230,3121 4230,3121 4200,3001 4170,3121 " + id="polygon3470" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3472" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3000,3450 3000,3119 " /> + <polygon + points="3030,3121 3030,3121 3000,3001 2970,3121 " + id="polygon3474" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polygon + points="3040,1875 3000,1800 3000,1800 2960,1875 3000,1950 " + id="polygon3476" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3478" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3000,1950 3000,2280 " /> + <polygon + points="2970,2279 2970,2279 3000,2399 3030,2279 " + id="polygon3480" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3482" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4200,1950 4200,2280 " /> + <polygon + points="4170,2279 4170,2279 4200,2399 4230,2279 " + id="polygon3484" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3486" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="6300,2550 6300,2880 " /> + <polygon + points="6270,2879 6270,2879 6300,2999 6330,2879 " + id="polygon3488" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3490" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="5100,6600 4919,6600 " /> + <polygon + points="4921,6570 4921,6570 4801,6600 4921,6630 " + id="polygon3492" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3494" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="6600,6600 6419,6600 " /> + <polygon + points="6421,6570 6421,6570 6301,6600 6421,6630 " + id="polygon3496" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polygon + points="1390,1875 1350,1800 1350,1800 1310,1875 1350,1950 " + id="polygon3498" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3500" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1350,1950 1350,4980 " /> + <polygon + points="1320,4979 1320,4979 1350,5099 1380,4979 " + id="polygon3502" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3504" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="1350,1200 1350,900 " /> + <polyline + id="polyline3506" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="3600,1200 3600,900 " /> + <text + x="2925" + y="1575" + id="text3508" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Environment</text> + <text + x="3375" + y="3975" + id="text3510" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Node</text> + <text + x="5925" + y="2175" + id="text3512" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Walker</text> + <text + x="2325" + y="2775" + id="text3514" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Builder</text> + <text + x="4125" + y="2775" + id="text3516" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Scanner</text> + <text + x="2700" + y="6675" + id="text3518" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Dir</text> + <text + x="150" + y="6675" + id="text3520" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Entry</text> + <text + x="1425" + y="6675" + id="text3522" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">File</text> + <text + x="1200" + y="5475" + id="text3524" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Node.FS</text> + <text + x="5325" + y="6675" + id="text3526" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Record</text> + <text + x="6750" + y="6675" + id="text3528" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Field</text> + <text + x="5100" + y="5475" + id="text3530" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Node.DB</text> + <text + x="4050" + y="6675" + id="text3532" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Table</text> + <text + x="5850" + y="3375" + id="text3534" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Wrapper</text> + <text + x="1200" + y="1575" + id="text3536" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">FS</text> + </g> + </g> +</svg> diff --git a/doc/python10/process.xml b/doc/python10/process.xml index 4ff0ab1..5f8f964 100644 --- a/doc/python10/process.xml +++ b/doc/python10/process.xml @@ -1,3 +1,40 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-process" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Development Process</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + <para> The &SCons; project has paid particular attention from day one to the @@ -351,3 +388,5 @@ </para> </section> + +</section> diff --git a/doc/python10/scanner.eps b/doc/python10/scanner.eps deleted file mode 100644 index 35614f8..0000000 --- a/doc/python10/scanner.eps +++ /dev/null @@ -1,168 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/scanner.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 398 200 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 200 moveto 0 0 lineto 398 0 lineto 398 200 lineto closepath clip newpath --17.3 360.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -% Polyline -7.500 slw -n 2700 5400 m 4500 5400 l 4500 6000 l 2700 6000 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -3000 5775 m -gs 1 -1 sc (ProgScanner) col0 sh gr -% Polyline -n 2700 4200 m 4500 4200 l 4500 4800 l 2700 4800 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -3225 4575 m -gs 1 -1 sc (Scanner) col0 sh gr -% Polyline -n 2700 3000 m 4500 3000 l 4500 3600 l 2700 3600 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -2925 3375 m -gs 1 -1 sc (Environment) col0 sh gr -% Polyline - [60] 0 sd -n 5100 5400 m 6900 5400 l 6900 6000 l 5100 6000 l - cp gs col0 s gr [] 0 sd -/Times-Roman ff 240.00 scf sf -5400 5775 m -gs 1 -1 sc (JavaScanner) col0 sh gr -% Polyline -n 300 5400 m 2100 5400 l 2100 6000 l 300 6000 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -750 5775 m -gs 1 -1 sc (CScanner) col0 sh gr -% Polyline -n 600 3300 m 1500 3300 l 1500 3900 l 600 3900 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -825 3675 m -gs 1 -1 sc (Node) col0 sh gr -% Polyline -n 1200 5400 m 1200 5100 l 6000 5100 l - 6000 5400 l gs col0 s gr -% Polyline -n 3600 4950 m - 3600 5400 l gs col0 s gr -% Polyline -n 3600 4800 m 3525 4950 l 3675 4950 l - cp gs col0 s gr -% Polyline -n 3600 3600 m 3560 3675 l 3600 3750 l 3640 3675 l - cp gs col0 s gr -% Polyline -n 1050 3900 m 1010 3975 l 1050 4050 l 1090 3975 l - cp gs col0 s gr -% Polyline -gs clippath -2715 4530 m 2715 4470 l 2564 4470 l 2684 4500 l 2564 4530 l cp -eoclip -n 1050 4050 m 1050 4500 l - 2700 4500 l gs col0 s gr gr - -% arrowhead -n 2564 4530 m 2684 4500 l 2564 4470 l 2564 4530 l cp gs 0.00 setgray ef gr col0 s -% Polyline -gs clippath -3570 4215 m 3630 4215 l 3630 4064 l 3600 4184 l 3570 4064 l cp -eoclip -n 3600 3750 m - 3600 4200 l gs col0 s gr gr - -% arrowhead -n 3570 4064 m 3600 4184 l 3630 4064 l 3570 4064 l cp gs 0.00 setgray ef gr col0 s -% Polyline - [60] 0 sd -n 3600 3000 m - 3600 2700 l gs col0 s gr [] 0 sd -$F2psEnd -rs diff --git a/doc/python10/scanner.svg b/doc/python10/scanner.svg new file mode 100644 index 0000000..6fcb0e3 --- /dev/null +++ b/doc/python10/scanner.svg @@ -0,0 +1,160 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.07472826,0,0,0.07472826,105.97826,207.29425)" + id="g3657" + style="fill:none;stroke-width:0.025in"> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="5400" + id="rect3659" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="4200" + id="rect3661" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="2700" + y="3000" + id="rect3663" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1800" + height="600" + rx="0" + x="5100" + y="5400" + id="rect3665" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" /> + <rect + width="1800" + height="600" + rx="0" + x="300" + y="5400" + id="rect3667" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="900" + height="600" + rx="0" + x="600" + y="3300" + id="rect3669" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3671" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1200,5400 1200,5100 6000,5100 6000,5400 " /> + <polyline + id="polyline3673" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3600,4950 3600,5400 " /> + <polygon + points="3600,4800 3600,4800 3525,4950 3675,4950 " + id="polygon3675" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="3640,3675 3600,3600 3600,3600 3560,3675 3600,3750 " + id="polygon3677" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="1090,3975 1050,3900 1050,3900 1010,3975 1050,4050 " + id="polygon3679" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3681" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="1050,4050 1050,4500 2580,4500 " /> + <polygon + points="2579,4530 2579,4530 2699,4500 2579,4470 " + id="polygon3683" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3685" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3600,3750 3600,4080 " /> + <polygon + points="3570,4079 3570,4079 3600,4199 3630,4079 " + id="polygon3687" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3689" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="3600,3000 3600,2700 " /> + <text + x="3000" + y="5775" + id="text3691" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">ProgScanner</text> + <text + x="3225" + y="4575" + id="text3693" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Scanner</text> + <text + x="2925" + y="3375" + id="text3695" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Environment</text> + <text + x="5400" + y="5775" + id="text3697" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">JavaScanner</text> + <text + x="750" + y="5775" + id="text3699" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">CScanner</text> + <text + x="825" + y="3675" + id="text3701" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Node</text> + </g> + </g> +</svg> diff --git a/doc/python10/scons.mod b/doc/python10/scons.mod deleted file mode 100644 index c1bd439..0000000 --- a/doc/python10/scons.mod +++ /dev/null @@ -1,428 +0,0 @@ -<!-- - - Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The SCons Foundation - - An SCons-specific DTD module, for use with SCons DocBook - documentation, that contains names, phrases, acronyms, etc. used - throughout the SCons documentation. - ---> - - - -<!-- - - Other applications that we reference. - ---> - -<!ENTITY Aegis "<application>Aegis</application>"> -<!ENTITY Ant "<application>Ant</application>"> -<!ENTITY Autoconf "<application>Autoconf</application>"> -<!ENTITY Automake "<application>Automake</application>"> -<!ENTITY cc "<application>cc</application>"> -<!ENTITY Cons "<application>Cons</application>"> -<!ENTITY cp "<application>cp</application>"> -<!ENTITY csh "<application>csh</application>"> -<!ENTITY gcc "<application>gcc</application>"> -<!ENTITY Jam "<application>Jam</application>"> -<!ENTITY jar "<application>jar</application>"> -<!ENTITY javac "<application>javac</application>"> -<!ENTITY javah "<application>javah</application>"> -<!ENTITY Make "<application>Make</application>"> -<!ENTITY Makepp "<application>Make++</application>"> -<!ENTITY Python "<application>Python</application>"> -<!ENTITY ranlib "<application>ranlib</application>"> -<!ENTITY rmic "<application>rmic</application>"> -<!ENTITY SCons "<application>SCons</application>"> -<!ENTITY scons "<application>scons</application>"> -<!ENTITY ScCons "<application>ScCons</application>"> -<!ENTITY tar "<application>tar</application>"> -<!ENTITY touch "<application>touch</application>"> -<!ENTITY zip "<application>zip</application>"> - - -<!-- - - Classes. - ---> - -<!ENTITY Action "<classname>Action</classname>"> -<!ENTITY ActionBase "<classname>ActionBase</classname>"> -<!ENTITY CommandAction "<classname>CommandAction</classname>"> -<!ENTITY FunctionAction "<classname>FunctionAction</classname>"> -<!ENTITY ListAction "<classname>ListAction</classname>"> -<!ENTITY Builder "<classname>Builder</classname>"> -<!ENTITY BuilderBase "<classname>BuilderBase</classname>"> -<!ENTITY CompositeBuilder "<classname>CompositeBuilder</classname>"> -<!ENTITY MultiStepBuilder "<classname>MultiStepBuilder</classname>"> -<!ENTITY Job "<classname>Job</classname>"> -<!ENTITY Jobs "<classname>Jobs</classname>"> -<!ENTITY Serial "<classname>Serial</classname>"> -<!ENTITY Parallel "<classname>Parallel</classname>"> -<!ENTITY Node "<classname>Node</classname>"> -<!ENTITY Node_FS "<classname>Node.FS</classname>"> -<!ENTITY Scanner "<classname>Scanner</classname>"> -<!ENTITY Sig "<classname>Sig</classname>"> -<!ENTITY Signature "<classname>Signature</classname>"> -<!ENTITY Taskmaster "<classname>Taskmaster</classname>"> -<!ENTITY TimeStamp "<classname>TimeStamp</classname>"> -<!ENTITY Walker "<classname>Walker</classname>"> -<!ENTITY Wrapper "<classname>Wrapper</classname>"> - - - -<!-- - - Options, command-line. - ---> - -<!ENTITY debug-explain "<literal>--debug=explain</literal>"> -<!ENTITY implicit-cache "<literal>--implicit-cache</literal>"> -<!ENTITY implicit-deps-changed "<literal>--implicit-deps-changed</literal>"> -<!ENTITY implicit-deps-unchanged "<literal>--implicit-deps-unchanged</literal>"> -<!ENTITY Q "<literal>-Q</literal>"> - -<!-- - - Options, SConscript-settable. - ---> - -<!ENTITY implicit_cache "<literal>implicit_cache</literal>"> -<!ENTITY implicit_deps_changed "<literal>implicit_deps_changed</literal>"> -<!ENTITY implicit_deps_unchanged "<literal>implicit_deps_unchanged</literal>"> - - - -<!-- - - File and directory names. - ---> - -<!ENTITY build "<filename>build</filename>"> -<!ENTITY Makefile "<filename>Makefile</filename>"> -<!ENTITY Makefiles "<filename>Makefiles</filename>"> -<!ENTITY SConscript "<filename>SConscript</filename>"> -<!ENTITY SConstruct "<filename>SConstruct</filename>"> -<!ENTITY Sconstruct "<filename>Sconstruct</filename>"> -<!ENTITY sconstruct "<filename>sconstruct</filename>"> -<!ENTITY sconsign "<filename>.sconsign</filename>"> -<!ENTITY src "<filename>src</filename>"> - - - -<!-- - - Methods and functions. This includes functions from both - the Build Engine and the Native Python Interface. - ---> - -<!ENTITY Add "<function>Add</function>"> -<!ENTITY AddOptions "<function>AddOptions</function>"> -<!ENTITY Alias "<function>Alias</function>"> -<!ENTITY Aliases "<function>Aliases</function>"> -<!ENTITY Append "<function>Append</function>"> -<!ENTITY BoolOption "<function>BoolOption</function>"> -<!ENTITY Build "<function>Build</function>"> -<!ENTITY CacheDir "<function>CacheDir</function>"> -<!ENTITY Clean "<function>Clean</function>"> -<!ENTITY Clone "<function>Clone</function>"> -<!ENTITY Command "<function>Command</function>"> -<!ENTITY Configure "<function>Configure</function>"> -<!ENTITY Copy "<function>Copy</function>"> -<!ENTITY Default "<function>Default</function>"> -<!ENTITY DefaultRules "<function>DefaultRules</function>"> -<!ENTITY Depends "<function>Depends</function>"> -<!ENTITY Dir "<function>Dir</function>"> -<!ENTITY Entry "<function>Entry</function>"> -<!ENTITY EnumOption "<function>EnumOption</function>"> -<!ENTITY Environment "<function>Environment</function>"> -<!ENTITY Export "<function>Export</function>"> -<!ENTITY File "<function>File</function>"> -<!ENTITY Finish "<function>Finish</function>"> -<!ENTITY GenerateHelpText "<function>GenerateHelpText</function>"> -<!ENTITY Help "<function>Help</function>"> -<!ENTITY Ignore "<function>Ignore</function>"> -<!ENTITY Import "<function>Import</function>"> -<!ENTITY Install "<function>Install</function>"> -<!ENTITY InstallAs "<function>InstallAs</function>"> -<!ENTITY Link "<function>Link</function>"> -<!ENTITY ListOption "<function>ListOption</function>"> -<!ENTITY Local "<function>Local</function>"> -<!ENTITY Module "<function>Module</function>"> -<!ENTITY Objects "<function>Objects</function>"> -<!ENTITY Options "<function>Options</function>"> -<!ENTITY PackageOption "<function>PackageOption</function>"> -<!ENTITY PathOption "<function>PathOption</function>"> -<!ENTITY Precious "<function>Precious</function>"> -<!ENTITY Prepend "<function>Prepend</function>"> -<!ENTITY Replace "<function>Replace</function>"> -<!ENTITY Repository "<function>Repository</function>"> -<!ENTITY Return "<function>Return</function>"> -<!ENTITY RuleSet "<function>RuleSet</function>"> -<!ENTITY Salt "<function>Salt</function>"> -<!ENTITY SetBuildSignatureType "<function>SetBuildSignatureType</function>"> -<!ENTITY SetContentSignatureType "<function>SetContentSignatureType</function>"> -<!ENTITY SourceSignature "<function>SourceSignature</function>"> -<!ENTITY SourceSignatures "<function>SourceSignatures</function>"> -<!ENTITY Split "<function>Split</function>"> -<!ENTITY TargetSignatures "<function>TargetSignatures</function>"> -<!ENTITY Task "<function>Task</function>"> - -<!-- Environment methods --> -<!ENTITY subst "<function>subst</function>"> - -<!-- Configure context functions --> -<!ENTITY Message "<function>Message</function>"> -<!ENTITY Result "<function>Result</function>"> -<!ENTITY CheckCHeader "<function>CheckCHeader</function>"> -<!ENTITY CheckCXXHeader "<function>CheckCXXHeader</function>"> -<!ENTITY CheckFunc "<function>CheckFunc</function>"> -<!ENTITY CheckHeader "<function>CheckHeader</function>"> -<!ENTITY CheckLib "<function>CheckLib</function>"> -<!ENTITY CheckLibWithHeader "<function>CheckLibWithHeader</function>"> -<!ENTITY CheckType "<function>CheckType</function>"> -<!ENTITY TryAction "<function>TryAction</function>"> -<!ENTITY TryBuild "<function>TryBuild</function>"> -<!ENTITY TryCompile "<function>TryCompile</function>"> -<!ENTITY TryLink "<function>TryLink</function>"> -<!ENTITY TryRun "<function>TryRun</function>"> - -<!-- Python functions --> -<!ENTITY str "<function>str</function>"> -<!ENTITY zipfile "<function>zipfile</function>"> - -<!-- Obsolete, but referenced in old documents. --> -<!ENTITY Cache "<function>Cache</function>"> - - - -<!-- - - Global variables. - ---> - -<!ENTITY ARGUMENTS "<varname>ARGUMENTS</varname>"> -<!ENTITY BUILD_TARGETS "<varname>BUILD_TARGETS</varname>"> -<!ENTITY COMMAND_LINE_TARGETS "<varname>COMMAND_LINE_TARGETS</varname>"> -<!ENTITY DEFAULT_TARGETS "<varname>DEFAULT_TARGETS</varname>"> - - - -<!-- - - Construction variables. - ---> - -<!ENTITY BUILDERMAP "<varname>BUILDERMAP</varname>"> -<!ENTITY BUILDERS "<varname>BUILDERS</varname>"> -<!ENTITY CC "<varname>CC</varname>"> -<!ENTITY CCFLAGS "<varname>CCFLAGS</varname>"> -<!ENTITY CCCOM "<varname>CCCOM</varname>"> -<!ENTITY COLOR "<varname>COLOR</varname>"> -<!ENTITY COLORS "<varname>COLORS</varname>"> -<!ENTITY CONFIG "<varname>CONFIG</varname>"> -<!ENTITY CPPDEFINES "<varname>CPPDEFINES</varname>"> -<!ENTITY ENV "<varname>ENV</varname>"> -<!ENTITY JAVACLASSDIR "<varname>JAVACLASSDIR</varname>"> -<!ENTITY LIBDIRPREFIX "<varname>LIBDIRPREFIX</varname>"> -<!ENTITY LIBDIRSUFFIX "<varname>LIBDIRSUFFIX</varname>"> -<!ENTITY LIBLINKPREFIX "<varname>LIBLINKPREFIX</varname>"> -<!ENTITY LIBLINKSUFFIX "<varname>LIBLINKSUFFIX</varname>"> -<!ENTITY LIBPATH "<varname>LIBPATH</varname>"> -<!ENTITY LIBS "<varname>LIBS</varname>"> -<!ENTITY LINK "<varname>LINK</varname>"> -<!ENTITY LINKCOM "<varname>LINKCOM</varname>"> -<!ENTITY LINKFLAGS "<varname>LINKFLAGS</varname>"> -<!ENTITY RELEASE "<varname>RELEASE</varname>"> -<!ENTITY RELEASE_BUILD "<varname>RELEASE_BUILD</varname>"> -<!ENTITY SCANNERMAP "<varname>SCANNERMAP</varname>"> -<!ENTITY SCANNERS "<varname>SCANNERS</varname>"> -<!ENTITY TARFLAGS "<varname>TARFLAGS</varname>"> -<!ENTITY TARSUFFIX "<varname>TARSUFFIX</varname>"> - - - -<!-- - - Environment variables. - ---> - -<!ENTITY PATH "<varname>PATH</varname>"> -<!ENTITY PYTHONPATH "<varname>PYTHONPATH</varname>"> -<!ENTITY SCONSFLAGS "<varname>SCONSFLAGS</varname>"> - - - -<!-- - - Function and method arguments. - ---> - -<!ENTITY allowed_values "<varname>allowed_values</varname>"> -<!ENTITY build_dir "<varname>build_dir</varname>"> -<!ENTITY map "<varname>map</varname>"> -<!ENTITY ignorecase "<varname>ignorecase</varname>"> -<!ENTITY options "<varname>options</varname>"> -<!ENTITY exports "<varname>exports</varname>"> -<!ENTITY source "<varname>source</varname>"> -<!ENTITY target "<varname>target</varname>"> - - - -<!-- - - Values of function and method arguments. - ---> - -<!ENTITY all "<literal>all</literal>"> -<!ENTITY none "<literal>none</literal>"> - - - -<!-- - - Builder and Scanner objects. - ---> - -<!ENTITY BuildDir "<function>BuildDir</function>"> -<!ENTITY CFile "<function>CFile</function>"> -<!ENTITY CXXFile "<function>CXXFile</function>"> -<!ENTITY DVI "<function>DVI</function>"> -<!ENTITY Jar "<function>Jar</function>"> -<!ENTITY Java "<function>Java</function>"> -<!ENTITY JavaH "<function>JavaH</function>"> -<!ENTITY Library "<function>Library</function>"> -<!ENTITY Object "<function>Object</function>"> -<!ENTITY PCH "<function>PCH</function>"> -<!ENTITY PDF "<function>PDF</function>"> -<!ENTITY PostScript "<function>PostScript</function>"> -<!ENTITY Program "<function>Program</function>"> -<!ENTITY RES "<function>RES</function>"> -<!ENTITY RMIC "<function>RMIC</function>"> -<!ENTITY SharedLibrary "<function>SharedLibrary</function>"> -<!ENTITY SharedObject "<function>SharedObject</function>"> -<!ENTITY StaticLibrary "<function>StaticLibrary</function>"> -<!ENTITY StaticObject "<function>StaticObject</function>"> -<!ENTITY Tar "<function>Tar</function>"> -<!ENTITY Zip "<function>Zip</function>"> - -<!-- Obsolete, but referenced in old documents. --> -<!ENTITY MakeBuilder "<function>Make</function>"> - - - -<!-- - - Terms. Define both singular and plural forms in various - case-sensitive combinations for use in titles, in-line, etc. - ---> - -<!ENTITY buildfunc "<literal>builder function</literal>"> -<!ENTITY builder_method "<literal>builder method</literal>"> - -<!ENTITY Configure_Contexts "<literal>Configure Contexts</literal>"> -<!ENTITY configure_context "<literal>configure context</literal>"> - -<!ENTITY ConsEnv "<literal>Construction Environment</literal>"> -<!ENTITY ConsEnvs "<literal>Construction Environments</literal>"> -<!ENTITY Consenv "<literal>Construction environment</literal>"> -<!ENTITY Consenvs "<literal>Construction environments</literal>"> -<!ENTITY consenv "<literal>construction environment</literal>"> -<!ENTITY consenvs "<literal>construction environments</literal>"> - -<!ENTITY ConsVar "<literal>Construction Variable</literal>"> -<!ENTITY ConsVars "<literal>Construction Variables</literal>"> -<!ENTITY Consvar "<literal>Construction variable</literal>"> -<!ENTITY Consvars "<literal>Construction variables</literal>"> -<!ENTITY consvar "<literal>construction variable</literal>"> -<!ENTITY consvars "<literal>construction variables</literal>"> - -<!ENTITY CPPPATH "<literal>CPPPATH</literal>"> - -<!ENTITY Dictionary "<literal>Dictionary</literal>"> - -<!ENTITY Emitter "<literal>Emitter</literal>"> -<!ENTITY emitter "<literal>emitter</literal>"> -<!ENTITY Generator "<literal>Generator</literal>"> -<!ENTITY generator "<literal>generator</literal>"> - -<!ENTITY Nodes "<literal>Nodes</literal>"> - -<!ENTITY signature "<literal>signature</literal>"> -<!ENTITY buildsignature "<literal>build signature</literal>"> - -<!ENTITY true "<literal>true</literal>"> -<!ENTITY false "<literal>false</literal>"> - -<!ENTITY typedef "<literal>typedef</literal>"> - -<!-- - - File and program names used in examples. - ---> - -<!ENTITY bar "<application>bar</application>"> -<!ENTITY common1_c "<filename>common1.c</filename>"> -<!ENTITY common2_c "<filename>common2.c</filename>"> -<!ENTITY custom_py "<filename>custom.py</filename>"> -<!ENTITY goodbye "<application>goodbye</application>"> -<!ENTITY goodbye_o "<filename>goodbye.o</filename>"> -<!ENTITY goodbye_obj "<filename>goodbye.obj</filename>"> -<!ENTITY file_dll "<filename>file.dll</filename>"> -<!ENTITY file_in "<filename>file.in</filename>"> -<!ENTITY file_lib "<filename>file.lib</filename>"> -<!ENTITY file_o "<filename>file.o</filename>"> -<!ENTITY file_obj "<filename>file.obj</filename>"> -<!ENTITY file_out "<filename>file.out</filename>"> -<!ENTITY foo "<application>foo</application>"> -<!ENTITY foo_o "<filename>foo.o</filename>"> -<!ENTITY foo_obj "<filename>foo.obj</filename>"> -<!ENTITY hello "<application>hello</application>"> -<!ENTITY hello_c "<filename>hello.c</filename>"> -<!ENTITY hello_exe "<filename>hello.exe</filename>"> -<!ENTITY hello_h "<filename>hello.h</filename>"> -<!ENTITY hello_o "<filename>hello.o</filename>"> -<!ENTITY hello_obj "<filename>hello.obj</filename>"> -<!ENTITY libfile_a "<filename>libfile_a</filename>"> -<!ENTITY libfile_so "<filename>libfile_so</filename>"> -<!ENTITY new_hello "<application>new_hello</application>"> -<!ENTITY new_hello_exe "<application>new_hello.exe</application>"> -<!ENTITY prog "<filename>prog</filename>"> -<!ENTITY prog1 "<filename>prog1</filename>"> -<!ENTITY prog2 "<filename>prog2</filename>"> -<!ENTITY prog_c "<filename>prog.c</filename>"> -<!ENTITY prog_exe "<filename>prog.exe</filename>"> -<!ENTITY stdio_h "<filename>stdio.h</filename>"> - -<!-- - - Punctuation. - ---> - -<!ENTITY plus "<literal>+</literal>"> -<!ENTITY hash "<literal>#</literal>"> - -<!-- - - Mailing lists - ---> - -<!ENTITY scons-announce "<literal>announce@scons.tigris.org</literal>"> -<!ENTITY scons-devel "<literal>dev@scons.tigris.org</literal>"> -<!ENTITY scons-users "<literal>users@scons.tigris.org</literal>"> diff --git a/doc/python10/sig.eps b/doc/python10/sig.eps deleted file mode 100644 index 26aabaa..0000000 --- a/doc/python10/sig.eps +++ /dev/null @@ -1,147 +0,0 @@ -%!PS-Adobe-2.0 EPSF-2.0 -%%Title: build/doc/python10/sig.fig -%%Creator: /usr/bin/fig2dev Version 3.2 Patchlevel 3d -%%CreationDate: Sun Jan 2 01:21:05 2005 -%%For: knight@casablanca.home.baldmt.com (Steven Knight) -%%BoundingBox: 0 0 308 128 -%%Magnification: 1.0000 -%%EndComments -/$F2psDict 200 dict def -$F2psDict begin -$F2psDict /mtrx matrix put -/col-1 {0 setgray} bind def -/col0 {0.000 0.000 0.000 srgb} bind def -/col1 {0.000 0.000 1.000 srgb} bind def -/col2 {0.000 1.000 0.000 srgb} bind def -/col3 {0.000 1.000 1.000 srgb} bind def -/col4 {1.000 0.000 0.000 srgb} bind def -/col5 {1.000 0.000 1.000 srgb} bind def -/col6 {1.000 1.000 0.000 srgb} bind def -/col7 {1.000 1.000 1.000 srgb} bind def -/col8 {0.000 0.000 0.560 srgb} bind def -/col9 {0.000 0.000 0.690 srgb} bind def -/col10 {0.000 0.000 0.820 srgb} bind def -/col11 {0.530 0.810 1.000 srgb} bind def -/col12 {0.000 0.560 0.000 srgb} bind def -/col13 {0.000 0.690 0.000 srgb} bind def -/col14 {0.000 0.820 0.000 srgb} bind def -/col15 {0.000 0.560 0.560 srgb} bind def -/col16 {0.000 0.690 0.690 srgb} bind def -/col17 {0.000 0.820 0.820 srgb} bind def -/col18 {0.560 0.000 0.000 srgb} bind def -/col19 {0.690 0.000 0.000 srgb} bind def -/col20 {0.820 0.000 0.000 srgb} bind def -/col21 {0.560 0.000 0.560 srgb} bind def -/col22 {0.690 0.000 0.690 srgb} bind def -/col23 {0.820 0.000 0.820 srgb} bind def -/col24 {0.500 0.190 0.000 srgb} bind def -/col25 {0.630 0.250 0.000 srgb} bind def -/col26 {0.750 0.380 0.000 srgb} bind def -/col27 {1.000 0.500 0.500 srgb} bind def -/col28 {1.000 0.630 0.630 srgb} bind def -/col29 {1.000 0.750 0.750 srgb} bind def -/col30 {1.000 0.880 0.880 srgb} bind def -/col31 {1.000 0.840 0.000 srgb} bind def - -end -save -newpath 0 128 moveto 0 0 lineto 308 0 lineto 308 128 lineto closepath clip newpath --71.3 288.7 translate -1 -1 scale - -/cp {closepath} bind def -/ef {eofill} bind def -/gr {grestore} bind def -/gs {gsave} bind def -/sa {save} bind def -/rs {restore} bind def -/l {lineto} bind def -/m {moveto} bind def -/rm {rmoveto} bind def -/n {newpath} bind def -/s {stroke} bind def -/sh {show} bind def -/slc {setlinecap} bind def -/slj {setlinejoin} bind def -/slw {setlinewidth} bind def -/srgb {setrgbcolor} bind def -/rot {rotate} bind def -/sc {scale} bind def -/sd {setdash} bind def -/ff {findfont} bind def -/sf {setfont} bind def -/scf {scalefont} bind def -/sw {stringwidth} bind def -/tr {translate} bind def -/tnt {dup dup currentrgbcolor - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add - 4 -2 roll dup 1 exch sub 3 -1 roll mul add srgb} - bind def -/shd {dup dup currentrgbcolor 4 -2 roll mul 4 -2 roll mul - 4 -2 roll mul srgb} bind def -/$F2psBegin {$F2psDict begin /$F2psEnteredState save def} def -/$F2psEnd {$F2psEnteredState restore end} def - -$F2psBegin -10 setmiterlimit - 0.06000 0.06000 sc -% -% Fig objects follow -% -% Polyline -7.500 slw -n 1200 3000 m 2700 3000 l 2700 3600 l 1200 3600 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -1950 3375 m -gs 1 -1 sc (Taskmaster) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 3300 4200 m 4500 4200 l 4500 4800 l 3300 4800 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -3900 4575 m -gs 1 -1 sc (MD5) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 5100 4200 m 6300 4200 l 6300 4800 l 5100 4800 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -5700 4575 m -gs 1 -1 sc (TStamp) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 4200 3000 m 5400 3000 l 5400 3600 l 4200 3600 l - cp gs col0 s gr -/Times-Roman ff 240.00 scf sf -4800 3375 m -gs 1 -1 sc (Sig) dup sw pop 2 div neg 0 rm col0 sh gr -% Polyline -n 2700 3300 m 2775 3340 l 2850 3300 l 2775 3260 l - cp gs col0 s gr -% Polyline -n 4800 3600 m 4725 3750 l 4875 3750 l - cp gs col0 s gr -% Polyline -n 3900 4200 m 3900 3900 l 5700 3900 l - 5700 4200 l gs col0 s gr -% Polyline -n 4800 3750 m - 4800 3900 l gs col0 s gr -% Polyline -gs clippath -4215 3330 m 4215 3270 l 4064 3270 l 4184 3300 l 4064 3330 l cp -eoclip -n 2850 3300 m - 4200 3300 l gs col0 s gr gr - -% arrowhead -n 4064 3330 m 4184 3300 l 4064 3270 l 4064 3330 l cp gs 0.00 setgray ef gr col0 s -% Polyline - [60] 0 sd -n 1950 3000 m - 1950 2700 l gs col0 s gr [] 0 sd -% Polyline - [60] 0 sd -n 4800 3000 m - 4800 2700 l gs col0 s gr [] 0 sd -$F2psEnd -rs diff --git a/doc/python10/sig.svg b/doc/python10/sig.svg new file mode 100644 index 0000000..09e2719 --- /dev/null +++ b/doc/python10/sig.svg @@ -0,0 +1,124 @@ +<?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="744.09448" + height="1052.3622" + id="svg2"> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <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> + <g + id="layer1"> + <g + transform="matrix(0.07552694,0,0,0.07552694,91.773975,249.13616)" + id="g3772" + style="fill:none;stroke-width:0.025in"> + <rect + width="1500" + height="600" + rx="0" + x="1200" + y="3000" + id="rect3774" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="3300" + y="4200" + id="rect3776" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="5100" + y="4200" + id="rect3778" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <rect + width="1200" + height="600" + rx="0" + x="4200" + y="3000" + id="rect3780" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="2775,3260 2700,3300 2700,3300 2775,3340 2850,3300 " + id="polygon3782" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polygon + points="4800,3600 4800,3600 4725,3750 4875,3750 " + id="polygon3784" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" /> + <polyline + id="polyline3786" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="3900,4200 3900,3900 5700,3900 5700,4200 " /> + <polyline + id="polyline3788" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="4800,3750 4800,3900 " /> + <polyline + id="polyline3790" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter" + points="2850,3300 4080,3300 " /> + <polygon + points="4079,3330 4079,3330 4199,3300 4079,3270 " + id="polygon3792" + style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8" /> + <polyline + id="polyline3794" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="1950,3000 1950,2700 " /> + <polyline + id="polyline3796" + style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:40, 40" + points="4800,3000 4800,2700 " /> + <text + x="1950" + y="3375" + id="text3798" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Taskmaster</text> + <text + x="3900" + y="4575" + id="text3800" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">MD5</text> + <text + x="5700" + y="4575" + id="text3802" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">TStamp</text> + <text + x="4800" + y="3375" + id="text3804" + xml:space="preserve" + style="font-size:192px;font-style:normal;font-weight:normal;text-anchor:middle;fill:#000000;font-family:Times">Sig</text> + </g> + </g> +</svg> diff --git a/doc/python10/summary.xml b/doc/python10/summary.xml new file mode 100644 index 0000000..1b09f97 --- /dev/null +++ b/doc/python10/summary.xml @@ -0,0 +1,52 @@ +<?xml version='1.0'?> +<!DOCTYPE sconsdoc [ + <!ENTITY % scons SYSTEM "../scons.mod"> + %scons; +]> + +<section id="sect-summary" + xmlns="http://www.scons.org/dbxsd/v1.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd"> +<title>Summary</title> + +<!-- + + Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY + KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE + WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +--> + + <para> + + This paper has introduced &SCons;, a next-generation build tool + with a modular, embeddable architecture and a direct Python + interface. &SCons; has a global view of the dependencies in a source + tree, uses MD5 signatures to decide if derived files are out of date, + and automatically scans files for dependencies, all of which make &SCons; + builds exceptionally reliable. The &SCons; development methodology has + been described, notable for its emphasis on automated regression + testing to ensure a robust and reliable tool from day one. Several + future directions for &SCons; have also been discussed. + + </para> + +</section> |