Package: notmuch
Version: 0.0+201001211401
Severity: wishlist
Tags: patch

Prospective users of notmuch get to read the package description,
think it sounds useful, visit the homepage and find out the reasons
for the name, install it, peruse the README files and the man page's
"Description" section, scan down for the command they need to do a
test-run, and execute "notmuch setup"... before finally being told:

# [...]
#
# If you already have your email being delivered to directories in either
# maildir or mh format, then that's perfect. Mail storage that uses mbox
# format, (where one mbox file contains many messages), will not work with
# notmuch. If that's how your mail is currently stored, we recommend you
# first convert it to maildir format with a utility such as mb2md.  You can
# continue configuring notmuch now, but be sure to complete the conversion
# before you run "notmuch new" for the first time.

Given that mbox is the normal default format, this makes notmuch
fairly useless for a significant proportion of users.  It would be
nice if the package description could give a hint at this - maybe 

    Notmuch is a system for indexing, searching, reading, and tagging large
    collections of email messages.
                                 in maildir or mh format.

While I'm nitpicking this description, I suppose I should point out 
the trivial grammar slip in the next sentence:

                                   It uses the Xapian library to provide fast,
    full-text search of very large collection of email with a very convenient
    search syntax.

That's "collections".  But don't bother fixing it - the phrase is
repetitive.  Just say:

   Description: thread-based email index, search and tagging
    Notmuch is a system for indexing, searching, reading, and tagging
    large collections of email messages in maildir or mh format. It uses
    the Xapian library to provide fast full-text searches with a very
    convenient search syntax.

-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (500, 'testing'), (50, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.32.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 notmuch depends on:
ii  libc6                   2.10.2-2         GNU C Library: Shared libraries
ii  libgcc1                 1:4.4.2-9        GCC support library
ii  libglib2.0-0            2.22.4-1         The GLib library of C routines
ii  libgmime-2.4-2          2.4.11-1         MIME message parser and creator li
ii  libstdc++6              4.4.2-9          The GNU Standard C++ Library v3
ii  libtalloc2              2.0.1-1          hierarchical pool based memory all
ii  libxapian15             1.0.17-1         Search engine library
ii  zlib1g                  1:1.2.3.4.dfsg-3 compression library - runtime

notmuch recommends no packages.

Versions of packages notmuch suggests:
pn  emacs                         <none>     (no description available)
pn  vim                           <none>     (no description available)

-- no debconf information
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru notmuch-0.0+201001211401.pristine/debian/control notmuch-0.0+201001211401/debian/control
--- notmuch-0.0+201001211401.pristine/debian/control	2010-01-21 02:15:16.000000000 +0000
+++ notmuch-0.0+201001211401/debian/control	2010-01-22 16:38:03.000000000 +0000
@@ -17,6 +17,6 @@
 Suggests: emacs, vim
 Description: thread-based email index, search and tagging
  Notmuch is a system for indexing, searching, reading, and tagging
- large collections of email messages. It uses the Xapian library to
- provide fast, full-text search of very large collection of email with
- a very convenient search syntax.
+ large collections of email messages in maildir or mh format. It uses
+ the Xapian library to provide fast full-text searches with a very
+ convenient search syntax.

Reply via email to