wiki:GitHowto

Version 3 (modified by slavazanko, 15 years ago) (diff)

--

Small Howto use our Git Repro

Geting repro

Developer

At first: Every developer should check out the git repository via ssh.. as every other possibility is readonly:

  git clone ssh://midnight-commander.org:2222/git/mc.git

Anonymous R/O access

  git clone http://git.midnight-commander.org/mc.git

or

  git clone git://midnight-commander.org/git/mc.git

Some info about current repro

There are now several branches, namely:

  • master (testing area)
  • stable (from this branch we do the releases, only stable code)
  • mc-ru-fork (code from a former fork, which should be integrated)
  • utf-8 (a utf8 patch applied)

Our workflow is splitted up in four parts:

  • Creating the patch
  • Discussing the patch
  • Applying the patch to master
  • Moving the patch after testing to stable

Creating the patch

There are two possible ways in order to create a patch:

Way 1

  • create a local branch on top of master:
        git checkout -b foobar #if you are on master
    
  • Do some work inside this branch.
  • Have a look what has changed really:
        git status
    
  • Add all files which shoul go into the patch in order to track them:
        git add src/file1.c po/file2.po maint/file3.txt
    
  • Create a diff against master:
        git diff master > /tmp/newpatch.patch
    
  • Delete everything which was done:
        git reset --hard $sha_of_last_usefull_commit
    
    Using here --soft will also work but then you'll have to delete the untracked stuff on your own
  • Check if something is still there which shouldn't be there
        git status
    
  • Switch back to master and delete the foobar branch
    git checkout master 
    git branch -d foobar
    

Way 2

  • Do some work in the master branch
  • Add all files which should show up in the diff into the stagging area
        git add file1 file2 file3
    
  • Create patchfile:
        git diff master > /tmp/patchfile.patch
    
  • Reset master to last usefull commit:
        git reset --hard $sha_of_last_usefull_commit
    
  • Check if something is still there which shouldn't be there
        git status
    

Discussing the patch

As a patch should always be build on master it should be fairly trivial to test if the patch is okay (applies): For this only fetch the patch and apply it on master (or on a foobar branch for testing). Maybe test if the patch behaves as expected and read through the patch if the coding style and the changes itself are good. After that comment on the ticket if the patch is okay or should reworked.

Afterwards you can clean up again the master branch with

git reset --hard $sha_of_last_usefull_commit

Applying the patch on master

There are a lot of other possibilities in order to create patches/work on the git but I would suggest that you try it on your own ;-)