Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 147 insertions, 0 deletions

diff --git a/upstream/debian-bookworm/man5/sane-gphoto2.5 b/upstream/debian-bookworm/man5/sane-gphoto2.5
new file mode 100644
index 00000000..7fd16d69
--- /dev/null
+++ b/upstream/debian-bookworm/man5/sane-gphoto2.5
@@ -0,0 +1,147 @@
+.TH sane\-gphoto2 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
+.IX sane\-gphoto2
+.SH NAME
+sane\-gphoto2 \- SANE backend for gphoto2 supported cameras
+.SH DESCRIPTION
+The
+.B sane\-gphoto2
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access to the digital cameras supported by gphoto2.
+This backend has only been tested with a handful of cameras so far.  Patches
+to support other models are welcome.
+.PP
+Because of the limited testing of this backend, it is commented out
+in
+.I /etc/sane.d/dll.conf
+by default.  Either the comment
+character must be removed or the backend must be called explicitly.
+E.g.
+.I "scanimage \-d gphoto2"
+or
+.IR "xscanimage gphoto2" .
+.SH "DEVICE NAMES"
+The current version of the backend only allows one camera to be
+connected.  The device name is always "0".
+.SH CONFIGURATION
+The contents of the
+.I gphoto2.conf
+specify the characteristics of the camera to be used.   Resolutions
+(high resolution, low resolution, and thumbnail size) are
+required since they are needed by the sane frontends, but can't be obtained
+through the gphoto2 interface.  Valid ports and cameras can be obtained
+by
+.I "gphoto2 \-\-list\-cameras"
+and
+.I "gphoto2 \-\-list\-ports".
+.PP
+The
+.B dumpinquiry
+line causes some information about the camera to be printed.
+.PP
+Empty lines and lines starting with a hash mark (#) are
+ignored.  A sample configuration file is shown below:
+.PP
+The
+.B topfolder
+line specifies the "fixed" part of the file path.  For
+example, on the Kodak DC-240, files are stored in the directory
+.IR /DCIM/100DC240.
+The
+.I /DCIM
+portion is constant, but 100DC240 will change and must be read from the camera.
+In this case, the line would read "topfolder=/DCIM"
+.PP
+Some cameras don't implement a file structure and store all pictures
+in the
+.I "/"
+directory.  This is indicated by setting "subdirs=0" with
+"topfolder=/"
+.PP
+.RS
+port=usb:
+.br
+camera=Kodak DC240
+.br
+# this is a comment
+.br
+high_resolution=1280x960
+.br
+low_resolution=640x480
+.br
+thumb_resolution=160x120
+.br
+dumpinquiry
+.RE
+.PP
+.SH FILES
+.TP
+.I /etc/sane.d/gphoto2.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-gphoto2.a
+The static library implementing this backend.
+.TP
+.I /usr/lib/x86_64-linux-gnu/sane/libsane\-gphoto2.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+
+.SH ENVIRONMENT
+.TP
+.B SANE_CONFIG_DIR
+This environment variable specifies the list of directories that may
+contain the configuration file.  On *NIX systems, the directories are
+separated by a colon (`:'), under OS/2, they are separated by a
+semi-colon (`;').  If this variable is not set, the configuration file
+is searched in two default directories: first, the current working
+directory
+.RI ( "." )
+and then in
+.IR /etc/sane.d .
+If the value of the
+environment variable ends with the directory separator character, then
+the default directories are searched after the explicitly specified
+directories.  For example, setting
+.B SANE_CONFIG_DIR
+to "/tmp/config:" would result in directories
+.IR "tmp/config" ,
+.IR "." ,
+and
+.I "/etc/sane.d"
+being searched (in this order).
+.TP
+.B SANE_DEBUG_GPHOTO2
+If the library was compiled with debugging support enabled, this
+environment variable controls the debug level for this backend.
+A value of 128 requests maximally copious debug output; smaller
+levels reduce verbosity.
+.TP
+.B GP_DEBUG
+Set to 1, 2, or 3, to enable various levels of debugging within the
+gphoto2 libraries.
+
+.SH "SEE ALSO"
+.BR sane (7) ,
+.BR scanimage (1) ,
+.BR xscanimage (1) ,
+.BR libgphoto2 (3)
+
+.SH AUTHOR
+Peter S. Fales
+
+.PP
+The manpage was largely copied from the
+.BR sane\-dc210 (5)
+manpage.
+
+.SH BUGS
+Many, no doubt.
+.PP
+More general comments, suggestions, and inquiries about frontends
+or SANE should go to the SANE Developers mailing list
+(see
+.I http://www.sane\-project.org/mailing\-lists.html
+for details).
+You must be subscribed to the list, otherwise your mail won't be
+sent to the subscribers.