ctkDeliver.pl

Description

        This script performs all steps to
        prepare a deliverable version :
                - Adapt user doc text file         user_doc.txt => user_doc.POD
                - Activate user doc text file      user_doc.POD => user_doc.txt (with bak version)
                - zip the user_doc for download:  user_doc-<version>.zip
                - zip the Examples : Examples-<version>.zip
                - update pguide I and II
                - build deliverable
                - build file MANIFEST
                - build the tarball
                - update the local homepage

Prerequisites

                - user_doc.txt has been exported from user_doc.html
                - source has been tested
                   - Examples (list of sample projects)
                   - templates
                   - demo application
                - ./README updated
                - clickTk_readme.txt updated
                - ctk_w.exe has been built
                - user_doc has been updated,
                  saved as user_doc.html and exported into user_doc.txt
                - documents published in the hompage has been updated
                        - homepage/hp*.html
                        - homepage/index.html
                        - doc/diagrams/

Postprocess

                - check tarballs
                - check webpage
                - upload webpage files
                - upload tarball to CPAN

Syntax

                perl ctkDeliver.pl <options>
                whereby <options> may be
                        -d           debug mode
                        -h           help
                        -p           update user doc
                        -v <version> version (mandatory), i.e. 4.11
                        -u           userid

Programming notes

Not all prerequisites are checked.
Processes are started up by means of command system.
STDOUT & STDERR of the processes are not redirected to persistent log file.
Archives are built using winzip program WinZip\WZZIP.exe

buildArchive

        Build a zip archive using the command line version of winzip.
        Arguments
                - folder containing the data to be zipped
                - name of the archive
                - list of file masks (ref to array)
                - prefix of the archive name
        Returns
                return code of the test run of wzunzip
        Note:
                - the archive will be stored into the given folder
                - the file name of the archive will be <prefix>-<name>.zip

Back to index