[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: log format for vc-bzr
From: |
Eli Zaretskii |
Subject: |
Re: log format for vc-bzr |
Date: |
Fri, 08 Jan 2010 21:35:36 +0200 |
> From: Óscar_Fuentes <address@hidden>
> Date: Fri, 08 Jan 2010 18:45:07 +0100
>
> > Then the docs should have said "pending uncommitted merge results".
> >
> > IOW, the fact that there should be a commit after the merge is not the
> > reason to call the just-performed merge "pending". The results of the
> > merge are pending commit, but the merge itself is no longer pending,
> > it was already done.
>
> I disagree. The pending is not done until the corresponding revision is
> created and hence integrated on the history of the branch. That revision
> is the merge, not the source code changes that `bzr merge' created.
>
> This is a about how to interpret certain terms. You are seeing the issue
> from the POV of a code writer who cares mostly about the state of the
> working tree. Me from the POV of somebody who is more fluent with the
> tool (bzr) and see things on terms of history points.
That's your mistake, right there: this is user documentation, not
documentation of bzr internals. So it should take the POV of the user
who cares much less about the implementation than about the visible
effect.
It is this wrong POV that is one of the reasons that the current bzr
docs impose such a tremendous mental pressure on a novice who is
trying to make themselves fluent with the tool.
- Re: bzr Q&A [was Re: log format for vc-bzr], (continued)
- Re: bzr Q&A [was Re: log format for vc-bzr], Eli Zaretskii, 2010/01/09
- bzr Q&A [was Re: log format for vc-bzr], Stephen J. Turnbull, 2010/01/09
- Re: log format for vc-bzr, Stephen J. Turnbull, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Juanma Barranquero, 2010/01/08
- Re: log format for vc-bzr, Stephen J. Turnbull, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/09
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr,
Eli Zaretskii <=
- Re: log format for vc-bzr, Miles Bader, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Thien-Thi Nguyen, 2010/01/09
- Re: log format for vc-bzr, Andreas Schwab, 2010/01/09
- Re: log format for vc-bzr, Thien-Thi Nguyen, 2010/01/09