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