My fourth report: Cheese doc in real

To upload my advanced of Cheese documentation in real life, I have to text somewhere… so, it is good idea to put the docs in Gitorious branch.

With the help of Phil Bull, I created my Gitorious account and upload my public SSH key.      I got my ssh key doing cat ~/.shh/id_rsa.pub

It’s like git.gnome.org, but we use it for documentation that’s currently being heavily developed. We can put all of our ‘work in progress’stuff in that branch and it lets you (people who have access to Gitorious and want to review the doc)

Clone the Glitorious doing: git clone git@gitorious.org:cheese-docs/cheese-docs.git

You can add your files, like you would with the normal git.gnome.org stuff, e.g. git add, git commit.

git checkout master

To push your changes, it’s slightly different:

git push origin master

And that’s it!

Ready to start! 
https://gitorious.org/cheese-docs/cheese-docs  
[yulys@yulys ~]$ cd cheese/cheese/help/C
[yulys@yulys C]$ yelp-new task index "Cheese Webcam Booth" 

This will create a file called index.page, with the title ”Cheese Webcam Booth”. You can then edit that file and write content in it.

* Alternative Scenarios:

1. If you have a denied permission message,

[yulys@yulys C]$ yelp-new task index “Cheese Webcam Booth”
/usr/bin/yelp-new: line 129: index.page: Permission denied

a) Check the permission doing:  

ls -lH cheese/cheese/help

If it looks like:    drwxr-xr-x  5 root root …blah blah… C

you’ll have to change the owner of the directory back to you, or at least make it read-write.

b) Give the permission:

[root@yulys ~]# chown -R yulys.yulys /home/yulys/cheese/cheese/.git

I did it as a root , because I got this: [yulys@yulys help]$ sudo chown yulys.yulys -R * .
[sudo] password for yulys: 
yulys is not in the sudoers file. This incident will be reported.

c) Look for the entry for “C”. It should look something like this:

drwxr-xr-x. 3 yulys yulys  4096 Jun 21 14:31 C

2. If you got a fatal message while doing some git thing,

 [yulys@yulys ~]$ git checkout

fatal: Not a git repository (or any parent up to mount parent )
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).

Make sure that you are in the correct folder:

[yulys@yulys ~]$ cd cheese/cheese/help
[yulys@yulys help]$ gedit index.page
[yulys@yulys help]$ git checkout
M	help/index.page
Your branch is ahead of 'origin/master' by 1 commit.

3. If you got a fatal message after doing some git push in gitorious:

[yulys@yulys help]$ git add index.page
[yulys@yulys help]$ git commit -a
[master a9d4bd5] This is the index for Cheese
 1 files changed, 2 insertions(+), 2 deletions(-)
[yulys@yulys help]$ git push origin master
fatal: The remote end hung up unexpectedly

Make sure you are using gitorious’s repos instead of git repos and what the branch is

[yulys@yulys help]$ git remote -v
origin	git://git.gnome.org/cheese (fetch)
origin	git://git.gnome.org/cheese (push)

*** Finally, my first commit ***

[yulys@yulys cheese-docs]$ mv /home/yulys/cheese/cheese/help/index.page .

[yulys@yulys cheese-docs]$ ls

HACKING  index.page

[yulys@yulys cheese-docs]$ git branch

* master

[yulys@yulys cheese-docs]$ gedit index.page

[yulys@yulys cheese-docs]$ git checkout

[yulys@yulys cheese-docs]$ git commit -a

# On branch master

# Untracked files:

#   (use “git add <file>…” to include in what will be committed)

#

# index.page

# index.page~

nothing added to commit but untracked files present (use “git add” to track)

[yulys@yulys cheese-docs]$ git add index.page

[yulys@yulys cheese-docs]$ git commit -a

[master f36ec63] This is the principal page: Introduction and scope of Cheese

 1 files changed, 34 insertions(+), 0 deletions(-)

 create mode 100644 index.page

[yulys@yulys cheese-docs]$ git push origin master

Counting objects: 4, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (3/3), done.

Writing objects: 100% (3/3), 1.13 KiB, done.

Total 3 (delta 0), reused 0 (delta 0)

== Gitorious: ==========================================================

You do not have write access to this repository

========================================================================

error: hooks/pre-receive exited with error code 1

To git@gitorious.org:cheese-docs/cheese-docs.git

 ! [remote rejected] master -> master (pre-receive hook declined)

error: failed to push some refs to ‘git@gitorious.org:cheese-docs/cheese-docs.git’

[yulys@yulys cheese-docs]$