Changes between Version 18 and Version 19 of SynBuild

Timestamp:

01/19/17 14:38:33 (8 years ago)

Author:

Edwin Eefting

Comment:

--

SynBuild

@@ -62 +62 @@
 
 
+= Werken met git versie beheer =
 
-
-== svn tree updaten ==
-
-Om de wijzigingen van andere developers binnen te halen doe je af en toe een svn update: 
-
+Om de wijzigingen van andere developers binnen te halen doe je af en toe een git pull:
 {{{
-root@builder:/home/psy/syn3# svn update
-U    install/install.sh
-U    install/lang_nl.sh
-U    install/lang_pl.sh
-...
-Updated to revision 3421.
-
+psy@ws1 ~/opensyn3 % git pull
+Already up-to-date.
 }}}
 
 Het is handig om dit regelmatig te doen, en hierna de status te controleren
 
-== svn nieuwe files en directoryies toevoegen ==
+Er zijn vele andere commandos om bijvoorbeeld je wijzigingen op te slaan of naar DatuX te versturen.
 
-Als je een nieuw pakketje gemaakt hebt moet je deze directory markeren als toegevoegd:
-{{{
-root@builder:/home/psy/syn3# svn add npl/internetserver/ebtables
-A      npl/internetserver/ebtables
-A      npl/internetserver/ebtables/ebtables.pkg
-A      npl/internetserver/ebtables/ebtables.version
-A      npl/internetserver/ebtables/ebtables.md5
-A      npl/internetserver/ebtables/ebtables-v2.0.8-1.tar.gz
-A      npl/internetserver/ebtables/ebtables.SlackBuild
-A      npl/internetserver/ebtables/ebtables.arch
-}}}
-
-Dit gebeurd alleen lokaal, pas bij het committen (zie verderop) word de data ook naar de centrale server gestuurd.
-
-== svn status controleren ==
-
-Om te zien of het updaten goed gegaan is en om te zien of je wijzigingen gemaakt hebt gebruik je svn status. Dit commando laat de '''locale''' status van je tree zien en doet dus niks met de server:
-
-{{{
-root@builder:/home/psy/syn3# svn status
-?      test
-?      npl/bla
-A      npl/internetserver/ebtables
-A      npl/internetserver/ebtables/ebtables.pkg
-A      npl/internetserver/ebtables/ebtables.version
-A      npl/internetserver/ebtables/ebtables.md5
-A      npl/internetserver/ebtables/ebtables-v2.0.8-1.tar.gz
-A      npl/internetserver/ebtables/ebtables.SlackBuild
-A      npl/internetserver/ebtables/ebtables.arch
-M      npl/mailserver/syncml_openxchange/syncml_openxchange.SlackBuild
-...
-}}}
+Om te leren hoe git werkt verwijzen we je naar: https://git-scm.com/book/en/v2
 
 
-De eerste en tweede kolom zijn het belangrijkste, zie ook svn status --help:
+= Vervolg stappen =
 
-    First column: Says if item was added, deleted, or otherwise changed
-    *  ' ' no modifications
-    *  'A' Added
-    *  ''''C' Conflicted'''
-    *  'D' Deleted
-    *  'I' Ignored
-    *  'M' Modified
-    *  'R' Replaced
-    *  'X' item is unversioned, but is used by an externals definition
-    *  '?' item is not under version control
-    *  '!' item is missing (removed by non-svn command) or incomplete
-    *  '~' versioned item obstructed by some item of a different kind
+ * Voor meer info zie over de indeling van de source tree zie SynTree.
+ * Voor meer info over Syn-3 packets bouwen zie: SynPackaging
 
