unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
From: David Bremner <david@tethera.net>
To: Jameson Graef Rollins <jrollins@finestructure.net>,
	Notmuch Mail <notmuch@notmuchmail.org>
Subject: Re: have "notmuch help" call man?
Date: Thu, 22 Dec 2011 06:49:12 -0400	[thread overview]
Message-ID: <878vm4ubiv.fsf@zancas.localnet> (raw)
In-Reply-To: <87k45pqkaz.fsf@servo.finestructure.net>

On Wed, 21 Dec 2011 20:53:08 -0800, Jameson Graef Rollins <jrollins@finestructure.net> wrote:

> * There are a couple of formatting issues (notmuch.1, notmuch-config.1,
>   notmuch-reply.1).

I'm sure there are. Can you be more specific? I suspect I might fix a
different set of problems than you found ;).

> * The notmuch part command is completely deprecated, so I don't think
>   there's really any reason to include a man page for it.

I'm not sure if removing that would be "doing too many things at once";
it is in the current man page. But maybe that was an oversight?

> * There's no man page for restore (notmuch-restore.1).

Currently the symlink to notmuch-dump.1.gz is installed at runtime. I
agree this is a bit inconvenient for testing; I think it should work to
have symlinks in the source just for the convenience of testers.

> It also occurs to me while looking through this: do we really need a
> separate "setup" command?  

I guess notmuch-setup is a UI convenience mainly for people who want to
re-run setup.  It doesn't feel as natural to me to run notmuch without
arguments in this case. I couldn't really justify that, though.

Thanks for the review,

David

  reply	other threads:[~2011-12-22 10:49 UTC|newest]

Thread overview: 15+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-12-16 16:01 have "notmuch help" call man? David Bremner
2011-12-16 16:41 ` Adam Wolfe Gordon
2011-12-16 18:17 ` Kazuo Teramoto
2011-12-16 21:35 ` Jameson Graef Rollins
2011-12-17  9:56 ` Tomi Ollila
2011-12-20  4:16 ` David Bremner
2011-12-22  3:43   ` David Bremner
2011-12-22  4:53     ` Jameson Graef Rollins
2011-12-22 10:49       ` David Bremner [this message]
2011-12-27  0:35       ` David Bremner
2011-12-29  2:24         ` Austin Clements
2011-12-29 13:11           ` [PATCH v3] notmuch: replace built-in help with exec of man David Bremner
2011-12-29 13:47             ` David Bremner
2011-12-30 18:50             ` Austin Clements
2011-12-31 19:25               ` David Bremner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://notmuchmail.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=878vm4ubiv.fsf@zancas.localnet \
    --to=david@tethera.net \
    --cc=jrollins@finestructure.net \
    --cc=notmuch@notmuchmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).