show printer driver support contacts, status, and unsupported color mode warning

Fixed in trunk. (r406 and r407). The "show non-recommended drivers" part is bug 271286.

Much better now, but still not complete. Not only the functionality indices are needed but also:

 - Is the driver supplied by the manufacturer or a third party?
 - Does the driver have patent issues?
 - Support contacts and support levels for each contact
 - If the printer is color but the driver only BW an appropriate warning

An "Advanced display" button should also reveal (add to the content of the main area, no pop-up window).

- Name of the driver
- Name of the supplier
- max. resolution
- BW/Color
- Driver type
- license name (GPL, MIT, ...)

In addition, the short description should be wrapped and not cut when it is too long, at least in the main area.

The driver name could perhaps even be added to the standard display instead of only to the advanced display.

The license window should have a button to switch to the original English text if a translated text is shown. See

http://openprinting.org/show_license.cgi?driver=splix

and see also the output which you get from the OpenPrinting web API.

This bug was fixed in the package jockey - 0.5~alpha1-0ubuntu3

---------------
jockey (0.5~alpha1-0ubuntu3) intrepid; urgency=low

  * Merge some bug fixes from trunk:
    - Fix search_drivers() to not return unrelated available handlers.
    - Change --search-driver UIs from confirmation dialog to displaying list
      of matches. (One half of LP: #269454)
    - OpenPrintingDriverDB: Show shortdescription and functionality fields.
      (Other half of LP: #269454)
    - Drop a lot of redundant probing from add_driverdb() and search_driver().
    - Build KDE .ui -> python on build time, to avoid runtime uic dependency.
      (LP: #271317)
    - nvidia, fglrx handlers: Remove RgbPath option, it causes X.org to crash.
    - ui.py: Update action button strings according to latest recommendations
      from Matthew Thomas, thanks!
    - ui.py: Properly intercept failure to connect to D-BUS. (LP: #258472)
  * Add python-kde4-dev build dependency, now needed to get pykde4uic.
  * fglrx, nvidia: Uninstall -kernel-source in disable(), thanks Alberto.
    (LP: #251962)
  * jockey/oslib.py, install_package(): Intercept SystemError. (LP: #258713,
    LP: #272146)

 -- Martin Pitt <email address hidden> Mon, 22 Sep 2008 15:39:42 +0200

Reopening as this upload does not add the driver information as I have asked for in the last comment.

Another UI issue:

The window with the list of suitable drivers shows the cryptic device ID, like

printer_deviceid:MFG:Samsung;MDL:ML-1610;DES:;CMD:GDI;

It should better show the human-readable make and model, like:

Samsung ML-1610

Fixed the presentation of the searched device for printers.

Till, some questions:

 - Is the driver supplied by the manufacturer or a third party?
 - Support contacts and support levels for each contact
 - If the printer is color but the driver only BW an appropriate warning

to which fields of the returned data structure do these map?

 - Does the driver have patent issues?

-> that maps to the "patents" field. However, a simple yes/no field is quite uninteresting for the user? I mean, knowing that there are patents doesn't really help him, he needs details? (and most users wouldn't care anyway, as long as it is free software)

E. g. this is what I get for splix:

{'packages': {...}, 'name': 'splix', 'license': 'GPL', 'url': 'http://splix.ap2c.org/', 'recommended': True, 'functionality': {'text': '100', 'lineart': '100', 'photo': '80', 'graphics': '100'}, 'licensetext': '...', 'supplier': 'SpliX project', 'freesoftware': True, 'nonfreesoftware': False, 'shortdescription': 'Driver for Samsung SPL2 (ML-1710, ...) and SPLc (CLP-500, ...) laser printers', 'patents': True}

Except for the patent field (which I have a separate question about above), I make use of all other fields, and I don't see where support contacts, or color/bw warnings are happening?

Needs input from Till. While http://www.linuxfoundation.org/en/OpenPrinting/Database/Query describes the input parameters very well, it says nothing about the output structure.

Removing milestone. The bulk of information and the initial bug is fixed, just some bits are missing now.

Let us take this example (pasted below) for answering your questions:

http://openprinting.org/query.cgi?type=drivers&moreinfo=1&printer=Samsung-ML-1750&onlydriverpackages=1&onlynewestdriverpackages=1&architectures=i386&packagesystem=rpm&lsbversion=3.2&format=xml

I assume you use the XML format. If you use text, please tell me.

Martin Pitt wrote:
> Till, some questions:
>
> - Is the driver supplied by the manufacturer or a third party?

*** 1 ***
<thirdpartysupplied/>

A manufacturer-supplied driver has

<manufacturersupplied/>

here. If none of the two is there, assume a third-party driver.

> - Support contacts and support levels for each contact

*** 2 ***

<supportcontacts>

section. Can have one or more support contacts. They can be "voluntary"
or "commercial".

> - If the printer is color but the driver only BW an appropriate warning
>

Driver supports color if it has

<color/>

field in the

<functionality>

section.

I found out now that I have totally forgotten to add the info about
whether a printer is color or not to the printer entries. You could at
least add the info whether the driver is color or bw to the driver list
entry for now.

> to which fields of the returned data structure do these map?
>
> - Does the driver have patent issues?
>
> -> that maps to the "patents" field. However, a simple yes/no field is
> quite uninteresting for the user? I mean, knowing that there are patents
> doesn't really help him, he needs details? (and most users wouldn't care
> anyway, as long as it is free software)
>

The details have to be put into the license text field. See the SpliX
driver.

    Till

<drivers>
<driver id="driver/gutenprint52">
<name>gutenprint52</name>
<url>http://gimp-print.sourceforge.net/</url>
<supplier>Gutenprint project</supplier>
<thirdpartysupplied/> *** 1 ***
<license>GPL</license>
<freesoftware/>
<supportcontacts>
<supportcontact level="voluntary"
url="https://lists.sourceforge.net/lists/listinfo/gimp-print-devel">Gutenprint
mailing list at SourceForge</supportcontact>
</supportcontacts> *** 2 ***
<shortdescription>

    Top Quality Printer Drivers for inkjets, dye sublimation printers,
    and PCL lasers<br>

    (<b>Development snapshot, not for daily use!</b>)

</shortdescription>
<execution>
<cups/>
</execution>
<functionality>
<color/>
<text>90</text>
<lineart>90</lineart>
<graphics>100</graphics>
<photo>100</photo>
<speed>60</speed>
</functionality>
<packages>
<i486>
<package file="gutenprint-5.2.0-0.beta4.0lsb3.2.i486.rpm">
<url>
http://www.openprinting.org/download/printdriver/RPMS/i486/gutenprint-5.2.0-0.beta4.0lsb3.2.i486.rpm
</url>
<realversion>5.2.0beta4</realversion>
<version>5.2.0</version>
<release>0.beta4.0</release>
<lsbver>3.2</lsbver>
<sortindex>5.2.0_0.beta4.0_3.2</sortindex>
<text>5.2.0beta4 (RPM for LSB 3.2)</text>
<arch>i486</arch>
<pkgsys>rpm</pkgsys>
<scope>general</scope>
<repositories>
<yum>
[openprinting-gutenprint52-driver]
name=OpenPrinting LSB-3.2-based driver packages of "gutenprint52"
baseurl=http://www.openprinting.org/download/printdriver/components/lsb3.2/gutenprint52/RPMS
enabled=1
gpgcheck=0
</yum>
<zypper>
zypper sa
http://ww...

Thanks, Till. It seems that python-cupshelpers does not actually export these fields (it uses the XML output, BTW). So we first need to fix cupshelpers to export the fields, then I can use them in Jockey.

In particular, those are missing:

 - thirdpartysupplied
 - manufacturersupplied
 - supportcontacts

pitti, can you report an upstream bug on system-config-printer (https://fedorahosted.org/system-config-printer). These are more or less the most important fields which I have added to the Foomatic entries so that the user can decide on the drivers.

I have created a patch for /usr/share/python-support/python-cupshelpers/cupshelpers/openprinting.py (file belongs to the system-config-printer source package) now which makes python-cupshelpers exporting the missing fields. The patch is attached. Apply it and implement the support for these fields then.

I will apply it to the Ubuntu package of s-c-p and upstream.

pitti, you do not need to report an upstream bug on s-c-p any more, I have applied the patch upstream now.

I have also applied the patch to the Ubuntu package of s-c-p now. As we are in beta freeze I cannot simply upload it. Therefore I am attaching the debdiff against the current Intrepid package.

I have uploaded s-c-p now. It is waiting in the beta freeze review queue.

This bug was fixed in the package system-config-printer - 1.0.5+git20080819-0ubuntu3

---------------
system-config-printer (1.0.5+git20080819-0ubuntu3) intrepid; urgency=low

  * debian/patches/openprinting-query-missingfields.patch:
    Added some missing fields to the data structure for queried printer
    driver records (LP: #269454).

 -- Till Kamppeter <email address hidden> Thu, 25 Sep 2008 22:20:26 +0200

To get a feeling how the driver info presented to the user should look like, see my implementation in the PostScript PPD download function of system-config-printer.

Get system-config-printer 1.0.5+git20080819-0ubuntu4, install and start it (take its source package from Launchpad if it did not arrive on the mirrors yet).

Click "New Printer", select an arbitrary detected printer, click "Forward", on the next page choose"Search for a printer driver to download", as "Make and Model" search term enter "HP LaserJet 3390", click "Search" and the "Forward" again. This brings you to the download screen for the PPD file for the HP LaserJet 3390. The info which Jockey should show about a downloadable printer driver package should be at least this one.

Added support contacts, supplier, and status to http://bazaar.launchpad.net/~jockey-hackers/jockey/trunk/revision/480 . I did not add a particular "unsupported color" warning, as Till says it's not yet implemented in the driver DB. However, the driver description already gives the support level of B/W and color, so the user can already see it.

http://bazaar.launchpad.net/~jockey-hackers/jockey/trunk/revision/480

This bug was fixed in the package jockey - 0.5~beta2-0ubuntu2

---------------
jockey (0.5~beta2-0ubuntu2) intrepid; urgency=low

  * Merge bug fixes from trunk:
    - openprinting.org detected handlers: Add supplier and support contacts to
      long description. (LP: #269454)
    - backend.py, set_enabled(): Report progress signals early when handling
      packages, to avoid delays until package manager sends out the first
      progress. (LP: #279073)
  * data/handlers/fglrx.py: Enable driver again, current version works now.
    Also add "Recommends: fglrx-modaliases", so that detection works in a
    default installation. (LP: #262819)

 -- Martin Pitt <email address hidden> Wed, 15 Oct 2008 00:10:53 +0200

Fixed in upstream 0.5 beta 3.