Bug 244156 - FreeBSD Handbook: Image Scanners: outdated
Summary: FreeBSD Handbook: Image Scanners: outdated
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Marc Fonvieille
URL: https://docs.freebsd.org/en/books/han...
Keywords:
Depends on:
Blocks: handbook-2022
  Show dependency treegraph
 
Reported: 2020-02-16 06:34 UTC by Tobias Kortkamp
Modified: 2023-07-14 12:23 UTC (History)
4 users (show)

See Also:
grahamperrin: maintainer-feedback? (blackend)


Attachments
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 freebsd_triage 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 freebsd_triage 2020-02-17 13:43:05 UTC
Hello,

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.

Marc
Comment 2 Marc Fonvieille freebsd_committer freebsd_triage 2020-03-01 16:39:40 UTC
Created attachment 212078 [details]
First pass
Comment 3 Marc Fonvieille freebsd_committer freebsd_triage 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.

Marc
Comment 4 commit-hook freebsd_committer freebsd_triage 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

Log:
  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>

Changes:
  head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
Comment 5 Pau Amma 2022-04-11 06:18:50 UTC
(In reply to Marc Fonvieille from comment #3)
Do you still plan to add a devd.conf example? (Is one needed in hindsight?)
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2022-12-30 04:04:59 UTC
Triage: 

* numbering has changed, and may change again, so edit the summary line
* status
* flag for feedback
* …
Comment 7 Graham Perrin freebsd_committer freebsd_triage 2022-12-30 11:59:36 UTC
Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …
Comment 8 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-07-14 12:23:26 UTC
Since we upgrade the multimedia chapter in the Handbook working group and we upgrade the scanners section. I'm gonna close this PR.

If there are more improvements we can open a new PR and work with the last version of the Handbook.

Thanks for your work on this.