KDE Games/Git Conversion Progress: Difference between revisions

From KDE Community Wiki
(Added some rulesets in progress.)
(say conversion is finished)
 
(87 intermediate revisions by 11 users not shown)
Line 1: Line 1:
This page is used to keep track of progress in KDEGames's conversion from SVN to Git.
Update: As of September 10, 2012, the conversion is finished.
== How to Fill Out the Table ==
== How to Fill Out the Table ==


=== Rule Writers ===
=== Rule Writers ===


* When you start writing rules for a particular game, add your initials to the "Rules" column followed by a '%' to indicate that the rules are in progress so that efforts aren't duplicated.
The progress table uses a Mediawiki template with named parameters, to make it easier to edit than the raw table markup.
* Once you've written the rules and feel they're complete, push them to the kdegames directory of the kde-ruleset repository. Make your initials in the "Rules" column a link pointing to the rules file and remove the '%'.
 
* Once you've generated a repository from the rules and verified its correctness, push it some place public, preferably a personal scratch repo. Add your initials in the "Repo" column as a link pointing to the repository webpage.
* When you start writing rules for a particular game, add your initials in a <tt>rulesby=</tt> parameter, and set <tt>inprogress=1</tt>; for example <tt>rulesby=NA|inprogress=1</tt>. This will indicate that the rules are in progress so that efforts aren't duplicated.
* Once you've written the rules and feel they're complete, push them to the kdegames directory of the kde-ruleset repository and remove <tt>inprogress=1</tt> from the table. The "Rules" column will automatically turn into a link pointing to the rules file.
* Once you've generated a repository from the rules and verified its correctness, push it some place public, preferably a personal scratch repo. Add a <tt>scratch=</tt> param with the scratch repository path, and a <tt>scratchby=</tt> param with your initials; for example <tt>scratch=scratch/nalvarez/kdegames-foo.git|scratchby=NA</tt>.


=== Repository Checkers ===
=== Repository Checkers ===


* It is assumed that the rule writer has already verified the correctness of the repository, so don't bother adding yourself to the table.
* Checkout the repository, poke around a bit and then perform each of the following checks, adding your initials in each column. Ideally, more than one person should check each repo, in which case, separate each set of initials with a comma.
* Checkout the repository, poke around a bit and then perform each of the following checks, adding your initials in each column. Ideally, more than one person should check each repo, in which case, separate each set of initials with a comma.


=== The Checks ===
=== The Checks ===


