Topic: Update Git page on the website
Could we update the above Git page with details on how a budding new developer could create their first git patch? First stab at some wording ...
How to create your first GParted patch using git
1. Clone the git repository locally:
git clone git://git.gnome.org/gparted
2. Set your name and email address.
git config --global user.name "Joe Bloggs" git config --global user.email "firstname.lastname@example.org"
3. Create a new branch and switch to it:
cd gparted git checkout -b feature
4. Edit the code, compile and test it.
# Use favourite editor ./autogen.sh make su root -c src/gpartedbin
5. Commit change to git
git add file1 file2 ... git commit
Compose a suitable commit message:
Short one line summary of change (#999999)
Optional longer description explaining why the change is necessary.
Include details that will help the reviewer understand how the code
code is broken and being fixed or why this change is an improvement.
Bug #999999 - GNOME Bugzilla one line summary
6. Often make large and complicated changes as a series of smaller changes by repeating steps 4. and 5. as necessary.
7. Create a patch file:
git format-patch master --stdout > ~/mypatch.mbox
8. Final review, apply, compile and test:
cd /tmp git clone git://git.gnome.org/gparted gparted-test cd gparted-test git am ~/mypatch.mbox ./autogen.sh make su root -c src/gpartedbin
9. Attach ~/mypatch.mbox to your GNOME bug report with a few words