[Pkg-octave-devel] Guidelines for the Debian Octave Group
Rafael Laboissiere
Rafael Laboissiere <rafael@debian.org>
Tue, 8 Feb 2005 10:12:44 +0100
--qDbXVdCdHGoSgWSk
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
I wrote a set of Guidelines for the collaborative work in the Debian Octave
Group, improving the SVN cookbook that Isaac Clerencia posted here some days
ago. You will the Guidelines at:
http://svn.debian.org/wsvn/pkg-octave/trunk/README
I am also attaching the file below, just for the record.
Please, read the document and fix any mistake in the text, in particular as
regards the usage of English. No fear: the file is under Subversion control
:-)
--
Rafael
--qDbXVdCdHGoSgWSk
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename=README
Guidelines for maintaining Octave-related Debian packages
=========================================================
1. Coordination
---------------
The development of Octave-related packages in Debian is done as a
collaborative work by the Debian Octave Group at alioth.debian.org. Any
maintainer/developer, either a DD or not, interested in Octave related
packages is encouraged to join the pkg-octave project at Alioth.
Issues are discussed in the pkg-octave-devel mailing list. For more
information about subscription and for looking at the archives, please
visit http://lists.alioth.debian.org/mailman/listinfo/pkg-octave-devel
Besides the common development of the Octave-related packages, the Debian
Octave Group will eventually improve the common build infrastructure, which
will result in a better integration of the packages in the Debian
distribution.
2. Building and uploading packages
----------------------------------
The first thing to do when contributing a new package is to set the
maintainer to Debian Octave Group <pkg-octave-devel@lists.alioth.debian.org>
in debian/control.
The debian/changelog entries should look like this:
octave-cool (1.2.3-4) unstable; urgency=low
+++ Changes made by Dirk Eddelbuettel
* Rebuilt with cool stuff
+++ Changes made by Rafael Laboissiere
* Cool tweaks
-- Debian Octave Group <pkg-octave-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 Octave Group"
debian-changelog-mailing-address: "pkg-octave-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-octave-commit mailing list. For
more information, please visit
http://lists.alioth.debian.org/mailman/listinfo/pkg-octave-commit
The repository is organized as follows
snv://svn.debian.org/svn/pkg-octave/
trunk/
packages/
octave2.1/
debian/
octave-forge/
debian/
[...]
tags/
packages/
octave2.1/
2.1.64-3/
2.1.64-4/
[...]
octave-forge/
2004.11.16-3/
2004.11.16-4/
[...]
[...]
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-octave/tags/packages/<package>/<version>
Here is the cookbook to put a new package under Subversion control:
# Import the pkg-octave repository
svn co svn+ssh://svn.debian.org/svn/pkg-octave
# Create the directory for the new package in trunk and tags
mkdir pkg-octave/trunk/packages/octave-cool
mkdir pkg-octave/tags/packages/octave-cool
# Get the latest released version of the package
apt-get source octave-cool
# Copy the debian directory to trunk
cp -a octave-cool-1.2.3/debian pkg-octave/trunk/packages/octave-cool
# Add the Debian-related files to the repository
cd pkg-octave
svn add trunk/packages/octave-cool
svn add tags/packages/octave-cool
svn commit --message 'Initial import of package octave-cool'
# Tag its current version
svn copy trunk/packages/octave-cool tags/packages/octave-cool/1.2.3-4
svn commit tags/packages/octave-cool --message 'Debian release 1.2.3-4'
# Now you can go back to the package sources and do:
cd ../octave-cool-1.2.3-4
rm -rf debian
svn co svn+ssh://svn.debian.org/svn/pkg-octave/trunk/packages/octave-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:
octave-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 Octave Group <pkg-octave-devel@lists.alioth.debian.org>
$Id: README 15 2005-02-08 08:57:26Z rafael $
Editor settings
---------------
Local variables:
mode: indented-text
End:
--qDbXVdCdHGoSgWSk--