view roundup/dist/command/build_doc.py @ 4492:5d43b2a5eb69

test that announcement.txt is pure ASCII... ...required at least up to python2.5 by distutils. (Note tht doc/announcement.txt is the *old* announcement from the last release, I've changed it so that setup.py will work for now and to illustrate what needed to be changed).
author Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
date Wed, 20 Apr 2011 13:12:53 +0000
parents bca7c59ac400
children 7b575e1f7368
line wrap: on
line source

#
# Copyright (C) 2009 Stefan Seefeld
# All rights reserved.
# For license terms see the file COPYING.txt.
#

import os, sys
from stat import *
import os.path
from shutil import *
import glob

from distutils.command import build
from distutils.spawn import spawn, find_executable
from distutils.dep_util import newer, newer_group
from distutils.dir_util import copy_tree, remove_tree, mkpath
from distutils.file_util import copy_file
from distutils import sysconfig

class build_doc(build.build):
    """Defines the specific procedure to build roundup's documentation."""

    description = "build documentation"

    def run(self):
        """Run this command, i.e. do the actual document generation."""

        sphinx = find_executable('sphinx-build')
        if not sphinx:
            self.warn("could not find sphinx-build in PATH")
            self.warn("cannot build documentation")
            return

        doc_dir = os.path.join('share', 'doc', 'roundup', 'html')
        temp_dir = os.path.join(self.build_temp, 'doc')
        cmd = [sphinx, '-d', temp_dir, 'doc', doc_dir]
        spawn(cmd)

Roundup Issue Tracker: http://roundup-tracker.org/