Imported Upstream version 0.84upstream/0.84

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)
-
-