Package: trash-cli
Version: 0.1.10.28-1
Severity: minor
This package is a classic case of "nice program, a shame about the
documentation". In particular:
1) The package description needs work:
# Description: Command line trashcan utility
# Command line interface trashcan freedesktop.org specs compliant. For each
# trashed file remember name, original path, date of deletion, and
# permissions.
# .
# Designed to interoperate with KDE Trash.
The short description isn't bad (though DevRef says package synopses
should not be capitalised); the long description is gobbledigook. I
think what you were aiming at was something like:
Description: command line trashcan utility
This package provides a command line interface trashcan utility
compliant with the FreeDesktop.org Trash Specification. It remembers
the name, original path, deletion date, and permissions of each trashed
file, and is designed to interoperate with KDE Trash.
(Does that mean it's known _not_ to interoperate with GNOME etc?)
2) All of the man pages are lamentable, too. What little
information they provide is badly formatted, badly
organised, and badly translated into English. As a random
example, the "OPTIONS" section for trash(1) says:
# OPTIONS
# --'trash
# To remove move foo in the trash can, use $trash foo
Putting this under "OPTIONS" makes no sense; the punctuation before
the word "trash" makes no sense; the pretence that "$trash" is a
variable makes no sense; and the content makes no sense. It should
be something along the lines of:
ARGUMENTS
To move the file 'foo' into the trashcan, use 'trash foo'.
3) The docs should prominently feature either a summary of the
FreeDesktop.org Trash Specification or at least the URL:
SEE ALSO
list-trash(1), restore-trash(1), list-trash(1), empty-trash(1),
and the FreeDesktop.org Trash Specification at
"http://www.ramendik.ru/docs/trashspec.html";.
4) There's a surplus man page, /usr/share/man/man1/bluetrash.1.gz,
with no corresponding executable (and no way for users to
find it). If the options it lists really exist, they should
be included in the other man pages.
-- System Information:
Debian Release: lenny/sid
APT prefers testing
APT policy: (500, 'testing'), (50, 'unstable')
Architecture: i386 (i586)
Kernel: Linux 2.6.25.custom
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages trash-cli depends on:
ii python 2.5.2-1 An interactive high-level object-o
ii python-support 0.8.1 automated rebuilding support for P
trash-cli recommends no packages.
-- no debconf information
--
JBR
Ankh kak! (Ancient Egyptian blessing)
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
