Bug#711475: useless package description

[Justin B Rye]

Martin Eberhard Schauer wrote:
> for poor package descriptions. In general there was a prompt response with a
> considerably improved text.

Well, I'm usually ready to offer my assistance with wobbly grammar,
but here the problem seems to be a shortage of content.

# Description: Tools for accessing secret store
#  Provides tools for accessing the secret store.

That makes it sound like a case of
"http://tvtropes.org/pmwiki/pmwiki.php/Main/TheLittleShopThatWasntThereYesterday"

The README file is one noun phrase long:
 GObject based library for accessing the Secret Service API.
         
So apparently this might make sense to GNOME developers?  Or perhaps
people in the Secret Service, which would explain a lot.  But wait,
there's a man page in here:

# NAME
#	secret-tool - Store and retrieve passwords
[...]
# DESCRIPTION
#	secret-tool is a command line tool that can be used to store and
#	retrieve passwords.
#
#	Each password is stored in an item. Items are uniquely identified by a
#	set of attribute keys and values. When storing a password you must
#	specify unique pairs of attributes names and values, and when looking
#	up a password you provide the same attribute name and value pairs.
[...]

Er, root login passwords?  Online banking passwords?  There's still a
substantial chunk of basic context missing...

A few minutes googling tells me the "Secret Service API" is a
freedesktop thing based on dbus that's designed to replace KWallet and
GNOME Keyring.

So far, my best guess is that the package description should say
something like:

  Description: tool for storing and retrieving GObject passwords
   This package provides a command line tool using libsecret to access
   the freedesktop.org Secret Service API. This can be used to store
   and retrieve passwords for desktop applications.

I'm still not clear whether this is GNOME-specific or cross-desktop,
though.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package