Re: Missing branches after clone
- From
Philip Oakley <philipoakley@iee.org>
- Date
- May 19, 2019, 00:09 UTC
- Message-ID
- <033ba463-dddd-d5b8-903c-9729190c213a@iee.org>
- In-Reply-To
- <CACsJy8Cc+cj0kC5=N+6AGB2UGDWA3uK946vgdhg9Cpx9a7w2wg@mail.gmail.com>
On 18/05/2019 13:17, Duy Nguyen wrote:
Show 23 quoted lines
> On Tue, May 14, 2019 at 6:10 PM Philip Oakley <philipoakley@iee.org> 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