1 X-BASED MISSING LINK(tm)
2 ==================== Missing Link X widget, V5.5.2
3
4Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
5Secondary site: ftp://ftp.x.org/contrib/games/puzzles
6Web page: http://www.tux.org/~bagleyd/puzzles.html
7Maintainer: David A. Bagley <bagleyd@tux.org>
8
9 It has been tested on the following platforms:
10 Sun Ultra SunOS 5.6-5.7
11 PC Pentium Linux 2.0.9
12 IBM PowerPC AIX 4.3.1.0
13 HP 898 HP-UX 10.20
14
15 Previous versions tested on:
16 Sun SPARC SunOS 5.5.1 (X11R5 & X11R6)
17 Sun SPARC SunOS 4.1.3
18 PC 486 Linux 1.2.13(*)
19 DEC VAX & ALPHA VMS 6.1
20 HP 3xx & 700 HP-UX 9.01
21
22 * Keypad may not work, since various keycodes may not be defined
23 by default. Check that "KP_1 - KP_9, Home, Up, Prior, Left,
24 Begin, Right, End, Down, Next" are defined towards the end of
25 /usr/lib/X11/etc/xmodmap.std . If not defined
26 cp /usr/lib/X11/etc/xmodmap.std /usr/lib/X11/xinit/.Xmodmap
27 and then motify this or create your own at ${HOME}/.Xmodmap .
28 You should just have to uncomment them (get rid of some '!').
29 This should be done before X is started. Also it may work better
30 with the Num-Lock on.
31
32 If you have to do any editing to get this to work, please mail me
33 the changes.
34
35HOW TO BUILD?
36
37 An ANSI C compiler is required for build.
38
39 To build, it should be easy. There are 3 choices.
40
41 configure:
42 Relatively new so there is a good possiblity that it is not set up
43 correctly on your system. You may want to set SCOREFILE and DATAFILE
44 in Makefile.in .
45
46 configure ; make
47
48 imake:
49 Sometimes this is not setup correctly by the distributer ... i.e. not
50 my fault. You may want to set SCOREFILE and DATAFILE in Imakefile .
51 If you have Motif you may want to do this quick edit in the Imakefile:
52 Uncomment line "#define XpmLibrary".
53
54 xmkmf ; make
55
56 make.com (VMS users only):
57 You may want to set SCOREFILE and DATAFILE in make.com .
58
59 @make
60
61 Then just run "xmlink" (or "xmmlink" if you have Motif).
62 If you do a "make install" "SCOREFILE" and "DATAFILE" must be
63 set correctly.
64
65 You should have Mlink.ad copied to $(HOME)/Mlink or
66 /usr/lib/X11/app-defaults/Mlink to run, especially if the background
67 is similar to one of the faces. Edit this file for your preferences.
68 You might want to move xmlink into /usr/bin/X11 (or wherever your
69 X binaries are).
70 You might also want to move xmlink.man to /usr/man/man6/xmlink.6
71
72 Monochrome users may have to run it with -tile Black or -tile White.
73 or with -fg White or -fg Black. Whatever works for you.
74
75 I chose to display the puzzle horizontally because if I ever decide
76 to implement the auto-solver, it will be easier because the IDEAL
77 solution book shows it that way.
78
79 Keep in mind that Mlink is a widget that can be simply stuck in
80 other X programs. (If you find a use for this, let me know).
81
82 Refer to the man page for detailed command line options.
83
84 If you want further information on puzzles, I'll be glad :-) to send
85 it to you.
86
87FOUND A BUG?
88
89 Send bugs reports and fixes to the author. For bugs, please include
90 as much information as to their location as possible, since I may not
91 have the resources to duplicate the them.
92
93HISTORY
94
95 [Aug 11, 99] V5.5.2: Fixed runtime library problems when using configure.
96 [Jul 31, 99] V5.5.1: Got rid of invisible white links.
97 [Jun 20, 99] V5.5: Added -rv, fixed flashing on mono, added -base
98 [Jan 01, 97] V5.4: Username, concurrency check, configure, man page
99 updates.
100 [Aug 01, 96] V5.3.2: Fixed for default for monochrome.
101 [Apr 08, 96] V5.3: Minor changes. Links are drawn now with the same
102 orientation as the original.
103 [Jan 31, 96] V5.2: Now uses an intuitive drag and drop approach for
104 rotating tiles. Tiles will invert, when selected.
105 Now using dynamic allocation, so there is no maximum size.
106 [Dec 15, 95] V5.1: Minor updates, RNG for 32/64 bit. Better sector
107 drawing algorithm. Border color to make faces look more
108 realistic.
109 [Oct 01, 95] V5.0: Xt/Motif, your choice.
110 [May 16, 95] V4.10: Warnings removed from Sun's cc and lint and now
111 include a random number generator. Bug fixed where
112 xmlink moved correctly but was hard to turn.
113 [Mar 13, 95] V1.4: Removed lint warnings and added a VMS make.com .
114 [Nov 11, 94] V1.3: Conservative guess for random number generator.
115 [Nov 07, 94] V1.2: Now allows undos, saves, and recalls.
116 [Sep 19, 94] V1.1: Initialize bug removed.
117 [Aug 30, 94] V1.0: Xt version.
118