git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Patrick Doyle <wpdster@gmail.com>
To: git <git@vger.kernel.org>
Subject: path/to/some/file: needs update
Date: Fri, 3 Dec 2010 13:34:24 -0500	[thread overview]
Message-ID: <AANLkTinsUZCUJamUHWN=H7tyL5nKACmEcyvG6hpsTDtv@mail.gmail.com> (raw)

Would it make sense to change the "needs update" message to read
"locally modified"?

I walked out of the office yesterday afternoon little knowing that the
two folks left there, who are both VCS neophytes in general, were
about to enter what they described as "version control H#@@".

It all started when one of them tried to pull the latest version of
our repository from the server.  He was quite startled by all of the
messages that read

path/to/some/file: needs update.

Then things got worse... one of the messages said:

error: Entry 'path/to/some/binaryfile' not uptodate.  Cannot merge

"Huh?!?!", they exclaimed to each other.  "I wasn't doing a merge.  I
was doing a pull.  Well, I guess that's kinda like a merge.  But why
did it generate an error?  Shouldn't it have generated a conflict
message?".  At least, I'm imagining that's what they said to each
other.  I wasn't there.  I just got the phone call an hour later when
I was on the train going home.

Needless to say, I was able to calm them down.  But it occurred to me
that "needs update" isn't necessarily the most helpful message and
that "error: ... Cannot merge" could offer a little more explanation.

I'm happy to submit the trivial patch changing "needs update" to
"locally modified".  I suspect there might be some ramifications in
terms of scripts that expect the old message to be there, but
hopefully not.

What do folks think?

--wpd

             reply	other threads:[~2010-12-03 18:34 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-12-03 18:34 Patrick Doyle [this message]
2010-12-03 18:52 ` path/to/some/file: needs update Jonathan Nieder
2010-12-03 18:58 ` Matthieu Moy
2010-12-06  0:44   ` Patrick Doyle
2010-12-06 19:06     ` Neal Kreitzinger
2010-12-06 19:19       ` Neal Kreitzinger
2010-12-06 19:23         ` Patrick Doyle
2010-12-06 20:47     ` Ben Walton
2010-12-07 15:23       ` Drew Northup

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

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

  git send-email \
    --in-reply-to='AANLkTinsUZCUJamUHWN=H7tyL5nKACmEcyvG6hpsTDtv@mail.gmail.com' \
    --to=wpdster@gmail.com \
    --cc=git@vger.kernel.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.
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 NNTP newsgroup(s).