kopia lustrzana https://gitlab.com/sane-project/standard
.editorconfig: trim trailing whitespace
rodzic
8b6aac9839
commit
fdbd803649
|
@ -0,0 +1,14 @@
|
||||||
|
# .editorconfig -- settings for consistent coding style conventions
|
||||||
|
# Copyright (C) 2017 Olaf Meeuwissen
|
||||||
|
#
|
||||||
|
# License: GPL-3.0+
|
||||||
|
|
||||||
|
# Your editor may need a plugin for this configuration to take effect.
|
||||||
|
# See http://editorconfig.org/#download for details.
|
||||||
|
|
||||||
|
root = true ; look no further
|
||||||
|
|
||||||
|
[*]
|
||||||
|
charset = utf-8
|
||||||
|
insert_final_newline = true
|
||||||
|
trim_trailing_whitespace = true
|
6
net.tex
6
net.tex
|
@ -86,7 +86,7 @@ The four primitive types of the SANE standard are encoded as follows:
|
||||||
\code{SANE\_Char} array. The trailing NUL byte is considered part
|
\code{SANE\_Char} array. The trailing NUL byte is considered part
|
||||||
of the array and a \code{NULL} pointer is encoded as a zero-length
|
of the array and a \code{NULL} pointer is encoded as a zero-length
|
||||||
array.
|
array.
|
||||||
|
|
||||||
\item[\code{\defn{SANE\_Handle}}:] A handle is encoded like a word.
|
\item[\code{\defn{SANE\_Handle}}:] A handle is encoded like a word.
|
||||||
The network backend needs to take care of converting these integer
|
The network backend needs to take care of converting these integer
|
||||||
values to the opaque pointer values that are presented to the user
|
values to the opaque pointer values that are presented to the user
|
||||||
|
@ -473,7 +473,7 @@ are no request or reply arguments in this call. As a result of this
|
||||||
call, the connection between the client and the server that was
|
call, the connection between the client and the server that was
|
||||||
established by the \code{SANE\_NET\_INIT} call will be closed.
|
established by the \code{SANE\_NET\_INIT} call will be closed.
|
||||||
|
|
||||||
% Local Variables:
|
% Local Variables:
|
||||||
% mode: latex
|
% mode: latex
|
||||||
% TeX-master: "sane.tex"
|
% TeX-master: "sane.tex"
|
||||||
% End:
|
% End:
|
||||||
|
|
66
sane.tex
66
sane.tex
|
@ -423,7 +423,7 @@ numbers.
|
||||||
frontend/backend pair is compatible. The minor version and the
|
frontend/backend pair is compatible. The minor version and the
|
||||||
build revision are used for informational and bug-fixing purposes
|
build revision are used for informational and bug-fixing purposes
|
||||||
only.
|
only.
|
||||||
|
|
||||||
\item[\code{\defn{SANE\_VERSION\_MAJOR}(\var{vc})}:] This macro returns the
|
\item[\code{\defn{SANE\_VERSION\_MAJOR}(\var{vc})}:] This macro returns the
|
||||||
major version number component of the version code passed in
|
major version number component of the version code passed in
|
||||||
argument \var{vc}.
|
argument \var{vc}.
|
||||||
|
@ -574,7 +574,7 @@ typedef char SANE_Char;
|
||||||
|
|
||||||
Type \code{\defn{SANE\_String}} represents a text string as a sequence
|
Type \code{\defn{SANE\_String}} represents a text string as a sequence
|
||||||
of C \verb|char| values. The end of the sequence is indicated by a
|
of C \verb|char| values. The end of the sequence is indicated by a
|
||||||
\verb|'\0'| (\defn{NUL}) character.
|
\verb|'\0'| (\defn{NUL}) character.
|
||||||
\begin{quote}
|
\begin{quote}
|
||||||
\begin{verbatim}
|
\begin{verbatim}
|
||||||
typedef SANE_Char *SANE_String;
|
typedef SANE_Char *SANE_String;
|
||||||
|
@ -702,20 +702,20 @@ will be expanded as need arises):
|
||||||
\hline
|
\hline
|
||||||
\multicolumn{2}{|c|}{\bf \defn{Vendor Strings}} \\
|
\multicolumn{2}{|c|}{\bf \defn{Vendor Strings}} \\
|
||||||
\hline\hline
|
\hline\hline
|
||||||
\code{AGFA} & \code{Microtek} \\
|
\code{AGFA} & \code{Microtek} \\
|
||||||
\code{Abaton} & \code{Minolta} \\
|
\code{Abaton} & \code{Minolta} \\
|
||||||
\code{Acer} & \code{Mitsubishi} \\
|
\code{Acer} & \code{Mitsubishi} \\
|
||||||
\code{Apple} & \code{Mustek} \\
|
\code{Apple} & \code{Mustek} \\
|
||||||
\code{Artec} & \code{NEC} \\
|
\code{Artec} & \code{NEC} \\
|
||||||
\code{Avision} & \code{Nikon} \\
|
\code{Avision} & \code{Nikon} \\
|
||||||
\code{CANON} & \code{Plustek} \\
|
\code{CANON} & \code{Plustek} \\
|
||||||
\code{Connectix} & \code{Polaroid} \\
|
\code{Connectix} & \code{Polaroid} \\
|
||||||
\code{Epson} & \code{Relisys} \\
|
\code{Epson} & \code{Relisys} \\
|
||||||
\code{Fujitsu} & \code{Ricoh} \\
|
\code{Fujitsu} & \code{Ricoh} \\
|
||||||
\code{Hewlett-Packard} & \code{Sharp} \\
|
\code{Hewlett-Packard} & \code{Sharp} \\
|
||||||
\code{IBM} & \code{Siemens} \\
|
\code{IBM} & \code{Siemens} \\
|
||||||
\code{Kodak} & \code{Tamarack} \\
|
\code{Kodak} & \code{Tamarack} \\
|
||||||
\code{Lexmark} & \code{UMAX} \\
|
\code{Lexmark} & \code{UMAX} \\
|
||||||
\code{Logitech} & \code{Noname} \\
|
\code{Logitech} & \code{Noname} \\
|
||||||
\hline
|
\hline
|
||||||
\end{tabular}
|
\end{tabular}
|
||||||
|
@ -823,29 +823,29 @@ in Table \ref{tab:valuetype}.
|
||||||
\hline\hline
|
\hline\hline
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_BOOL}} & 0 & Option value is of type
|
\code{\defn{SANE\_TYPE\_BOOL}} & 0 & Option value is of type
|
||||||
\verb|SANE_Bool|. \\
|
\verb|SANE_Bool|. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_INT}} & 1 & Option value is of type
|
\code{\defn{SANE\_TYPE\_INT}} & 1 & Option value is of type
|
||||||
\verb|SANE_Int|. \\
|
\verb|SANE_Int|. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_FIXED}}&2 & Option value is of type
|
\code{\defn{SANE\_TYPE\_FIXED}}&2 & Option value is of type
|
||||||
\verb|SANE_Fixed|. \\
|
\verb|SANE_Fixed|. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_STRING}}&3 & Option value is of type
|
\code{\defn{SANE\_TYPE\_STRING}}&3 & Option value is of type
|
||||||
\verb|SANE_String|. \\
|
\verb|SANE_String|. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_BUTTON}} & 4 & An option of this type has no value.
|
\code{\defn{SANE\_TYPE\_BUTTON}} & 4 & An option of this type has no value.
|
||||||
Instead, setting an option of this type has an option-specific
|
Instead, setting an option of this type has an option-specific
|
||||||
side-effect. For example, a button-typed option could be used by a
|
side-effect. For example, a button-typed option could be used by a
|
||||||
backend to provide a means to select default values or to the tell an
|
backend to provide a means to select default values or to the tell an
|
||||||
automatic document feeder to advance to the next sheet of paper. \\
|
automatic document feeder to advance to the next sheet of paper. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_TYPE\_GROUP}} & 5 & An option of this type has no value.
|
\code{\defn{SANE\_TYPE\_GROUP}} & 5 & An option of this type has no value.
|
||||||
This type is used to group logically related options. A group option
|
This type is used to group logically related options. A group option
|
||||||
is in effect up to the point where another group option is encountered
|
is in effect up to the point where another group option is encountered
|
||||||
(or up to the end of the option list, if there are no other group
|
(or up to the end of the option list, if there are no other group
|
||||||
options). For group options, only members \code{title} and
|
options). For group options, only members \code{title} and
|
||||||
\code{type} are valid in the option descriptor. \\
|
\code{type} are valid in the option descriptor. \\
|
||||||
|
|
||||||
\hline
|
\hline
|
||||||
\end{tabular}
|
\end{tabular}
|
||||||
|
@ -945,14 +945,14 @@ capability bitset:
|
||||||
\hline\hline
|
\hline\hline
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_SOFT\_SELECT}} & 1 & The option
|
\code{\defn{SANE\_CAP\_SOFT\_SELECT}} & 1 & The option
|
||||||
value can be set by a call to \code{sane\_con\-trol\_opt\-ion()}.\\
|
value can be set by a call to \code{sane\_con\-trol\_opt\-ion()}.\\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_HARD\_SELECT}} & 2 & The option value can be set by
|
\code{\defn{SANE\_CAP\_HARD\_SELECT}} & 2 & The option value can be set by
|
||||||
user-intervention (e.g., by flipping a switch). The user-interface
|
user-intervention (e.g., by flipping a switch). The user-interface
|
||||||
should prompt the user to execute the appropriate action to set such
|
should prompt the user to execute the appropriate action to set such
|
||||||
an option. This capability is mutually exclusive with
|
an option. This capability is mutually exclusive with
|
||||||
SANE\_CAP\_SOFT\_SELECT (either one of them can be set, but not both
|
SANE\_CAP\_SOFT\_SELECT (either one of them can be set, but not both
|
||||||
simultaneously). \\
|
simultaneously). \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_SOFT\_DETECT}} & 4 & The option
|
\code{\defn{SANE\_CAP\_SOFT\_DETECT}} & 4 & The option
|
||||||
value can be detected by software. If
|
value can be detected by software. If
|
||||||
|
@ -961,23 +961,23 @@ capability bitset:
|
||||||
may or may not be set. If this capability is set but neither
|
may or may not be set. If this capability is set but neither
|
||||||
\code{SANE\_CAP\_SO\-FT\_SEL\-ECT} nor \code{SANE\_CAP\_HA\-RD\_SEL\-ECT}
|
\code{SANE\_CAP\_SO\-FT\_SEL\-ECT} nor \code{SANE\_CAP\_HA\-RD\_SEL\-ECT}
|
||||||
are, then there is no way to control the option. That is, the
|
are, then there is no way to control the option. That is, the
|
||||||
option provides read-out of the current value only. \\
|
option provides read-out of the current value only. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_EMULATED}} & 8 & If set, this capability indicates
|
\code{\defn{SANE\_CAP\_EMULATED}} & 8 & If set, this capability indicates
|
||||||
that an option is not directly supported by the device and is
|
that an option is not directly supported by the device and is
|
||||||
instead emulated in the backend. A sophisticated frontend may
|
instead emulated in the backend. A sophisticated frontend may
|
||||||
elect to use its own (presumably better) emulation in lieu of an emulated
|
elect to use its own (presumably better) emulation in lieu of an emulated
|
||||||
option. \\
|
option. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_AUTOMATIC}} & 16 & If set, this capability indicates
|
\code{\defn{SANE\_CAP\_AUTOMATIC}} & 16 & If set, this capability indicates
|
||||||
that the backend (or the device) is capable to picking a reasonable
|
that the backend (or the device) is capable to picking a reasonable
|
||||||
option value automatically. For such options, it is possible to
|
option value automatically. For such options, it is possible to
|
||||||
select automatic operation by calling \code{sane\_control\_option()}
|
select automatic operation by calling \code{sane\_control\_option()}
|
||||||
with an action value of \code{SANE\_ACTION\_SET\_AUTO}. \\
|
with an action value of \code{SANE\_ACTION\_SET\_AUTO}. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_INACTIVE}} & 32 & If set, this capability indicates
|
\code{\defn{SANE\_CAP\_INACTIVE}} & 32 & If set, this capability indicates
|
||||||
that the option is not currently active (e.g., because it's
|
that the option is not currently active (e.g., because it's
|
||||||
meaningful only if another option is set to some other value). \\
|
meaningful only if another option is set to some other value). \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CAP\_ADVANCED}} & 64 &
|
\code{\defn{SANE\_CAP\_ADVANCED}} & 64 &
|
||||||
If set, this capability indicates that the option should be
|
If set, this capability indicates that the option should be
|
||||||
|
@ -985,7 +985,7 @@ capability bitset:
|
||||||
displays such options in a less conspicuous way than regular options
|
displays such options in a less conspicuous way than regular options
|
||||||
(e.g., a command line interface may list such options last or a
|
(e.g., a command line interface may list such options last or a
|
||||||
graphical interface may make them available in a seperate ``advanced
|
graphical interface may make them available in a seperate ``advanced
|
||||||
settings'' dialog).
|
settings'' dialog).
|
||||||
\\
|
\\
|
||||||
|
|
||||||
\hline
|
\hline
|
||||||
|
@ -1045,7 +1045,7 @@ SANE_Range;
|
||||||
specifies the quantization value. If $l$ is the minimum value, $u$
|
specifies the quantization value. If $l$ is the minimum value, $u$
|
||||||
the maximum value and $q$ the (non-zero) quantization of a range,
|
the maximum value and $q$ the (non-zero) quantization of a range,
|
||||||
then the legal values are $v=k\cdot q+l$ for all non-negative
|
then the legal values are $v=k\cdot q+l$ for all non-negative
|
||||||
integer values of $k$ such that $v<=u$. \\
|
integer values of $k$ such that $v<=u$. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CONSTRAINT\_WORD\_LIST}} & 2 & This constraint is applicable
|
\code{\defn{SANE\_CONSTRAINT\_WORD\_LIST}} & 2 & This constraint is applicable
|
||||||
to integer and fixed-point valued options only. It constrains the
|
to integer and fixed-point valued options only. It constrains the
|
||||||
|
@ -1055,7 +1055,7 @@ SANE_Range;
|
||||||
integer (\verb|SANE_Int|) that specifies the length of the list (not
|
integer (\verb|SANE_Int|) that specifies the length of the list (not
|
||||||
counting the length itself). The remaining elements in the list are
|
counting the length itself). The remaining elements in the list are
|
||||||
interpreted according to the type of the option value
|
interpreted according to the type of the option value
|
||||||
(\verb|SANE_TYPE_INT| or \verb|SANE_TYPE_FIXED|). \\
|
(\verb|SANE_TYPE_INT| or \verb|SANE_TYPE_FIXED|). \\
|
||||||
|
|
||||||
\code{\defn{SANE\_CONSTRAINT\_STRING\_LIST}} & 3 & This constraint is
|
\code{\defn{SANE\_CONSTRAINT\_STRING\_LIST}} & 3 & This constraint is
|
||||||
applicable to string-valued options only. It constrains the option
|
applicable to string-valued options only. It constrains the option
|
||||||
|
@ -1288,7 +1288,7 @@ described in Table~\ref{tab:actions}.
|
||||||
|
|
||||||
\code{\defn{SANE\_ACTION\_SET\_VALUE}} & 1 & Set option value. The
|
\code{\defn{SANE\_ACTION\_SET\_VALUE}} & 1 & Set option value. The
|
||||||
option value passed through argument \code{v} may be modified by the
|
option value passed through argument \code{v} may be modified by the
|
||||||
backend if the value cannot be set exactly. \\
|
backend if the value cannot be set exactly. \\
|
||||||
|
|
||||||
\code{\defn{SANE\_ACTION\_SET\_AUTO}} & 2 & Turn on automatic mode. Backend
|
\code{\defn{SANE\_ACTION\_SET\_AUTO}} & 2 & Turn on automatic mode. Backend
|
||||||
or device will automatically select an appropriate value. This mode
|
or device will automatically select an appropriate value. This mode
|
||||||
|
@ -1862,7 +1862,7 @@ regarding these options:
|
||||||
|
|
||||||
\item A frontend must work properly with any or all of these options
|
\item A frontend must work properly with any or all of these options
|
||||||
missing.
|
missing.
|
||||||
|
|
||||||
\end{itemize}
|
\end{itemize}
|
||||||
|
|
||||||
\input{net.tex}
|
\input{net.tex}
|
||||||
|
|
Ładowanie…
Reference in New Issue