From e9e606f333685696ecc9979b8813b0838b9e969e Mon Sep 17 00:00:00 2001 From: Tomi Ollila Date: Sun, 24 Jun 2012 23:46:29 +0300 Subject: [PATCH] manpages: extra newlines fix --- manpages/notmuch-1.mdwn | 3 +- manpages/notmuch-config-1.mdwn | 3 +- manpages/notmuch-count-1.mdwn | 3 +- manpages/notmuch-dump-1.mdwn | 3 +- manpages/notmuch-hooks-5.mdwn | 3 +- manpages/notmuch-new-1.mdwn | 6 +- manpages/notmuch-reply-1.mdwn | 3 +- manpages/notmuch-restore-1.mdwn | 6 +- manpages/notmuch-search-1.mdwn | 3 +- manpages/notmuch-search-terms-7.mdwn | 3 +- manpages/notmuch-setup-1.mdwn | 122 +++++++++++++++++++++++++++ manpages/notmuch-show-1.mdwn | 3 +- manpages/notmuch-tag-1.mdwn | 6 +- 13 files changed, 137 insertions(+), 30 deletions(-) create mode 100644 manpages/notmuch-setup-1.mdwn diff --git a/manpages/notmuch-1.mdwn b/manpages/notmuch-1.mdwn index f873926..b7ddcf1 100644 --- a/manpages/notmuch-1.mdwn +++ b/manpages/notmuch-1.mdwn @@ -104,8 +104,7 @@ 
        notmuch-config(1), notmuch-count(1), notmuch-dump(1), notmuch-hooks(5),
        notmuch-new(1),    notmuch-reply(1),    notmuch-restore(1),    notmuch-
-       search(1)
-, notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+       search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
 
        The notmuch website: http://notmuchmail.org
diff --git a/manpages/notmuch-config-1.mdwn b/manpages/notmuch-config-1.mdwn index a831b9f..149a51c 100644 --- a/manpages/notmuch-config-1.mdwn +++ b/manpages/notmuch-config-1.mdwn @@ -113,8 +113,7 @@

SEE ALSO

        notmuch(1),  notmuch-count(1),  notmuch-dump(1), notmuch-hooks(5), not-
-       much-new(1)
-, notmuch-reply(1),  notmuch-restore(1),  notmuch-search(1),
+       much-new(1), notmuch-reply(1),  notmuch-restore(1),  notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-count-1.mdwn b/manpages/notmuch-count-1.mdwn index 9f0190d..7b87287 100644 --- a/manpages/notmuch-count-1.mdwn +++ b/manpages/notmuch-count-1.mdwn @@ -44,8 +44,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-dump(1), notmuch-hooks(5), not-
-       much-new(1)
-, notmuch-reply(1),  notmuch-restore(1),  notmuch-search(1),
+       much-new(1), notmuch-reply(1),  notmuch-restore(1),  notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-dump-1.mdwn b/manpages/notmuch-dump-1.mdwn index f2108f8..ece1889 100644 --- a/manpages/notmuch-dump-1.mdwn +++ b/manpages/notmuch-dump-1.mdwn @@ -33,8 +33,7 @@

SEE ALSO

        notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-hooks(5), not-
-       much-new(1)
-,  notmuch-reply(1),  notmuch-restore(1), notmuch-search(1),
+       much-new(1),  notmuch-reply(1),  notmuch-restore(1), notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-hooks-5.mdwn b/manpages/notmuch-hooks-5.mdwn index f694721..77436a1 100644 --- a/manpages/notmuch-hooks-5.mdwn +++ b/manpages/notmuch-hooks-5.mdwn @@ -41,8 +41,7 @@

SEE ALSO

        notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not-
