Some hackers like to put their source code under revision control, in a repository that remembers changes to files in a software project. The internet has multiple places that provide such repositories. OpenSVN is one such place, and is also the location of Kernigh's Personal Repository. OpenSVN provides Subversion repositories and Trac instances.
- Subversion keeps track of old versions of files, uses atomic changesets, permits branching by copying, computes differences, and facilitates merges.
- Trac provides a web interface to browse a Subversion repository.
The FAQ of OpenSVN states, "OpenSVN is currently operated by several enthusiastic students at Department of Computer Science and Information Engineering, National Taiwan University, Taiwan, R.O.C."
Kernigh's Personal Repository
Trac browser is the best way to explore the repository. ViewCVS browser is an alternative. The ViewCVS interface tends to be slower, because each page loads a menu of all the repositories. Trac pages do not load this menu, and Trac also provides a nicer interface and a Timeline page. However, ViewCVS now works across both HTTP and HTTPS, while Trac requires HTTPS.
Kernigh uses OpenSVN to store the source code for ObjectNecromancer, Xtank and some other projects. Though Trac can also have wiki pages and tickets (like bug reports), Kernigh does not use those Trac features.
HTTPS Information
You need HTTPS to use the Trac browser. When you connect to OpenSVN by HTTPS, your computer will warn about an unverified certificate. There are two ways to solve this.
- Create a security exception for opensvn.csie.org, or
- Go to http://ca.csie.org/ and install their root CA and trust it to verify web sites.
(The risk of an unverified certificate is that someone else might pretend to be OpenSVN. So you might not want to give your credit card number or payment information to OpenSVN!)
Fetching source code to your computer
If your computer has a Subversion client, then you may copy files from Kernigh's Personal Repository to your computer. (Most Unix/Linux systems provide a Subversion package.) The repository is a single Subversion root at http://opensvn.csie.org/kernigh which permits anonymous checkouts and allows access through either HTTP or HTTPS. Here are some examples of how you may use the svn command from a Unix/Linux computer with Subversion.
Checkout a copy of Xtank from Kernigh.
Place the copy in a directory called "xtank-svn".
$ svn co http://opensvn.csie.org/kernigh/trunk/xtank xtank-svn
Update that copy of Xtank to the latest revision in trunk.
$ cd xtank-svn
$ svn up
Show the changes that you made to your copy.
$ svn status
$ svn diff
Undo the changes that you made to your copy.
$ svn revert
Layout of the Repository
Starting with r25, Kernigh's project root contains the typical "branches", "tags", and "trunk" directories. Revisions before r25 have only a "trunk" directory, without branches or tags. Revisions before r16 use a different layout without a trunk.
Within Kernigh's Personal Repository, a branch or tag is a copy of one subdirectory of the trunk. (Within most other repositories, a branch or tag is a copy of the entire trunk.) Each individual project lives in a subdirectory of the trunk (instead of having its own separate trunk). The trunk/README file contains a list of the projects in the trunk.
The text of this wiki page is in the PublicDomain.
Comments (0)
You don't have permission to comment on this page.