; Check1 : The complete history is present. The first commit should be the initial import into KDE's CVS or SVN. All transitions from playground, kdereview, extragear, KDE3, etc. should be present.
; Main history : The complete history is present. The first commit should be the initial import into KDE's CVS or SVN. All transitions from playground, kdereview, extragear, KDE3, etc. should be present. [http://websvn.kde.org/trunk/KDE/kdegames/kshisen/?view=log Example]
; Check2 : The user documentation is in a subdirectory named "doc". The history of the doc folder should match that of the "kdegames/doc/<game>" folder.
; Docs : The user documentation is in a subdirectory named "doc". The history of the doc folder should match that of the "kdegames/doc/<game>" folder. In very early revisions there can be a doc/ or html/ folder inside the game.
; Check3 : Commit messages contain the original SVN path and revision numbers. (--add-metadata was used during conversion.)
; Heads : The repository has only one head. (git branch -r) Two heads mean a broken master branch. <syntaxhighlight lang="bash">git log --format='%h %p' --all | grep '^[0-9a-f]\+ *$'</syntaxhighlight> (if that shows more than one commit, something is wrong)
; Check4 : The repository has only one head. (git branch -r) Two heads mean a broken master branch.
; Stable branches : All relevant stable branches are present. If a game entered the kdegames module for the 4.3 release, it should have a stable branch "KDE/4.x" for each x >= 3 and none for x < 3.
; Check5 : All relevant stable branches are present. If a game entered the kdegames module for the 4.3 release, it should have a stable branch "KDE/4.x" for each x >= 3 and none for x < 3.
; Tags: All relevant release tags are present. If a game entered the kdegames module for the 4.3 release, it should have tags "v4.x.y" and newer.
; Check6 : All relevant release tags are present. If a game entered the kdegames module for the 4.3 release, it should have tags "KDE/4.x.y" for each x >= 3 and none for x < 3.
; Branches : If the game has a non-linear history (i.e. work branches were created and later merged back in to trunk) that should be recreated in the Git history. This is by far the most difficult check. Use "gitk --all" or "qgit --all" to visualise branches and merges, but you have to know what you're looking for. Fortunately, this isn't required for games that have a simple playground -> kdereview -> kdegames history. To determine where an application has been throughout its history, enter its name into [http://stuff.povaddict.com.ar/kde-svn-search.php this page], which will return all known SVN change paths containing the name. (Pay no attention to the l10n and www stuff.)
; Check7 : All stable branches are of the format "KDE/X.Y" and all release tags are of the format "vX.Y.Z".
; Content: There is a script kde-ruleset/kdegames/compare which compares the checked out tree between svn and git for master and all branches 1.0 up to 4.9. It should not show any differences.
; Check8 : If the game has a non-linear history (i.e. work branches were created and later merged back in to trunk) that should be recreated in the Git history. This is by far the most difficult check. Use git gui to visualise branches and merges, but you have to know what you're looking for. Fortunately, this isn't required for games that have a simple playground -> kdereview -> kdegames history.


== Contributor Initials ==
== The Table, Fall 2012 ==


; MK : Mathias Kraus
The scratch repositories in this table should be ready for migration, all postprocessing is done.
; PC : Parker Coates
; WR : Wolfgang Rohdewald


== The Table ==
Everything checked by WR, double checks are needed!


{| style="background-color:#EEEEEE"
{| style="background-color:#EEEEEE" class="wikitable"
|-
|-
! !! Rules !! Repo !! Check1 !! Check2 !! Check3 !! Check4 !! Check5 !! Check6 !! Check7 !! Check8
! !! Rules !! Repo !! Main history !! Docs !! Heads !! Stable branches !! Tags !! Branches
{{KdeGamesSvn2GitRow|bomber|longname=Bomber|rulesby=PC|scratchby=PC|scratch=scratch/wrohdewald/bomber.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|bovo|longname=Bovo|rulesby=PC|scratchby=PC|scratch=scratch/wrohdewald/bovo.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|granatier|longname=Granatier|rulesby=MK|scratch=scratch/wrohdewald/granatier.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kajongg|longname=Kajongg|rulesby=WR|scratch=scratch/wrohdewald/kajongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kapman|longname=Kapman|rulesby=PC|scratch=scratch/wrohdewald/kapman.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|katomic|longname=Katomic|rulesby=WR|scratch=scratch/wrohdewald/katomic.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kblackbox|longname=KBlackBox|rulesby=WR|scratch=scratch/wrohdewald/kblackbox.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kblocks|longname=KBlocks|rulesby=PC|scratch=scratch/wrohdewald/kblocks.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kbounce|longname=KBounce|rulesby=WR|scratch=scratch/wrohdewald/kbounce.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kbreakout|longname=KBreakout|rulesby=PC|scratch=scratch/wrohdewald/kbreakout.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kdiamond|longname=KDiamond|rulesby=SM|scratch=scratch/wrohdewald/kdiamond.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kfourinline|longname=KFourInLine|rulesby=FS|scratch=scratch/wrohdewald/kfourinline.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kgoldrunner|longname=KGoldrunner|rulesby=FS|scratch=scratch/wrohdewald/kgoldrunner.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kigo|longname=Kigo|rulesby=PC|scratch=scratch/wrohdewald/kigo.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|killbots|longname=Killbots|rulesby=PC|scratch=scratch/wrohdewald/killbots.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kiriki|longname=Kiriki|rulesby=PC|scratch=scratch/wrohdewald/kiriki.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kjumpingcube|longname=KJumpingCube|rulesby=FS|scratch=scratch/wrohdewald/kjumpingcube.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|klickety|longname=Klickety|rulesby=NH|scratch=scratch/wrohdewald/klickety.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|klines|longname=KLines|rulesby=FS|scratch=scratch/wrohdewald/klines.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kmahjongg|longname=KMahjongg|rulesby=WR|scratch=scratch/wrohdewald/kmahjongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kmines|longname=KMines|rulesby=PC|scratch=scratch/wrohdewald/kmines.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|knavalbattle|longname=KNavalBattle|rulesby=FS|scratch=scratch/wrohdewald/knavalbattle.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|knetwalk|longname=KNetWalk|rulesby=PC|scratch=scratch/wrohdewald/knetwalk.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kolf|longname=Kolf|rulesby=WR|scratch=scratch/wrohdewald/kolf.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kollision|longname=Kollision|rulesby=PC|scratch=scratch/wrohdewald/kollision.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|konquest|longname=Konquest|rulesby=FS|scratch=scratch/wrohdewald/konquest.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kpat|longname=KPatience|rulesby=NA|scratch=scratch/wrohdewald/kpat.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kreversi|longname=KReversi|rulesby=WR|scratch=scratch/wrohdewald/kreversi.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kshisen|longname=KShisen|rulesby=FS|scratch=scratch/wrohdewald/kshisen.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksirk|longname=KSirk|rulesby=WR|scratch=scratch/wrohdewald/ksirk.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksnakeduel|longname=KSnakeDuel|rulesby=FS|scratch=scratch/wrohdewald/ksnakeduel.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksokoban|longname=KSokoban|rulesby=WR|scratch=scratch/wrohdewald/ksokoban.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kspaceduel|longname=KSpaceDuel|rulesby=WR|scratch=scratch/wrohdewald/kspaceduel.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksquares|longname=KSquares|rulesby=PC|scratch=scratch/wrohdewald/ksquares.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksudoku|longname=KSudoku|rulesby=PC|scratch=scratch/wrohdewald/ksudoku.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ktuberling|longname=KTuberling|rulesby=NA|scratch=scratch/wrohdewald/ktuberling.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kubrick|longname=Kubrick|rulesby=PC|scratch=scratch/wrohdewald/kubrick.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|libkdegames|longname=libkdegames|rulesby=SM|scratch=scratch/wrohdewald/libkdegames.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|libkmahjongg|longname=libkmahjongg|rulesby=WR|scratch=scratch/wrohdewald/libkmahjongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|lskat|longname=Lieutenant Skat|rulesby=WR|scratch=scratch/wrohdewald/lskat.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|palapeli|longname=Palapeli|rulesby=SM|scratch=scratch/wrohdewald/palapeli.git|scratchby=WR}}
|}


|-
== The Table, Spring 2012 ==
! Bomber
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fbomber-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fbomber-conversion-test.git PC]
| || || || || || || || ||


|-
<!-- If you change the columns here, even if it's only the order,
! Bovo
remember to update the KdeGamesSvn2GitRow template too! -->
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fbovo-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fbovo-conversion-test.git PC]
| || || || || || || || ||


