aboutsummaryrefslogtreecommitdiffhomepage
path: root/notmuch.c
diff options
context:
space:
mode:
authorGravatar Carl Worth <cworth@cworth.org>2010-11-06 12:03:51 -0700
committerGravatar Carl Worth <cworth@cworth.org>2010-11-06 12:03:51 -0700
commit81d3bd3670f570c9aeb7e1f3b317b86194ee4426 (patch)
tree0a0149bffd49998c2325bf5d33e1f0842e488483 /notmuch.c
parent581ea7c8d39c9de73282b21de16dd9b0192ec5ac (diff)
Rename "notmuch cat" to "notmuch show --format=raw"
This is part of an effort to avoid proliferation of excessive top-level notmuch commands. Also, "raw" better captures the functionality here, (as opposed to "cat" which is a fairly oblique reference to a bad Unix abbreviation whose metaphor doesn't work here since "notmuch cat" operates only on a single message and hence cannot "con'cat'enate" anything).
Diffstat (limited to 'notmuch.c')
-rw-r--r--notmuch.c13
1 files changed, 8 insertions, 5 deletions
diff --git a/notmuch.c b/notmuch.c
index 0eba89a3..9ba0ec03 100644
--- a/notmuch.c
+++ b/notmuch.c
@@ -222,7 +222,7 @@ command_t commands[] = {
"\t\tall messages in the same thread as any matched\n"
"\t\tmessage will be displayed.\n"
"\n"
- "\t--format=(text|json|mbox)\n"
+ "\t--format=(text|json|mbox|raw)\n"
"\n"
"\t\ttext (default)\n"
"\n"
@@ -254,6 +254,13 @@ command_t commands[] = {
"\n"
"\t\thttp://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html\n"
"\n"
+ "\t\traw\n"
+ "\n"
+ "\t\tThe original, raw content of the email message is displayed.\n"
+ "\t\tConsumers of this format should expect to implement MIME\n"
+ "\t\tdecoding and similar functions. This format must only\n"
+ "\t\tbe used with search terms matching a single message.\n"
+ "\n"
"\tA common use of \"notmuch show\" is to display a single\n"
"\tthread of email messages. For this, use a search term of\n"
"\t\"thread:<thread-id>\" as can be seen in the first column\n"
@@ -343,10 +350,6 @@ command_t commands[] = {
"\tcontain tags only from messages that match the search-term(s).\n"
"\n"
"\tIn both cases the list will be alphabetically sorted." },
- { "cat", notmuch_cat_command,
- "<search-terms>",
- "Output raw content of a single message matched by the search term.",
- "" },
{ "part", notmuch_part_command,
"--part=<num> <search-terms>",
"Output a single MIME part of a message.",