NAME
zoid - a modular perl shell
SYNOPSIS
zoid [options] [-] [files]
If no options or files are given the Zoidberg shell is started in interactive mode. Given files are evaluated as source scripts, contents of these files are NOT handled the same way as commands entered in interactive mode. If STDIN is a pipeline input will be evalluated the same as when entered interactively.
DESCRIPTION
Zoidberg provides a modular Perl shell written, configured, and operated entirely in Perl. It aspires to be a fully operational login shell with all the features one normally expects. But it also gives direct access to Perl objects and data structures from the command line, and allows you to run Perl code within the scope of your commandline. Although Zoidberg does not do the language interpreting itself -- it uses perl to do this -- it supplies powerfull language extensions aimed at creating an easy to use interface.
FIXME more technical description (above is just the freshmeat text)
OPTIONS
- -e command, --exec=command
-
Execute a string as interpreted by zoidberg. If non-interactive exits with exit status of command string. Multiple commands may be given to build up a multi-line script. Make sure to use semicolons where you would in a normal multiline script.
- -c command, --command=command
-
Does the same as --exec but this is bound to change.
- -h, --help
- -u, --usage
-
Print a help message and exits.
- -Idir[,dir]
-
The specified directories are prepended to the module search path
@INC. - -i, --interactive
-
Start an interactive shell. This is the default if no other options are supplied.
- -l, --list-conf
-
List general configuration of the installation.
- -V, --version
-
Display version information.
ENVIRONMENT
FIXME
FILES
FIXME
DIAGNOSTICS
Error messages may be issued either by perl or by one any of the modules in use. zoid itself will only complain when the commandline options are wrong. If a fatal error occurs zoid will return a non-zero exit status.
RESTRICTIONS
Source files and command input are NOT interpreted in the same way.
Use -e or -c, do not mix them.
BUGS
Known bugs are listed in the BUGS file, which is included in the source package. Please report bugs through the bug tracker on the Sourceforce project page http://sourceforge.net/projects/zoidberg or mail pardus <pardus@users.sf.net>.
DOCUMENTATION
More elaborate documentation on the Zoidberg shell can be found online at http://zoidberg.sourceforge.net/doc or on your local system, by default it could be found in /usr/local/doc/zoid/. In interactive mode help should be available by entering the command help.
SEE ALSO
perl(1), Zoidberg(3), http://zoidberg.sourceforge.net
AUTHORS
Jaap Karssenberg || Pardus [Larus] <pardus@users.sf.net>
R.L. Zwart, <carl0s@users.sf.net>
COPYRIGHT
Copyright (c) 2002 Jaap G Karssenberg and RL Zwart. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See http://www.perl.com/language/misc/Artistic.html and http://www.gnu.org/copyleft/gpl.html