{| style="background-color:#EEEEEE" class="wikitable"
|-
|-
! Granatier
! !! Rules !! Repo !! Main history !! Docs !! Heads !! Stable branches !! Tags !! Branches
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fgranatier-rules MK]
{{KdeGamesSvn2GitRow|bomber|longname=Bomber|rulesby=PC|scratchby=PC|scratch=scratch/coates/bomber-conversion-test.git}}
|
{{KdeGamesSvn2GitRow|bovo|longname=Bovo|rulesby=PC|scratchby=PC|scratch=scratch/coates/bovo-conversion-test.git}}
| || || || || || || || ||
{{KdeGamesSvn2GitRow|granatier|longname=Granatier|rulesby=MK|scratch=scratch/mkraus/granatier-conversion-test.git|scratchby=MK}}
{{KdeGamesSvn2GitRow|kajongg|longname=Kajongg|rulesby=WR|scratch=scratch/wrohdewald/kajongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kapman|longname=Kapman|rulesby=PC|scratch=scratch/coates/kapman-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|katomic|longname=Katomic|rulesby=WR|scratch=scratch/wrohdewald/katomic-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kblackbox|longname=KBlackBox|rulesby=WR|scratch=scratch/wrohdewald/kblackbox-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kblocks|longname=KBlocks|rulesby=PC|scratch=scratch/coates/kblocks-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|kbounce|longname=KBounce|rulesby=WR|scratch=scratch/wrohdewald/kbounce-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kbreakout|longname=KBreakout|rulesby=PC|scratch=scratch/coates/kbreakout-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|kdiamond|longname=KDiamond|rulesby=SM|scratch=scratch/majewsky/kdiamond-conversion-test.git|scratchby=SM}}
{{KdeGamesSvn2GitRow|kfourinline|longname=KFourInLine|rulesby=FS}}
{{KdeGamesSvn2GitRow|kgoldrunner|longname=KGoldrunner|rulesby=FS|scratch=scratch/schwarzer/kgoldrunner-conversion-test.git|scratchby=FS|tagscheck=<ref>out-of-kdegames tags: http://websvn.kde.org/tags/kgoldrunner/</ref>}}
{{KdeGamesSvn2GitRow|kigo|longname=Kigo|rulesby=PC|scratch=scratch/coates/kigo-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|killbots|longname=Killbots|rulesby=PC|scratch=scratch/coates/killbots-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|kiriki|longname=Kiriki|rulesby=PC|scratch=scratch/coates/kiriki-conversion-test2.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|kjumpingcube|longname=KJumpingCube|rulesby=FS}}
{{KdeGamesSvn2GitRow|klickety|longname=Klickety|rulesby=NH|scratch=scratch/nihui/klickety.git|scratchby=NH}}
{{KdeGamesSvn2GitRow|klines|longname=KLines|rulesby=FS}}
{{KdeGamesSvn2GitRow|kmahjongg|longname=KMahjongg|rulesby=WR|scratch=scratch/wrohdewald/kmahjongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kmines|longname=KMines|rulesby=PC|inprogress=1}}
{{KdeGamesSvn2GitRow|knavalbattle|longname=KNavalBattle|rulesby=FS}}
{{KdeGamesSvn2GitRow|knetwalk|longname=KNetWalk|rulesby=PC|scratch=scratch/coates/knetwalk-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|kolf|longname=Kolf|rulesby=WR|scratch=scratch/wrohdewald/kolf-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kollision|longname=Kollision|rulesby=PC|scratch=scratch/coates/kollision-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|konquest|longname=Konquest|rulesby=FS}}
{{KdeGamesSvn2GitRow|kpatience|longname=KPatience|rulesby=NA}}
{{KdeGamesSvn2GitRow|kreversi|longname=KReversi|rulesby=WR|scratch=scratch/wrohdewald/kreversi-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|kshisen|longname=KShisen|rulesby=FS|tagscheck=early tags broken}}
{{KdeGamesSvn2GitRow|ksirk|longname=KSirk|rulesby=WR|scratch=scratch/wrohdewald/ksirk-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksnakeduel|longname=KSnakeDuel|rulesby=FS}}
{{KdeGamesSvn2GitRow|kspaceduel|longname=KSpaceDuel|rulesby=WR|scratch=scratch/wrohdewald/kspaceduel-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|ksquares|longname=KSquares|rulesby=PC|scratch=scratch/coates/ksquares-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|ksudoku|longname=KSudoku|rulesby=PC|scratch=scratch/coates/ksudoku-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|ktuberling|longname=KTuberling|rulesby=NA}}
{{KdeGamesSvn2GitRow|kubrick|longname=Kubrick|rulesby=PC|scratch=scratch/coates/kubrick-conversion-test.git|scratchby=PC}}
{{KdeGamesSvn2GitRow|libkdegames|longname=libkdegames|rulesby=SM|branchescheck=parentmap missing!}}
{{KdeGamesSvn2GitRow|libkmahjongg|longname=libkmahjongg|rulesby=WR|scratch=scratch/wrohdewald/libkmahjongg.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|lskat|longname=Lieutenant Skat|rulesby=WR|scratch=scratch/wrohdewald/lskat-conversion-test.git|scratchby=WR}}
{{KdeGamesSvn2GitRow|palapeli|longname=Palapeli|rulesby=SM}}
|}
<references/>


|-
== Contributor Initials ==
! Kajongg
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkajongg-rules WR]
| [http://quickgit.kde.org/index.php?p=scratch%2Fwrohdewald%2Fkajongg.git WR]
| || || || || || || || ||


|-
; CK : Christian Krippendorf
! Kapman
; FS : Frederik Schwarzer
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkapman-rules PC]
; IW : Ian Wadham
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkapman-conversion-test.git PC]
; MK : Mathias Kraus
| || || || || || || || ||
; NA : Nicolás Alvarez
 
