[Pkg-jed-commit] r3 - trunk/www
Rafael Laboissiere
rafael@costa.debian.org
Wed, 16 Mar 2005 10:11:03 +0100
Author: rafael
Date: 2005-03-16 10:11:03 +0100 (Wed, 16 Mar 2005)
New Revision: 3
Added:
trunk/www/DJG-Guidelines.txt
Log:
Added Guidelines for the DJG
Added: trunk/www/DJG-Guidelines.txt
===================================================================
--- trunk/www/DJG-Guidelines.txt 2005-03-16 09:04:59 UTC (rev 2)
+++ trunk/www/DJG-Guidelines.txt 2005-03-16 09:11:03 UTC (rev 3)
@@ -0,0 +1,184 @@
+Guidelines for maintaining JED-related Debian packages
+=========================================================
+
+
+1. Coordination
+---------------
+
+The development of JED-related packages in Debian is done as a
+collaborative work by the Debian JED Group at alioth.debian.org. Any
+maintainer/developer, either a DD or not, interested in jed related
+packages is encouraged to join the pkg-jed project at Alioth.
+
+Issues are discussed in the pkg-jed-devel mailing list. For more
+information about subscription and for looking at the archives, please
+visit http://lists.alioth.debian.org/mailman/listinfo/pkg-jed-devel
+
+
+2. Building and uploading packages
+----------------------------------
+
+The first thing to do when contributing a new package is to set the
+maintainer to Debian JED Group <pkg-jed-devel@lists.alioth.debian.org>
+in debian/control.
+
+The debian/changelog entries should look like this:
+
+jed-cool (1.2.3-4) unstable; urgency=low
+
+ +++ Changes by Joe Developer:
+
+ * Rebuilt with cool stuff
+
+ +++ Changes by Sam Debianer:
+
+ * Cool tweaks
+
+ -- Debian JED Group <pkg-jed-devel@lists.alioth.debian.org> Mon, 15 Oct 2012 08:30:00 -0400
+
+
+At the end of debian/changelog put the following lines:
+
+Local Variables:
+debian-changelog-full-name: "Debian JED Group"
+debian-changelog-mailing-address: "pkg-jed-devel@lists.alioth.debian.org"
+End:
+
+This is a great help when using (X)Emacs with the debian-changelog-mode and
+hitting [(control) c] [(control) c].
+
+
+3. SVN repository
+-----------------
+
+The packages are under Subversion control at svn.debian.org. For more
+information on Subversion, please look at the web site
+http://subversion.tigris.org. The Subversion book is also a valuable
+resource. Install the subversion package and point your browser at
+file::///usr/share/doc/subversion/book/.
+
+Automatic SVN activity is sent to the pkg-jed-commit mailing list. For
+more information, please visit
+http://lists.alioth.debian.org/mailman/listinfo/pkg-jed-commit
+
+The repository is organized as follows
+
+ snv://svn.debian.org/svn/pkg-jed/
+ trunk/
+ packages/
+ jed/
+ debian/
+ jed-extra/
+ debian/
+ [...]
+ tags/
+ packages/
+ jed/
+ 0.99.16-4/
+ 0.99.16-5/
+ [...]
+ jed-extra/
+ 0.1.8/
+ 1.0-1/
+ [...]
+ [...]
+
+
+Notice that only the debian files are put under Subversion control. No
+upstream files, please.
+
+As regards tag conventions, use the following path:
+
+ svn://svn.debian.org/svn/pkg-jed/tags/packages/<package>/<version>
+
+Only create a tag in tags/packages after the Debian version is actually
+released. This avoids having to issue extra svn copy commands if the tag is
+created too early.
+
+Comparison between two released Debian versions of a given package can then
+be done with a command like the following:
+
+ svn diff \
+ svn+ssh://svn.debian.org/svn/pkg-jed/tags/packages/jed-cool/1.2.3-3 \
+ svn+ssh://svn.debian.org/svn/pkg-jed/tags/packages/jed-cool/1.2.3-4
+
+Here is the cookbook to put a new package under Subversion control:
+
+# Import the pkg-jed repository
+
+svn co svn+ssh://svn.debian.org/svn/pkg-jed
+
+[N.B.: This only works if your user name in the system you are working is
+ the same as your user name in Alioth. If this is not the case, you
+ will need to set the SVN_SSH environment variable, like this:
+
+ export SVN_SSH="ssh -l my-alioth-username"
+
+ Otherwise, you can add your Alioth user name directly in the URL:
+
+ svn co svn+ssh://my-alioth-username@svn.debian.org/svn/pkg-jed
+
+ Yet another solution, probably the best one, is adding to your
+ personal configuration file ~/.ssh/config something like:
+
+ Host svn.debian.org
+ User my-alioth-username
+]
+
+# Create the directory for the new package in trunk and tags
+
+mkdir pkg-jed/trunk/packages/jed-cool
+mkdir pkg-jed/tags/packages/jed-cool
+
+# Get the latest released version of the package
+
+apt-get source jed-cool
+
+# Copy the debian directory to trunk
+
+cp -a jed-cool-1.2.3/debian pkg-jed/trunk/packages/jed-cool
+
+# Add the Debian-related files to the repository
+
+cd pkg-jed
+svn add trunk/packages/jed-cool
+svn add tags/packages/jed-cool
+svn commit --message 'Initial import of package jed-cool'
+
+# Tag its current version
+
+svn copy trunk/packages/jed-cool tags/packages/jed-cool/1.2.3-4
+svn commit tags/packages/jed-cool --message 'Debian release 1.2.3-4'
+
+# Now you can go back to the package sources and do:
+
+cd ../jed-cool-1.2.3-4
+rm -rf debian
+svn co svn+ssh://svn.debian.org/svn/pkg-jed/trunk/packages/jed-cool/debian
+
+When committing changes that do not result in a Debian release, keep
+debian/changelog in a clearly broken state, such that the other developers
+will know that the version is not yet released. Something like this:
+
+jed-cool (1.2.3-4) unstable; urgency=low
+
+ NOT YET RELEASED!
+
+ +++ Changes made by Rafael Laboissiere
+
+ * First import
+
+ --
+
+Notice the absence of signature and release date. dpkg-buildpackage will
+refuse to build a package with such an entry at the top of debian/changelog.
+
+
+Author
+------
+
+Rafael Laboissiere <rafael@debian.org>
+in the behalf of the
+Debian JED Group <pkg-jed-devel@lists.alioth.debian.org>
+
+$Id$