[Pkg-cups-devel] Bug#376580: NEWS is hard to read

[Tomas Pospisek]

Package: cupsys
Version: 1.2.1-2
Severity: normal
Tags: patch

Current:

> * The USB backend no longer supports the usb:/dev/foo
>   format on systems that support device ID queries since 1.2.1-1.
>   Because Linux supports device ID queries, you have to
>   replace your printer configuration uses usb:/dev/foo style
>   with device ID style. usb backend will show device IDs of
>   active USB printers.
> * Port/Listen and Browsing parameters are merged again to
>   /etc/cups/cupsd.conf. Therefore debconf configuration interface
>   for them is removed. For your information, CUPS Web interface
>   (http://localhost:631) provides a server configuration interface.

Suggested improvement:

> * The USB backend no longer allows 'usb:/dev/foo' syntax in
>   its configuration under Linux. [1] You'll have to replace it
>   with the new device ID syntax as follows: [2]. Use 'lsusb' to
>   see what device IDs your printers have. [3]
> * The 'Port'/'Listen' parameters have again been merged into
>   the 'Browsing' configuration parameter. Therefore the accompanying
>   debconf configuration interface has been removed. Consider using
>   CUPS' web interface for configuration tasks. [4]

[1] I'd omit "since 1.2.1-1", because the user will only see the NEWS
    entries that are relevant to his upgrade path anyway. Say if he
    updates from 1.2.1-2 to 1.2.1-3 then he won't see the entry twice
    but if she updates from 1.2.1-1 then she will see it.
[2] Unfortunately a moderately quick search didn't tell me how
    USB "device ID"s look like or where they are documented. If there
    isn't any good example on how device IDs look like then saying
    "You'll have to replace it with the new device ID syntax documented
     at [file|http://some.place]documentation.html
[3] I unfortunately didn't understand the phrase "usb backend will show
    device IDs of active USB printers." at all. What do you mean by the
    usb backend"? Maybe 'lsusb'?
[4] As said in [1] when a user will be updating the cupsys package, she
    will see all the NEWS items that apply to the version jump. Thus she
    will be seing the notice, that Port listen have been introduced and
    later a notice that they have been abolished again.
    In order to make updating from sarge to etch less confusing I'd
    suggest to remove the respective NEWS regarding the
    Port/Listen <-> Browsing items before the next stable release.

Thanks,
*t

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable'), (50, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-1-686
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)

Versions of packages cupsys depends on:
ii  adduser                  3.87            Add and remove users and groups
ii  debconf [debconf-2.0]    1.5.2           Debian configuration management sy
ii  gs-esp                   8.15.1.dfsg.1-2 The Ghostscript PostScript interpr
ii  libacl1                  2.2.37-1        Access control list shared library
ii  libc6                    2.3.6-15        GNU C Library: Shared libraries
ii  libcupsimage2            1.2.1-2         Common UNIX Printing System(tm) - 
ii  libcupsys2               1.2.1-2         Common UNIX Printing System(tm) - 
ii  libdbus-1-2              0.62-4          simple interprocess messaging syst
ii  libgnutls13              1.4.0-2         the GNU TLS library - runtime libr
hi  libldap2                 2.1.30-13+b1    OpenLDAP libraries
hi  libpam0g                 0.79-3.1        Pluggable Authentication Modules l
ii  libpaper1                1.1.19          Library for handling paper charact
hi  libslp1                  1.2.1-5         OpenSLP libraries
ii  lsb-base                 3.1-10          Linux Standard Base 3.1 init scrip
ii  patch                    2.5.9-4         Apply a diff file to an original
ii  perl-modules             5.8.8-4         Core Perl modules
hi  procps                   1:3.2.6-2.2     /proc file system utilities
ii  xpdf-utils [poppler-util 3.01-8          Portable Document Format (PDF) sui
ii  zlib1g                   1:1.2.3-11      compression library - runtime

Versions of packages cupsys recommends:
ii  cupsys-client           1.2.1-2          Common UNIX Printing System(tm) - 
ii  foomatic-filters        3.0.2-20060530-1 linuxprinting.org printer support 
ii  smbclient               3.0.22-1         a LanManager-like simple client fo

-- debconf information excluded