search.cpan.org is shutting down
For details read Perl NOC. After June 25th this page will redirect to MetaCPAN.org
For details read Perl NOC. After June 25th this page will redirect to MetaCPAN.org
psh - Developing for Perl Shell
Developing for the Perl Shell.
The -d option puts psh into "debugging" mode,
which prints diagnostic output.
Note that you can also enter/leave this debugging mode in a running psh via the $Psh::debugging variable.
Possible values for -d/$Psh::debugging are either 0 to disable it,
1 to enable all debug messages or a string of characters where each character denotes a certain class of debug messages.
s - enables printing of information about the chosen strategy for each commando - enables printing of "other" debug info - info which has not been further categorizedf - enables printing of the rc files read by psh on startup while it is executed and allows easy tracing of problems in these filesi - enables printing of initialization debug infoe - enables printing of otherwise suppressed error messagesc - enables printing of debug messages for completionEven though psh aims to be an interactive shell instead of a scripting environment, speed is important. The main concern here is that startup speed of psh, which is primarily determined by two factors:
The startup time on a normal, not to busy, computer should be smaller than one second. To make this possible, keep some simple rules in mind:
require to use whenever possibleapplies method of evaluation strategies be as fast as possibleOn startup,
psh scans the Psh::Builtins:: namespace and will add the names of all found dynamic loadable builtins to %Psh::built_ins.
During evaluation of an input line,
psh will first check the %Psh::built_ins variable.
If this fails it will try to locate an appropriate built-in function in Psh::Builtins.pm.
A dynamical loadable builtin has to be in a file called Builtinname.pm within the Psh::Builtins:: namespace and has at least one subroutine, called 'bi_builtinname'. Additionally, it may provide a cmpl_builtinname subroutine for a custom completion. Furthermore, a builtin should contain some pod documentation, starting with "=item * " and ending with "=cut". The builtin will be called with 2 arguments, the first one if the rest of the line while the second one is an array to all the words psh discovered.
For a list of the predefined psh builtins, use the "help" command from within psh.
Currently empty due to overhaul of strategies
Copyright (C) 1999-2003 Gregor N. Purdy. All rights reserved. This script is free software. It may be copied or modified according to the same terms as Perl itself.
