[Pkg-voip-commits] r9455 - /README

[tzafrir at alioth.debian.org]

Author: tzafrir
Date: Tue Jan 31 14:16:40 2012
New Revision: 9455

URL: http://svn.debian.org/wsvn/pkg-voip/?sc=1&rev=9455
Log:
README: basic git setup instructions

Modified:
    README

Modified: README
URL: http://svn.debian.org/wsvn/pkg-voip/README?rev=9455&op=diff
==============================================================================
--- README (original)
+++ README Tue Jan 31 14:16:40 2012
@@ -85,7 +85,7 @@
 
 
 Using svn-buildpackage
-----------------------
+~~~~~~~~~~~~~~~~~~~~~~
 Packages with an upstream tarball will require you to set the mergeWithUpstream
 property first (from the package root) so that svn-buildpackage will look for
 the .orig.tar.gz in the ../tarballs directory.
@@ -176,7 +176,7 @@
 may come in handy.
 
 Tarballs and Build-area directories
----------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 You need to place those dirs in the parent directory of the one from which you're 
 running svn-buildpackage. Usually this means placing tarballs/ and build-area/ dirs 
 in 'pkgname'/ dir, at the same level as trunk/
@@ -194,7 +194,7 @@
 --svn-tag.
 
 Using svn-inject
-----------------
+~~~~~~~~~~~~~~~~
 To inject a new package into the Debian VoIP SVN archive you should use svn-inject(1)
 as follows:
 	
@@ -204,6 +204,46 @@
 uploaded to the archive.  Note you will also need to manually copy the 
 package.orig.tar.gz to your tarballs directory.  The -o option is important as 
 this ensures that we 'Only keep modified files under SVN control'
+
+
+Git repositories
+----------------
+We have a set of git repositories on Alioth, all under `pkg-voip`. See
+http://wiki.debian.org/Alioth/Git
+
+* Browse a repository: http://anonscm.debian.org/gitweb/?p=pkg-voip/foo.git
+* Read-only clone: `git clone git://anonscm.debian.org/pkg-voip/foo.git`
+* As a developer: `git+ssh://git.debian.org/git/pkg-voip/foo.git'
+
+Authorized SSH keys are controlled at https://alioth.debian.org/account/
+
+Creating a Git Repository
+~~~~~~~~~~~~~~~~~~~~~~~~~
+Here is what you need to create the repository ''foo'':
+------------------------
+  ssh git.debian.org
+  cd /srv/git.debian.org/git/pkg-voip
+
+  # Create repo:
+  mkdir foo.git
+  cd foo.git
+  git init --bare
+
+  # Fix HTTP access:
+  mv hooks/post-receive.sample hooks/post-receive
+
+  # Notifications:
+  echo /home/groups/pkg-voip/scripts/pkg-voip-post-receive >> hooks/post-receive
+  git config --add hooks.mailinglist pkg-voip-commits at lists.alioth.debian.org
+------------------------
+Now push your content into the repository. Run the following from the
+directory of your git repository:
+
+--------------------------
+  git remote add alioth git+ssh://git.debian.org/git/pkg-voip/foo.git
+  git push alioth master
+--------------------------
+
 
 Patch management systems
 ------------------------
@@ -300,8 +340,12 @@
 This file
 ---------
 This file is a asciidoc-formatted file that resides on the top-level
-directory of the pkg-voip team's subversion repository. Once you updated
-it and commited the changes, run the following to apply them:
+directory of the pkg-voip team's subversion repository. Testing them:
+
+  asciidoc -n -a toc README
+
+and check the generated README.html . Once you updated it and commited
+the changes, run the following to apply them:
 
   ssh wagner.debian.org 'make -C /home/groups/pkg-voip/htdocs clean all'