Attachment 212078 Details for Bug 244156 – First pass

[patch] First pass

chapter.diff (text/plain), 6.96 KB, created by Marc Fonvieille on 2020-03-01 16:39:40 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Marc Fonvieille

Created: 2020-03-01 16:39:40 UTC

Size: 6.96 KB

patch

obsolete

>Index: chapter.xml
>===================================================================
>--- chapter.xml	(revision 53937)
>+++ chapter.xml	(working copy)
>@@ -1461,7 +1461,8 @@
>       <programlisting>device usb
> device uhci
> device ohci
>-device ehci</programlisting>
>+device ehci
>+device xhci</programlisting>
> 
>       <para>To determine if the <acronym>USB</acronym> scanner is
> 	detected, plug it in and use <command>dmesg</command> to
>@@ -1524,29 +1525,26 @@
>     <sect2>
>       <title><application>SANE</application> Configuration</title>
> 
>-      <para>The <application>SANE</application> system is split in two
>-	parts: the backends
>-	(<package>graphics/sane-backends</package>) and the frontends
>-	(<package>graphics/sane-frontends</package> or
>-	<package>graphics/xsane</package>).  The backends provide
>-	access to the scanner.  Refer to <link
>+      <para>The <application>SANE</application> system provides the
>+	access to the scanner via backends (<package>graphics/sane-backends</package>).
>+	Refer to <link
> 	  xlink:href="http://www.sane-project.org/sane-supported-devices.html">http://www.sane-project.org/sane-supported-devices.html</link>
>-	to determine which backend supports the scanner.  The
>-	frontends provide the graphical scanning interface.
>-	<package>graphics/sane-frontends</package> installs
>-	<application>xscanimage</application> while
>-	<package>graphics/xsane</package> installs
>-	<application>xsane</application>.</para>
>+	to determine which backend supports the scanner.  A
>+	graphical scanning interface is provided by third party
>+	applications like <application>Kooka</application>
>+	(<package>graphics/kooka</package>) or
>+	<application>XSane</application>
>+	(<package>graphics/xsane</package>).
>+	<application>SANE</application>'s backends are enough to test
>+	the scanner.</para>
> 
>-      <para>To install the two parts from binary packages:</para>
>+      <para>To install the backends from binary package:</para>
> 
>-      <screen>&prompt.root; <userinput>pkg install xsane sane-frontends</userinput></screen>
>+      <screen>&prompt.root; <userinput>pkg install sane-backends</userinput></screen>
> 
>       <para>Alternatively, to install from the Ports Collection</para>
> 
>-      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/sane-frontends</userinput>
>-&prompt.root; <userinput>make install clean</userinput>
>-&prompt.root; <userinput>cd /usr/ports/graphics/xsane</userinput>
>+      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/sane-backends</userinput>
> &prompt.root; <userinput>make install clean</userinput></screen>
> 
>       <para>After installing the
>@@ -1579,12 +1577,13 @@
>       <screen>&prompt.root; <userinput>scanimage -L</userinput>
> device `snapscan:/dev/pass3' is a AGFA SNAPSCAN 600 flatbed scanner
> &prompt.root; <userinput>scanimage -L</userinput>
>-device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner</screen>
>+device 'epson2:libusb:000:002' is a Epson GT-8200 flatbed scanner</screen>
> 
>       <para>In this second example,
>-	<literal>'epson2:libusb:/dev/usb:/dev/ugen0.2'</literal> is
>-	the backend name (<literal>epson2</literal>) and
>-	<literal>/dev/ugen0.2</literal> is the device node used by the
>+	<literal>epson2</literal> is
>+	the backend name and
>+	<literal>libusb:000:002</literal> means
>+	<filename>/dev/ugen0.2</filename> is the device node used by the
> 	scanner.</para>
> 
>       <para>If <command>scanimage</command> is unable to identify the
>@@ -1612,7 +1611,7 @@
> 	with the right backend name and the device node:</para>
> 
>       <screen>&prompt.root; <userinput>scanimage -L</userinput>
>-device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner</screen>
>+device 'epson2:libusb:000:002' is a Epson GT-8200 flatbed scanner</screen>
> 
>       <para>Once <command>scanimage -L</command> sees the scanner, the
> 	configuration is complete and the scanner is now ready to
>@@ -1621,16 +1620,12 @@
>       <para>While <command>scanimage</command> can be used to perform
> 	an image acquisition from the command line, it is often
> 	preferable to use a graphical interface to perform image
>-	scanning.  The <package>graphics/sane-frontends</package>
>-	package or port installs a simple but efficient graphical
>-	interface, <application>xscanimage</application>.</para>
>-
>-      <para>Alternately, <application>xsane</application>, which is
>-	installed with the <package>graphics/xsane</package> package
>-	or port, is another popular graphical scanning frontend.  It
>-	offers advanced features such as various scanning modes, color
>-	correction, and batch scans.  Both of these applications are
>-	usable as a <application>GIMP</application> plugin.</para>
>+	scanning.  Applications like <application>Kooka</application>
>+	or <application>XSane</application> are popular scanning
>+	frontends.  They
>+	offer advanced features such as various scanning modes, color
>+	correction, and batch scans.  <application>XSane</application>
>+	is also usable as a <application>GIMP</application> plugin.</para>
>     </sect2>
> 
>     <sect2>
>@@ -1637,8 +1632,14 @@
>       <title>Scanner Permissions</title>
> 
>       <para>In order to have access to the scanner, a user needs read
>-	and write permissions to the device node used by the scanner.
>-	In the previous example, the <acronym>USB</acronym> scanner
>+	and write permissions to the device node used by the
>+	scanner.  There are several ways to give the user the
>+	permissions.</para>
>+
>+      <sect3>
>+	<title>Using &man.devfs.8;</title>
>+
>+	<para>In the previous example, the <acronym>USB</acronym> scanner
> 	uses the device node <filename>/dev/ugen0.2</filename> which
> 	is really a symlink to the real device node
> 	<filename>/dev/usb/0.2.0</filename>.  The symlink and the
>@@ -1668,6 +1669,27 @@
> add path ugen0.2 mode 0660 group usb
> add path usb/0.2.0 mode 0666 group usb</programlisting>
> 
>+      <note>
>+	<para>It happens the device node changes with the addition or
>+	  removal of devices, so one may want to give access to all
>+	  USB devices using these ruleset instead:</para>
>+
>+	<programlisting>[system=5]
>+add path 'ugen*' mode 0660 group usb
>+add path 'usb/*' mode 0666 group usb</programlisting>
>+      </note>
>+
>+      <para>Refer to &man.devfs.rules.5; for more information about
>+	this file.</para>
>+
>+      <para>Next, enable the ruleset in /etc/rc.conf:</para>
>+
>+      <programlisting>devfs_system_ruleset="system"</programlisting>
>+
>+      <para>And, restart the &man.devfs.8; system:</para>
>+
>+      <screen>&prompt.root; <userinput>service devfs restart</userinput></screen>
>+
>       <para>Finally, add the users to <systemitem
> 	  class="groupname"><replaceable>usb</replaceable></systemitem>
> 	in order to allow access to the scanner:</para>
>@@ -1675,6 +1697,15 @@
>       <screen>&prompt.root; <userinput>pw groupmod usb -m <replaceable>joe</replaceable></userinput></screen>
> 
>       <para>For more details refer to &man.pw.8;.</para>
>+      </sect3>
>+
>+      <sect3>
>+	<title>Using the Device State Change Daemon
>+	  (&man.devd.8;)</title>
>+
>+	<para>To be written...</para>
>+
>+      </sect3>
>     </sect2>
>   </sect1>
> </chapter>

Actions: View | Diff

Attachments on bug 244156: 212078