README
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