Merge branch 'feature/upstream' into develop

1 files changed, 153 insertions, 0 deletions

diff --git a/INSTALL.linux b/INSTALL.linux
new file mode 100644
index 0000000..a851852
--- /dev/null
+++ b/INSTALL.linux
@@ -0,0 +1,153 @@
+Installation Instructions
+*************************
+
+1. Quick install:
+=================
+
+$ ./autogen.sh          # only if you just cloned the git repository
+$ ./configure
+$ make
+$ make install
+
+
+2. Step by step install on Linux >=2.6, with udev:
+==================================================
+
+2.1. Install with your preferred package manager:
+     (a) the development environment for your Linux distibution
+         - mandatory: gcc, make, kernel header files, autoconf, autoconf-archive
+         - optional:  git
+     (b) missing development packages
+         - libusb-dev or libusb-devel or libusb-compat-devel
+         - libjpeg-dev or libjpeg8-dev or libjpeg-turbo-devel or turbojpeg-devel
+         - libpng-dev or similar
+
+2.2. Get the latest SANE backend from git:
+      You can download "daily git snapshot" from here:
+
+      http://www.sane-project.org/snapshots/
+
+      If you prefer to use git, you can fetch a read-only copy of the git tree
+      with this command:
+
+      $ git clone https://gitlab.com/sane-project/backends.git
+
+      If you already are using a self compiled SANE backend and just fetched a
+      new copy of the git tree or if you patched some source files, there is no
+      need to follow the installation procedure again. You only need to make and
+      install libsane:
+
+      $ make && sudo make install
+
+2.3. Configure, make and install latest SANE backend:
+      We install a new SANE dynamically linked shared object library in
+      /usr/local/lib beside your system's SANE library.
+
+      $ ./autogen.sh          # only if you just cloned the git repository
+      $ ./configure
+      $ make && sudo make install
+
+      If you want to change some settings for your SANE installation, please
+      read the documentation on the website, the man pages and:
+
+      $ ./configure --help
+
+      Maybe you don't want to compile all scanners on your system, then you can
+      select the backends you need, e.g. epson2 and fujitsu:
+
+      $ ./configure BACKENDS="epson2 fujitsu"
+
+      You can search for your scanners backend names here:
+
+      http://sane-project.org/lists/sane-backends-cvs.html
+
+2.3.1. SANE library:
+      Register new installed SANE dynamically linked shared object library.
+
+      $ sudo ldconfig -v | grep libsane
+        libsane.so.1 -> libsane.so.1.0.25
+        libsane.so.1 -> libsane.so.1.0.23
+
+      This example shows that the system first find version 1.0.25 and then
+      1.0.23. This is the correct order.
+
+      If your system first find the old version and then the new installed one,
+      then you must change the order for library paths in /etc/ld.so.conf or you
+      must create the new configuration file /etc/ld.so.conf.d/1-sane.conf.
+
+      $ echo "/usr/local/lib" | sudo tee -a /etc/ld.so.conf.d/1-sane.conf
+
+      Then you must repeat this step.
+
+2.3.2. Localization file:
+
+      $ cd /usr/share/locale/<language>/LC_MESSAGES
+      $ sudo ln -sf /usr/local/share/locale/<language>/LC_MESSAGES/sane-backends.mo .
+      $ cd -
+
+2.3.3. udev rules file:
+
+      $ sudo cp tools/udev/libsane.rules /etc/udev/rules.d
+
+      Reconnect your scanner to the USB bus to activate the new rules file.
+
+2.3.4. Use the scanner with normal user rights:
+
+      Your user must be a member of the group scanner.
+
+      $ cat /etc/group | grep scanner
+      scanner:x:107:<user>
+
+      Create a new group scanner, if it doesn't exist.
+
+      $ sudo addgroup scanner
+
+      Add an existing user to group scanner.
+
+      $ sudo adduser <username> scanner
+
+      After this you must logoff and login again.
+
+2.4. Test your scanner:
+
+2.4.1. Check the used backend version:
+
+      The programs must use the installed SANE backend version, e.g. 1.0.25.
+
+      $ scanimage -V
+      scanimage (sane-backends) 1.0.25git; backend version 1.0.25
+
+      This example shows that backend and scanimage are version 1.0.25.
+
+      $ /usr/bin/scanimage -V
+      scanimage (sane-backends) 1.0.23; backend version 1.0.25
+
+      This example shows that an old scanimage (1.0.23) uses the backend 1.0.25.
+
+      If you want to use xsane, start xsane and check the used version with
+      CTRL - i.
+
+2.4.2. Access scanner with normal user rights:
+
+      $ scanimage -L
+
+      If your scanner isn't recognised here, try this:
+
+      $ sudo scanimage -L
+
+      If this works, your user doesn't have the rights to access the scanner.
+
+      However, please check and redo the installation described above.
+      If this doesn't help, you can ask the mailing list
+      <sane-devel@alioth-lists.debian.net> for further support.
+
+2.4.3. Testscan:
+
+      $ cd ~
+      $ scanimage > test.pnm
+
+
+3. Advanced Installation Information
+====================================
+
+      Please read the documents INSTALL, README and README.linux.