INTRODUCTION

Term::Shell -- Write command-line shells in Perl.

Term::Shell makes it joyfully easy to write command-line interfaces in Perl.
All the boring details like command-line parsing and terminal handling are
done for you.

Example:

  package MyShell;
  use base qw(Term::Shell);

  # This behaves like the system echo command, minus shell expansion
  sub run_echo {
      my $o = shift;
      print "@_\n" if @_;      # print the arguments
  }

  package main;
  MyShell->new->cmdloop;

Here is a sample session from this program:

  shell> help
  Type 'help command' for more detailed help on a command.
    Commands:
      echo - undocumented - no help available
      exit - exits the program
      help - prints this screen, or help on 'command'
  shell> echo
  shell> echo 1 2 3
  1 2 3
  shell> echo $VAR
  $VAR
  shell> exit

------------------------------------------------------------------------------
INSTALLATION:

This module requires Term::ReadLine to be installed. This module has been a
core module since at least 5.005_03, so it shouldn't be a problem.

This module requires Text::Autoformat for some features. Text::Autoformat can
be found on your nearest CPAN mirror, probably the same place you got
Term::Shell.

To install Term::Shell do this:

perl Makefile.PL
make
make test
make install

(On ActivePerl for MSWin32, use nmake instead of make.)

You have to 'make install' before you can run it successfully.

------------------------------------------------------------------------------
INFORMATION:

- For more information on Term::Shell see 'perldoc Term::Shell'.
- For more information on Term::ReadLine see 'perldoc Term::ReadLine'.
- For more information on Text::Autoformat see 'perldoc Text::Autoformat'.

Please send questions and comments to "Neil Watkiss" <[email protected]>

Copyright (c) 2002, Neil Watkiss. All Rights Reserved.