On 18/05/2019 13:17, Duy Nguyen wrote:
On Tue, May 14, 2019 at 6:10 PM Philip Oakley <philipoakley@xxxxxxx> wrote:
It is a 'branch which tracks a remote', and it is has the 'last time I
looked' state of the branch that is on the remote server, which may
have, by now, advanced or changed.
So you need to have the three distinct views in your head of 'My branch,
held locally', 'my copy of Their branch, from when I last looked', and
'Their branch, on a remote server, in a state I haven't seen recently'.
What I was looking for is this. I don't think we have something like
this in the man pages (I only checked a few though) and not even sure
where it should be if it should be added to the man pages, git-branch?
git-remote? git-fetch? git-branch.txt might be the best place because
this is still about branches.
At the moment its in `git help glossary`, but could be improved, and
references to it given in the various man pages.
It does not look easy to link to a specific term/section between man
pages. The way user-manual.html does it is to embed the whole
glossary.
I suppose we could still do something similar after breaking down
glossary.txt (like we do with config.txt) the only include relevant
terms. Not sure if this a really good idea to pursue.
Mainly I was commenting on the fact that the description is in a guide
(which isn't well known).
And that we rarely give links to the guides.
For those that end up using the HTML man pages, having hyperlinks to the
particular section would be useful, though I'm not sure if their is a
neat way of doing that which is 'nice' for those using the 'man' viewer.
So yes, it's more of a back burner issue, unless some eager tech authors
suddenly show up;-)
--
Philip
