Bug 244156 - Handbook: Stale 7.7 Image Scanners chapter
Summary: Handbook: Stale 7.7 Image Scanners chapter
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Marc Fonvieille
Depends on:
Reported: 2020-02-16 06:34 UTC by Tobias Kortkamp
Modified: 2020-05-07 14:23 UTC (History)
1 user (show)

See Also:

First pass (6.96 KB, patch)
2020-03-01 16:39 UTC, Marc Fonvieille
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Tobias Kortkamp freebsd_committer 2020-02-16 06:34:05 UTC
On the off chance that somebody has time and a USB scanner that is
supported by SANE, please update the Scanner chapter [1] in the
handbook.  It has gotten a little stale.  sane-frontends is
deprecated, recommending the unmaintained xsane might not be
the best idea.  graphics/kooka might be an alternative to xsane.

Advice in "7.7.3 Scanner Permissions" is bad too, because it uses
devfs.rules and assumes that USB device nodes never change.
Permissions change should happen via devd instead based on scanner
vendor/product id.  Somebody has already written a rough outline
about this 10 years ago in sane-backends's pkg-message [2] but it
could use some polishing and IMHO it would be much better to have
it in the Handbook.

Ideally I'd like to completely remove or trim the pkg-message from
sane-backends a lot because I do not think a page long tutorial
belongs there.

[1] https://www.freebsd.org/doc/handbook/scanners.html
[2] https://github.com/freebsd/freebsd-ports/blob/master/graphics/sane-backends/files/pkg-message.in
Comment 1 Marc Fonvieille freebsd_committer 2020-02-17 13:43:05 UTC

I'd like to minimize the mention to frontends, since many people may use a desktop env. coming, I assume, with its own frontend.  Just mentioning both kooka and Xsane (because of Gimp) may be enough.

Regarding permissions,

add path 'usb/*' mode 0660 group usb
add path 'ugen*' mode 0666 group usb

may be better. Then, we can also add an example using devd.

I'm also wondering if we need to keep the part on SCSI.

Comment 2 Marc Fonvieille freebsd_committer 2020-03-01 16:39:40 UTC
Created attachment 212078 [details]
First pass
Comment 3 Marc Fonvieille freebsd_committer 2020-03-01 16:44:13 UTC
Here's my first, incomplete, work.
I updated several things (see the "First pass" patch for more details).
I'm still not sure about devd(8) since it's more complex for the user than just using devfs(8).
See https://people.freebsd.org/~blackend/scanners/scanners.html for a rendered version.

Comment 4 commit-hook freebsd_committer 2020-05-07 14:23:14 UTC
A commit references this bug:

Author: blackend
Date: Thu May  7 14:23:11 UTC 2020
New revision: 54106
URL: https://svnweb.freebsd.org/changeset/doc/54106

  Update Image Scanners section:
  - remove mention to deprecated frontend;
  - update kernel config settings;
  - update devfs(8) part for device nodes permissions.
  Example with devd(8) will be added soon.

  PR:		244156
  Submitted by:	Tobias Kortkamp <tobik@FreeBSD.org>