Merge branch 'feature/upstream' into develop

1 files changed, 27 insertions, 16 deletions

diff --git a/doc/sane-kodak.man b/doc/sane-kodak.man
index 61ea88e..9b89c2b 100644
--- a/doc/sane-kodak.man
+++ b/doc/sane-kodak.man
@@ -16,7 +16,8 @@ This document describes backend version 7, which shipped with SANE 1.0.21.
 This version should support models which speak the Kodak SCSI and Firewire
 protocols. The i1860 was used to develop the backend, but other models may
 work with only minimal modifications. Please see the list at
-http://www.sane\-project.org/sane\-supported\-devices.html for an updated list.
+.I http://www.sane\-project.org/sane\-supported\-devices.html
+for an updated list.
 
 If you have a machine not on that list, or reported as 'untested': the best way
 to determine level of support is to test the scanner directly, or to collect a
@@ -31,42 +32,47 @@ may be supported by another backend.
 .SH OPTIONS
 Effort has been made to expose the basic hardware options, including:
 .PP
-source s
+.B --source s
 .RS
 Selects the source for the scan. Options
 may include "Flatbed", "ADF Front", "ADF Back", "ADF Duplex".
 .RE
 .PP
-mode m
+.B --mode m
 .RS
 Selects the mode for the scan. Options
 may include "Lineart", "Halftone", "Gray", and "Color".
 .RE
 .PP
-resolution
+.B --resolution
 .RS
 Controls scan resolution. Available choices may be limited by mode.
 .RE
 .PP
-tl\-x, tl\-y, br\-x, br\-y
+.BR --tl\-x ", " --tl\-y ", " --br\-x ", "  --br\-y
 .RS
 Sets scan area upper left and lower right coordinates. These are renamed
-t, l, x, y by some frontends.
+.BR -t ", " -l ", " -x ", " -y
+by some frontends.
 .RE
 .PP
-page\-width, page\-height
+.BR --page\-width ", " --page\-height
 .RS
 Sets paper size. Used by scanner to determine centering of scan
 coordinates when using ADF and to detect double feed errors.
 .RE
 .PP
 Other options will be available based on the capabilities of the scanner.
-Use 'scanimage \-\-help' to get a list, but be aware that some options may
+Use
+.I scanimage \-\-help
+to get a list, but be aware that some options may
 be settable only when another option has been set, and that advanced options
 may be hidden by some frontend programs.
 .PP
 .SH CONFIGURATION FILE
-The configuration file "kodak.conf" is used to tell the backend how to look
+The configuration file
+.I kodak.conf
+is used to tell the backend how to look
 for scanners, and provide options controlling the operation of the backend.
 This file is read each time the frontend asks the backend for a list
 of scanners, generally only when the frontend starts. If the configuration
@@ -77,7 +83,7 @@ Scanners can be specified in the configuration file in 2 ways:
 .PP
 "scsi KODAK"
 .RS
-Requests backend to search all scsi busses in the system for a device
+Requests backend to search all scsi buses in the system for a device
 which reports itself to be a scanner made by 'KODAK'.
 .RE
 .PP
@@ -104,8 +110,9 @@ warned.
 .PP
 
 .SH ENVIRONMENT
-The backend uses a single environment variable, SANE_DEBUG_KODAK, which
-enables debugging output to stderr. Valid values are:
+The backend uses a single environment variable,
+.BR SANE_DEBUG_KODAK ,
+which enables debugging output to stderr. Valid values are:
 .PP
 .RS
 5  Errors
@@ -130,13 +137,17 @@ endorser, iThresholding, multi\-stream, etc.
 .PP
 
 .SH CREDITS
-The various authors of the sane\-fujitsu backend provided useful code.
+The various authors of the
+.BR sane\-fujitsu (5)
+backend provided useful code.
 .br
 Kodak provided access to hardware, documentation and personnel.
 
 .SH "SEE ALSO"
-sane(7),
-sane\-scsi(5)
+.BR sane (7),
+.BR sane\-scsi (5),
+.BR scanimage (1)
 
 .SH AUTHOR
-m. allan noah: <kitno455 a t gmail d o t com>
+m. allan noah:
+.RI < "kitno455 a t gmail d o t com" >