cscript

   1 # -*- mode: python -*-
   2 #
   3 #    Copyright (C) 2012-2017 Carl Hetherington <cth@carlh.net>
   4 #
   5 #    This file is part of DCP-o-matic.
   6 #
   7 #    DCP-o-matic is free software; you can redistribute it and/or modify
   8 #    it under the terms of the GNU General Public License as published by
   9 #    the Free Software Foundation; either version 2 of the License, or
  10 #    (at your option) any later version.
  11 #
  12 #    DCP-o-matic is distributed in the hope that it will be useful,
  13 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 #    GNU General Public License for more details.
  16 #
  17 #    You should have received a copy of the GNU General Public License
  18 #    along with DCP-o-matic.  If not, see <http://www.gnu.org/licenses/>.
  19 #
  20
  21 from __future__ import print_function
  22 import glob
  23 import shutil
  24 import os
  25 import copy
  26
  27 deb_build_depends = dict()
  28
  29 deb_build_depends_base = ['debhelper', 'python', 'g++', 'pkg-config', 'libsndfile1-dev', 'libgtk2.0-dev', 'libx264-dev']
  30
  31 deb_build_depends['14.04'] = copy.deepcopy(deb_build_depends_base)
  32 deb_build_depends['14.04'].extend(['libssh-dev'])
  33 deb_build_depends['16.04'] = copy.deepcopy(deb_build_depends_base)
  34 deb_build_depends['16.04'].extend(['libssh-dev'])
  35 deb_build_depends['17.10'] = copy.deepcopy(deb_build_depends_base)
  36 deb_build_depends['17.10'].extend(['libssh-dev'])
  37 deb_build_depends['18.04'] = copy.deepcopy(deb_build_depends_base)
  38 deb_build_depends['18.04'].extend(['libssh-dev'])
  39 deb_build_depends['7'] = copy.deepcopy(deb_build_depends_base)
  40 deb_build_depends['7'].extend(['libssh-dev'])
  41 deb_build_depends['8'] = copy.deepcopy(deb_build_depends_base)
  42 deb_build_depends['8'].extend(['libssh-gcrypt-dev'])
  43 deb_build_depends['9'] = copy.deepcopy(deb_build_depends_base)
  44 deb_build_depends['9'].extend(['libssh-gcrypt-dev'])
  45 deb_build_depends['unstable'] = copy.deepcopy(deb_build_depends_base)
  46
  47 deb_depends = dict()
  48
  49 deb_depends_base = ['libc6', 'libsndfile1', 'libsamplerate0', 'libxmlsec1', 'libxmlsec1-openssl', 'libgtk2.0-0']
  50
  51 deb_depends['14.04'] = copy.deepcopy(deb_depends_base)
  52 deb_depends['14.04'].extend(['libboost-filesystem1.54.0',
  53                              'libboost-thread1.54.0',
  54                              'libboost-regex1.54.0',
  55                              'libmagick++5',
  56                              'libxml++2.6-2',
  57                              'libboost-date-time1.54.0',
  58                              'libzip2',
  59                              'libcairomm-1.0-1',
  60                              'libpangomm-1.4-1,'
  61                              'libicu52',
  62                              'libnettle4',
  63                              'libssh-4',
  64                              'libx264-142',
  65                              'libcurl3'])
  66
  67 deb_depends['16.04'] = copy.deepcopy(deb_depends_base)
  68 deb_depends['16.04'].extend(['libboost-filesystem1.58.0',
  69                              'libboost-thread1.58.0',
  70                              'libboost-regex1.58.0',
  71                              'libmagick++-6.q16-5v5',
  72                              'libxml++2.6-2v5',
  73                              'libboost-date-time1.58.0',
  74                              'libzip4',
  75                              'libcairomm-1.0-1v5',
  76                              'libpangomm-1.4-1v5',
  77                              'libwxgtk3.0-0v5',
  78                              'libicu55',
  79                              'libnettle6',
  80                              'libssh-4',
  81                              'libx264-148',
  82                              'libcurl3'])
  83
  84 deb_depends['17.10'] = copy.deepcopy(deb_depends_base)
  85 deb_depends['17.10'].extend(['libboost-filesystem1.62.0',
  86                              'libboost-thread1.62.0',
  87                              'libboost-regex1.62.0',
  88                              'libmagick++-6.q16-7',
  89                              'libxml++2.6-2v5',
  90                              'libboost-date-time1.62.0',
  91                              'libzip4',
  92                              'libwxgtk3.0-0v5',
  93                              'libicu57',
  94                              'libnettle6',
  95                              'libssh-4',
  96                              'libx264-148',
  97                              'libcurl3'])
  98
  99 deb_depends['18.04'] = copy.deepcopy(deb_depends_base)
 100 deb_depends['18.04'].extend(['libboost-filesystem1.65.1',
 101                              'libboost-thread1.65.1',
 102                              'libboost-regex1.65.1',
 103                              'libboost-date-time1.65.1',
 104                              'libmagick++-6.q16-7',
 105                              'libcairomm-1.0-1v5',
 106                              'libpangomm-1.4-1v5',
 107                              'libxml++2.6-2v5',
 108                              'libzip4',
 109                              'libwxgtk3.0-0v5',
 110                              'libicu60',
 111                              'libnettle6',
 112                              'libssh-4',
 113                              'libx264-152',
 114                              'libcurl4'])
 115
 116 deb_depends['7'] = copy.deepcopy(deb_depends_base)
 117 deb_depends['7'].extend(['libboost-filesystem1.49.0',
 118                          'libboost-thread1.49.0',
 119                          'libboost-regex1.49.0',
 120                          'libmagick++5',
 121                          'libxml++2.6-2',
 122                          'libboost-date-time1.49.0',
 123                          'libzip2',
 124                          'libcairomm-1.0-1',
 125                          'libpangomm-1.4-1',
 126                          'libicu48',
 127                          'libnettle4',
 128                          'libnotify4',
 129                          'libx264-123',
 130                          'libcurl3'])
 131
 132 deb_depends['8'] = copy.deepcopy(deb_depends_base)
 133 deb_depends['8'].extend(['libboost-filesystem1.55.0',
 134                          'libboost-thread1.55.0',
 135                          'libboost-date-time1.55.0',
 136                          'libboost-regex1.55.0',
 137                          'libmagick++-6.q16-5',
 138                          'libxml++2.6-2',
 139                          'libzip2',
 140                          'libcairomm-1.0-1',
 141                          'libpangomm-1.4-1',
 142                          'libwxgtk3.0-0',
 143                          'libxcb-xfixes0',
 144                          'libxcb-shape0',
 145                          'libicu52',
 146                          'libnettle4',
 147                          'libssh-4',
 148                          'libx264-142',
 149                          'libcurl3'])
 150
 151 deb_depends['9'] = copy.deepcopy(deb_depends_base)
 152 deb_depends['9'].extend(['libboost-filesystem1.62.0',
 153                          'libboost-thread1.62.0',
 154                          'libboost-regex1.62.0',
 155                          'libboost-date-time1.62.0',
 156                          'libmagick++-6.q16-7',
 157                          'libxml++2.6-2v5',
 158                          'libgtk2.0-0',
 159                          'libzip4',
 160                          'libcairomm-1.0-1v5',
 161                          'libpangomm-1.4-1v5',
 162                          'libwxgtk3.0-0v5',
 163                          'libxcb-xfixes0',
 164                          'libxcb-shape0',
 165                          'libasound2',
 166                          'libicu57',
 167                          'libssh-4',
 168                          'libssh-gcrypt-4',
 169                          'libnettle6',
 170                          'libx264-148',
 171                          'libpulse0',
 172                          'libcurl3'])
 173
 174 deb_depends['unstable'] = copy.deepcopy(deb_depends_base)
 175 deb_depends['unstable'].extend(['libboost-filesystem1.62.0',
 176                                 'libboost-thread1.62.0',
 177                                 'libboost-regex1.62.0',
 178                                 'libboost-date-time1.62.0',
 179                                 'libmagick++-6.q16-7',
 180                                 'libxml++2.6-2v5',
 181                                 'libgtk2.0-0',
 182                                 'libzip4',
 183                                 'libicu57',
 184                                 'libnettle6',
 185                                 'libx264-148',
 186                                 'libcurl3'])
 187
 188 def packages(name, packages, f):
 189     s = '%s: ' % name
 190     for p in packages:
 191         s += str(p) + ', '
 192     print(s[:-2], file=f)
 193
 194 def make_control(debian_version, bits, filename, debug):
 195     f = open(filename, 'w')
 196     print('Source: dcpomatic', file=f)
 197     print('Section: video', file=f)
 198     print('Priority: extra', file=f)
 199     print('Maintainer: Carl Hetherington <carl@dcpomatic.com>', file=f)
 200     packages('Build-Depends', deb_build_depends[debian_version], f)
 201     print('Standards-Version: 3.9.3', file=f)
 202     print('Homepage: http://dcpomatic.com/', file=f)
 203     print('', file=f)
 204     print('Package: dcpomatic', file=f)
 205     if bits == 32:
 206         print('Architecture: i386', file=f)
 207     else:
 208         print('Architecture: amd64', file=f)
 209
 210     packages('Depends', deb_depends[debian_version], f)
 211
 212     print('Description: Generator of Digital Cinema Packages (DCPs)', file=f)
 213     print('  DCP-o-matic generates Digital Cinema Packages (DCPs) from videos, images,', file=f)
 214     print('  sound and subtitle files.  You can use it to make content for playback on DCI-compliant', file=f)
 215     print('  cinema projectors.', file=f)
 216
 217     if debug:
 218         print('', file=f)
 219         print('Package: dcpomatic-dbg', file=f)
 220         if bits == 32:
 221             print('Architecture: i386', file=f)
 222         else:
 223             print('Architecture: amd64', file=f)
 224         print('Section: debug', file=f)
 225         print('Priority: extra', file=f)
 226         packages('Depends', deb_depends[debian_version], f)
 227         print('Description: debugging symbols for dcpomatic', file=f)
 228         print('  This package contains the debugging symbols for dcpomatic.', file=f)
 229         print('', file=f)
 230
 231 def make_spec(filename, version, target, requires=None):
 232     """Make a .spec file for a RPM build"""
 233     f = open(filename, 'w')
 234     print('Summary:A program that generates Digital Cinema Packages (DCPs) from video and audio files', file=f)
 235     print('Name:dcpomatic2', file=f)
 236     print('Version:%s' % version, file=f)
 237     print('Release:1%{?dist}', file=f)
 238     print('License:GPL', file=f)
 239     print('Group:Applications/Multimedia', file=f)
 240     print('URL:http://dcpomatic.com/', file=f)
 241     if requires is not None:
 242         print('Requires:%s' % requires, file=f)
 243     print('', file=f)
 244     print('%description', file=f)
 245     print('DCP-o-matic generates Digital Cinema Packages (DCPs) from video and audio ', file=f)
 246     print('files (such as those from DVDs or Blu-Rays) for presentation on DCI-compliant ', file=f)
 247     print('digital projectors.', file=f)
 248     print('', file=f)
 249     print('%files', file=f)
 250     print('%{_bindir}/dcpomatic2', file=f)
 251     print('%{_bindir}/dcpomatic2_batch', file=f)
 252     print('%{_bindir}/dcpomatic2_cli', file=f)
 253     print('%{_bindir}/dcpomatic2_create', file=f)
 254     print('%{_bindir}/dcpomatic2_kdm', file=f)
 255     print('%{_bindir}/dcpomatic2_server', file=f)
 256     print('%{_bindir}/dcpomatic2_server_cli', file=f)
 257     print('%{_bindir}/dcpomatic2_kdm_cli', file=f)
 258     print('%{_bindir}/dcpomatic2_player', file=f)
 259     print('%{_datadir}/applications/dcpomatic2.desktop', file=f)
 260     print('%{_datadir}/applications/dcpomatic2_batch.desktop', file=f)
 261     print('%{_datadir}/applications/dcpomatic2_server.desktop', file=f)
 262     print('%{_datadir}/applications/dcpomatic2_kdm.desktop', file=f)
 263     print('%{_datadir}/applications/dcpomatic2_player.desktop', file=f)
 264     print('%{_datadir}/dcpomatic2/dcpomatic2_server_small.png', file=f)
 265     print('%{_datadir}/dcpomatic2/LiberationSans-Regular.ttf', file=f)
 266     print('%{_datadir}/dcpomatic2/LiberationSans-Italic.ttf', file=f)
 267     print('%{_datadir}/dcpomatic2/LiberationSans-Bold.ttf', file=f)
 268     print('%{_datadir}/dcpomatic2/splash.png', file=f)
 269     for r in ['128x128', '16x16', '22x22', '256x256', '32x32', '48x48', '512x512', '64x64']:
 270         print('%%{_datadir}/icons/hicolor/%s/apps/dcpomatic2.png' % r, file=f)
 271         print('%%{_datadir}/icons/hicolor/%s/apps/dcpomatic2_batch.png' % r, file=f)
 272         print('%%{_datadir}/icons/hicolor/%s/apps/dcpomatic2_kdm.png' % r, file=f)
 273         print('%%{_datadir}/icons/hicolor/%s/apps/dcpomatic2_server.png' % r, file=f)
 274         print('%%{_datadir}/icons/hicolor/%s/apps/dcpomatic2_player.png' % r, file=f)
 275     for l in ['de_DE', 'es_ES', 'fr_FR', 'it_IT', 'sv_SE', 'nl_NL', 'ru_RU', 'pl_PL', 'da_DK',
 276               'pt_PT', 'pt_BR', 'sk_SK', 'cs_CZ', 'uk_UA', 'zh_CN', 'ar_LB', 'fi_FI', 'el_GR', 'tr_TR']:
 277         print('%%{_datadir}/locale/%s/LC_MESSAGES/dcpomatic2.mo' % l, file=f)
 278         print('%%{_datadir}/locale/%s/LC_MESSAGES/libdcpomatic2-wx.mo' % l, file=f)
 279         print('%%{_datadir}/locale/%s/LC_MESSAGES/libdcpomatic2.mo' % l, file=f)
 280     print('', file=f)
 281     print('%prep', file=f)
 282     print('rm -rf $RPM_BUILD_DIR/dcpomatic-%s' % version, file=f)
 283     print('tar xjf $RPM_SOURCE_DIR/dcpomatic-%s.tar.bz2' % version, file=f)
 284     print('%build', file=f)
 285     print('cd dcpomatic-%s' % version, file=f)
 286     print('export PKG_CONFIG_PATH=%s/lib/pkgconfig:%s/lib64/pkgconfig:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig' % (target.directory, target.directory), file=f)
 287
 288     print('CXXFLAGS="-I%s/include" LDFLAGS="-L%s/lib" ./waf configure --prefix=%%{buildroot}/usr --install-prefix=/usr %s' %
 289           (target.directory, target.directory, configure_options(target)), file=f)
 290     print('./waf', file=f)
 291     print('%install', file=f)
 292     print('cd dcpomatic-%s' % version, file=f)
 293     print('./waf install', file=f)
 294     print('', file=f)
 295     print('%post', file=f)
 296     print('/bin/touch --no-create %{_datadir}/icons/hicolor &>/dev/null || :', file=f)
 297     print('', file=f)
 298     print('%postun', file=f)
 299     print('if [ $1 -eq 0 ] ; then', file=f)
 300     print('    /bin/touch --no-create %{_datadir}/icons/hicolor &>/dev/null', file=f)
 301     print('    /usr/bin/gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :', file=f)
 302     print('fi', file=f)
 303     print('', file=f)
 304     print('%posttrans', file=f)
 305     print('/usr/bin/gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :', file=f)
 306
 307 def dependencies(target):
 308
 309     if target.platform == 'linux':
 310         ffmpeg_options = { 'shared': False }
 311     else:
 312         ffmpeg_options = {}
 313
 314     return (('ffmpeg-cdist', '5c90508', ffmpeg_options),
 315             ('libdcp', '7b03aba'),
 316             ('libsub', 'b24b081'),
 317             ('rtaudio-cdist', '739969e'))
 318
 319 def configure_options(target):
 320     opt = ''
 321     if target.debug:
 322         opt += ' --enable-debug'
 323     if target.platform == 'windows':
 324         opt += ' --target-windows'
 325     elif target.platform == 'linux':
 326         opt += ' --static-dcpomatic --static-wxwidgets --static-ffmpeg --static-dcp --static-sub --static-cxml'
 327         if target.distro == 'centos':
 328             opt += ' --disable-tests'
 329             if target.version == '6.5':
 330                 opt += ' --static-boost --static-xmlpp'
 331             elif target.version == '7':
 332                 opt += ' --workaround-gssapi'
 333                 # Centos 7 ships with glibmm 2.50.0 which requires C++11
 334                 # but its compiler (gcc 4.8.5) defaults to C++97.  Go figure.
 335                 # I worry that this will cause ABI problems but I don't have
 336                 # a better solution.
 337                 opt += ' --force-cpp11'
 338
 339     if hasattr(target, 'gui') and target.gui == 'no':
 340         opt += ' --disable-gui'
 341
 342     # Build Windows debug versions with static linking as I think gdb works better then
 343     if target.debug and target.platform == 'windows':
 344         opt += ' --static-dcpomatic'
 345
 346     return opt
 347
 348 def build(target, options):
 349     target.command('./waf configure --prefix=%s %s' % (target.directory, configure_options(target)))
 350     target.command('./waf')
 351
 352     if target.platform == 'linux' or target.platform == 'osx':
 353         target.command('./waf install')
 354
 355 def package_windows(target):
 356     identifier = ''
 357     if target.version is not None:
 358         identifier = '%s.' % target.version
 359     identifier += '%d' % target.bits
 360     shutil.copyfile('build/platform/windows/installer.%s.nsi' % identifier, 'build/platform/windows/installer2.%s.nsi' % identifier)
 361     target.command('sed -i "s~%%resources%%~%s/platform/windows~g" build/platform/windows/installer2.%s.nsi' % (os.getcwd(), identifier))
 362     target.command('sed -i "s~%%graphics%%~%s/graphics~g" build/platform/windows/installer2.%s.nsi' % (os.getcwd(), identifier))
 363     target.command('sed -i "s~%%static_deps%%~%s~g" build/platform/windows/installer2.%s.nsi' % (target.windows_prefix, identifier))
 364     target.command('sed -i "s~%%cdist_deps%%~%s~g" build/platform/windows/installer2.%s.nsi' % (target.directory, identifier))
 365     target.command('sed -i "s~%%mingw%%~%s~g" build/platform/windows/installer2.%s.nsi' % (target.mingw_path, identifier))
 366     target.command('sed -i "s~%%binaries%%~%s/build~g" build/platform/windows/installer2.%s.nsi' % (os.getcwd(), identifier))
 367     target.command('sed -i "s~%%bits%%~32~g" build/platform/windows/installer2.%s.nsi' % identifier)
 368     target.command('makensis build/platform/windows/installer2.%s.nsi' % identifier)
 369     return os.path.abspath(glob.glob('build/platform/windows/*%s*.exe' % target.bits)[0])
 370
 371 def package_debian(target, cpu, version):
 372     make_control(target.version, target.bits, 'debian/control', target.debug)
 373     target.command('./waf dist')
 374     f = open('debian/files', 'w')
 375     print('dcpomatic_%s-1_%s.deb video extra' % (version, cpu), file=f)
 376     shutil.rmtree('build/deb', ignore_errors=True)
 377
 378     os.makedirs('build/deb')
 379     os.chdir('build/deb')
 380     shutil.move('../../dcpomatic-%s.tar.bz2' % version, 'dcpomatic_%s.orig.tar.bz2' % version)
 381     target.command('tar xjf dcpomatic_%s.orig.tar.bz2' % version)
 382     os.chdir('dcpomatic-%s' % version)
 383     target.command('dch -b -v %s-1 "New upstream release."' % version)
 384     target.set('CDIST_LINKFLAGS', target.get('LINKFLAGS'))
 385     target.set('CDIST_CXXFLAGS', target.get('CXXFLAGS'))
 386     target.set('CDIST_PKG_CONFIG_PATH', target.get('PKG_CONFIG_PATH'))
 387
 388     target.set('CDIST_CONFIGURE', '"' + configure_options(target) + '"')
 389     if target.debug:
 390         target.set('CDIST_DEBUG_PACKAGE', '--dbg-package=dcpomatic-dbg')
 391     if target.version in ['7', '14.04']:
 392         target.set('CDIST_LOCALE_PREFIX', '/usr/local/share/locale')
 393     else:
 394         target.set('CDIST_LOCALE_PREFIX', '/usr/share/locale')
 395
 396     target.command('dpkg-buildpackage -uc -us')
 397
 398     debs = []
 399     for p in glob.glob('../*.deb'):
 400         debs.append(os.path.abspath(p))
 401
 402     return debs
 403
 404 def package_rpm(target, cpu, version):
 405     print('package_rpm %s %s %s' % (target, cpu, version))
 406     topdir = os.path.realpath('build/rpmbuild')
 407     os.makedirs('%s/BUILD' % topdir)
 408     os.makedirs('%s/RPMS' % topdir)
 409     os.makedirs('%s/SOURCES' % topdir)
 410     os.makedirs('%s/SPECS' % topdir)
 411     os.makedirs('%s/SRPMS' % topdir)
 412
 413     target.command('./waf dist')
 414     shutil.copyfile(
 415         "%s/src/dcpomatic/dcpomatic-%s.tar.bz2" % (target.directory, version),
 416         "%s/SOURCES/dcpomatic-%s.tar.bz2" % (topdir, version)
 417         )
 418
 419     requires = None
 420     if target.distro == 'mageia':
 421         requires = "lib64xmlsec1-devel"
 422
 423     make_spec('build/platform/linux/dcpomatic2.spec', version, target, requires)
 424     cmd = 'rpmbuild --define "_topdir %s" -bb build/platform/linux/dcpomatic2.spec' % topdir
 425     target.command(cmd)
 426     rpms = []
 427
 428     if cpu == "amd64":
 429         cpu = "x86_64"
 430     else:
 431         cpu = "i686"
 432
 433     print('Looking in %s/RPMS/%s/*.rpm' % (topdir, cpu))
 434     for p in glob.glob('%s/RPMS/%s/*.rpm' % (topdir, cpu)):
 435         print('found %s' % p)
 436         rpms.append(os.path.abspath(p))
 437
 438     return rpms
 439
 440 def package(target, version):
 441     if target.platform == 'windows':
 442         return package_windows(target)
 443     elif target.platform == 'linux':
 444         if target.bits == 32:
 445             cpu = 'i386'
 446         else:
 447             cpu = 'amd64'
 448
 449         if target.distro == 'debian' or target.distro == 'ubuntu':
 450             return package_debian(target, cpu, version)
 451         elif target.distro == 'centos' or target.distro == 'fedora' or target.distro == 'mageia':
 452             return package_rpm(target, cpu, version)
 453     elif target.platform == 'osx':
 454         target.command('bash platform/osx/make_dmg.sh %s' % target.directory)
 455         return [os.path.abspath(x) for x in glob.glob('build/platform/osx/DCP-o-matic*.dmg')]
 456     elif target.platform == 'docker':
 457         shutil.copyfile(target.deb, 'build/platform/docker')
 458         f = open('build/platform/docker/Dockerfile', 'w')
 459         print('FROM debian:jessie', file=f)
 460         print('MAINTAINER carl@dcpomatic.com', file=f)
 461         print('ADD build/platform/docker/dcpomatic_%s-1_amd64.deb /tmp' % (version, version), file=f)
 462         print('RUN apt-get -o Acquire:http::Timeout="5" update; exit 0', file=f)
 463         print('RUN dpkg -i /tmp/dcpomatic_*.deb; exit 0', file=f)
 464         print('RUN apt-get -y -f install', file=f)
 465         print('RUN apt-get clean', file=f)
 466         print('EXPOSE 6192', file=f)
 467         print('CMD ["/usr/bin/dcpomatic2_server_cli", "--verbose"]', file=f)
 468         f.close()
 469         target.command('docker build build/platform/docker -t dcpomatic-server:%s' % version)
 470         target.command('docker save dcpomatic-server:%s -o dcpomatic-server-%s-docker.tar' % (version, version))
 471
 472 def make_pot(target):
 473     target.command('./waf pot')
 474     return [os.path.abspath('build/src/lib/libdcpomatic.pot'),
 475             os.path.abspath('build/src/wx/libdcpomatic-wx.pot'),
 476             os.path.abspath('build/src/tools/dcpomatic.pot')]
 477
 478 def make_manual(target):
 479     os.chdir('doc/manual')
 480     target.command('make')
 481     target.command('pdflatex colour.tex')
 482     return [os.path.abspath('pdf'), os.path.abspath('html'), os.path.abspath('colour.pdf')]
 483
 484 def test(target, test):
 485     if target.platform != 'windows':
 486         target.set('LC_ALL', 'C')
 487         cmd = 'run/tests '
 488         if target.debug:
 489             cmd += '--backtrace '
 490         if test is not None:
 491             cmd += '--run_test=%s' % test
 492         target.command(cmd)