Unclear documatation: branch_remote_name

[lolbinarycat]

branch_remote_name, branch_upstream_name, and branch_upstream_remote all take the name of a local branch and return some aspect of the branch's upstream, but it's not clear what the difference is.

i think a single example for each would go a long way towards making this more clear.

### Tasks