r386 - /
Thomas Schmidt
pkg-vdr-dvb-changes@lists.alioth.debian.org
Sat, 09 Apr 2005 15:04:55 +0000
Author: tschmidt
Date: 2005-04-09 15:04:54 +0000 (Sat, 09 Apr 2005)
New Revision: 386
Added:
index.html
Log:
Initial import of a very simple webpage for the project
Added: index.html
===================================================================
--- index.html 2005-04-06 19:14:45 UTC (rev 385)
+++ index.html 2005-04-09 15:04:54 UTC (rev 386)
@@ -0,0 +1,126 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+
+<head>
+ <title>Debian VDR and DVB Packaging Project</title>
+ <meta name="GENERATOR" content="Quanta Plus">
+ <meta name="AUTHOR" content="Thomas Schmidt <tschmidt@debian.org>">
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body>
+<h1>Debian VDR and DVB Packaging Project</h1>
+<h2>How-to build our packages</h2>
+ First you need to install subversion and svn-buildpackage.
+
+ <h3>ssh</h3>
+
+ Now let's configure ssh to use allways the right username when
+ logging into svn.debian.org (<strong>Note:</strong> You only need this step if
+ have commit access to svn.debian.org in the pkg-vdr-dvb project,
+ if you just have read-only access, you can skip this step.)
+ <br><br>
+ You should put the following into your ~/.ssh/config:
+ <br><br>
+ <code>
+ Host svn.debian.org<br>
+ Compression=yes<br>
+ User=<your_Alioth_username><br>
+ IdentityFile=/home/<your_local_username>/.ssh/<name_of_you_sshkey><br>
+ </code>
+ <br>
+ (Of course you can skip the IdentityFile line and use password
+ authentication, but believe me, it is much more comfortable
+ this way.) ;-)
+ <br><br>
+ You have to place the public key into you homedirectory on
+ svn.debian.org manually by copying it to via scp to
+ svn.debian.org and appending it to ~/.ssh/authorized_keys:
+ <br><br>
+ <code>
+ scp /home/<your_local_username>/.ssh/<name_of_you_sshkey>.pub svn.debian.org:<br>
+ ssh svn.debian.org<br>
+ mkdir ~/.ssh<br>
+ cat <name_of_you_sshkey>.pub >> ~/.ssh/authorized_keys<br>
+ </code>
+ <br>
+ <strong>Another note:</strong> I can only recommend that you use a
+ ssh-key with passphrase together with the ssh-agent (ssh-add), but
+ it is up to you, to decide this.
+
+ <h3>Directory layout</h3>
+
+ The recommended directory layout for you working copies looks
+ like this
+ <br><br>
+ <code>
+ basedir/build-area/<br>
+ basedir/dvb/<br>
+ basedir/dvb/linuxtv-dvb<br>
+ basedir/dvb/linuxtv-dvb-apps<br>
+ basedir/general/<br>
+ basedir/tarballs/<br>
+ basedir/vdr/<br>
+ basedir/vdr/vdr/<br>
+ basedir/vdr/vdr-plugin-mp3/<br>
+ </code>
+ <br>
+ Please note that the package directories only contain the debian
+ subdirectory, the upstream sources will be merged with the debian
+ directory automatically by svn-buildpackage at build-time, the
+ upstream tarballs are located in the tarballs directory.
+ <br><br>
+ Every package directory in the repository contains 3 subdirectories,
+ trunk, branches and tags. Normal development will be done in the
+ trunk directory, branches should contain branches of the package
+ (For example it is planned to add a sarge branch for packages in
+ sarge soon.), the tags directory contains copies of all uploaded
+ version of the package (You should not edit anything inside the
+ tags directory, it should be used to get a specific version of a
+ package from the repository.)
+
+ <h3>checking out and building</h3>
+
+ The next step is to checkout the necessary files from the subversion
+ repository (<strong>Note:</strong> It is recommended that you checkout
+ only the trunk-directories of the packages, because checking out every
+ module with the trunk, branches and tags directories would consume a
+ lot of space on your disk.)
+ <br><br>
+ OK, lets checkout and build the vdr package as an example:
+ <br><br>
+ <code>
+ cd basedir<br>
+ svn co svn+ssh://svn.debian.org/svn/pkg-vdr-dvb/tarballs<br>
+ svn co svn+ssh://svn.debian.org/svn/pkg-vdr-dvb/vdr/vdr/trunk vdr/vdr<br>
+ cd vdr/vdr<br>
+ svn-buildpackage -rfakeroot -uc -us<br>
+ </code>
+ <br>
+ If you only have read-only access to svn.debian.org, you just have
+ to use svn:// instead of svn+ssh:// when checking out the files.
+ <br><br>
+ My ~/.svn-buildpackage.conf contains just one line, similar to this one:
+ <br><br>
+ <code>svn-override=buildArea=/basedir/build-area,origDir=/basedir/tarballs</code>
+ <br><br>
+ This means that svn-buildpackage allways will build and place the
+ resulting packages in /basedir/build-area/ and that it will get
+ the upstream tarballs from /basedir/tarballs/.
+ <br><br>
+ Additional documentation on svn-buildpackage and the other related
+ tools can be found under /usr/share/doc/svn-buildpackage/.
+
+ <h2>Links</h2>
+ <ol>
+ <li><a href="https://alioth.debian.org/projects/pkg-vdr-dvb/">Our project page</a></li>
+ <li><a href="http://svn.debian.org/wsvn/pkg-vdr-dvb">Our subversion repository</a></li>
+ <li><a href="http://qa.debian.org/developer.php?login=Debian+VDR+Team&
+ set=yes&bugs=3&version=1&excuses=1&bin=1&buildd=1&security=0&problems=1
+ &uninstallable=0&watch=1§ion=0&priority=0&pool=0">Developer page
+ for the Debian VDR Team</a></li>
+ <li><a href="http://people.debian.org/~igloo/status.php?email=pkg-vdr-
+ dvb-devel%40lists.alioth.debian.org">Build status of our packages</a></li>
+ <li><a href="http://svnbook.org/">Subversion book</a></li>
+ </ol>
+</body>
+</html>