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/design/MANIFEST | 17 +- doc/design/SConstruct | 49 + doc/design/acks.xml | 16 +- doc/design/bground.xml | 16 +- doc/design/chtml.xsl | 56 + doc/design/copyright.xml | 14 +- doc/design/engine.svg | 529 ++ doc/design/engine.xml | 28 +- doc/design/goals.xml | 16 +- doc/design/html.xsl | 55 + doc/design/install.xml | 20 +- doc/design/intro.xml | 16 +- doc/design/issues.xml | 16 +- doc/design/main.xml | 116 +- doc/design/native.xml | 16 +- doc/design/overview.xml | 36 +- doc/design/pdf.xsl | 71 + doc/design/scons.css | 263 + doc/design/scons.mod | 429 -- doc/design/scons_title.xsl | 6352 +++++++++++++++++++++++ doc/design/summary.xml | 53 + doc/design/titlepage/SConsBuildBricks_path.svg | 320 ++ doc/design/titlepage/SCons_path.svg | 196 + doc/design/titlepage/bricks.jpg | Bin 0 -> 36855 bytes doc/design/titlepage/mapnik_final_colors.svg | 6397 ++++++++++++++++++++++++ 25 files changed, 14544 insertions(+), 553 deletions(-) create mode 100644 doc/design/SConstruct create mode 100644 doc/design/chtml.xsl create mode 100644 doc/design/engine.svg create mode 100644 doc/design/html.xsl create mode 100644 doc/design/pdf.xsl create mode 100644 doc/design/scons.css delete mode 100644 doc/design/scons.mod create mode 100644 doc/design/scons_title.xsl create mode 100644 doc/design/summary.xml create mode 100644 doc/design/titlepage/SConsBuildBricks_path.svg create mode 100644 doc/design/titlepage/SCons_path.svg create mode 100755 doc/design/titlepage/bricks.jpg create mode 100644 doc/design/titlepage/mapnik_final_colors.svg (limited to 'doc/design') diff --git a/doc/design/MANIFEST b/doc/design/MANIFEST index 33ab8f0..0168e11 100644 --- a/doc/design/MANIFEST +++ b/doc/design/MANIFEST @@ -1,8 +1,9 @@ +# We don't use a wildcard for the XML files +# here, because it would pull in the created +# ones as well... acks.xml bground.xml copyright.xml -engine.fig -engine.jpg engine.xml goals.xml install.xml @@ -11,4 +12,14 @@ issues.xml main.xml native.xml overview.xml -scons.mod +summary.xml +engine.fig +engine.jpg +engine.svg +*.xsl +scons.css +SConstruct +titlepage/bricks.jpg +titlepage/mapnik_final_colors.svg +titlepage/SCons_path.svg +titlepage/SConsBuildBricks_path.svg diff --git a/doc/design/SConstruct b/doc/design/SConstruct new file mode 100644 index 0000000..1cafcb1 --- /dev/null +++ b/doc/design/SConstruct @@ -0,0 +1,49 @@ +# +# 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'], + DOCBOOK_DEFAULT_XSL_HTML='html.xsl', + DOCBOOK_DEFAULT_XSL_HTMLCHUNKED='chtml.xsl', + DOCBOOK_DEFAULT_XSL_PDF='pdf.xsl') + +has_pdf = False +if (env.WhereIs('fop') or + env.WhereIs('xep')): + has_pdf = True + +# +# Create document +# +env.DocbookXInclude('design_xi.xml', 'main.xml') +env.DocbookXslt('design.xml', 'design_xi.xml', + xsl='../xslt/to_docbook.xslt') +env.DocbookHtmlChunked('index.html','design.xml', base_dir='scons-design/') +if has_pdf: + env.DocbookPdf('scons-design.pdf','design.xml') diff --git a/doc/design/acks.xml b/doc/design/acks.xml index b1a8a58..94a249f 100644 --- a/doc/design/acks.xml +++ b/doc/design/acks.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Acknowledgements + + + + + + + + + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + + diff --git a/doc/design/copyright.xml b/doc/design/copyright.xml index d73906e..df3d544 100644 --- a/doc/design/copyright.xml +++ b/doc/design/copyright.xml @@ -1,6 +1,16 @@ + + + %scons; +]> + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Node.FS + Intercessor.FS + Intercessor.DB + Scanner + Builder + Intercessor + Environment + Node.DB + Dir + File + Table + Record + Field + Node + dependency + * + srcnode + 1 + repnode + 1 + 0..1 + 0..1 + * + * + build() + scan() + 1 + 1 + * + 1 + * + * + + diff --git a/doc/design/engine.xml b/doc/design/engine.xml index afe9877..4f56e61 100644 --- a/doc/design/engine.xml +++ b/doc/design/engine.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Build Engine API + + + + + + + + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + + diff --git a/doc/design/install.xml b/doc/design/install.xml index e670e83..dc27b2c 100644 --- a/doc/design/install.xml +++ b/doc/design/install.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Installation + + + + + + + diff --git a/doc/design/intro.xml b/doc/design/intro.xml index 561baa4..1d042ae 100644 --- a/doc/design/intro.xml +++ b/doc/design/intro.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Introduction + + + diff --git a/doc/design/issues.xml b/doc/design/issues.xml index 1f9a78c..a43b77f 100644 --- a/doc/design/issues.xml +++ b/doc/design/issues.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Other Issues + - %version; - --> - - - - - - %scons; - - - - - - - - - - - ]> - + - SCons Design version &buildversion; - + SCons &buildversion; + Design Steven Knight - Revision &buildrevision; (&builddate;) + Steven Knight 2001 @@ -80,79 +55,34 @@ Steven Knight - - ©right; - + version &buildversion; - - Introduction - &intro; - + - - Goals - &goals; - + - - Overview - &overview; - + - - Build Engine API - &engine; - + - - Native Python Interface - &native; - + - - Other Issues - &issues; - - - - Background - &bground; - - - - Summary - - - &SCons; offers a robust and feature-rich design for an SC-build - tool. With a Build Engine based on the proven design of - the &Cons; utility, it offers increased simplification of the - user interface for unsophisticated users with the addition - of the "do-the-right-thing" env.Make - method, increased flexibility for sophisticated users with the - addition of &Builder; and &Scanner; objects, a mechanism to - allow tool-masters (and users) to share working construction - environments, and embeddability to provide reliable dependency - management in a variety of environments and interfaces. - - - - - - Acknowledgements - &acks; - + + + + + + + diff --git a/doc/design/native.xml b/doc/design/native.xml index c665e0c..83227ab 100644 --- a/doc/design/native.xml +++ b/doc/design/native.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Native Python Interface + + + diff --git a/doc/design/overview.xml b/doc/design/overview.xml index 266c9e8..66ef78d 100644 --- a/doc/design/overview.xml +++ b/doc/design/overview.xml @@ -1,6 +1,18 @@ + + + %scons; +]> + + +Overview + - - @@ -496,3 +504,5 @@ This is where it will go, anyway... + + diff --git a/doc/design/pdf.xsl b/doc/design/pdf.xsl new file mode 100644 index 0000000..c8acf1b --- /dev/null +++ b/doc/design/pdf.xsl @@ -0,0 +1,71 @@ + + + + + + + + + + +0pt + + + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + + bold + + + + + + + + + + + diff --git a/doc/design/scons.css b/doc/design/scons.css new file mode 100644 index 0000000..6941abb --- /dev/null +++ b/doc/design/scons.css @@ -0,0 +1,263 @@ +body { + background: #ffffff; + margin: 10px; + padding: 0; + font-family:palatino, georgia, verdana, arial, sans-serif; + } + + +a { + color: #80572a; + } + +a:hover { + color: #d72816; + text-decoration: none; + } + +tt { + color: #a14447; + } + +pre { + background: #e0e0e0; + } + +#main { + border: 1px solid; + border-color: black; + background-color: white; + background-image: url(../images/sconsback.png); + background-repeat: repeat-y 50% 0; + background-position: right top; + margin: 30px auto; + width: 750px; + } + +#banner { + background-image: url(../images/scons-banner.jpg); + border-bottom: 1px solid; + height: 95px; + } + +#menu { + font-family: sans-serif; + font-size: small; + line-height: 0.9em; + float: right; + width: 220px; + clear: both; + margin-top: 10px; + } + +#menu li { + margin-bottom: 7px; + } + +#menu li li { + margin-bottom: 2px; + } + +#menu li.submenuitems { + margin-bottom: 2px; + } + +#menu a { + text-decoration: none; + } + +#footer { + border-top: 1px solid black; + text-align: center; + font-size: small; + color: #822; + margin-top: 4px; + background: #eee; + } + +ul.hack { + list-style-position:inside; + } + +ul.menuitems { + list-style-type: none; + } + +ul.submenuitems { + list-style-type: none; + font-size: smaller; + margin-left: 0; + padding-left: 16px; + } + +ul.subsubmenuitems { + list-style-type: none; + font-size: smaller; + margin-left: 0; + padding-left: 16px; + } + +ol.upper-roman { + list-style-type: upper-roman; + } + +ol.decimal { + list-style-type: decimal; + } + +#currentpage { + font-weight: bold; + } + +#bodycontent { + margin: 15px; + width: 520px; + font-size: small; + line-height: 1.5em; + } + +#bodycontent li { + margin-bottom: 6px; + list-style-type: square; + } + +#sconsdownloadtable downloadtable { + display: table; + margin-left: 5%; + border-spacing: 12px 3px; + } + +#sconsdownloadtable downloadrow { + display: table-row; + } + +#sconsdownloadtable downloadentry { + display: table-cell; + text-align: center; + vertical-align: bottom; + } + +#sconsdownloadtable downloaddescription { + display: table-cell; + font-weight: bold; + text-align: left; + } + +#sconsdownloadtable downloadversion { + display: table-cell; + font-weight: bold; + text-align: center; + } + +#sconsdocversiontable sconsversiontable { + display: table; + margin-left: 10%; + border-spacing: 12px 3px; + } + +#sconsdocversiontable sconsversionrow { + display: table-row; + } + +#sconsdocversiontable docformat { + display: table-cell; + font-weight: bold; + text-align: center; + vertical-align: bottom; + } + +#sconsdocversiontable sconsversion { + display: table-cell; + font-weight: bold; + text-align: left; + } + +#sconsdocversiontable docversion { + display: table-cell; + font-weight: bold; + text-align: center; + } + +#osrating { + margin-left: 35px; + } + + +h2 { + color: #272; + color: #c01714; + font-family: sans-serif; + font-weight: normal; + } + +h2.pagetitle { + font-size: xx-large; + } +h3 { + margin-bottom: 10px; + } + +.date { + font-size: small; + color: gray; + } + +.link { + margin-bottom: 22px; + } + +.linkname { + } + +.linkdesc { + margin: 10px; + margin-top: 0; + } + +.quote { + margin-top: 20px; + margin-bottom: 10px; + background: #f8f8f8; + border: 1px solid; + border-color: #ddd; + } + +.quotetitle { + font-weight: bold; + font-size: large; + margin: 10px; + } + +.quotedesc { + margin-left: 20px; + margin-right: 10px; + margin-bottom: 15px; + } + +.quotetext { + margin-top: 20px; + margin-left: 20px; + margin-right: 10px; + font-style: italic; + } + +.quoteauthor { + font-size: small; + text-align: right; + margin-top: 10px; + margin-right: 7px; + } + +.sconslogo { + font-style: normal; + font-weight: bold; + color: #822; + } + +.downloadlink { + } + +.downloaddescription { + margin-left: 1em; + margin-bottom: 0.4em; + } diff --git a/doc/design/scons.mod b/doc/design/scons.mod deleted file mode 100644 index 807f3cb..0000000 --- a/doc/design/scons.mod +++ /dev/null @@ -1,429 +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"> -NoClean"> -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/design/scons_title.xsl b/doc/design/scons_title.xsl new file mode 100644 index 0000000..52ca405 --- /dev/null +++ b/doc/design/scons_title.xsl @@ -0,0 +1,6352 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 200mm + 205.9mm + + + + + 190mm + 195.9mm + + + + + 180mm + 185.9mm + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + scons-titlepage-first + + + + + + + + + + + + + + + + + + + + + scons-titlepage-odd + + + + + + + + + + + + + + + + + + + + + scons-titlepage-even + + + + + + + + + + + + + + + + + + + + + + scons-chapter-first + + + + + + + + + + + + + + + + + + + + + scons-chapter-odd + + + + + + + + + + + + + + + + + + + + + scons-chapter-even + + + + + + + + + + + + + + + + + + + + + + + + scons-titlepage-first-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + + + scons-titlepage-odd-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + + + scons-titlepage-even-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + + + + scons-chapter-first-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + + + scons-chapter-odd-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + + + scons-chapter-even-draft + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + scons-titlepage-even + scons-titlepage-odd + + + + + + + + + + + + + + + + + + body-even-draft + body-odd-draft + + + + + + + + + + + + + + + + scons-chapter-even + scons-chapter-odd + + + + + + + + + + + + + + + + scons-chapter-even-draft + scons-chapter-odd-draft + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + bold + #C51410 + always + center + after + 0pt + 0pt + + + + + + + 24pt + #C51410 + bold + always + left + after + 0pt + 0pt + 0.7em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 6 + 5 + 4 + 3 + 2 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + 1 + 1 + 3 + + + + + + 3 + 3 + 1 + + + + + + + + + + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + 1 + 1 + 3 + + + + + + 3 + 3 + 1 + + + + + + + + + + + + + proportional-column-width( + + footer + + + ) + + + + + proportional-column-width( + + footer + + + ) + + + + + proportional-column-width( + + footer + + + ) + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0.5pt + solid + #C51410 + + + + + + + + + + + 0.5pt + solid + #C51410 + + + +1 0 1 +1 0 1 + + + + + diff --git a/doc/design/summary.xml b/doc/design/summary.xml new file mode 100644 index 0000000..8b68654 --- /dev/null +++ b/doc/design/summary.xml @@ -0,0 +1,53 @@ + + + %scons; +]> + + +Summary + + + + + + &SCons; offers a robust and feature-rich design for an SC-build + tool. With a Build Engine based on the proven design of + the &Cons; utility, it offers increased simplification of the + user interface for unsophisticated users with the addition + of the "do-the-right-thing" env.Make + method, increased flexibility for sophisticated users with the + addition of &Builder; and &Scanner; objects, a mechanism to + allow tool-masters (and users) to share working construction + environments, and embeddability to provide reliable dependency + management in a variety of environments and interfaces. + + + + diff --git a/doc/design/titlepage/SConsBuildBricks_path.svg b/doc/design/titlepage/SConsBuildBricks_path.svg new file mode 100644 index 0000000..ed0c60d --- /dev/null +++ b/doc/design/titlepage/SConsBuildBricks_path.svg @@ -0,0 +1,320 @@ + + + + + + + + + + image/svg+xml + + + 2008-05-18 + + + Hartmut Goebel + + + + + Hartmut Goebel <h.goebel@goebel-consult.de> + + + en + + + SCons + software build tool + software construction tool + + + + + + Based on the pixeled SCons logo (author unknown). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/design/titlepage/SCons_path.svg b/doc/design/titlepage/SCons_path.svg new file mode 100644 index 0000000..ef580ee --- /dev/null +++ b/doc/design/titlepage/SCons_path.svg @@ -0,0 +1,196 @@ + + + + + SCons - Build your software, better (SCons Logo) + + + + + + image/svg+xml + + SCons - Build your software, better (SCons Logo) + 2011-05-19 + + + Dirk Baechle + + + + + Dirk Baechle <dl9obn@darc.de> + + + en + + + SCons + software build tool + software construction tool + + + + + + Based on the SCons (Constructs using) logo by Hartmut Goebel <h.goebel@goebel-consult.de>. + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/design/titlepage/bricks.jpg b/doc/design/titlepage/bricks.jpg new file mode 100755 index 0000000..b2dc16b Binary files /dev/null and b/doc/design/titlepage/bricks.jpg differ diff --git a/doc/design/titlepage/mapnik_final_colors.svg b/doc/design/titlepage/mapnik_final_colors.svg new file mode 100644 index 0000000..23bb54a --- /dev/null +++ b/doc/design/titlepage/mapnik_final_colors.svg @@ -0,0 +1,6397 @@ + + + SCons, Book titlepage background + + + + image/svg+xml + + + SCons, Book titlepage background + 2013-04-15 + + + Dirk Baechle + + + + + Dirk Baechle <dl9obn@darc.de> + + + en + + + SCons + software build tool + software construction tool + + + + + Based on a SCons dependency tree of the Mapnik project (www.mapnik.org) + + + + + + + + + + + + + + + + + + + + + + + ./src/agg_renderer.os + + + + + + + ./agg/src + + + + + + + ./src/graphics.os + + + + + + + ./src/font_set.os + + + + + + + ./agg/src/agg_vcgen_markers_term.o + + + + + + + ./src/params.os + + + + + + + ./agg/src/agg_image_filters.o + + + + + + + ./bindings/python/mapnik_symbolizer.os + + + + + + + ./src/memory.os + + + + + + + ./bindings/python/mapnik_font_engine.os + + + + + + + ./plugins/input/shape/dbffile.os + + + + + + + ./agg/src/agg_line_aa_basics.o + + + + + + + ./src/save_map.os + + + + + + + ./bindings/python/mapnik_view_transform.os + + + + + + + ./src/color.os + + + + + + + ./agg/libagg.a + + + + + + + ./src/font_engine_freetype.os + + + + + + + ./src/stroke.os + + + + + + + ./bindings/python/mapnik_image.os + + + + + + + ./src/image_util.os + + + + + + + ./bindings/python/mapnik_datasource_cache.os + + + + + + + ./agg/include + + + + + + + ./bindings/python/mapnik_rule.os + + + + + + + ./agg/src/agg_bezier_arc.o + + + + + + + ./bindings/python/mapnik_featureset.os + + + + + + + ./agg/src/agg_arc.o + + + + + + + ./plugins/input/shape/shapefile.os + + + + + + + ./plugins/input/raster/raster_datasource.os + + + + + + + ./plugins/input/raster/raster_featureset.os + + + + + + + ./src/unicode.os + + + + + + + ./bindings/python/mapnik/ogcserver + + + + + + + ./bindings/python/mapnik_map.os + + + + + + + ./src/arrow.os + + + + + + + ./plugins + + + + + + + ./plugins/input/raster/raster.input + + + + + + + ./agg/src/agg_vcgen_contour.o + + + + + + + ./agg/src/agg_trans_warp_magnifier.o + + + + + + + ./bindings/python/mapnik_datasource.os + + + + + + + ./plugins/input/shape/shape_featureset.os + + + + + + + ./src/load_map.os + + + + + + + ./bindings/python/mapnik_point_symbolizer.os + + + + + + + ./src/line_pattern_symbolizer.os + + + + + + + ./bindings/python/mapnik + + + + + + + ./plugins/input/raster + + + + + + + ./src/map.os + + + + + + + ./src/wkb.os + + + + + + + ./agg/src/agg_vcgen_stroke.o + + + + + + + ./agg/src/agg_gsv_text.o + + + + + + + ./plugins/input/shape/shape.os + + + + + + + ./bindings + + + + + + + ./src + + + + + + + ./bindings/python/mapnik_filter.os + + + + + + + ./agg/src/agg_vcgen_bspline.o + + + + + + + ./bindings/python/mapnik_coord.os + + + + + + + ./src/envelope.os + + + + + + + ./agg/src/agg_vpgen_segmentator.o + + + + + + + ./bindings/python/mapnik_layer.os + + + + + + + ./bindings/python/mapnik_line_symbolizer.os + + + + + + + ./src/shield_symbolizer.os + + + + + + + ./agg/src/agg_trans_double_path.o + + + + + + + ./src/projection.os + + + + + + + ./src/tiff_reader.os + + + + + + + ./bindings/python/mapnik_proj_transform.os + + + + + + + ./bindings/python/mapnik_style.os + + + + + + + ./bindings/python/mapnik_shield_symbolizer.os + + + + + + + ./src/image_reader.os + + + + + + + ./agg/src/agg_bspline.o + + + + + + + ./agg/src/agg_trans_single_path.o + + + + + + + ./plugins/input/raster/raster_info.os + + + + + + + ./agg/src/agg_vcgen_dash.o + + + + + + + ./bindings/python/mapnik_projection.os + + + + + + + ./bindings/python/mapnik_image_view.os + + + + + + + ./src/distance.os + + + + + + + ./src/datasource_cache.os + + + + + + + ./bindings/python/mapnik_parameters.os + + + + + + + ./src/plugin.os + + + + + + + ./agg/src/agg_arrowhead.o + + + + + + + ./bindings/python/mapnik_feature.os + + + + + + + ./agg/src/agg_embedded_raster_fonts.o + + + + + + + ./src/libmapnik.so + + + + + + + ./src/placement_finder.os + + + + + + + ./agg/src/agg_sqrt_tables.o + + + + + + + ./agg/src/agg_vpgen_clip_polyline.o + + + + + + + ./bindings/python/mapnik_raster_symbolizer.os + + + + + + + ./agg/src/agg_line_profile_aa.o + + + + + + + ./bindings/python/mapnik_line_pattern_symbolizer.os + + + + + + + ./bindings/python/mapnik_color.os + + + + + + + ./src/proj_transform.os + + + + + + + ./src/memory_datasource.os + + + + + + + ./plugins/input + + + + + + + ./bindings/python/mapnik_python.os + + + + + + + ./src/png_reader.os + + + + + + + ./bindings/python/mapnik_envelope.os + + + + + + + ./bindings/python/mapnik_stroke.os + + + + + + + ./plugins/input/shape/shape.input + + + + + + + ./bindings/python/mapnik_query.os + + + + + + + ./src/point_symbolizer.os + + + + + + + ./src/filter_factory.os + + + + + + + ./bindings/python/mapnik_polygon_symbolizer.os + + + + + + + ./agg/src/agg_vcgen_smooth_poly1.o + + + + + + + ./plugins/input/shape/shape_index_featureset.os + + + + + + + ./bindings/python/python_cairo.os + + + + + + + ./src/symbolizer.os + + + + + + + ./bindings/python/_mapnik.so + + + + + + + ./agg/src/agg_trans_affine.o + + + + + + + ./src/polygon_pattern_symbolizer.os + + + + + + + ./bindings/python/mapnik_polygon_pattern_symbolizer.os + + + + + + + ./agg/src/agg_curves.o + + + + + + + ./src/text_symbolizer.os + + + + + + + ./src/scale_denominator.os + + + + + + + ./plugins/input/shape/shape_io.os + + + + + + + ./src/layer.os + + + + + + + ./agg + + + + + + + ./src/libxml2_loader.os + + + + + + + ./agg/src/agg_vpgen_clip_polygon.o + + + + + + + ./plugins/input/shape + + + + + + + ./bindings/python/mapnik_geometry.os + + + + + + + ./bindings/python/mapnik_text_symbolizer.os + + + + + + + ./agg/src/agg_rounded_rect.o + + + + + + + ./bindings/python + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -- cgit v1.2.3