- 1 Git and eTrice
- 1.1 Git in general and Git at Eclipse
- 1.2 Installations on your computer
- 1.3 Clone eTrice Repository
- 1.4 Create a Patch via Git Gui
- 1.5 Checkout a previous revision
- 1.6 working with branches
- 1.7 Using the eTrice github clone
- 1.8 Some hints to create Documentation
Git and eTrice
For eTrice we are using the Git-Repository from eclipse. For those people, who are not so familiar with Git, this chapter will give a step by step introduction.
Git in general and Git at Eclipse
- General: complete online version of the ProGIT book: http://progit.org/book/
- Git@Eclipse: http://wiki.eclipse.org/Git
- For committers: http://wiki.eclipse.org/Git_for_Committers
- You can diretly get Web access to git repositories: http://git.eclipse.org/
After installation of EGit in Eclipse, you can look up "Git for Eclipse Users" in the EGit Documentation.
Installations on your computer
- download git: http://git-scm.com/download
- e.g. for Windows: Git-184.108.40.206-preview20101002.exe
- Line Endings:
- Windows: check out Windows-style, commit Unix-style line endings
- Linux: Checkout as is, commit Unix-style line endings
- install EGit (update site): http://download.eclipse.org/egit/updates
Clone eTrice Repository
IMPORTANT: execute in shell or git shell:
- git config --global user.email <your email address>
- git config --global user.name "<your user name>"
pull/push (only for committers)
- ssh: git clone ssh://<dein commiter name>@git.eclipse.org/gitroot/etrice/org.eclipse.etrice.git
- https: git clone https://<dein commiter name>@git.eclipse.org/gitroot/etrice/org.eclipse.etrice.git
- http: git clone http://git.eclipse.org/gitroot/etrice/org.eclipse.etrice.git
- create empty workspace
- open view "Git Repositories" or perspective "Git Repository Exploring"
- add repository path of your local git repository you cloned before
- contextmenu on repository: "Import Projects..."
- Next >
- Select All + Finish
Create a Patch via Git Gui
- open the Git Gui from your windows menu
- open your "local Git Repositoriy"
- from the main menu select "Projektarchiv" => "Historie von >>master<< darstellen"
- in the new window the latest master version must be selected (blue)
- right click on "lokale Änderungen"
- in the contextmenu select "Patch erstellen"
Checkout a previous revision
Inspect the log and determine the commit id you want to change to.
git checkout this:
$ git checkout 2eb90f4643fd425f77de2b88753a86416cda0166 Note: checking out '2eb90f4643fd425f77de2b88753a86416cda0166'.
You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout.
If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example:
git checkout -b new_branch_name
HEAD is now at 2eb90f4... ui.structure: during creation take position as midpoint of new interface item. Adjusted PopulateDiagramCommand accordingly.
working with branches
creating a local branch
pushing a local branch
creating a remote tracking branch
pulling for remote tracking branches
If you often merge with the same branch, you may want to use something like the following in your configuration file:
[branch "before_indigo"] remote = <nickname> merge = <remote-ref>
[remote "<nickname>"] url = <url> fetch = <refspec>
With EGit the configuration can be accesses from the Git Repositories View context menu > Open Properties View The Properties View displays the current configuration and offers an Edit button in the upper left corner.
Using the eTrice github clone
According to https://bugs.eclipse.org/bugs/show_bug.cgi?id=332970 Eclipse projects with git repositories (and correct metadata set) are mirrored to github.
And so is eTrice: https://github.com/eclipse/etrice
Here are some slides explaining how github is accessed using EGit: http://www.slideshare.net/loianeg/using-the-egit-eclipse-plugin-with-git-hub-2578587
Any github user can fork an existing github repository. This facilitates collaborating with contributors which have no commit rights.
See also the Wiki page on Git contributions.
TODO: typical workflow...
Some hints to create Documentation
Location of Documentation
- ETrice Documentation will be put to org.eclipse.etrice.doc
- numbering of chapters is 000-xxx, 005-yyy, 010-zzz, 015... to have room for inject some chapters
- images (put to the folder images) should have the same numbering according to the chapters
- within the etrice-index.txt document the ordering of the chapters will be done. This file will be used from the build prozess to collect all single .textile files to produce the complete Doku.
- build prozess will be started from the external tool menu => "build-etrice-doc". (you must have internet access during production of the docu)
Within the .textile file
- with F1 you can get a list of the formating strings
- some formating options does not work well for all document types e.g. __italic__ does not work in the pdf file if the string contains "_". => therefore, for names which reference a concrete model name (shown in a picture or code block) use: "??This_is_my_name??" == citation
- use IrfanView to create screen shots (everything on board what you need)
- use the png format to save pictures (i had never problems with that)
- pictures should not be larger than 640*480 pixels. Otherwise they will cause problems in the PDF file. IrfanView: Ctrl+r => resize image
- to sharpen the images, use IrfanView: Image=>sharpen to create perfect screen shots.