Re: Bug#187548: ITP: newpg -- A module that covers GpgSM (S/MIME encryption and key-management) and SCDaemon (for Smartcard access).

[Steve Greenland <steveg@moregruel.net>]

On 04-Apr-03, 08:38 (CST), David B Harris <david@eelf.ddts.net> wrote: 
> And descriptions should be relatively understood by people who have
> almost no idea what the package is for beforehand; if they can't
> eliminate it as a possibility for whatever package they're looking for,
> it's a useless description.

But there's a limit to this: it's okay to describe something as "A Perl
module to perform Fast Fourier Transforms" without defining what FFTs
are, because Debian package descriptions are not math textbooks.

When in doubt, error on the side of verbosity, so that the poor schmuck
can find it with 'apt-cache search [random keyword]'. For example, if I
packaging a FFT library, I'd want both "FFT" and "Fast Fourier" in the
description.

Steve

-- 
Steve Greenland
    The irony is that Bill Gates claims to be making a stable operating
    system and Linus Torvalds claims to be trying to take over the
    world.       -- seen on the net