1To learn more about peps-2.0, please read the file peps.pdf. 2 3To INSTALL peps-2.0, please read the rest of this file. 4 5There are several prerequisites needed to install peps-2.0. 6 7 1. You need to have a version of Unix, such as FreeBSD. 8 Or you need a Unix clone, such as Linux. 9 Or you need a Unix emulation layer for some other 10 operating system, such as cygwin for MS Windows. 11 12 2. You need to have gzip installed somewhere on your 13 path. If you have (1), you probably already have (2). 14 15 3. You need Ghostscript on your system. It must be 16 on your system before you can install peps-2.0. 17 Just because you have (1) does not automatically 18 mean that you have (3), so check first. 19 20 4. You need a C compiler and make. If you have (1), 21 you probably have (4). 22 23 5. Optionally, if you want xpeps, you will either 24 need X Window and a version of Ghostscript that 25 supports X Window. If you have two versions of 26 Ghostscript, one plain and one for X Window, you 27 will need to make sure that your path leads you to 28 the one for X Window first. You can check it by 29 typing: 30 31 gs -h 32 33 If it shows x11 and x11gray4 among supported devices, 34 you can install xpeps. 35 36If you run a web host service, you should probably only 37install peps and not xpeps on your server, so inexperienced 38customers do not load xpeps by mistake from the their CGI scripts. 39They should install xpeps on their own computers and not use 40it on your web servers. But do install peps on your web server 41and make it available to your customers. 42 43If you wish to install peps somewhere other than the defaults 44specified by the Makefile, simply set the necessary environment 45variables before running make. You can see them in the Makefile. 46 47On most systems, to install just peps, all you need to type is: 48 49 make install clean 50 51If you want both, peps and xpeps, type: 52 53 make install xinstall clean 54 55If you are installing on MS Windows running cygwin, type: 56 57 env BINEXT=.exe make install xinstall clean 58 59Please note it is .exe (dot exe), not just exe. 60 61That accomplished, please check that the correct paths to 62Ghostscript and gzip were compiled. Type: 63 64 peps -d 65 66and 67 68 xpeps -d 69 70If you are installing under MS Windows with cygwin, it makes 71sense to use Windows version of Ghostscript, especially 72for xpeps since you will not need to run X Window to use 73it. If that is what you want, you need to install Ghostscript 74for Windows first (you still need cygwin and gzip). Then you 75will need to run cygwin. You will need to use the Unix-style 76path to your Ghostscript for Windows. And you will need to tell 77peps to use the "display" device of Ghostscript. You only need 78to do that once, before compiling and installing peps and 79xpeps. Now, assuming that your Ghostscript for Windows is in 80/cygdrive/c/gs/gs-8.15/bin, type the following from your 81cygwin prompt: 82 83 84 export GSPATH=/cygdrive/c/gs/gs-8.15/bin/gswin32c.exe 85 export XCOLOR=display 86 export XGRAY=display 87 export XBINDIR=/usr/bin 88 export BINEXT=.exe 89 make install xinstall clean 90 91The disadvantage is that every time you upgrade to a new 92version of Ghostscript and its path changes, you will need 93to reinstall peps and xpeps. The advantage is that you can 94run xpeps directly from Windows without the need to fire up 95X Window first. 96 97A note to Windows users: 98======================== 99 100Yes, you can run peps and xpeps under Windows, but you need 101to install cygwin first. You cannot just compile peps.c 102with Visual C or any other standard C compilers for Windows 103because peps needs standard Unix functionality which they 104do not support. 105 106Of course, you could rewrite peps not to search for the home 107directory, but then you would not get peps' full functionality. 108You can get cygwin and X Window from http://x.cygwin.com/ for free. 109