1 X-BASED OCTAHEDRON
2 ================== Octahedron 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.
30
31 If you have to do any editing to get this to work, please mail me
32 the changes.
33
34HOW TO BUILD?
35
36 An ANSI C compiler is required for build.
37
38 To build, it should be easy. There are 3 choices.
39
40 configure:
41 Relatively new so there is a good possiblity that it is not set up
42 correctly on your system. You may want to set SCOREFILE and DATAFILE
43 in Makefile.in .
44
45 configure ; make
46
47 imake:
48 Sometimes this is not setup correctly by the distributer ... i.e. not
49 my fault. You may want to set SCOREFILE and DATAFILE in Imakefile .
50 If you have Motif you may want to do this quick edit in the Imakefile:
51 Uncomment line "#define XpmLibrary".
52
53 xmkmf ; make
54
55 make.com (VMS users only):
56 You may want to set SCOREFILE and DATAFILE in make.com .
57
58 @make
59
60 Then just run "xoct" (or "xmoct" if you have Motif).
61 If you do a "make install" "SCOREFILE" and "DATAFILE" must be
62 set correctly.
63
64 You should have Oct.ad copied to $(HOME)/Oct or
65 /usr/lib/X11/app-defaults/Oct to run, especially if the background
66 is similar to one of the faces. Edit this file for your preferences.
67 You might want to move xoct into /usr/bin/X11 (or wherever your
68 X binaries are).
69 You might also want to move xoct.man to /usr/man/man6/xoct.6
70
71 Try resizing the octahedron. Notice the puzzle resizes to take
72 advantage of the "room" available.
73
74 If you were looking for a auto-solver, sorry. One of the problems in
75 auto-solvers the generally don't work for different number of cuts.
76 If you know of one let me know.
77
78 Personally, I have solved 1-2 in "Period 3" mode, 1-3 in the
79 "Period 4" mode, 1 in the "Both" mode, and "Sticky" I have not
80 solved it in any mode.
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 [Jun 20, 99] V5.5: Added -rv, fixed flashing on mono, and fixed a
97 potential core dump when window clicked initially with the left mouse
98 button.
99 [Jan 01, 97] V5.4: Username, concurrency check, configure, man page
100 updates.
101 [Apr 08, 96] V5.3: Minor changes.
102 [Jan 31, 96] V5.2: Puzzle can now moved by a more intuitive drag and
103 drop approach. Pieces will invert, when selected.
104 Now using dynamic allocation, so there is no maximum size.
105 [Dec 15, 95] V5.1: Minor updates, RNG for 32/64 bit, border color
106 to make faces look more realistic.
107 [Oct 04, 95] V5.0: Xt/Motif, your choice.
108 [Jun 06, 95] V4.10.1: Warning error fixed.
109 [May 16, 95] V4.10: Warnings removed from Sun's cc and lint and now
110 include a random number generator. More freedom in
111 movement using control+shift.
112 [Mar 13, 95] V4.4: Removed lint warnings and added a VMS make.com .
113 [Oct 11, 94] V4.3: Conservative guess for random number generator.
114 [Oct 07, 94] V4.2: Now allows undos, saves, and recalls.
115 [Jun 28, 94] V4.1: Can accommodate a auto-solver.
116 [Jun 05, 94] V4.0: Xt version.
117 I got some good ideas from oclock.
118 [Apr 01, 93] V3.0: Motif version.
119 I got some good ideas from Douglas A. Young's
120 book: "The X Window System Programming and Applications
121 with Xt OSF/Motif Edition", particularly his dial widget.
122 I got some good ideas on presentation from Q. Zhao's
123 tetris.
124 [Feb 01, 92] V2.0: XView version.
125 [Jun 10, 91] V1.0: SunView version.
126