KDE Games/Git Conversion Progress

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

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
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

MK

Mathias Kraus

NA

Nicolás Alvarez

NH

Ni Hui

PC

Parker Coates

SM

Stefan Majewsky

WR

Wolfgang Rohdewald