-    Second column: Modifications of a file's or directory's properties
-    *  ' ' no modifications
-    *  ''''C' Conflicted'''
-    *  'M' Modified
-
-Let er dus op dat je geen conflicten hebt. Als je dit wel hebt is het het handigste om de conflicteren de file en bijbehorden troep weg te halen en nogmaals update te doen. Een andere optie bij tekstfiles is de boel handmatig mergen.
-
-== Wijzgingen opslaan op svn server ==
-
-Hier heb je een account met schrijfrechten voor nodig!
-
-Als je een aantal wijzigingen gemaakt hebt moet je deze committen (opslaan), onder volgende voorwaarden:
-
- * Het gewijzigde onderdeel moet compleet zijn en het liefst als 1 geheel gecommit worden. (tenzij je een dag werk hebt, dan mag je een backup-commit doen)
- * Niet meer dan 1 onderdeel of wijziging tegelijk committen, bij iedere wijziging duidelijk commentaar!
- * Er moet niks stuk gaan waar anderen van afhankelijk zijn.
- * Nieuwe onderdelen op de juiste plek in de tree adden. (eventueel vragen aan edwin) Verderop vind je een overzicht van de tree indeling.
- * Indien het een pakket betreft, dit pakket eerst rebuilden alvorens te committen indien mogelijk.
-
-Stel we hebben de volgende status:
-{{{
-root@builder:/home/psy/syn3/npl/internetserver# svn status
-A      ebtables
-A      ebtables/ebtables.pkg
-A      ebtables/ebtables.version
-A      ebtables/ebtables.md5
-A      ebtables/ebtables-v2.0.8-1.tar.gz
-A      ebtables/ebtables.SlackBuild
-A      ebtables/ebtables.arch
-A      arptables
-A      arptables/arptables.version
-A      arptables/arptables.md5
-A      arptables/arptables-v0.0.3-2.tar.gz
-A      arptables/arptables.SlackBuild
-A      arptables/arptables.arch
-A      arptables/arptables.pkg
-}}}
-Zo te zien heb ik 2 nieuwe pakketjes gemaakt, er zijn dus 2 commits nodig:
-{{{
-root@builder:/home/psy/syn3/npl/internetserver# cd ebtables/
-root@builder:/home/psy/syn3/npl/internetserver/ebtables# svn commit -m 'nieuwe pakketje, nodig voor ethernet bridging en firewalling'
-Adding         ebtables
-Adding  (bin)  ebtables/ebtables-v2.0.8-1.tar.gz
-Adding         ebtables/ebtables.SlackBuild
-Adding         ebtables/ebtables.arch
-Adding         ebtables/ebtables.md5
-Adding  (bin)  ebtables/ebtables.pkg
-Adding         ebtables/ebtables.version
-Transmitting file data ......
-Committed revision 3422.
-root@builder:/home/psy/syn3/npl/internetserver/ebtables# cd ../arptables/
-root@builder:/home/psy/syn3/npl/internetserver/arptables# svn commit -m 'nieuw pakketje, nodig voor firewalling van arp pakketjes'
-Adding         arptables
-Adding  (bin)  arptables/arptables-v0.0.3-2.tar.gz
-Adding         arptables/arptables.SlackBuild
-Adding         arptables/arptables.arch
-Adding         arptables/arptables.md5
-Adding  (bin)  arptables/arptables.pkg
-Adding         arptables/arptables.version
-Transmitting file data ......
-Committed revision 3423.
-root@builder:/home/psy/syn3/npl/internetserver/arptables#
-}}}
-
-'''Let op:''' Als je eenmaal iets commit, kan dit nooit meer uit de history verwijderd worden. File en directorys kun je wel uit de tree verwijderen, maar ze blijven uiteraard bestaan in de oude revisie.
-
-=== Wijzigingen opslaan terwijl je geen rechten hebt ===
-
-Als je geen schrijfrechten hebt in de syn3 tree, kun je je wijzigingen op de volgende manier opslaan in een patch file:
-{{{
-psy /home/psy/syn3/npl # svn diff > bugfix-ldap.patch
-}}}
-
-Deze file kun je opsturen naar info@datux.nl, waarna hij gereviewed word en eventueel in de tree opgenomen word. Binary files worden niet meegenomen in een diff, daarom is het altijd van belang de orginele url mee naar de sourcefiles mee te sturen!
-
-= Branches maken =
-
-Soms kan het handig zijn een zogenaamde ''branch'' te maken. 
-
-Dit betekend dat je een bepaalde directory naar een appart deel op de SVN server kopieerd. Op deze manier kun je langere tijd aan grote wijzigingen werken, zonder dat mensen daar last van hebben.
-
-== Een nieuwe branch starten. ==
-
-Stel je bent al een tijdje bezig en je hebt nog niet gecommit. En je denkt: Ik wil dit niet comitten in de hoofd tree (trunk) want dan heeft iedereen last van mijn wijzigingen:
-{{{
-psy /home/psy/syn3/install # svn status
-M      meebezig
-}}}
-
-Kopieer de huidige versie, inclusief wijzigingen naar een branch:
-{{{
-psy /home/psy/syn3/install # svn copy . https://tracy.datux.nl/syn3/svndav/syn3/branches/installer-edwin
-
-Committed revision 4292.
-}}}
-
-Nu is er een nieuwe installer branch gemaakt op de SVN server. Om nu te zorgen dat je huidige werkdir aan die branch 'gekoppeld zit':
-{{{
-psy /home/psy/syn3/install # svn switch https://tracy.datux.nl/syn3/svndav/syn3/branches/installer-edwin
-G    meebezig
-Updated to revision 4292.
-psy /home/psy/syn3/install # svn status
-psy /home/psy/syn3/install #
-}}}
-
-Nu is in jou werk directory alleen /home/psy/syn3/install gekoppeld aan de branch. De rest van je tree zit nog gewoon aan trunk:
-{{{
-psy /home/psy/syn3/install # svn info
-Path: .
-URL: https://tracy.datux.nl/syn3/svndav/syn3/branches/installer-edwin
-Repository Root: https://tracy.datux.nl/syn3/svndav/syn3
-Repository UUID: 32fb8cd9-e6f8-0310-8218-8ae0250c70fb
-Revision: 4292
-Node Kind: directory
-Schedule: normal
-Last Changed Author: edwin
-Last Changed Rev: 4292
-Last Changed Date: 2008-11-06 10:31:18 +0100 (Thu, 06 Nov 2008)
-
-psy /home/psy/syn3/install # cd ..
-psy /home/psy/syn3 # svn info
-Path: .
-URL: https://tracy.datux.nl/syn3/svndav/syn3/trunk
-Repository Root: https://tracy.datux.nl/syn3/svndav/syn3
-Repository UUID: 32fb8cd9-e6f8-0310-8218-8ae0250c70fb
-Revision: 4287
-Node Kind: directory
-Schedule: normal
-Last Changed Author: edwin
-Last Changed Rev: 4285
-Last Changed Date: 2008-11-03 00:53:54 +0100 (Mon, 03 Nov 2008)
-}}}
-
-Zodra alle commits komen nu dus in je eigen branch, en niemand heeft hier last van.
-
-== Terug switchen naar trunk ==
-
-Dit kan zo:
-{{{
-psy /home/psy/syn3/install # svn switch https://tracy.datux.nl/syn3/svndav/syn3/trunk/install
-U    meebezig
-Updated to revision 4292.
-}}}
-
-Een switch doet ook meteen een svn update zoals je ziet. Als je nu in de file 'meebezig' kijkt, zie je de trunk versie en niet je eigen branch.
-
-Op deze manier kan je snel en makkelijk heen en weer switchen tussen trunk en je eigen branch.
-
-== Je branch terug mergen in trunk ==
-
-Als je branch zo ver is dat je de wijzigingen in trunk wilt mergen, switch je eerst terug naar trunk en tik je het volgende:
-{{{
-psy /home/psy/syn3/install # svn merge https://tracy.datux.nl/syn3/svndav/syn3/branches/installer-edwin
---- Merging r4288 through r4292 into '.':
-U    meebezig
-psy /home/psy/syn3/install # svn status
- M     .
-M      meebezig
-}}}
-
-Nu zijn de wijzigingen in je werk directory gemerged. Je kan controleren of de merge goed gegaan is en dan een svn commit doen als alles klopt.
-
-Je kan ook de nieuwste wijzigingen in de trunk naar jou branch mergen, op dezelfde manier. Switch dan eerst naar je branch en merge de trunk.
-
-
-== Huidige grote branches ==
-
- * Open syn-3 versie 5.x research en development: http://open.syn3.nl/syn3/trac/default/browser/branches/5.x
-
-= Meer info =
-
-Voor meer info zie over de indeling van de source tree zie SynTree.
-Voor meer info over Syn-3 packets bouwen zie: SynPackaging