SYNOPSIS

       build-twiki-kernel.pl [options] [-tempdir] [-outputdir] [-outfile]
       [-agent]

       Copyright 2004, 2005 Will Norris and Sven Dowideit. All Rights Reserved.

        Options:
          -tempdir [.]         where all temporary files for this build are placed
          -outfile             final output filename (defaults to TWikiKernel-SVNBRANCH-SVNREV.tar.gz)
          -outputdir [.]       location of outfile
          -changelog           automatically generate CHANGELOG from SVN (requires xsltproc)
          -tar                 generate .tar.gz output file (disable with -notar)
          -zip                 generate .zip output file (disable with -nozip)
          -agent [$Config->{agent}]    LWP::UserAgent name (used for downloading some documentation from wiki pages on twiki.org)
          -pdoc                process source code using Pdoc to produce html in twiki/doc/ (autodetects if Pdoc installed)
          -gendocs             process source code using the equivalent of TWiki:Plugins.PerlPodPlugin
          -verbose
          -debug
          -help                        this documentation
          -man                         full docs

DESCRIPTION

       build-twiki-kernel.pl will build a TWikiKernel release file base suit-
       able for creating a TWikiRelease/TWikiDistribution

       The TWikiKernel is comprised of several subsystems:
           * CgiScripts - fulfils requests from the web. Primarily through the
       ViewCgiScript
           * AuthenticationSubSystem - authenticates users and bestows privi-
       leges
           * ParsePipeline - interprets what's typed in forms and topics and
       converts into Topics, Forms, MetaData and Attachments
           * StorageSubSystem - arranges for data to be stored, currently in
       RcsFormat
           * RenderingPipeline - displays WikiML Topics, Forms, MetaData and
       Attachments as HTML
           * SearchSubsystem - fulfils searches

       Notably the TWikiKernel does not include any TWikiExtensions (e.g. Plu-
       gins or Skins); they are bundled into a particular TWikiRelease (or
       TWikiDistribution).

note that the existing terminology is used, and will need to be revisited when terminology is finalised.

-- WillNorris - 14 Apr 2005

sample build session:

su - twikibuilder
cd $TWIKIDEV/$BRANCH
svn update
cd $TWIKIDEV/$BRANCH/tools/distro
./build-twiki-kernel.pl --notar --outputdir=$TWIKIDEV/twikiplugins/lib/TWiki/Contrib/TWikiInstallerContrib/downloads/releases/

-- WillNorris - 23 Apr 2005