; NH : Ni Hui
|-
; PC : Parker Coates
! Katomic
; SM : Stefan Majewsky
|
; WR : Wolfgang Rohdewald
|
| || || || || || || || ||
 
|-
! KBlackBox
|
|
| || || || || || || || ||
 
|-
! KBlocks
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkblocks-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkblocks-conversion-test.git PC]
| || || || || || || || ||
 
|-
! KBounce
|
|
| || || || || || || || ||
 
|-
! KBreakout
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkbreakout-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkbreakout-conversion-test.git PC]
| || || || || || || || ||
 
|-
! KDiamond
|
|
| || || || || || || || ||
 
|-
! KFourInLine
|
|
| || || || || || || || ||
 
|-
! KGoldrunner
|
|
| || || || || || || || ||
 
|-
! Kigo
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkigo-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkigo-conversion-test.git PC]
| || || || || || || || ||
 
|-
! Killbots
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkillbots-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkillbots-conversion-test.git PC]
| || || || || || || || ||
 
|-
! Kiriki
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkiriki-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkiriki-conversion-test2.git PC]
| || || || || || || || ||
 
|-
! KJumpingCube
|
|
| || || || || || || || ||
 
|-
! Klickety
|
|
| || || || || || || || ||
 
|-
! KLines
|
|
| || || || || || || || ||
 
