From: Jameson Graef Rollins <jrollins@finestructure.net>
To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org
Subject: Re: [PATCH v3] contrib/nmbug: new script for sharing tags with a
	given prefix.
In-Reply-To: <87ty6a9puk.fsf@rocinante.cs.unb.ca>
References: <1320627586-10068-1-git-send-email-david@tethera.net>
	<1321024095-6387-1-git-send-email-david@tethera.net>
	<877h36fdgb.fsf@servo.finestructure.net>
	<87ty6a9puk.fsf@rocinante.cs.unb.ca>
User-Agent: Notmuch/0.9+131~g8fb8eec (http://notmuchmail.org) Emacs/23.3.1
	(x86_64-pc-linux-gnu)
Date: Fri, 11 Nov 2011 18:43:38 -0800
Message-ID: <871utef4bp.fsf@servo.finestructure.net>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-=";
	micalg=pgp-sha256; protocol="application/pgp-signature"
Precedence: list

--=-=-=

On Fri, 11 Nov 2011 18:55:15 -0500, David Bremner <david@tethera.net> wrote:
> I think the commit message and the online help are aimed a different
> audience, so it is not crucial (or even desirable) that they be exactly
> the same.  Perhaps it would be more clear to say that these are the
> "non-trivial" commands.

At this point I actually think they're probably exactly the same
audience, aren't they?  Isn't nmbug primarily aimed at notmuch
developers that are reading patches sent to the list?

> The "most commonly used commands" could be retitled "the minimal set of
> commands to use nmbug". My own workflow involves fetch, merge, and the
> occasional checkout. Your might or might not; in my case it has to do
> with the fact that I am syncing tags in several different ways.

This is the sort of thing that I'm finding confusing.  Is this your work
flow because you are the primary developer and are therefore frequently
working under the hood, or because this is the prescribed procedure?

The tag sharing process that nmbug is using is complicated and subtle
enough that you should make it very clear what the "proper" procedure
is, and what are the "under the hood" commands that one should never
really have to use.  I've been following pretty closely and I'm still
kind of confused.  I'm sure that others coming to it now because they're
seeing this posting to the list might share that confusion.  Maybe it
would help if you could follow up with a good how-to that describes how
someone could start using nmbug with a nicely defined prescribed
procedure.

jamie.

--=-=-=
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iQIcBAEBCAAGBQJOvd1aAAoJEO00zqvie6q8PqIP/2j7GzN3NIonglakGj7HVhRo
9QWHn16CbI/D130QCs+zyzI7a7X6YQ0k5XfXnFpaxzYSWT5H1kJ73AEW7wc9N5wK
h54WVmoGJSM1OIZ03cvqbqGuHz/45wc8LZvHGSBRI5PAJDRKwAhkClCXXnMLHaXV
DYadksu4oIb77kejRu+iyUQTaQwoM/k+XKvPAI+IJw2Dd4cVNaliqwZbYcxMeOmp
QoSOJ/RZPZfUjDDDqrlRc4wbz//JEaWVjNY8IH8SgZHayWN9bMaq7HrIZ4mb2FGk
Chm+aoKHGXRLsUM5XiyVmOyjiK2eu08VwVnsn3yZGXw/zP3ucbr8YgjvZcIdmG+x
zzYDW2Gj4oxxZIb242/CSh5UPxLntT58Mz+yCO/+T2oOGU6befvfINSA4frmrANQ
Rc6APrz+6Qi2pkRDwop6EvFMTAOD3DQ/jL+jyPEK8bGIwAXgZy8CIswa6umDPvEo
U+Ogyh+Zlh15Ds2JnwwJsSO7ivertg1Mp6i+YKhtNNJzZnY6xNTrxpeXMCWtL5nV
3N6GC0ZBGDewOye0qfRqxoq7u89/ATeox5aKPbsNok+dE0JeI0qEYTAgZYCiN5Zv
/4K6mHKST3NMjjkxtMqXpX+OIdPZcQz3hCbi9ZXYtrtpkpv5C6Ke10yyv9AZJV6O
ihDg8PgwhZw3LJe3lS4M
=LCgG
-----END PGP SIGNATURE-----
--=-=-=--