summaryrefslogtreecommitdiff
path: root/xsane.PROBLEMS
diff options
context:
space:
mode:
Diffstat (limited to 'xsane.PROBLEMS')
-rw-r--r--xsane.PROBLEMS91
1 files changed, 66 insertions, 25 deletions
diff --git a/xsane.PROBLEMS b/xsane.PROBLEMS
index 65e56e7..d3a7c04 100644
--- a/xsane.PROBLEMS
+++ b/xsane.PROBLEMS
@@ -1,21 +1,63 @@
READ THIS FILE IF YOU EXPERIENCE ANY PROBLEM
- - If you get segmentation faults or unexpected problems:
+ - 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)
- - If you compiled xsane/gtk/glib with the egcs compiler try
- recompiling all with the "normal" gcc compiler (test with gcc -v)!
-
- - If you get an error message that libsane-dll.so.1 is not found, you have to
- tell your system where the SANE-libraries are installed.
- For linux: edit /etc/ld.so.conf and add a line with the path to the
- libraries (normally /usr/local/lib/sane), then call ldconfig.
- THIS MUST BE DONE A ROOT!
- If you use a SuSE linux, edit /etc/ld.so.conf.in instead and call
- SuSEconfig instead of ldconfig.
-
- - The online-help-viewer is now selectable.
+ *** !!! 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.
@@ -34,31 +76,30 @@ READ THIS FILE IF YOU EXPERIENCE ANY PROBLEM
/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!
+ update to gimp-1.0.4 or newer! I suggest to use gimp-1.2.0 or newer.
- If the compilation aborts with
- sanei_wire.c:49: sane/sane.h: No such file or directory
+ ...: 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
-
- - If configure does not find libsane, try
- ./configure --enable-intl-patch
+ or
+ ./configure --disable-nls
- If gtk+ is compiled with NLS/gettext, you have to use the same
- gettext version. So if gtk+ is compiled with gettext in libc
+ 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
+ named gtk?.?-config, make sure environment variable GTK_CONFIG
is set with full path to the config file that shall be used
- - If you get a segmentation fault when opening the preview (or histogram)
- window and your system is IRIX, make sure the default visual is 24-bit
- (edit /usr/lib/X11/xdm/Xservers)
-
-