READ THIS FILE IF YOU EXPERIENCE ANY PROBLEM - there is a html documentation for xsane. If you have problems compiling xsane call netscape xsane-0.??/doc/sane-xsane-doc.html If you can start xsane you can open the online helpfile via the menu help->XSane doc - If you get segmentation faults or unexpected problems (device not found): - make sure there is only one sane version installed before you compile xsane (try as root: $find / -name "*sane*" | less) *** !!! ABOUT 50% OF ALL PROBLEM REPORTS I GET ARE CAUSED !!! *** *** !!! BY MULTIPLE SANE VERSIONS INSTALLED !!! *** - If you used an earlier version of xsane before remove the configuration directory: rm -rf ~/.sane/xsane (you have to enter all configurations again afterwards). - make sure there is only one gtk-config and only one gimp-config file on your system (find / -name "g*-config") or set path to the correct one (./configure --help) - Do not install any self compiled source package over binary packages, in most cases the installation paths are different so the old versions are not overwritten and you may have two versions installed! - If you get an error message that libsane-dll.so.1 or libsane-so.1 is not found, you have to tell your system where the SANE-libraries are installed. - On some systems the library directory "/usr/local/lib" is not searched by the systems dynamic library loader. If SANE is installed in "/usr/local/..." you have to tell your systems dynamic library loader to search in "/usr/local/lib". For linux: add the path "/usr/local/lib" to /etc/ld.so.conf and call ldconfig (as root). - For sane-1.0.1 you have to add a line with the path to the SANE libraries (normally /usr/local/lib/sane) to /etc/ld.so.conf and call ldconfig (as root). For sane-1.0.2 (and later versions) the path to the SANE libs (normally /usr/local/lib/sane) MUST NOT be listed in /etc/ld.so.conf. (don`t mix it with /usr/local/lib that has to be listed in /etc/ld.so.conf). - If all that does not help, make sure that /usr/local/lib/libsane.so.* are symbolic links to /usr/local/lib/sane/libsane-dll.so.* or ./sane/libsane-dll.so.* short explaination: xsane does not search itself for the library libsane.so, that is done by the dynamic library loader of your system. For linux: Edit /etc/ld.so.conf and call ldconfig to tell your dynamic library loader where it shall search for dlls. On other systems this is configured in other ways. Some systems use the environment variable LD_LIBRARY_PATH for additional search paths. When sane is installed in "/usr/local/....." the libraries are placed in "/usr/local/lib/sane/". The path "/usr/local/lib" has to be listed in /etc/ld.so.conf (call ldconfig after changing that file). In /usr/local/lib there are some links "libsane.so*" that point to the subdirectory ./sane to the fitting files "libsane-dll.so*". The libraries that are placed in ..../lib/sane are not accessed by the system´s dynamic library loader also not by xsane directly. These libraries are loaded by sane´s dynamic library loader (sane-dll). - The online-help-viewer is selectable. If you use kde you can enter kdehelp in setup/display. Preselected is netscape with usage of remote commands. On some SuSE systems there only is "Netscape" and no "netscape" in the path, in this case you have to set a symbolic link: ln -s /usr/bin/Netscape /usr/bin/netscape - If you call ./configure a second time, it may be good to call make distclean before that, if that does not work, remove config.cache: rm -f config.cache - If the compilation aborts with /usr/lib/libgimp.so: undefined reference to `g_debug' /usr/lib/libgimp.so: undefined reference to `g_message' /usr/lib/libgimp.so: undefined reference to `g_warning' /usr/lib/libgimp.so: undefined reference to `g_error' update to gimp-1.0.4 or newer! I suggest to use gimp-1.2.0 or newer. - If the compilation aborts with ...: sane/sane.h: No such file or directory you did not install sane-devel.rpm! Get sane-devel.rpm from the site you got sane.rpm and install it! - If make aborts with missing library "-lintl" try make distclean ./configure --with-included-gettext or ./configure --disable-nls - If gtk+ is compiled with NLS/gettext, you have to use the same gettext version for xsane. So if gtk+ is compiled with gettext in libc do NOT compile xsane with included gettext! Otherwise gtk will crash when gtk texts shall be translated. - If you have any problems with gtk/gdk/gimp, please call print-libs. It prints all libs/includes etc. that are relevant for xsane. Make sure that you do not have installed more than one version of each lib! - If you are running BSD and gtk-config is not in your path or is named gtk?.?-config, make sure environment variable GTK_CONFIG is set with full path to the config file that shall be used