summaryrefslogtreecommitdiff
path: root/include/sane
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2021-02-16 18:25:42 +0100
committerJörg Frings-Fürst <debian@jff-webhosting.net>2021-02-16 18:25:42 +0100
commit64ddd1a4dfcefd11f662f5cf4bb05b590d901a97 (patch)
tree4303648095deff998ae20c2393b56db527742ac9 /include/sane
parent5793a221e112fa49073de0137d6bfa750a61b0a1 (diff)
parentecaaf250cb33ff61f37a7b441f2337584a655350 (diff)
Merge branch 'feature/upstream' into develop
Diffstat (limited to 'include/sane')
-rw-r--r--include/sane/sane.h2
-rw-r--r--include/sane/sanei.h8
-rw-r--r--include/sane/sanei_ab306.h4
-rw-r--r--include/sane/sanei_access.h6
-rw-r--r--include/sane/sanei_auth.h4
-rw-r--r--include/sane/sanei_codec_ascii.h4
-rw-r--r--include/sane/sanei_codec_bin.h4
-rw-r--r--include/sane/sanei_config.h8
-rw-r--r--include/sane/sanei_ir.h14
-rw-r--r--include/sane/sanei_lm983x.h6
-rw-r--r--include/sane/sanei_magic.h4
-rw-r--r--include/sane/sanei_pa4s2.h6
-rw-r--r--include/sane/sanei_pio.h4
-rw-r--r--include/sane/sanei_pp.h6
-rw-r--r--include/sane/sanei_pv8630.h4
-rw-r--r--include/sane/sanei_scsi.h18
-rw-r--r--include/sane/sanei_thread.h10
-rw-r--r--include/sane/sanei_usb.h53
-rw-r--r--include/sane/sanei_wire.h4
-rw-r--r--include/sane/saneopts.h12
20 files changed, 93 insertions, 88 deletions
diff --git a/include/sane/sane.h b/include/sane/sane.h
index 9f8bc7c..494ee89 100644
--- a/include/sane/sane.h
+++ b/include/sane/sane.h
@@ -70,7 +70,7 @@ typedef enum
}
SANE_Status;
-/* following are for later sane version, older frontends wont support */
+/* following are for later sane version, older frontends won't support */
#if 0
#define SANE_STATUS_WARMING_UP 12 /* lamp not ready, please retry */
#define SANE_STATUS_HW_LOCKED 13 /* scanner mechanism locked for transport */
diff --git a/include/sane/sanei.h b/include/sane/sanei.h
index 7513d22..6f83776 100644
--- a/include/sane/sanei.h
+++ b/include/sane/sanei.h
@@ -15,8 +15,8 @@
License for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -118,7 +118,7 @@ extern "C" {
* @return
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_INVAL - if the value doesn't fit inside the constraint
- * or any other error occured
+ * or any other error occurred
* @sa sanei_constrain_value()
*/
@@ -135,7 +135,7 @@ extern "C" {
* @return
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_INVAL - if the function wasn't able to fit value into the
- * constraint or any other error occured
+ * constraint or any other error occurred
* @sa sanei_check_value()
*/
diff --git a/include/sane/sanei_ab306.h b/include/sane/sanei_ab306.h
index dacfd84..97885c5 100644
--- a/include/sane/sanei_ab306.h
+++ b/include/sane/sanei_ab306.h
@@ -13,9 +13,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_access.h b/include/sane/sanei_access.h
index 0f73f5f..36aef7f 100644
--- a/include/sane/sanei_access.h
+++ b/include/sane/sanei_access.h
@@ -15,9 +15,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -45,7 +43,7 @@
/** @file sanei_access.h
* Interface file for the sanei_access functions.
*
- * The idea is to provide some simple locking/unlocking mecanism, which
+ * The idea is to provide some simple locking/unlocking mechanism, which
* can be used to protect device access from more than one frontend
* simultaneously.
*/
diff --git a/include/sane/sanei_auth.h b/include/sane/sanei_auth.h
index 37c8d1f..64b0c7d 100644
--- a/include/sane/sanei_auth.h
+++ b/include/sane/sanei_auth.h
@@ -13,9 +13,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_codec_ascii.h b/include/sane/sanei_codec_ascii.h
index 991499a..52bf88f 100644
--- a/include/sane/sanei_codec_ascii.h
+++ b/include/sane/sanei_codec_ascii.h
@@ -13,8 +13,8 @@
for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_codec_bin.h b/include/sane/sanei_codec_bin.h
index ba17bac..ff196da 100644
--- a/include/sane/sanei_codec_bin.h
+++ b/include/sane/sanei_codec_bin.h
@@ -13,8 +13,8 @@
for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_config.h b/include/sane/sanei_config.h
index 3a60167..ed2de6f 100644
--- a/include/sane/sanei_config.h
+++ b/include/sane/sanei_config.h
@@ -13,9 +13,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -166,7 +164,9 @@ typedef struct
extern SANE_Status sanei_configure_attach (
const char *config_file,
SANEI_Config *config,
- SANE_Status (*config_attach)(SANEI_Config *config, const char *devname)
+ SANE_Status (*config_attach)(SANEI_Config *config, const char *devname,
+ void *data),
+ void *data
);
/** Return the list of config directories, extracted from the SANE_CONFIG_DIR
diff --git a/include/sane/sanei_ir.h b/include/sane/sanei_ir.h
index bbfd6d5..da70f40 100644
--- a/include/sane/sanei_ir.h
+++ b/include/sane/sanei_ir.h
@@ -12,7 +12,7 @@
* - 2) find the dirt
* - 3) replace the dirt
*
- * - 1) is mainly adressed by sanei_ir_spectral_clean
+ * - 1) is mainly addressed by sanei_ir_spectral_clean
* - 2) by sanei_ir_filter_madmean
* - 3) by sanei_ir_dilate_mean
*/
@@ -185,7 +185,7 @@ sanei_ir_to_8bit (SANE_Parameters * params, const SANE_Uint *in_img,
* @brief Allocate and initialize logarithmic lookup table
*
* @param[in] len length of table, usually 1 << depth
- * @param[out] lut_ln adress of pointer to allocated table
+ * @param[out] lut_ln address of pointer to allocated table
*
* @return
* - SANE_STATUS_GOOD - success
@@ -208,9 +208,9 @@ SANE_Status sanei_ir_ln_table (int len, double **lut_ln);
* - SANE_STATUS_GOOD - success
* - SANE_STATUS_NO_MEM - if out of memory
*
- * This routine is based on the observation that the relation beween the infrared value
+ * This routine is based on the observation that the relation between the infrared value
* ired and the red value red of an image point can be described by ired = b + a * ln (red).
- * First points are randomly sampled to calculate the linear regression coefficent a.
+ * First points are randomly sampled to calculate the linear regression coefficient a.
* Then ired' = ired - a * ln (red) is calculated for each pixel. Finally, the ir' image
* is scaled between 0 and maximal value. For the logarithms a lookup table is used.
* Negative films show very little spectral overlap but positive film usually has to be
@@ -255,8 +255,8 @@ sanei_ir_filter_mean (const SANE_Parameters * params,
* @param[in] in_img pointer to grey scale image
* @param[out] out_img address of pointer to newly allocated binary image
* @param[in] win_size Size of filtering window
- * @param[in] a_val Parameter, below is definetly clean
- * @param[in] b_val Parameter, above is definetly noisy
+ * @param[in] a_val Parameter, below is definitely clean
+ * @param[in] b_val Parameter, above is definitely noisy
*
* @return
* - SANE_STATUS_GOOD - success
@@ -267,7 +267,7 @@ sanei_ir_filter_mean (const SANE_Parameters * params,
* The dirty pixels which we wish to remove are always darker than the real signal. But
* at high resolutions the scanner may generate some noise and the ired cleaning step can
* reverse things. So a maximum filter will not do.
- * The second median is replaced by a mean filter to reduce computation time. Inspite of
+ * The second median is replaced by a mean filter to reduce computation time. In spite of
* these changes Crnojevic's recommendations for the choice of the parameters "a" and "b"
* are still valid when scaled to the color depth.
*
diff --git a/include/sane/sanei_lm983x.h b/include/sane/sanei_lm983x.h
index 8b48e65..9c075fd 100644
--- a/include/sane/sanei_lm983x.h
+++ b/include/sane/sanei_lm983x.h
@@ -16,9 +16,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -141,7 +139,7 @@ extern SANE_Status sanei_lm983x_read( SANE_Int fd, SANE_Byte reg,
*
* @param fd - device file descriptor
* @return
- * - SANE_TRUE - reset successfuly done
+ * - SANE_TRUE - reset successfully done
* - SANE_FALSE - reset failed
*/
extern SANE_Bool sanei_lm983x_reset( SANE_Int fd );
diff --git a/include/sane/sanei_magic.h b/include/sane/sanei_magic.h
index 297becd..c7ec83c 100644
--- a/include/sane/sanei_magic.h
+++ b/include/sane/sanei_magic.h
@@ -15,8 +15,8 @@
License for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_pa4s2.h b/include/sane/sanei_pa4s2.h
index 7138ceb..591ddd8 100644
--- a/include/sane/sanei_pa4s2.h
+++ b/include/sane/sanei_pa4s2.h
@@ -13,9 +13,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -54,7 +52,7 @@
/** @name Options to control interface operations */
/* @{ */
#define SANEI_PA4S2_OPT_DEFAULT 0 /* normal mode */
-#define SANEI_PA4S2_OPT_TRY_MODE_UNI 1 /* enable UNI protocoll */
+#define SANEI_PA4S2_OPT_TRY_MODE_UNI 1 /* enable UNI protocol */
#define SANEI_PA4S2_OPT_ALT_LOCK 2 /* use alternative lock cmd */
#define SANEI_PA4S2_OPT_NO_EPP 4 /* do not try to use EPP */
/* @} */
diff --git a/include/sane/sanei_pio.h b/include/sane/sanei_pio.h
index afdfa26..ec1f3de 100644
--- a/include/sane/sanei_pio.h
+++ b/include/sane/sanei_pio.h
@@ -14,9 +14,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_pp.h b/include/sane/sanei_pp.h
index 902fcfa..3fe8e0d 100644
--- a/include/sane/sanei_pp.h
+++ b/include/sane/sanei_pp.h
@@ -13,9 +13,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -161,7 +159,7 @@ extern SANE_Byte sanei_pp_inb_ctrl( int fd );
extern SANE_Byte sanei_pp_inb_epp ( int fd );
/** Delay execution for some micro-seconds.
- * Please not, that the accuracy highly depends on your system architechture
+ * Please note, that the accuracy highly depends on your system architecture
* and the time to delay. It is internally implemented as system calls to
* gettimeofday().
*
diff --git a/include/sane/sanei_pv8630.h b/include/sane/sanei_pv8630.h
index d69a024..c3bdece 100644
--- a/include/sane/sanei_pv8630.h
+++ b/include/sane/sanei_pv8630.h
@@ -17,9 +17,7 @@
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/sanei_scsi.h b/include/sane/sanei_scsi.h
index fa6e5d1..d9e0f8a 100644
--- a/include/sane/sanei_scsi.h
+++ b/include/sane/sanei_scsi.h
@@ -13,8 +13,8 @@
License for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -113,7 +113,7 @@ extern void sanei_scsi_find_devices (const char *vendor, const char *model,
* - SANE_STATUS_ACCESS_DENIED - if the file couldn't be accessed due to
* permissions
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if the filename was invalid or an unknown error occured
+ * - SANE_STATUS_INVAL - if the filename was invalid or an unknown error occurred
*
* @sa sanei_scsi_open_extended(), HAVE_SANEI_SCSI_OPEN_EXTENDED
*/
@@ -144,7 +144,7 @@ extern SANE_Status sanei_scsi_open (const char * device_name, int * fd,
* - SANE_STATUS_ACCESS_DENIED - if the file couldn't be accessed due to
* permissions
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if the filename was invalid or an unknown error occured
+ * - SANE_STATUS_INVAL - if the filename was invalid or an unknown error occurred
*
* @sa sanei_scsi_open(), HAVE_SANEI_SCSI_OPEN_EXTENDED
*/
@@ -186,7 +186,7 @@ extern SANE_Status sanei_scsi_open_extended (
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_IO_ERROR - if an error was received from the SCSI driver
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if a locking or an unknown error occured
+ * - SANE_STATUS_INVAL - if a locking or an unknown error occurred
* @sa sanei_scsi_req_enter2()
*
*/
@@ -200,7 +200,7 @@ extern SANE_Status sanei_scsi_req_enter (int fd,
* Same as sanei_scsi_req_enter(), but with separate buffers for the SCSI
* command and for the data to be sent to the device.
*
- * With sanei_scsi_req_enter(), the length of te SCSI command block must be
+ * With sanei_scsi_req_enter(), the length of the SCSI command block must be
* guessed. While that works in most cases, Canon scanners for example use the
* vendor specific commands 0xd4, 0xd5 and 0xd6. The Canon scanners want to
* get 6 byte command blocks for these commands, but sanei_scsi_req_enter() and
@@ -224,7 +224,7 @@ extern SANE_Status sanei_scsi_req_enter (int fd,
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_IO_ERROR - if an error was received from the SCSI driver
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if a locking or an unknown error occured
+ * - SANE_STATUS_INVAL - if a locking or an unknown error occurred
* @sa sanei_scsi_req_enter()
*/
extern SANE_Status sanei_scsi_req_enter2 (int fd,
@@ -264,7 +264,7 @@ extern SANE_Status sanei_scsi_req_wait (void *id);
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_IO_ERROR - if an error was received from the SCSI driver
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if a locking or an unknown error occured
+ * - SANE_STATUS_INVAL - if a locking or an unknown error occurred
*
* @sa sanei_scsi_cmd2(), sanei_scsi_req_enter(), sanei_scsi_req_wait()
*/
@@ -291,7 +291,7 @@ extern SANE_Status sanei_scsi_cmd (int fd,
* - SANE_STATUS_GOOD - on success
* - SANE_STATUS_IO_ERROR - if an error was received from the SCSI driver
* - SANE_STATUS_NO_MEM - if malloc failed (not enough memory)
- * - SANE_STATUS_INVAL - if a locking or an unknown error occured
+ * - SANE_STATUS_INVAL - if a locking or an unknown error occurred
*
* @sa sanei_scsi_cmd(), sanei_scsi_req_enter(), sanei_scsi_req_wait()
*/
diff --git a/include/sane/sanei_thread.h b/include/sane/sanei_thread.h
index 6e68964..72fd8fd 100644
--- a/include/sane/sanei_thread.h
+++ b/include/sane/sanei_thread.h
@@ -15,8 +15,8 @@
for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -101,7 +101,7 @@ extern SANE_Bool sanei_thread_is_valid (SANE_Pid pid);
*
* @note
* When using pthreads, this only works for those implementations
- * that opted to make pthread_t an arithmatic type. This is *not*
+ * that opted to make pthread_t an arithmetic type. This is *not*
* required by the POSIX threads specification. The choice to do
* SANE_Pid invalidation by means of a macro rather than a proper
* function circumvents to need to pass a pointer.
@@ -150,7 +150,7 @@ extern SANE_Pid sanei_thread_begin (int (*func) (void *args), void *args);
*
* @return
* - 0 on success
- * - any other value if an error occured while terminating the task
+ * - any other value if an error occurred while terminating the task
*/
extern int sanei_thread_kill (SANE_Pid pid);
@@ -165,7 +165,7 @@ extern int sanei_thread_kill (SANE_Pid pid);
*
* @return
* - 0 - on success
- * - any other value - if an error occured while sending the signal
+ * - any other value - if an error occurred while sending the signal
*/
extern int sanei_thread_sendsig (SANE_Pid pid, int sig);
diff --git a/include/sane/sanei_usb.h b/include/sane/sanei_usb.h
index 1c1699d..81032db 100644
--- a/include/sane/sanei_usb.h
+++ b/include/sane/sanei_usb.h
@@ -16,8 +16,8 @@
License for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -186,7 +186,7 @@ struct sanei_usb_dev_descriptor
must be called before sanei_usb_init().
The sanei_usb subsystem also implements a "development mode". It modifies
- the XML data file with the actual commands of the test run and attemps to
+ the XML data file with the actual commands of the test run and attempts to
proceed testing until a mismatching input command is found for which
input data is required.
@@ -224,6 +224,19 @@ extern SANE_String sanei_usb_testing_get_backend();
*/
extern SANE_Bool sanei_usb_is_replay_mode_enabled();
+/** Clears currently recorded data.
+
+ This is useful on certain backends to clear the currently recorded data if it relates to
+ other devices than the one that the scan will be performed on. On these backends all
+ devices that the backend supports are opened multiple times. Recording this interaction
+ to XML file makes it impossible to replay it, as the existence of these devices is not mocked
+ currently.
+
+ This function may only be called when no USB devices are open, otherwise the behavior is
+ unpredictable.
+ */
+extern void sanei_usb_testing_record_clear();
+
/** Records a debug message in the captured USB data if testing mode is enabled. If testing mode
* is not enabled, this function does nothing.
*
@@ -246,7 +259,7 @@ extern void sanei_usb_exit (void);
/** Search for USB devices.
*
- * Search USB busses for scanner devices.
+ * Search USB buses for scanner devices.
*/
extern void sanei_usb_scan_devices (void);
@@ -390,9 +403,9 @@ extern SANE_Status sanei_usb_reset (SANE_Int dn);
* @param size size of the data
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -409,8 +422,8 @@ sanei_usb_read_bulk (SANE_Int dn, SANE_Byte * buffer, size_t * size);
* @param size size of the data
*
* @return
- * - SANE_STATUS_GOOD - on succes
- * - SANE_STATUS_IO_ERROR - if an error occured during the write
+ * - SANE_STATUS_GOOD - on success
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the write
* - SANE_STATUS_INVAL - on every other error
*/
extern SANE_Status
@@ -418,7 +431,7 @@ sanei_usb_write_bulk (SANE_Int dn, const SANE_Byte * buffer, size_t * size);
/** Send/receive a control message to/from a USB device.
*
- * This function is only supported for libusb devices and kernel acces with
+ * This function is only supported for libusb devices and kernel access with
* Linux 2.4.13 and newer.
* For a detailed explanation of the parameters, have a look at the USB
* specification at the <a href="http://www.usb.org/developers/docs/">
@@ -455,9 +468,9 @@ sanei_usb_control_msg (SANE_Int dn, SANE_Int rtype, SANE_Int req,
* @param size size of the data
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -493,9 +506,9 @@ sanei_usb_attach_matching_devices (const char *name,
* @param configuration, configuration nummber
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -511,9 +524,9 @@ sanei_usb_set_configuration (SANE_Int dn, SANE_Int configuration);
* @param interface_number interface number
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -529,9 +542,9 @@ sanei_usb_claim_interface (SANE_Int dn, SANE_Int interface_number);
* @param interface_number interface number
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -547,9 +560,9 @@ sanei_usb_release_interface (SANE_Int dn, SANE_Int interface_number);
* @param alternate, alternate nummber
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_EOF - if zero bytes have been read
- * - SANE_STATUS_IO_ERROR - if an error occured during the read
+ * - SANE_STATUS_IO_ERROR - if an error occurred during the read
* - SANE_STATUS_INVAL - on every other error
*
*/
@@ -566,7 +579,7 @@ sanei_usb_set_altinterface (SANE_Int dn, SANE_Int alternate);
* @param desc where to put the information to
*
* @return
- * - SANE_STATUS_GOOD - on succes
+ * - SANE_STATUS_GOOD - on success
* - SANE_STATUS_UNSUPPORTED - if the feature is not supported by the OS or
* SANE.
* - SANE_STATUS_INVAL - on every other error
diff --git a/include/sane/sanei_wire.h b/include/sane/sanei_wire.h
index 679814e..9698c4b 100644
--- a/include/sane/sanei_wire.h
+++ b/include/sane/sanei_wire.h
@@ -13,8 +13,8 @@
License for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
diff --git a/include/sane/saneopts.h b/include/sane/saneopts.h
index 4a4b8cc..7c5933c 100644
--- a/include/sane/saneopts.h
+++ b/include/sane/saneopts.h
@@ -13,8 +13,8 @@
for more details.
You should have received a copy of the GNU General Public License
- along with sane; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with sane; see the file COPYING.
+ If not, see <https://www.gnu.org/licenses/>.
As a special exception, the authors of SANE give permission for
additional uses of the libraries contained in this release of SANE.
@@ -140,6 +140,8 @@
#define SANE_NAME_SCAN_LAMP_DEN "scan-lamp-density"
#define SANE_NAME_SELECT_LAMP_DENSITY "select-lamp-density"
#define SANE_NAME_LAMP_OFF_AT_EXIT "lamp-off-at-exit"
+#define SANE_NAME_FOCUS "focus"
+#define SANE_NAME_AUTOFOCUS "autofocus"
/* well known options from 'SENSORS' group*/
#define SANE_NAME_SCAN "scan"
@@ -229,6 +231,8 @@
#define SANE_TITLE_SCAN_LAMP_DEN SANE_I18N("Scan lamp density")
#define SANE_TITLE_SELECT_LAMP_DENSITY SANE_I18N("Set lamp density")
#define SANE_TITLE_LAMP_OFF_AT_EXIT SANE_I18N("Lamp off at exit")
+#define SANE_TITLE_FOCUS SANE_I18N("Focus position")
+#define SANE_TITLE_AUTOFOCUS SANE_I18N("Autofocus")
/* well known options from 'SENSORS' group*/
#define SANE_TITLE_SCAN "Scan button"
@@ -439,6 +443,10 @@ SANE_I18N("Define lamp density for scan")
SANE_I18N("Enable selection of lamp density")
#define SANE_DESC_LAMP_OFF_AT_EXIT \
SANE_I18N("Turn off lamp when program exits")
+#define SANE_DESC_FOCUS \
+SANE_I18N("Focus position for manual focus")
+#define SANE_DESC_AUTOFOCUS \
+SANE_I18N("Perform autofocus before scan")
/* well known options from 'SENSORS' group*/
#define SANE_DESC_SCAN SANE_I18N("Scan button")