[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: printing-howto.xml

[Jan Kundrat (jkt)]

jkt         11/02/14 06:33:07

  Modified:             printing-howto.xml
  Log:
  #35466, update of the hplip section by billie@g.o

Revision  Changes    Path
1.81                 xml/htdocs/doc/en/printing-howto.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/printing-howto.xml?rev=1.81&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/printing-howto.xml?rev=1.81&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/printing-howto.xml?r1=1.80&r2=1.81

Index: printing-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/printing-howto.xml,v
retrieving revision 1.80
retrieving revision 1.81
diff -u -r1.80 -r1.81
--- printing-howto.xml	10 Sep 2010 04:35:54 -0000	1.80
+++ printing-howto.xml	14 Feb 2011 06:33:07 -0000	1.81
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/printing-howto.xml,v 1.80 2010/09/10 04:35:54 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/printing-howto.xml,v 1.81 2011/02/14 06:33:07 jkt Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide>
@@ -22,8 +22,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>3.6</version>
-<date>2010-03-17</date>
+<version>4</version>
+<date>2011-02-14</date>
 
 <chapter>
 <title>Printing and Gentoo Linux</title>
@@ -781,7 +781,7 @@
 
 <ul>
   <li><uri link="#gutenprint">Gutenprint Driver</uri></li>
-  <li><uri link="#hplip">HPLIP Driver</uri> (deprecates HPOJ and HPIJS)</li>
+  <li><uri link="#hplip">HPLIP Driver</uri></li>
   <li><uri link="#pnm2ppa">PNM2PPA Driver</uri></li>
 </ul>
 
@@ -824,31 +824,50 @@
 The <uri link="http://hplipopensource.com/hplip-web/index.html">HPLIP
 Project</uri> uses the hpcups printer driver. It also includes scanner and fax
 support and service tools for various multi-purpose peripherals. For printing
-support, it is recomended to use the new hpcups driver, which you can enable
+support, it is recommended to use the new hpcups driver, which you can enable
 with the <c>hpcups</c> USE flag. The old hpijs driver is still included when you
-build <c>hplip</c> with the <c>hpijs</c> USE flag.
+build <c>net-print/hplip</c> with the <c>hpijs</c> USE flag.
 </p>
 
 <p>
-The default install enables dynamically generated ppd files at runtime. Some old
+The default install enables dynamically generated ppd files at runtime. Some
 printers may still require static ppd files. If you encounter problems when
 using <c>hp-setup</c> try enabling the <c>static-ppds</c> USE flag and
-rebuilding <c>hplip</c>.
+rebuild <c>net-print/hplip</c>.
+</p>
+
+<p>
+For USB printers <c>net-print/cups</c> has to be built with the <c>usb</c> USE
+flag. This way it makes use of the <c>dev-libs/libusb</c> user space tool which
+replaces kernel usb printer support (CONFIG_USB_PRINTER). In case of problems
+you can disable the <c>usb</c> USE flag for <c>net-print/cups</c> and activate
+the kernel functionality again. All users who need to access the printer have
+to be a member of the <c>lp</c> group.
+</p>
+
+<p>
+To be able to set up a network printer <c>net-print/cups</c> has to be built
+with USE <c>slp</c>. With recent versions of <c>net-print/hplip</c> the default
+lookup method for networked printers is mDNS which requires
+<c>net-print/cups</c> to be built with USE <c>zeroconf</c>. (Note: this method
+does not work with the upcoming <c>net-print/cups-1.4</c> series). To be able
+to print on a network printer <c>net-print/hplip</c> needs to be built with USE
+<c>snmp</c>.
 </p>
 
 <pre caption="Installing the hplip drivers">
 # <i>emerge -vp hplip</i>
 These are the packages that would be merged, in order:
 
-Calculating dependencies... done!
-[ebuild  N    ] net-print/hplip-3.9.12  USE="gtk hpcups qt4 -doc -fax -hpijs 
--libnotify -minimal -new-hpcups -parport -policykit -scanner -snmp -static-ppds
--udev-acl" 20,871 kB 
+Calculating dependencies            ... done!
+[ebuild  N    ] net-print/hplip-3.10.9  USE="X hpcups hpijs libnotify qt4 udev-acl
+-doc -fax -kde -minimal -parport -policykit -scanner -snmp -static-ppds" 21,307 kB
 
-Total: 1 package (1 new), Size of downloads: 20,871 kB
+Total: 1 package (1 new), Size of downloads: 21,307 kB
 
 # <i>emerge hplip</i>
-<comment>(Make sure your USB printer is plugged into your computer)</comment>
+<comment>(Make sure your USB printer is plugged into your computer or your network
+printer into the network socket.)</comment>
 # <i>hp-setup</i>
 # <i>/etc/init.d/cupsd restart</i>
 </pre>
@@ -856,7 +875,9 @@
 <p>
 When the emerge process has finished, the <c>hp-setup</c> tool will attempt to
 detect and install the printer drivers for your printer on the system. Once
-finished, your printer will be available in the CUPS configuration.
+finished, your printer will be available in the CUPS configuration. When
+upgrading <c>net-print/hplip</c> you should run <c>hp-setup -r</c> to remove
+all printers and configure them again. 
 </p>
 
 </body>