-       much-new(1)
-,  notmuch-reply(1),  notmuch-restore(1), notmuch-search(1),
+       much-new(1),  notmuch-reply(1),  notmuch-restore(1), notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-new-1.mdwn b/manpages/notmuch-new-1.mdwn index a20aa90..f8026ea 100644 --- a/manpages/notmuch-new-1.mdwn +++ b/manpages/notmuch-new-1.mdwn @@ -31,8 +31,7 @@ notmuch new updates tags according to maildir flag changes if the maildir.synchronize_flags configuration option is enabled. See notmuch- - config(1) - for details. + config(1) for details. The new command supports hooks. See notmuch-hooks(5) for more details on hooks. @@ -47,8 +46,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-, notmuch-reply(1), notmuch-restore(1), notmuch-search(1),
+       much-hooks(5), notmuch-reply(1), notmuch-restore(1), notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-reply-1.mdwn b/manpages/notmuch-reply-1.mdwn index 203b57d..c8a43ca 100644 --- a/manpages/notmuch-reply-1.mdwn +++ b/manpages/notmuch-reply-1.mdwn @@ -85,8 +85,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-, notmuch-new(1),  notmuch-restore(1),  notmuch-search(1),
+       much-hooks(5), notmuch-new(1),  notmuch-restore(1),  notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-restore-1.mdwn b/manpages/notmuch-restore-1.mdwn index a30b938..7ca2531 100644 --- a/manpages/notmuch-restore-1.mdwn +++ b/manpages/notmuch-restore-1.mdwn @@ -31,15 +31,13 @@ notmuch restore updates the maildir flags according to tag changes if the maildir.synchronize_flags configuration option is enabled. See not- - much-config(1) - for details. + much-config(1) for details.

SEE ALSO

        notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not-
