2000-10-03 Henning Meier-Geinitz <hmg@gmx.de>

* tools/find-scanner.c: Explicitly state that find-scanner won't
 	  find non-SCSI scanners.
	* doc/scanimage.man: Add examples for SANE device names.
	* frontend/scanimage.c: Output message when no devices are found.
	  Add example for devicename to --help message. Print warning
	  when a Unix devicename is used instead of a SANE device. Removed
	  compiler warning.
	* TODO: Removed entries about the fgets and include issues in
 	  umax. Removed entries about scanimage device name
 	  documentation. Added a point about xscanimage problems with the
 	  new GIMP API.
	* backend/mustek.* doc/sane-mustek.man: Update to Mustek backend
 	  1.0-98. Fixed segmentation fault in sane_init. Enabled double
 	  buffering. Clear inquiry buffer before using. Paragon 1200 SP now
 	  uses LD_BLOCK color correction. Removed LD MFS (wasn't used
 	  anymore). Fix sane_cancel for Paragon series II scanners. Fix
 	  halftone and grain for Paragon series II scanners. Backtracking is
 	  used automaticly by all scanners now. Some safety checks, code
 	  cleanup and more debug output. Details are in
	  backend/mustek.CHANGES.

doc/scanimage.man

@@ -1,4 +1,4 @@
-.TH scanimage 1 "29 April 2000"
+.TH scanimage 1 "30 September 2000"
 .IX scanimage
 .SH NAME
 scanimage - scan an image
@@ -35,8 +35,9 @@ The
 .B -d
 or
 .B --device-name
-options must be followed by a SANE device-name.  A (partial) list of
-available devices can be obtained with the
+options must be followed by a SANE device-name like "epson:/dev/sg0" or 
+"hp:/dev/usbscanner0". A (partial) list of available devices can be obtained
+with the
 .B --list-devices
 option (see below).  If no device-name is specified explicitly,
 .B scanimage

frontend/scanimage.c

@@ -101,7 +101,8 @@ sighandler (int signum)
 {
   if (device)
     {
-      fprintf (stderr, "%s: stopping scanner...\n", prog_name);
+      fprintf (stderr, "%s: stopping scanner... (sig %d)\n", prog_name,
+	       signum);
       sane_cancel (device);
     }
 }
@@ -1186,8 +1187,14 @@ main (int argc, char **argv)
 			 device_list[i]->name, device_list[i]->vendor,
 			 device_list[i]->model, device_list[i]->type);
 	      }
-             if (defdevname)
-                  printf ("default device is `%s'\n", defdevname);
+	    if (i == 0)
+	      printf ("\nNo scanners were identified. If you were expecting "
+	        "something different,\ncheck that the scanner is plugged "
+		"in, turned on and detected by the\nfind-scanner tool (if "
+		"appropriate). Please read the documentation which came\n"
+		"with this software (README, FAQ, manpages).\n");
+	    if (defdevname)
+	      printf ("default device is `%s'\n", defdevname);
 
 	    exit (0);
 	  }
@@ -1209,7 +1216,7 @@ standard output.\n\
 \n\
 -b, --batch=FORMAT         working in batch mode\n\
     --format=pnm|tiff      file format of output file\n\
--d, --device-name=DEVICE   use a given scanner device\n\
+-d, --device-name=DEVICE   use a given scanner device (e.g. hp:/dev/scanner)\n\
 -h, --help                 display this help message and exit\n\
 -L, --list-devices         show available scanner devices\n\
 -T, --test                 test backend thoroughly\n\
@@ -1246,6 +1253,14 @@ standard output.\n\
     {
       fprintf (stderr, "%s: open of device %s failed: %s\n",
 	       prog_name, devname, sane_strstatus (status));
+      if (devname[0] == '/')
+	fprintf (stderr, "\nYou seem to have specified a UNIX device name, "
+		 "or filename instead of selecting\nthe SANE scanner or "
+		 "image acquisition device you want to use. As an example,\n"
+		 "you might want \"epson:/dev/sg0\" or "
+		 "\"hp:/dev/usbscanner0\". If any supported\ndevices are "
+		 "installed in your system, you should be able to see a "
+		 "list with\n\"scanimage --list-devices\".\n");
       if (help)
 	device = 0;
       else

tools/find-scanner.c

@@ -412,7 +412,8 @@ main (int argc, char **argv)
   printf (
        "# Note that find-scanner will find any scanner that is connected\n"
        "# to a SCSI bus.  It will even find scanners that are not supported\n"
-       "# at all by SANE.\n\n");
+       "# at all by SANE. It won't find a scanner that is connected to a\n"
+       "# parallel, USB or other non-SCSI port.\n\n");
 
   if (getuid ())
     printf (