sokoDan 2.1 =========== (c) Daniel Déchelotte 1999-2002 Released under the GNU GPL. Mail: yo.dan@free.fr Contents -------- - What it is - What it is not - How it gets built/installed - What the future looks like What it is ---------- sokoDan is a solver for sokoban problems. What it is not -------------- sokoDan doesn't allows you to play, nor it has any built-in sokoban levels. It 's just a solver, and you have to provide the problem to solve. How it gets built/installed --------------------------- * For the impatients: tar zxf sokoDan-x.y.tar.gz cd sokoDan-x.y ./configure --with-included-gettext make su make install-strip * Step by step 1_ Get the archive sokoDan-x.y.tar.gz. Where x.y stands for the version number (for instance: 2.0). 2_ Uncompress the archive. You can type the command: tar zxf sokoDan-x.y.tar.gz Under Solaris it seems that you have to use gtar instead of tar: gtar zxf sokoDan-x.y.tar.gz If it still doesn't work, this should: zcat sokoDan-x.y.tar.gz | tar xf - A sokoDan-x.y directory will be created. Move in that folder: cd sokoDan-x.y 3_ Configure the package. That's done using the configure script. This is mandatory since it will generate the Makefiles. There is some generic information about configure that can be found in INSTALL. To support localization but not to worry about it I suggest you type: ./configure --with-included-gettext If you want to use the libraries installed in your system, just type: ./configure For more information about internationalization and gettext, please see ABOUT-NLS. You might want to disable the use of gnome for the graphical user interface. For this simply add "--disable-gnome". For instance: ./configure --with-included-gettext --disable-gnome If gnome is not installed on your system, autoconf may detect it and build the package without gnome. But most likely you will have to explicitly type "--disable-gnome". configure accept many other command-line arguments, for instance to tell it where to find libraries and where to install the package. Type: ./configure --help to see all supported options. 4_ Build the package Type: make It *will* work. 5_ Install the package Unless you 've changed where the package is going to get installed (see Step 3: Configure the package), you have to become root to install the package. Type: su and then the root password. If you are not root (for instance if it's not your own computer), go back to step 3 to ask configure to install the package where you have write permission. For this, use the "--prefix=/some/path" command-line option. Once you are root, type: make install-strip That should be it. What the future looks like (or may look like ;-) -------------------------- Some cool features I would like to add: - "Play" the solution. When a (lengthy) solution has been found, the user has a single click to do and he could watch the solution without having to click to step to the next move. The user could control the speed of that "animation". - Width and Height of the problems are hard-coded. Changing them in ./sokoDan_config.h "only" needs a recompilation, but it would be cool if we could change it during the execution. I will change that later, when a better algorithm is implemented, because for now it's a good way to prevent the user from submitting too large problems. ;-) - An info page. This would be "just for fun" since there is not much to explain, but the main interest of sokoDan is to use the GNU tools, so hopefully I will take the time to write a "dummy" info page. - The possibility to load and save problems.