What does '--set-upstream' do?

Question

What does git --set-upstream do?

I tried to understand it by reading the git manual, but I didn\'t quite get it.

Answer 1

git branch --set-upstream <> is officially not supported anymore and is replaced by git branch --set-upstream-to <>