initial splitting of notmuch.1

We mostly just cut and paste the command descriptions into individual
files, with a short header added to each one.

The splitting into subdirectories is to support the use of ./man as an
element in MANPATH, e.g. for testing.

1 files changed, 28 insertions, 0 deletions

diff --git a/man/man1/notmuch-part.1 b/man/man1/notmuch-part.1
new file mode 100644
index 00000000..67c4b5ed
--- /dev/null
+++ b/man/man1/notmuch-part.1
@@ -0,0 +1,28 @@
+.TH NOTMUCH-PART 1 2011-12-04 "Notmuch 0.10.2"
+.SH NAME
+notmuch-part \- Output a single part of a multipart MIME message.
+.SH SYNOPSIS
+
+.B notmuch part
+.BI "\-\-part=" "<part-number>"
+.RI < search-terms >
+
+.SH DESCRIPTION
+
+The
+.B part
+command can used to output a single part of a multipart MIME message.
+
+A single decoded MIME part, with no encoding or framing, is output to
+stdout. The search terms must match only a single message, otherwise
+this command will fail.
+
+The part number should match the part "id" field output by the
+"\-\-format=json" option of "notmuch show". If the message specified by
+the search terms does not include a part with the specified "id" there
+will be no output.
+
+See the
+.B "SEARCH SYNTAX"
+section below for details of the supported syntax for <search-terms>.
+.RE