==============================================================================
2007/06/01      Release of version 0.4.0 of runpugs/Web::Terminal
==============================================================================

NAME
    runpugs: a web terminal for interactive pugs 
    Web::Terminal: library for building a web terminal for interactive shells

INSTALLATION
    
    * To install, copy all folders to your web root
    (e.g. ~/apache on feather, or /var/www elsewhere)
    Rename html folder if required (e.g. htdocs -> html or public_html)

    * make sure that you installed the following CPAN modules:
    	Carp::Assert 
    	YAML::Syck 
    	Proc::Daemon 
    	Moose 
    	Net::Telnet 
    	IO::Pty
	Config::General
	Perl6::Say
	JSON

    * create a $HOME/.webtermrc configuration file (start from the webtermrc file in the repository)
    * make sure that you change the following settings
    	rel_root	(Release pugs)
    	dev_root	(Development pugs)
    	root		(web root)
    	port		(default 2059; any free TCP port is OK)
    	server		(bin/termserv.pl)
    	
    * Start the terminal server script (bin/termserv.pl) 
    
    * To run, simply point your browser to /runpugs/ 
    
    * Use scripts to start/stop/restart apache on feather and 
    maintain latest runpugs

DESCRIPTION
    runpugs has two main components: 
    -a mod_perl script (/perl/runpugs.pl) which uses an html template
    (/data/runpugs_async.html). The latter calls the runpugs.css stylesheet from
    /htdocs/runpugs.css. The script is called from /htdocs/runpugs/index.html
    -a server (/bin/termserv.pl) which handles the interactive pugs sessions and communicates with
    the mod_perl script. The pugs sessions stay alive for some time (currently 10') if
    left inactive.

    This version has some AJAX goodness and runs under mod_perl.
    The entrypoint is /htdocs/runpugs/index.html, which calls /perl/runpugs.pl

   The underlying library, Web/Terminal, can in principle be used for any
   interactive shell, not just pugs. So we could have runpython :-)
   See the POD for more info.
   
   'scripts' directory has some perl/shell scripts that are being used 
   to run/maintain runpugs on a feather.perl6.nl account. Those has been 
   written originally by wim.

AUTHOR
    Wim Vanderbauwhede (wim.vanderbauwhede@gmail.com)
    Ahmad M. Zawawi (ahmad.zawawi@gmail.com)

COPYRIGHT
    Copyright (c) 2006, Wim Vanderbauwhede. All Rights Reserved. This module is
    free software. It may be used, redistributed and/or modified under the
    terms of the Perl Artistic License (see
    http://www.perl.com/perl/misc/Artistic.html)


==============================================================================
CHANGES IN VERSION 0.4.0
    -Better session management
    -use Moose for Session objects
    -More generic (Settings.pm uses Config::General) 

CHANGES IN VERSION 0.3.0
    -Uses AJAX for persistent interface and mod_perl for speed
    -Sessions are preloaded for fast startup
    -The user interface behaves much more like a terminal.

CHANGES IN VERSION 0.2.0
    -Web/Terminal replaces the original WebTerminal modules. This
    implementation is much more generic and configurable.
    -The user interface is much improved, esp. in the unstable version.

==============================================================================

AVAILABILITY
    Pugs Subversion repository, misc/runpugs

==============================================================================