[Pkg-jed-commit] r44 - trunk/www
Guenter Milde
milde-guest@costa.debian.org
Thu, 09 Jun 2005 08:19:15 +0000
Author: milde-guest
Date: 2005-06-09 08:19:15 +0000 (Thu, 09 Jun 2005)
New Revision: 44
Modified:
trunk/www/DJG-Guidelines.txt
Log:
Turned the Guidelines into an reStructured text document
and produced a html version (needs the provided default.css).
Modified: trunk/www/DJG-Guidelines.txt
===================================================================
--- trunk/www/DJG-Guidelines.txt 2005-05-30 18:57:53 UTC (rev 43)
+++ trunk/www/DJG-Guidelines.txt 2005-06-09 08:19:15 UTC (rev 44)
@@ -22,28 +22,27 @@
maintainer to Debian JED Group <pkg-jed-devel@lists.alioth.debian.org>
in debian/control.
-The debian/changelog entries should look like this:
+The debian/changelog entries should look like this::
-jed-cool (1.2.3-4) unstable; urgency=low
+ 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
- +++ Changes by Joe Developer:
+At the end of debian/changelog put the following lines::
- * Rebuilt with cool stuff
+ Local Variables:
+ debian-changelog-full-name: "Debian JED Group"
+ debian-changelog-mailing-address: "pkg-jed-devel@lists.alioth.debian.org"
+ End:
- +++ 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].
@@ -61,7 +60,7 @@
more information, please visit
http://lists.alioth.debian.org/mailman/listinfo/pkg-jed-commit
-The repository is organized as follows
+The repository is organized as follows::
snv://svn.debian.org/svn/pkg-jed/
trunk/
@@ -87,7 +86,7 @@
Notice that only the debian files are put under Subversion control. No
upstream files, please.
-As regards tag conventions, use the following path:
+As regards tag conventions, use the following path::
svn://svn.debian.org/svn/pkg-jed/tags/packages/<package>/<version>
@@ -96,7 +95,7 @@
created too early.
Comparison between two released Debian versions of a given package can then
-be done with a command like the following:
+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 \
@@ -104,72 +103,72 @@
Here is the cookbook to put a new package under Subversion control:
-# Import the pkg-jed repository
+#. Import the pkg-jed repository::
+
+ svn co svn+ssh://svn.debian.org/svn/pkg-jed
+
+ :note: 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
-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:
+will know that the version is not yet released. Something like this::
-jed-cool (1.2.3-4) unstable; urgency=low
+ jed-cool (1.2.3-4) unstable; urgency=low
+
+ NOT YET RELEASED!
+
+ +++ Changes made by Rafael Laboissiere
+
+ * First import
+
+ --
- 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.