-       much-hooks(5)
-,   notmuch-new(1),  notmuch-reply(1),  notmuch-search(1),
+       much-hooks(5),   notmuch-new(1),  notmuch-reply(1),  notmuch-search(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn index c43a5d4..af5fe51 100644 --- a/manpages/notmuch-search-1.mdwn +++ b/manpages/notmuch-search-1.mdwn @@ -100,8 +100,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-,  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
+       much-hooks(5),  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
        notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-search-terms-7.mdwn b/manpages/notmuch-search-terms-7.mdwn index ff51323..2d20ff3 100644 --- a/manpages/notmuch-search-terms-7.mdwn +++ b/manpages/notmuch-search-terms-7.mdwn @@ -110,8 +110,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-,  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
+       much-hooks(5),  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
        notmuch-search(1), notmuch-show(1), notmuch-tag(1)
diff --git a/manpages/notmuch-setup-1.mdwn b/manpages/notmuch-setup-1.mdwn new file mode 100644 index 0000000..b7ddcf1 --- /dev/null +++ b/manpages/notmuch-setup-1.mdwn @@ -0,0 +1,122 @@ +

NOTMUCH(1)

+ +

NAME

+
+       notmuch - thread-based email index, search, and tagging
+
+ +

SYNOPSIS

+
+       notmuch command [args ...]
+
+ +

DESCRIPTION

+
+       Notmuch  is a command-line based program for indexing, searching, read-
+       ing, and tagging large collections of email messages.
+
+       This page describes how to get started using notmuch from  the  command
+       line,  and  gives  a brief overview of the commands available. For more
+       information on e.g.  notmuch show consult the notmuch-show(1) man page,
+       also accessible via notmuch help show
+
+       The  quickest  way  to get started with Notmuch is to simply invoke the
+       notmuch command with no arguments, which will interactively  guide  you
+       through the process of indexing your mail.
+
+ +

NOTE

+
+       While the command-line program notmuch provides powerful functionality,
+       it does not provide the most convenient interface for that  functional-
+       ity.  More  sophisticated interfaces are expected to be built on top of
+       either the command-line interface, or more likely, on top of  the  not-
+       much  library  interface.  See  http://notmuchmail.org  for  more about
+       alternate interfaces to notmuch. The emacs-based interface  to  notmuch
+       (available under emacs/ in the Notmuch source distribution) is probably
+       the most widely used at this time.
+
+ +

COMMANDS

+ +

  SETUP

+
+       The notmuch setup command is used to configure Notmuch for  first  use,
+       (or to reconfigure it later).
+
+       The  setup  command  will prompt for your full name, your primary email
+       address, any alternate email addresses you use, and the directory  con-
+       taining your email archives. Your answers will be written to a configu-
+       ration file in ${NOTMUCH_CONFIG} (if set) or ${HOME}/.notmuch-config  .
+       This configuration file will be created with descriptive comments, mak-
+       ing it easy to edit by hand later to change the configuration.  Or  you
+       can run notmuch setup again to change the configuration.
+
+       The  mail  directory you specify can contain any number of sub-directo-
+       ries and should primarily contain only files with individual email mes-
+       sages  (eg.  maildir  or  mh archives are perfect). If there are other,
+       non-email files (such as indexes maintained by  other  email  programs)
+       then notmuch will do its best to detect those and ignore them.
+
+       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  cur-
+       rently stored, it is recommended you first convert it to maildir format
+       with a utility such as mb2md before running notmuch setup .
+
+       Invoking notmuch with no command argument will run setup if  the  setup
+       command has not previously been completed.
+
+ +

  OTHER COMMANDS

+
+       Several  of the notmuch commands accept search terms with a common syn-
+       tax. See notmuch-search-terms(7) for more details on the supported syn-
+       tax.
+
+       The  search,  show and count commands are used to query the email data-
+       base.
+
+       The reply command is useful for  preparing  a  template  for  an  email
+       reply.
+
+       The tag command is the only command available for manipulating database
+       contents.
+
+       The dump and restore commands can be used to create a textual  dump  of
+       email tags for backup purposes, and to restore from that dump.
+
+       The  config  command can be used to get or set settings int the notmuch
+       configuration file.
+
+ +

ENVIRONMENT

+
+       The following environment variables can be used to control the behavior
+       of notmuch.
+
+       NOTMUCH_CONFIG
+              Specifies  the  location of the notmuch configuration file. Not-
+              much will use ${HOME}/.notmuch-config if this  variable  is  not
+              set.
+
+ +

SEE ALSO

+
+       notmuch-config(1), notmuch-count(1), notmuch-dump(1), notmuch-hooks(5),
+       notmuch-new(1),    notmuch-reply(1),    notmuch-restore(1),    notmuch-
+       search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+
+       The notmuch website: http://notmuchmail.org
+
+ +

CONTACT

+
+       Feel  free to send questions, comments, or kudos to the notmuch mailing
+       list <notmuch@notmuchmail.org> . Subscription is  not  required  before
+       posting, but is available from the notmuchmail.org website.
+
+       Real-time  interaction  with the Notmuch community is available via IRC
+       (server: irc.freenode.net, channel: #notmuch).
+
+ +

Notmuch 0.13.2

diff --git a/manpages/notmuch-show-1.mdwn b/manpages/notmuch-show-1.mdwn index b002066..936e4eb 100644 --- a/manpages/notmuch-show-1.mdwn +++ b/manpages/notmuch-show-1.mdwn @@ -130,8 +130,7 @@

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-,  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
+       much-hooks(5),  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
        notmuch-search(1), notmuch-search-terms(7), notmuch-tag(1)
diff --git a/manpages/notmuch-tag-1.mdwn b/manpages/notmuch-tag-1.mdwn index dbd99a5..a7c52bc 100644 --- a/manpages/notmuch-tag-1.mdwn +++ b/manpages/notmuch-tag-1.mdwn @@ -28,15 +28,13 @@ notmuch tag updates the maildir flags according to tag changes if the maildir.synchronize_flags configuration option is enabled. See notmuch- - config(1) - for details. + config(1) for details.

SEE ALSO

        notmuch(1),  notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
-       much-hooks(5)
-,  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
+       much-hooks(5),  notmuch-new(1),  notmuch-reply(1),  notmuch-restore(1),
        notmuch-search(1), notmuch-search-terms(7), notmuch-show(1),
-- 2.43.0