1REQUIREMENTS 2------------ 3 4Currently, psh works on any modern Unix system with perl5. It has been 5most extensively tested on GNU/Linux systems with perl 5.005, and also 6works with perl 5.004. Earlier versions of perl will probably cause psh to 7fail. 8 9 10INSTALLING psh 11-------------- 12 13Follow the standard procedure (from the source directory): 14 perl Makefile.PL 15 make 16 17As superuser (if required): 18 make install 19 20Copy pshrc to ~/.pshrc. 21 22Optional: 23Copy share to /usr/share/psh (or /usr/local/share/psh ). 24 25Alternatively, you can copy share to ~/.psh/ or to /psh/ on Windows. 26 27 28WITHOUT root ACCESS 29------------------- 30 31If you don't have root access you'll have to move the files manually. You 32can make your own modules directory and put something like alias 33perl="perl -I~/.pm" in your shell's startup dotfile, and copy the modules 34there. Then copy psh wherever you want it, such as ~/bin. 35 36 37MAKING psh YOUR LOGIN SHELL 38--------------------------- 39 40If you'd like to make psh your login shell, you'll need to change your 41entry in /etc/passwd. Here's an example for a Linux distribution with 42bash: 43 chsh -s `which psh` 44Depending on your setup, you may need to add the full path to psh to 45another file, such as /etc/shells. 46 47It's possible that if you don't have root access, your Unix flavor won't 48allow you to change your login shell. You can try to work around this by 49putting something like 50 exec psh 51in your shell's startup dotfile. Be careful that this file isn't executed 52by a shebang (#!) invocation of the shell, or shell scripts written for 53that shell may mysteriously fail. 54 55SETTING UP A .pshrc FILE 56------------------------ 57 58After starting psh, you can enter the command 59 60 firsttime 61 62to have some help with setting up your first .pshrc file. The firsttime 63command will try to parse your bash and tcsh rc files to gather aliases, 64environment variables and bring them into psh format. 65