r199 - website

[Joachim Breitner]

Author: nomeata
Date: 2004-06-11 15:37:40 -0600 (Fri, 11 Jun 2004)
New Revision: 199

Modified:
   website/subversion.pod
Log:
Clearifiying tags and releases (Allard, please check!)

Modified: website/subversion.pod
===================================================================
--- website/subversion.pod	2004-06-11 21:13:58 UTC (rev 198)
+++ website/subversion.pod	2004-06-11 21:37:40 UTC (rev 199)
@@ -148,9 +148,9 @@
 
 =back
 
-We now have to tag the release, but only if this is a definite
-version. Hack away at the source, commit, and if you're done, tag the
-release:
+If the imported release is already in the debian archive you might want to
+tag that release, using the follow command. It is not really required,
+though, as long as "our" releases are tagged properly.
 
  svn copy \
    svn+ssh://user@svn.debian.org/svn/pkg-perl/packages/libfile-touch-perl/trunk/ \
@@ -201,6 +201,15 @@
 If you upload the the first and subsequential packages of an upstream
 version, you don't have to worry about this.
 
+If you are satisfied with the package, and want to build the final packge
+(the one that is going to be uploaded to the archive), use
+
+ svn-buildpackage --svn-tag [-rfakeroot] [-kyourkey] [-uc] [-us]
+
+to make svn-buildpackage create a tag of this release. You should
+harldy ever need to tag a release by yourself.
+
+
 =head2 4.2 Building an already tagged release
 
 This is a little trickier than building the trunk. First check out the tag:
@@ -235,8 +244,17 @@
 logentries and the copied tree doesn't take up any extra space on 
 disk.
 
-It works like this:
+Note that using our usual workflow, the tags will be created by
 
+ svn-buildpackage --svn-tag
+
+when building the final version of the package that is going to be uploaded
+to the archie. Only execption might be the initial upload of a package
+with a version alread in the archive (though it might be arguable if we
+actually need this version as a tag).
+
+Anyways, it works like this:
+
  svn copy \
    svn://user@svn.debian.org/svn/pkg-perl/packages/libfile-touch-perl/trunk/ \
    svn://user@svn.debian.org/svn/pkg-perl/packages/libfile-touch-perl/tags/debian_version_0.04-1
@@ -312,3 +330,6 @@
 complete text of the GNU General Public License can be found in
 `/usr/share/common-licenses/GPL' and the Artistic Licence in
 `/usr/share/common-licenses/Artistic'.
+
+=for comment
+vim:tw=80