User Tools

Site Tools


wiki:development:development-workspace

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
wiki:development:development-workspace [2011/08/09 08:02]
morty Remove git.....
wiki:development:development-workspace [2013/03/08 13:31]
127.0.0.1 external edit
Line 4: Line 4:
  
 Before you can start developing you need the source code. Before you can start developing you need the source code.
-The code is managed in a [[git | GIT repository]]. +The code is managed in a [[git| GIT repository]]. 
  
 ===== Building ===== ===== Building =====
 +
 +On Ubuntu you'll probably need the following dependencies to get a proper build:
 +
 +<code>
 +  sudo apt-get install devscripts debhelper \
 +    ubuntu-dev-tools build-essential \
 +    libldap2-dev libssh-dev libxpm-dev libcups2-dev
 +</code>
 +
 +More info in general form: [[https://wiki.ubuntu.com/PackagingGuide/HandsOn]]
 ==== Getting Build Dependencies ==== ==== Getting Build Dependencies ====
 Each git has a file'' debian/control''. It has a section ''Build-Depends''. Each git has a file'' debian/control''. It has a section ''Build-Depends''.
Line 13: Line 23:
  
 ==== Makefile ==== ==== Makefile ====
-Most projects should have makefile, that builds the project running make (This is work in progress).+ 
 +Most projects should have a Makefile, that builds the project by running make (This is work in progress).
  
 ==== DPKG ==== ==== DPKG ====
-installable package can be built running ''debuild -b -us -uc'' in the projet folder. The .deb-file will be place in the superior folder. The package can be installed using ''dpkg -i <packagenmame>*.deb''.+ 
 +An installable package can be built running ''debuild -b -us -uc'' in the project folder. The .deb-file will be placed in the superior folder. The package can be installed using ''dpkg -i <packagenmame>*.deb''.
  
  
Line 132: Line 144:
  
  
-===== Maintiner Stuff =====+===== Maintainer Stuff =====
  
 ==== Install Software ==== ==== Install Software ====
Line 165: Line 177:
  
  
-==== Reverting Merge Commits ==== 
- 
-If you forget to run ''git-pull'' before modifying code files you will run into merge problems when committing your changes. 
- 
-There is nothing bad about merge commits apart from the fact that the X2go Git system won't allow them being pushed to the server :-/. 
- 
-Thus, you probably want to avoid merge commits right from the beginning. However, from time to time it occurs that you crunch your Git log with a merge commit. This is how such a thing can happen: 
- 
-  * change a file 
-  * commit it locally 
-  * push it to X2go Git 
-  * find that the push operation gets rejected :-( 
-  * then run ''git-pull'' instead 
-  * and then uuups... realize: the ''git-pull'' fetched in some code for the same file, I have just been working on...) -> you probably forgot to run a ''git-pull'' before starting to work on that particular file... 
- 
-One possible solution for this is //cherry-picking//. Here is an example (presuming that your are working on the master branch): 
- 
-<code> 
-# make a temporary backup copy of the master branch 
-$ git checkout -b master-bak-tmp 
- 
-# go back to master branch 
-$ git checkout master 
- 
-# and reset it to that refspec where local Git and server's Git were known to be still in sync 
-$ git reset --hard <last-refspec-known-to-be-identical-with-server> 
- 
-# then take a look at the log of your old local master branch 
-$ git log master-bak-tmp 
- 
-# now cherry-pick your local changes individually from the master-bak-tmp branch (where refspec-1 ... refspec-n are the commit hashes of each commit): 
-$ git cherry-pick <refspec-1> 
-$ git cherry-pick <refspec-2> 
-... 
-$ git cherry-pick <refspec-n> 
- 
-# finally drop the tmp backup of old master 
-$ git branch -D master-bak-tmp 
-</code> 
- 
-==== Pushing to X2go Git ==== 
- 
-Whenever your local X2go Git project is in an acceptable state for the community, feel free to push the code to the X2go Git server: 
- 
-<code> 
-$ git push 
-</code> 
- 
-<note> 
-When working on master's HEAD do not wait __too__ long before pushing them to the server as it may happen that others work on master's HEAD as well. 
- 
-Keeping back code for too long can result in code conflicts (changes in the same code block of the same file by two different developers). 
-</note> 
- 
-The update scripts of X2go Git will shout warnings at you while pushing. These warnings relate to 
- 
-  * whitespaces found at the end of lines 
-  * tabs found in the file (for Python: no tabs, for Bash, Perl, C++, etc. tabs are wanted, so you can ignore these if not coding Python) 
-  * no \newline at end of file 
  
-You may consider silencing those warnings before committing the next time... 
  
-===== Releasing X2go Projects =====+==== Releasing X2go Projects ====
  
 The X2go version scheme is a four digit version number: ''<major>.<minor>.<micro>.<nano>'' The X2go version scheme is a four digit version number: ''<major>.<minor>.<micro>.<nano>''
Line 254: Line 206:
   - Before you continue working on the code you should make sure that the newly released code has been built on Launchpad and also moved to the x2go-stable PPA.   - Before you continue working on the code you should make sure that the newly released code has been built on Launchpad and also moved to the x2go-stable PPA.
  
-===== Git / Code Administration =====+==== Git / Code Administration ====
  
 For Git / code administation you have to be able to logon to the host ''code.x2go.org'' as user ''x2go-admin'': For Git / code administation you have to be able to logon to the host ''code.x2go.org'' as user ''x2go-admin'':
wiki/development/development-workspace.txt · Last modified: 2013/03/14 23:40 by sunweaver