|-
! KMahjongg
|
|
| || || || || || || || ||
 
|-
! KMines
|
|
| || || || || || || || ||
 
|-
! KNavalBattle
|
|
| || || || || || || || ||
 
|-
! KNetWalk
| PC%
|
| || || || || || || || ||
 
|-
! Kolf
|
|
| || || || || || || || ||
 
|-
! Kollision
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkollision-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkollision-conversion-test.git PC]
| || || || || || || || ||
 
|-
! Konquest
|
|
| || || || || || || || ||
 
|-
! KPatience
| NA%
|
| || || || || || || || ||
 
|-
! KReversi
|
|
| || || || || || || || ||
 
|-
! KShisen
|
|
| || || || || || || || ||
 
|-
! KSirk
|
|
| || || || || || || || ||
 
|-
! KSnakeDuel
|
|
| || || || || || || || ||
 
|-
! KSpaceDuel
|
|
| || || || || || || || ||
 
|-
! KSquares
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fksquares-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fksquares-conversion-test.git PC]
| || || || || || || || ||
 
|-
! KSudoku
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fksudoku-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fksudoku-conversion-test.git PC]
| || || || || || || || ||
 
|-
! KTuberling
| NA%
|
| || || || || || || || ||
 
|-
! Kubrick
| [http://quickgit.kde.org/index.php?p=kde-ruleset.git&a=blob&f=kdegames%2Fkubrick-rules PC]
| [http://quickgit.kde.org/index.php?p=scratch%2Fcoates%2Fkubrick-conversion-test.git PC]
| || || || || || || || ||
 
|-
! libkdegames
|
|
| || || || || || || || ||
 
|-
! libkmahjongg
|
|
| || || || || || || || ||
 
|-
! Lieutenant Skat
|
|
| || || || || || || || ||
 
|-
! Palapeli
|
|
| || || || || || || || ||
 
|}

Latest revision as of 23:09, 11 September 2012

This page is used to keep track of progress in KDEGames's conversion from SVN to Git.

Update: As of September 10, 2012, the conversion is finished.

How to Fill Out the Table

Rule Writers

The progress table uses a Mediawiki template with named parameters, to make it easier to edit than the raw table markup.

  • When you start writing rules for a particular game, add your initials in a rulesby= parameter, and set inprogress=1; for example rulesby=NA|inprogress=1. This will indicate that the rules are in progress so that efforts aren't duplicated.
  • Once you've written the rules and feel they're complete, push them to the kdegames directory of the kde-ruleset repository and remove inprogress=1 from the table. The "Rules" column will automatically turn into a link pointing to the rules file.
  • Once you've generated a repository from the rules and verified its correctness, push it some place public, preferably a personal scratch repo. Add a scratch= param with the scratch repository path, and a scratchby= param with your initials; for example scratch=scratch/nalvarez/kdegames-foo.git|scratchby=NA.

Repository Checkers

  • Checkout the repository, poke around a bit and then perform each of the following checks, adding your initials in each column. Ideally, more than one person should check each repo, in which case, separate each set of initials with a comma.

The Checks

Main history
The complete history is present. The first commit should be the initial import into KDE's CVS or SVN. All transitions from playground, kdereview, extragear, KDE3, etc. should be present. Example
Docs
The user documentation is in a subdirectory named "doc". The history of the doc folder should match that of the "kdegames/doc/<game>" folder. In very early revisions there can be a doc/ or html/ folder inside the game.
Heads
The repository has only one head. (git branch -r) Two heads mean a broken master branch.
git log --format='%h %p' --all | grep '^[0-9a-f]\+ *$'
(if that shows more than one commit, something is wrong)
Stable branches
All relevant stable branches are present. If a game entered the kdegames module for the 4.3 release, it should have a stable branch "KDE/4.x" for each x >= 3 and none for x < 3.
Tags
All relevant release tags are present. If a game entered the kdegames module for the 4.3 release, it should have tags "v4.x.y" and newer.
Branches
If the game has a non-linear history (i.e. work branches were created and later merged back in to trunk) that should be recreated in the Git history. This is by far the most difficult check. Use "gitk --all" or "qgit --all" to visualise branches and merges, but you have to know what you're looking for. Fortunately, this isn't required for games that have a simple playground -> kdereview -> kdegames history. To determine where an application has been throughout its history, enter its name into this page, which will return all known SVN change paths containing the name. (Pay no attention to the l10n and www stuff.)
Content
There is a script kde-ruleset/kdegames/compare which compares the checked out tree between svn and git for master and all branches 1.0 up to 4.9. It should not show any differences.

The Table, Fall 2012

The scratch repositories in this table should be ready for migration, all postprocessing is done.

Everything checked by WR, double checks are needed!

Rules Repo Main history Docs Heads Stable branches Tags Branches
Bomber PC WR
Bovo PC WR
Granatier MK WR
Kajongg WR WR
Kapman PC WR
Katomic WR WR
KBlackBox WR WR
KBlocks PC WR
KBounce WR WR
KBreakout PC WR
KDiamond SM WR
KFourInLine FS WR
KGoldrunner FS WR
Kigo PC WR
Killbots PC WR
Kiriki PC WR
KJumpingCube FS WR
Klickety NH WR
KLines FS WR
KMahjongg WR WR
KMines PC WR
KNavalBattle FS WR
KNetWalk PC WR
Kolf WR WR
Kollision PC WR
Konquest FS WR
KPatience NA WR
KReversi WR WR
KShisen FS WR
KSirk WR WR
KSnakeDuel FS WR
KSokoban WR WR
KSpaceDuel WR WR
KSquares PC WR
KSudoku PC WR
KTuberling NA WR
Kubrick PC WR
libkdegames SM WR
libkmahjongg WR WR
Lieutenant Skat WR WR
Palapeli SM WR

The Table, Spring 2012

Rules Repo Main history Docs Heads Stable branches Tags Branches
Bomber PC PC
Bovo PC PC
Granatier MK MK
Kajongg WR WR
Kapman PC PC
Katomic WR WR
KBlackBox WR WR
KBlocks PC PC
KBounce WR WR
KBreakout PC PC
KDiamond SM SM
KFourInLine FS
KGoldrunner FS FS [1]
Kigo PC PC
Killbots PC PC
Kiriki PC PC
KJumpingCube FS
Klickety NH NH
KLines FS
KMahjongg WR WR
KMines PC%
KNavalBattle FS
KNetWalk PC PC
Kolf WR WR
Kollision PC PC
Konquest FS
KPatience NA
KReversi WR WR
KShisen FS early tags broken
KSirk WR WR
KSnakeDuel FS
KSpaceDuel WR WR
KSquares PC PC
KSudoku PC PC
KTuberling NA
Kubrick PC PC
libkdegames SM parentmap missing!
libkmahjongg WR WR
Lieutenant Skat WR WR
Palapeli SM

Contributor Initials

CK
Christian Krippendorf
FS
Frederik Schwarzer
IW
Ian Wadham
MK
Mathias Kraus
NA
Nicolás Alvarez
NH
Ni Hui
PC
Parker Coates
SM
Stefan Majewsky
WR
Wolfgang Rohdewald