* I started filing the bug to let the maintainers of the core know what is going on.
https://bugzilla.gnome.org/show_bug.cgi?id=658377
* Then I cloned the gnome-utils from git.gnome.org
[yulys@yulys ~]$ git clone ssh://jinca@git.gnome.org/git/gnome-utils Cloning into gnome-utils... remote: Counting objects: 59085, done. remote: Compressing objects: 100% (15576/15576), done. remote: Total 59085 (delta 45829), reused 55090 (delta 42944) Receiving objects: 100% (59085/59085), 35.10 MiB | 30 KiB/s, done. Resolving deltas: 100% (45829/45829), done.
* After that, we find out the branch we are:
[yulys@yulys ~]$ cd gnome-utils/ [yulys@yulys gnome-utils]$ git branch -a * master remotes/origin/GNOME20 remotes/origin/GNOME_UTILS_1_2_0 remotes/origin/HEAD -> origin/master remotes/origin/gdict-vala remotes/origin/gnome-2-0 remotes/origin/gnome-2-0-2 remotes/origin/gnome-2-10 remotes/origin/gnome-2-12 remotes/origin/gnome-2-14 remotes/origin/gnome-2-16 remotes/origin/gnome-2-18 remotes/origin/gnome-2-2 remotes/origin/gnome-2-2-0 remotes/origin/gnome-2-20 remotes/origin/gnome-2-24 remotes/origin/gnome-2-26 remotes/origin/gnome-2-28 remotes/origin/gnome-2-30 remotes/origin/gnome-2-32 remotes/origin/gnome-2-4 remotes/origin/gnome-2-6 remotes/origin/gnome-2-8 remotes/origin/gnome-3-0 remotes/origin/gnome-core-1-4 remotes/origin/gnome-utils-1-4 remotes/origin/gsettings-tutorial remotes/origin/linasa remotes/origin/linasb remotes/origin/linasc remotes/origin/linasd remotes/origin/linase remotes/origin/linasf remotes/origin/linasg remotes/origin/linash remotes/origin/linasi remotes/origin/linasj remotes/origin/linask remotes/origin/linasl remotes/origin/linasm remotes/origin/linasn remotes/origin/linaso remotes/origin/linasp remotes/origin/linasq remotes/origin/linasr remotes/origin/linass remotes/origin/linast remotes/origin/linasu remotes/origin/linasv remotes/origin/linasw remotes/origin/linasx remotes/origin/logview-plugin remotes/origin/mallard-documentation remotes/origin/master remotes/origin/multihead remotes/origin/new-dictionary remotes/origin/new-toplevel remotes/origin/sh_utils [yulys@yulys gnome-utils]$
* Finally, we need to git checkout -b mallard-documentation remotes/origin/mallard-documentation
[yulys@yulys gnome-utils]$ git checkout -b mallard-documentation remotes/origin/mallard-documentation Branch mallard-documentation set up to track remote branch mallard-documentation from origin. Switched to a new branch 'mallard-documentation' [yulys@yulys gnome-utils]$ git branch * mallard-documentation master
git checkout will create a local branch on your machine which will correspond to the remote branch, which we’re working on.
[yulys@yulys gnome-utils]$ git pullAlready up-to-date.
Now, what we are going to do is our first commit… it will be about deleting the files of the old doc written in Docbook.
[yulys@yulys gnome-utils]$ cd baobab/ [yulys@yulys baobab]$ ls AUTHORS ChangeLog data help Makefile.am pixmaps README src TODO [yulys@yulys baobab]$ cd C bash: cd: C: No such file or directory [yulys@yulys baobab]$ ls AUTHORS ChangeLog data help Makefile.am pixmaps README src TODO [yulys@yulys baobab]$ cd help [yulys@yulys help]$ cd C [yulys@yulys C]$ ls baobab.xml figures legal.xml [yulys@yulys C]$ cd figures [yulys@yulys figures]$ ls baobab_fullscan.png baobab_ringschart1.png baobab_window.png baobab_prefs.png baobab_ringschart2.png baobab_remote.png baobab_treemaps.png [yulys@yulys C]$ git rm -rf *.* rm 'baobab/help/C/baobab.xml' rm 'baobab/help/C/legal.xml' [yulys@yulys C]$ ls figures [yulys@yulys C]$ git rm -r * rm 'baobab/help/C/figures/baobab_fullscan.png' rm 'baobab/help/C/figures/baobab_prefs.png' rm 'baobab/help/C/figures/baobab_remote.png' rm 'baobab/help/C/figures/baobab_ringschart1.png' rm 'baobab/help/C/figures/baobab_ringschart2.png' rm 'baobab/help/C/figures/baobab_treemaps.png' rm 'baobab/help/C/figures/baobab_window.png'
… we have to check the status of the file
[yulys@yulys gnome-utils]$ git status # On branch mallard-documentation # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # deleted: baobab/help/C/baobab.xml # deleted: baobab/help/C/figures/baobab_fullscan.png # deleted: baobab/help/C/figures/baobab_prefs.png # deleted: baobab/help/C/figures/baobab_remote.png # deleted: baobab/help/C/figures/baobab_ringschart1.png # deleted: baobab/help/C/figures/baobab_ringschart2.png # deleted: baobab/help/C/figures/baobab_treemaps.png # deleted: baobab/help/C/figures/baobab_window.png # deleted: baobab/help/C/legal.xml #
So, now we are ready for our first commit!!!… yeah!
I deleted all the content of baobab because it was written in DocBook.# Please enter the commit message for your changes. Lines starting# with '#' will be ignored, and an empty message aborts the commit.# On branch mallard-documentation# Changes to be committed:# (use "git reset HEAD <file>..." to unstage)## deleted: baobab/help/C/baobab.xml# deleted: baobab/help/C/figures/baobab_fullscan.png# deleted: baobab/help/C/figures/baobab_prefs.png# deleted: baobab/help/C/figures/baobab_remote.png# deleted: baobab/help/C/figures/baobab_ringschart1.png# deleted: baobab/help/C/figures/baobab_ringschart2.png# deleted: baobab/help/C/figures/baobab_treemaps.png# deleted: baobab/help/C/figures/baobab_window.png# deleted: baobab/help/C/legal.xml#~ ~ ~ ~ ~ ~ :wq
wala! all the contents are gone ^^
[yulys@yulys gnome-utils]$ git commit -a[mallard-documentation e27d1a6] I deleted all the content of baobab because it was written in DocBook. 9 files changed, 0 insertions(+), 519 deletions(-) delete mode 100644 baobab/help/C/baobab.xml delete mode 100644 baobab/help/C/figures/baobab_fullscan.png delete mode 100644 baobab/help/C/figures/baobab_prefs.png delete mode 100644 baobab/help/C/figures/baobab_remote.png delete mode 100644 baobab/help/C/figures/baobab_ringschart1.png delete mode 100644 baobab/help/C/figures/baobab_ringschart2.png delete mode 100644 baobab/help/C/figures/baobab_treemaps.png delete mode 100644 baobab/help/C/figures/baobab_window.png delete mode 100644 baobab/help/C/legal.xml[yulys@yulys gnome-utils]$
now the push thing to complete the process:
[yulys@yulys gnome-utils]$ git push origin mallard-documentationCounting objects: 7, done.Delta compression using up to 4 threads.Compressing objects: 100% (4/4), done.Writing objects: 100% (4/4), 392 bytes, done.Total 4 (delta 3), reused 0 (delta 0)To ssh://jinca@git.gnome.org/git/gnome-utils 797ffb7..e27d1a6 mallard-documentation -> mallard-documentation[yulys@yulys gnome-utils]$
http://git.gnome.org/browse/gnome-utils/log/?h=mallard-documentation
So, now we are going to do another COMMIT making a copy of all my new files made them in Mallard in the gnome-utils folder.
[yulys@yulys gnome-utils]$ cd baobab/help/C[yulys@yulys C]$ lsfigures introduction.page scan-folder.page scan-remote.pageindex.page scan-file-system.page scan-home.page[yulys@yulys C]$
… there are the files, and now I am going to do the git add .
[yulys@yulys C]$ git add . [yulys@yulys C]$ git status # On branch mallard-documentation # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # new file: figures/disk-usage-analyzer.png # new file: figures/scan-file-system.png # new file: index.page # new file: introduction.page # new file: scan-file-system.page # new file: scan-folder.page # new file: scan-home.page # new file: scan-remote.page # [yulys@yulys C]$
To check it better:
[yulys@yulys C]$ cd ../../..[yulys@yulys gnome-utils]$ git status# On branch mallard-documentation# Changes to be committed:# (use "git reset HEAD <file>..." to unstage)## new file: baobab/help/C/figures/disk-usage-analyzer.png# new file: baobab/help/C/figures/scan-file-system.png# new file: baobab/help/C/index.page# new file: baobab/help/C/introduction.page# new file: baobab/help/C/scan-file-system.page# new file: baobab/help/C/scan-folder.page# new file: baobab/help/C/scan-home.page# new file: baobab/help/C/scan-remote.page#[yulys@yulys gnome-utils]$
NOW!!! Finally, the last commit for today!!!
help/baobab: pushing the firsts pages in Mallard documentation. # Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # On branch mallard-documentation # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # new file: baobab/help/C/figures/disk-usage-analyzer.png # new file: baobab/help/C/figures/scan-file-system.png # new file: baobab/help/C/index.page # new file: baobab/help/C/introduction.page # new file: baobab/help/C/scan-file-system.page # new file: baobab/help/C/scan-folder.page # new file: baobab/help/C/scan-home.page # new file: baobab/help/C/scan-remote.page # ~ ~ ~ ~ ~ ~ ~ :wq [yulys@yulys gnome-utils]$ git push origin mallard-documentation Counting objects: 17, done. Delta compression using up to 4 threads. Compressing objects: 100% (14/14), done. Writing objects: 100% (14/14), 85.32 KiB, done. Total 14 (delta 6), reused 0 (delta 0) To ssh://jinca@git.gnome.org/git/gnome-utils e27d1a6..b4f4157 mallard-documentation -> mallard-documentation [yulys@yulys gnome-utils]$

