/docs/MyDocs

 Remote repositories

 -------------------

 - Basic setup

    * Git tracks so called 'remotes'. 'origin' is a standard remote normally telling where is the package cloned from.

    Remotes are just named references to remote git repositories. Information about configure remotes:

        git remote -v -v

    * Now, some association between local and remote branches can be configured. A specific local branch can be configured

    to monitor changes in the specific branch of one for the remotes. On clone, the local 'master' branch will start tracking

    the changes on the 'master' branch of remote 'origin.

        git config --get branch.master.remote                                   - Get remote associated with local branch 'master'

        git config --get branch.master.merge                                    - ?

    * All remotes have own set of branches. When you clone package infromation about all its branches is downloaded. Plus a new 

    * Adjust remote URL

        git remote set-url <remote> <new-url>

    local branch 'master' is created. There are many operations which can be performed on the remote branches. It is possible to

    checkout the remote branchike with local: checkout them, merge from them, etc. Information about available remote branches 

    can be acquired with:

        git branch -a

    * Adding new remote

        git remote add <remote-name> https://github.com/<package>.git

        git fetch <remote-name> [refspec]                                       - retrieves refs and objects from the remote branch

        git pull <remote-name> [refspec]                                        - fetch + merge into the current branch

    * Pushing changes

        git push <remote-name> [refspec]                                        - and other way arround

            git push origin master                                              - will push back the modified master branch

    * The tags are not pushed automatically

        git push <remote-name> --tags                                           - pushes all tags

        git push <remote-name> <tag_name>                                       - pushes specific tag

    * If multiple users are sharing remote repository, the merge should be performed before. Standard procedure is following 

        'git fetch' last changes from the server into the refs/remotes/heads/<branch>

        Merge the revision into the refs/heads/<branch>

        Push it to the server

    * Remove remote branch 

        git push <remote-name> :refs/heads/invalid                              - or '--delete <remote-ref>'

    * Get more information about remote

        git remote show <remote-name>        

 

 

 - RefSpec is used to associate local and remote branches. 

        +<src>:<ldst>

    * In the simplest form it just associates two refs

        +refs/heads/master:refs/remotes/origin/master

    i.e. if 'get fetch' is executed, the remote master branch will be synchronized locally to the refs/remotes/origin/master

    * Many things can be ommited and auto-detected by git. The refspec can be as simple as

        master

    which would first resovled to 'refs/heads/master' and then the same repository will be considered on the other side.

    * It is also possible to associate multiple branches

        +refs/heads/test_*:refs/remotes/origin/test_*

    * The '+' allows git to perform update even if the branches diverged and fast-forward is not possible.

        - For synchronization in 'refs/remotes' it is completely fine (and actually could happen if some weird changes happened upstream)

 

 So, lets consider default configuration when remote is created: .git/config get updated and refspec is given for 'fetch' action. Like 

 that. This actually means that we will synchronize all the remote branches:

        fetch = +refs/heads/*:refs/remotes/origin/*

    * Now we can limit ourselves to a single branch

        fetch = +refs/heads/master:refs/remotes/origin/master

    * Synchronize directly to the local master if branches have not diverged (no plus sign)

        fetch = refs/heads/master:refs/heads/master

    * Multiple fetch refspecs can be configured in the configuration by including 'fetch =' statement multiple times

    * The same it is possible to configure automatic 'push'. Though '+' should not be used in this case :)