Yadex $VERSION ($SOURCE_DATE)

Troubleshooting

While compiling

Compilation fails (errors during "make")

The most common causes are  :

You don't have GNU make.

If you type "make --version", you should see something that starts with "GNU Make version something". Otherwise, you don't have GNU make. Installing GNU make is not very difficult. Fetch the archive make-version.tar.gz from ftp.gnu.org, extract its contents, type "./configure; make; su -c 'make install'" and you're set. Don't worry, this is not going to overwrite your old make program. The new make program is installed as /usr/bin/local/make. Use that to compile and install Yadex.

"cc/c++: command not found"

You don't have a C or C++ compiler. You could install EGCS or GCC (they're free).

"-lX11: no such file or directory"

The linker can't find the X11 libraries. Make sure that you have one or more files named "libX11*" on your system and that they are in /usr/X11R6/lib. If they're somewhere else, try typing "make X11LIBDIR=/somewhere/else" instead.

"no space left on device".

Your disk is full :-).

Something else

Mail me the output of "make showconf", the command you ran and the error messages you got.

While installing

Installation fails (errors during "make install")

The most common causes are :

"permission denied".

You don't have the necessary rights to copy the files to the installation directories. Either try logging in as root and running "make install" again or specifying another target directory.

"no space left on device".

Your disk is full :-).

Something else

Mail me the output of "make showconf", the command you ran and the error messages you got.

While running

Error message "Can't open ".../doom2.wad" (No such file or directory)"

Yadex can't find your Doom II iwad. Either :

• copy it or symlink it to /usr/local/share/games/doom2/doom2.wad or
• change the iwad2= parameter in /usr/local/etc/yadex.cfg.

Error message "invalid option: "-something""

Yadex wants a space between options and their argument. For example, "yadex -g doom" is okay, "yadex -gdoom" isn't.

The display lags behind when I drag objects or scroll

Yes. Yadex takes too much time to redraw its window. This kill be fixed in another release. In the meantime, you can try to :

• run Yadex with the -P option (but you'll get more flicker),
• use a smaller window ,
• use a lesser screen depth, such as 8 BPP,
• keep the grid step large or disable the grid completely,
• use more powerful hardware.

The window has turned black !

Don't panic. This is a known bug, and a totally harmless one. Yadex is not crashed or hung. It just didn't realize that its window has been erased and needs to be redrawn. It still accepts input, though the display might look funny. If that disturbs you, you can back out by pressing [Esc], several times if necessary, and everything will return to normal.

If your problem is not listed here, you might have found a bug. Read on how to report bugs there.

If the suggested remedies don't fix your problem, see there how to get help.