forked from isislovecruft/discern
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
64 lines (51 loc) · 2.92 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
Installing the DISCERN performance system
=========================================
DISCERN has been compiled and tested on the following platforms:
* Sun Sparc (SunOS 4.1.3), cc/gcc
* IBM RS/6000 (AIX 3.2.5), xlc/gcc
* MIPS Ultrix 4.2A, cc/gcc
If your platform is not one of those listed above, you should still be
able to build it with little effort. In general, you will need MIT
X11R5 and a C compiler (ANSI or K&R). The code is conditionalized so
that it can be compiled with either ANSI C compiler (with prototypes) or
with K&R C compiler. The code has not been tested with other versions of
X windows (X11R6, OpenWindows).
Feedback and suggestions on how to improve the system are welcome.
Building DISCERN
================
If you have xmkmf, type "xmkmf", then type "make". Otherwise, edit
"Makefile.noimake", copy to "makefile", and say "make".
DISCERN uses strcasecmp() which is an extension beyond standard C
libraries. You can get the code for strcasecmp() from NetBSD/FreeBSD
distribution if your system doesn't include one (check at ftp sites near
you or try gatekeeper.dec.com:/pub/BSD/NetBSD/NetBSD-current/src/lib/
libc/string/strcasecmp.c).
Running DISCERN
===============
The distribution includes a number of configuration files and input
command and story files which are used at runtime. Please refer to
"FILES" for description of each of these files, and to "USERDOC" for
detailed instructions on how to run the system.
The X application default file (called "Discern.ad" in the distribution)
should be installed somewhere in a systemwide app-default directory.
The file should be renamed "Discern". You can also install it in your
home directory (or in $XAPPLRESDIR), or make it part of your .Xdefaults.
DISCERN can be run with or without the graphics display. If it fails to
open connection to your X display (or if you have so specified in the
application defaults or the command line), it will fallback to the
terminal mode with just text output. The graphics mode is useful for
debugging and understanding what the network is doing. The terminal mode
is useful when you want to gather performance statistics of DISCERN in
the background over a large data set and do not care to see what is
going on in real time.
DISCERN can be run on a variety of X displays, including gray-scale and
B&W. In most cases, it should come up with a reasonable graphics
defaults without any changes. However, in some cases you may need to
set the resources manually in the application default file. You may want
to replace the colors with black and white if you don't have color; you
may want to use a private colormap if your display has few colors; you
may want to slow down the display if your machine is very fast; and
because the fonts are not scalable in X11R5, you may want to change them
if your display size differs a lot from the default. The resources,
defaults, and possible commandline options that override them are
described in the file "Discern.ad".