Next Previous Contents

3. Compiling, Setting Up and Starting xmame/xmess

Note: This section is not a Unix tutorial. You need to know some basic Unix commands to compile and install xmame/xmess.

3.1 Requirements

3.2 Follow these steps to compile xmame/xmess

  1. See compile-notes-section for platform specific compiling information.

  2. Download the xmame/xmess source files archive.

  3. Move the xmame/xmess source files archive to a suitable work directory. When you extract the archive, sub directories will be created under the work directory.

  4. Rename the source files archive so its extension is .gz so gzip doesn't complain. For example, change xmame-0.34b1.1.tgz to xmame-0.34b1.1.tar.gz

  5. Use gzip -d to uncompress the archive. For example, type:

    gzip -d xmame-0.34b1.1.tar.gz

  6. Extract the files with tar. For example, type:

    tar xvf xmame-0.34b1.1.tar

  7. After extracting the archive, change to the subdirectory created by the extraction process. For example, after extracting the xmame- 0.34b1.1.tar archive, a directory named xmame-0.34b1.1 is created. Change to it. This directory is the top of the source tree.

  8. Edit the file makefile.unix and change the settings according to your system. The default makefile.unix is pre configured to run under X11/Linux. Be careful editing this file. If you want to build for multiple display targets you can repeat steps 8 - 11 as many times as wanted, no need todo a make clean.

  9. Compile xmame/xmess by typing: make -f makefile.unix

  10. If the compile fails, report the problem to the author.

  11. To install xmame/xmess, type: make -f makefile.unix install

    *** YOU MAY NEED TO BE root TO PERFORM STEP 11 ***

  12. In your home directory, create a subdirectory called .xmame.

  13. From the top of the source tree, copy the file doc/xmamerc.dist to the ${HOME}/.xmame/xmamerc directory. (For xmess do this for xmessrc)

  14. If desired copy xmamerc.dist to the global xmamerc location as "xmamerc" (For mess copy xmamerc.dist to xmessrc). The global xmamerc location is defined in makefile.unix.

  15. Edit ${HOME}/.xmame/xmamerc to match your preferences. (For xmess edit ${HOME}/.xmess/xmessrc)

  16. Be sure that DISPLAY and PATH enviromment variables are set correctly.

  17. Make sure your ROM images are installed.

  18. Start X-Windows. (Unless you compiled for a different display method in which case you skip this step.)

  19. Start xmame/xmess. For example: /usr/games/xmame.x11 dkong

3.3 If you have problems compiling, installing and starting xmame/xmess...

If all else fails, send email to the current maintainer of the xmame/xmess project. See mail-section for email addresses.


Next Previous Contents