Mercurial > parpg-core
diff site_scons/site_tools/cpython/doc/SConstruct @ 11:4706e0194af3
Various improvements to the build process including support for self-contained builds.
* Note that despite all of these changes PARPG still does not run because asset paths are not standardized,
* Modified the SCons script so that by default running `scons` with no arguments creates a self-contained "build" under a build subdirectory to make in-source testing easier. To install PARPG, use `scons install` instead.
* Got rid of the binary launcher and replaced it with a shell script for unix and a batch script for Windows (batch script is untested). The binary turned out to be too much trouble to maintain.
* Modified the parpg.settings module and parpg.main entry script so that PARPG searches through several default search paths for configuration file(s). PARPG thus no longer crashes if it can't find a configuration file in any particular search path, but will crash it if can't find any configuration files.
* Paths supplied to parpg.main are now appended as search paths for the configuration file(s).
* Changed the default configuration file name to "parpg.cfg" to simplify searches.
* Created the site_scons directory tree where SCons extensions and tools should be placed.
* Created a new SCons builder, CopyRecurse, which can copy only certain files and folders from a directory tree using filters (files and folders that start with a leading dot "." e.g. ".svn" are ignored by default).
* Added the CPython SCons tool (stands for Compile-Python - I didn't name it!), which provides the InstallPython builder for pre-compiling python sources before they are installed. However, it is currently broken and only installs the python sources.
| author | M. George Hansen <technopolitica@gmail.com> |
|---|---|
| date | Tue, 31 May 2011 02:46:20 -0700 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/site_scons/site_tools/cpython/doc/SConstruct Tue May 31 02:46:20 2011 -0700 @@ -0,0 +1,56 @@ +# +# A simple SConstruct for creating PDF files from Docbook XML +# sources. It's plain and ugly...but does its job ;). +# + +# +# Copyright (c) 2001-2010 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 + +bld_fo = Builder(action = 'xsltproc ./pdf.xsl $SOURCE > $TARGET', + suffix = '.fo', + src_suffix = '.xml', + single_source = True) + +bld_html = Builder(action = 'xsltproc ./html.xsl $SOURCE > $TARGET', + suffix = '.html', + src_suffix = '.xml', + single_source = True) + +bld_pdf = Builder(action = 'fop $SOURCE $TARGET', + suffix = '.pdf', + src_suffix = '.fo', + single_source = True) + +env = Environment(ENV = os.environ, + BUILDERS = {'Fo' : bld_fo, + 'Html' : bld_html, + 'Pdf' : bld_pdf}) + +env.Pdf('manual', env.Fo('manual')) +env.Pdf('reference', env.Fo('reference')) + +env.Html('manual','manual') +env.Html('reference','reference') +