From 140d836e9cd54fb67b969fd82ef7ed19ba574d40 Mon Sep 17 00:00:00 2001 From: Luca Falavigna Date: Sat, 26 Apr 2014 15:11:58 +0200 Subject: Imported Upstream version 2.3.1 --- doc/python10/MANIFEST | 12 +- doc/python10/SConstruct | 46 +++++ doc/python10/abstract.xml | 37 ++++ doc/python10/acks.xml | 39 +++++ doc/python10/arch.eps | 134 -------------- doc/python10/arch.svg | 124 +++++++++++++ doc/python10/builder.eps | 325 ---------------------------------- doc/python10/builder.svg | 330 ++++++++++++++++++++++++++++++++++ doc/python10/copyright.xml | 14 +- doc/python10/design.xml | 143 +++++++++------ doc/python10/future.xml | 39 +++++ doc/python10/install.xml | 39 +++++ doc/python10/intro.xml | 39 +++++ doc/python10/job-task.eps | 238 ------------------------- doc/python10/job-task.svg | 244 ++++++++++++++++++++++++++ doc/python10/main.xml | 85 +++------ doc/python10/node.eps | 351 ------------------------------------- doc/python10/node.svg | 414 +++++++++++++++++++++++++++++++++++++++++++ doc/python10/process.xml | 39 +++++ doc/python10/scanner.eps | 168 ------------------ doc/python10/scanner.svg | 160 +++++++++++++++++ doc/python10/scons.mod | 428 --------------------------------------------- doc/python10/sig.eps | 147 ---------------- doc/python10/sig.svg | 124 +++++++++++++ doc/python10/summary.xml | 52 ++++++ 25 files changed, 1850 insertions(+), 1921 deletions(-) create mode 100644 doc/python10/SConstruct delete mode 100644 doc/python10/arch.eps create mode 100644 doc/python10/arch.svg delete mode 100644 doc/python10/builder.eps create mode 100644 doc/python10/builder.svg delete mode 100644 doc/python10/job-task.eps create mode 100644 doc/python10/job-task.svg delete mode 100644 doc/python10/node.eps create mode 100644 doc/python10/node.svg delete mode 100644 doc/python10/scanner.eps create mode 100644 doc/python10/scanner.svg delete mode 100644 doc/python10/scons.mod delete mode 100644 doc/python10/sig.eps create mode 100644 doc/python10/sig.svg create mode 100644 doc/python10/summary.xml (limited to 'doc/python10') 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 @@ + + + %scons; +]> + + + + + &SCons; is a software construction tool (build tool, or make tool) @@ -30,3 +65,5 @@ and discusses future plans and directions for the tool. + + 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 @@ + + + %scons; +]> + +
+Acknowledgements + + + 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. + +
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 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + scons + Script + Build Engine + SCons + SCons + API + other + interface + + + 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 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Environment + BuilderWrapper + BuilderBase + ActionBase + MultiStep- + Builder + Composite- + Builder + Command + Action + Action + Function + List + Action + Node + + + 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 @@ + + + %scons; +]> + + + + The &SCons; architecture consists of three layers: +
+&SCons; architecture - - - - + - +
@@ -164,19 +199,17 @@ +
+ Node subsystem - - - - + - +
@@ -228,19 +261,17 @@ +
+ Scanner subsystem - - - - + - +
@@ -270,19 +301,17 @@ +
+ Signature subsystem - + - + - +
@@ -326,19 +355,17 @@ +
+ Builder subsystem - - - - + - +
@@ -389,19 +416,17 @@ +
+ Job/Task subsystem - + - + - +
@@ -531,8 +556,8 @@ - env = Environment() - env_debug = Environment(CCFLAGS = '-g') +env = Environment() +env_debug = Environment(CCFLAGS = '-g') @@ -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 CCFLAGS, LIBPATH) to influence the specific build execution. @@ -559,7 +584,7 @@ - bld = Builder(name = 'Program', action = "$CC -o $TARGET $SOURCES") +bld = Builder(name = 'Program', action = "$CC -o $TARGET $SOURCES") @@ -608,8 +633,8 @@ - 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') @@ -629,13 +654,13 @@ &Builder; objects are associated with a &consenv; through a - &consvar; named &BUILDERS;, a list of the &Builder; objects that + &consvar; named BUILDERS, a list of the &Builder; objects that will be available for execution through the &consenv;: - env = Environment(BUILDERS = [ Object, Library, WebPage, Program ]) +env = Environment(BUILDERS = [ Object, Library, WebPage, Program ]) @@ -678,13 +703,13 @@ &Scanner; objects are associated with a &consenv; through a - &consvar; named &SCANNERS;, a list of the &Scanner; objects that + &consvar; named SCANNERS, a list of the &Scanner; objects that will be available through the &consenv;: - env = Environment(SCANNERS = [ CScan, M4Scan ]) +env = Environment(SCANNERS = [ CScan, M4Scan ]) @@ -720,7 +745,7 @@ - BuildDir(source = 'src', build = 'bld') +BuildDir(source = 'src', build = 'bld') @@ -738,7 +763,7 @@ - BuildDir(source = 'src', build = 'bld', no_sources = 1) +BuildDir(source = 'src', build = 'bld', no_sources = 1) @@ -759,7 +784,7 @@ - Repository('/home/source/1.1', '/home/source/1.0') +Repository('/home/source/1.1', '/home/source/1.0') @@ -785,7 +810,7 @@ - Cache('/var/build.cache/i386') +Cache('/var/build.cache/i386') @@ -855,7 +880,7 @@ - source_files = 'f1.c f2.c f3.c' +source_files = 'f1.c f2.c f3.c' @@ -867,7 +892,7 @@ - SConscript('src/SConscript', 'lib/SConscript') +SConscript('src/SConscript', 'lib/SConscript') @@ -896,3 +921,5 @@ + + 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 @@ + + + %scons; +]> + +
+Future Directions + + + There are a number of things we would like to do to continue to @@ -168,3 +205,5 @@
+ + 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 @@ + + + %scons; +]> + +
+Installation + + + Initial installation of a new utility provides the first, lasting @@ -177,3 +214,5 @@
+ + 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 @@ + + + %scons; +]> + +
+Introduction + + + More than twenty years after its creation, the classic UNIX &Make; @@ -210,3 +247,5 @@
+ + 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 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Task + Node + Sig + Walker + TaskMaster + Parallel + Serial + Jobs + + + 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 @@ + + %scons; + +]> + +
+ - - - %scons; - - - - - - - - - - -]> - -
+ SCons Design and Implementation @@ -81,56 +73,21 @@ - - &abstract; - + -
- Introduction - &intro; -
+ -
- Architecture - &design; -
+ -
- Installation - &install; -
+ -
- Development Process - &process; -
+ -
- Future Directions - &future; -
+ -
- Summary - + - 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. - - -
- -
- Acknowledgements - &acks; -
+ + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Environment + Node + Walker + Builder + Scanner + Dir + Entry + File + Node.FS + Record + Field + Node.DB + Table + Wrapper + FS + + + 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 @@ + + + %scons; +]> + +
+Development Process + + + The &SCons; project has paid particular attention from day one to the @@ -351,3 +388,5 @@
+ + 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 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + ProgScanner + Scanner + Environment + JavaScanner + CScanner + Node + + + 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 @@ - - - - - - -Aegis"> -Ant"> -Autoconf"> -Automake"> -cc"> -Cons"> -cp"> -csh"> -gcc"> -Jam"> -jar"> -javac"> -javah"> -Make"> -Make++"> -Python"> -ranlib"> -rmic"> -SCons"> -scons"> -ScCons"> -tar"> -touch"> -zip"> - - - - -Action"> -ActionBase"> -CommandAction"> -FunctionAction"> -ListAction"> -Builder"> -BuilderBase"> -CompositeBuilder"> -MultiStepBuilder"> -Job"> -Jobs"> -Serial"> -Parallel"> -Node"> -Node.FS"> -Scanner"> -Sig"> -Signature"> -Taskmaster"> -TimeStamp"> -Walker"> -Wrapper"> - - - - - ---debug=explain"> ---implicit-cache"> ---implicit-deps-changed"> ---implicit-deps-unchanged"> --Q"> - - - -implicit_cache"> -implicit_deps_changed"> -implicit_deps_unchanged"> - - - - - -build"> -Makefile"> -Makefiles"> -SConscript"> -SConstruct"> -Sconstruct"> -sconstruct"> -.sconsign"> -src"> - - - - - -Add"> -AddOptions"> -Alias"> -Aliases"> -Append"> -BoolOption"> -Build"> -CacheDir"> -Clean"> -Clone"> -Command"> -Configure"> -Copy"> -Default"> -DefaultRules"> -Depends"> -Dir"> -Entry"> -EnumOption"> -Environment"> -Export"> -File"> -Finish"> -GenerateHelpText"> -Help"> -Ignore"> -Import"> -Install"> -InstallAs"> -Link"> -ListOption"> -Local"> -Module"> -Objects"> -Options"> -PackageOption"> -PathOption"> -Precious"> -Prepend"> -Replace"> -Repository"> -Return"> -RuleSet"> -Salt"> -SetBuildSignatureType"> -SetContentSignatureType"> -SourceSignature"> -SourceSignatures"> -Split"> -TargetSignatures"> -Task"> - - -subst"> - - -Message"> -Result"> -CheckCHeader"> -CheckCXXHeader"> -CheckFunc"> -CheckHeader"> -CheckLib"> -CheckLibWithHeader"> -CheckType"> -TryAction"> -TryBuild"> -TryCompile"> -TryLink"> -TryRun"> - - -str"> -zipfile"> - - -Cache"> - - - - - -ARGUMENTS"> -BUILD_TARGETS"> -COMMAND_LINE_TARGETS"> -DEFAULT_TARGETS"> - - - - - -BUILDERMAP"> -BUILDERS"> -CC"> -CCFLAGS"> -CCCOM"> -COLOR"> -COLORS"> -CONFIG"> -CPPDEFINES"> -ENV"> -JAVACLASSDIR"> -LIBDIRPREFIX"> -LIBDIRSUFFIX"> -LIBLINKPREFIX"> -LIBLINKSUFFIX"> -LIBPATH"> -LIBS"> -LINK"> -LINKCOM"> -LINKFLAGS"> -RELEASE"> -RELEASE_BUILD"> -SCANNERMAP"> -SCANNERS"> -TARFLAGS"> -TARSUFFIX"> - - - - - -PATH"> -PYTHONPATH"> -SCONSFLAGS"> - - - - - -allowed_values"> -build_dir"> -map"> -ignorecase"> -options"> -exports"> -source"> -target"> - - - - - -all"> -none"> - - - - - -BuildDir"> -CFile"> -CXXFile"> -DVI"> -Jar"> -Java"> -JavaH"> -Library"> -Object"> -PCH"> -PDF"> -PostScript"> -Program"> -RES"> -RMIC"> -SharedLibrary"> -SharedObject"> -StaticLibrary"> -StaticObject"> -Tar"> -Zip"> - - -Make"> - - - - - -builder function"> -builder method"> - -Configure Contexts"> -configure context"> - -Construction Environment"> -Construction Environments"> -Construction environment"> -Construction environments"> -construction environment"> -construction environments"> - -Construction Variable"> -Construction Variables"> -Construction variable"> -Construction variables"> -construction variable"> -construction variables"> - -CPPPATH"> - -Dictionary"> - -Emitter"> -emitter"> -Generator"> -generator"> - -Nodes"> - -signature"> -build signature"> - -true"> -false"> - -typedef"> - - - -bar"> -common1.c"> -common2.c"> -custom.py"> -goodbye"> -goodbye.o"> -goodbye.obj"> -file.dll"> -file.in"> -file.lib"> -file.o"> -file.obj"> -file.out"> -foo"> -foo.o"> -foo.obj"> -hello"> -hello.c"> -hello.exe"> -hello.h"> -hello.o"> -hello.obj"> -libfile_a"> -libfile_so"> -new_hello"> -new_hello.exe"> -prog"> -prog1"> -prog2"> -prog.c"> -prog.exe"> -stdio.h"> - - - -+"> -#"> - - - -announce@scons.tigris.org"> -dev@scons.tigris.org"> -users@scons.tigris.org"> 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 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + Taskmaster + MD5 + TStamp + Sig + + + 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 @@ + + + %scons; +]> + +
+Summary + + + + + + 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. + + + +
-- cgit v1.2.3