[Debtags-commits] [svn] r1621 - tagdb

[Enrico Zini]

Author: enrico
Date: Thu Mar  2 12:58:52 2006
New Revision: 1621

Removed:
   tagdb/assimilate
   tagdb/commitpatch
   tagdb/dotag
   tagdb/filter-removed-packages
   tagdb/getnew
   tagdb/runonetag
Modified:
   tagdb/filterpkgs
   tagdb/process
   tagdb/stattags
Log:
Big cleanup of legacy scripts
Added/improved comments in the remaining scripts


Modified: tagdb/filterpkgs
==============================================================================
--- tagdb/filterpkgs	(original)
+++ tagdb/filterpkgs	Thu Mar  2 12:58:52 2006
@@ -1,5 +1,9 @@
 #!/usr/bin/perl -w
 
+# Filter a tagged collection, removing all those packages that are not listed
+# in the given file.
+# This is used mainly to support ./process where bash and tagcoll can't easily go
+
 use strict;
 use warnings;
 

Modified: tagdb/process
==============================================================================
--- tagdb/process	(original)
+++ tagdb/process	Thu Mar  2 12:58:52 2006
@@ -1,9 +1,32 @@
 #!/bin/bash -e
 
+# process - Interactive tool for manual approval of central database submissions
 #
-# Interactive tool to do manual verification of tag database changes
+# Copyright (C) 2005,2006  Enrico Zini <enrico at debian.org>
 #
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+# Usage: it's interactive, just run it.
 
+
+###
+#
+# Background information for the various tasks we do here
+#
+###
+#
 # There are 6 elements:
 #
 # Central database version
@@ -20,7 +43,9 @@
 # Corrections
 #   Reverse patch for those changes that have not been approved
 #   file: corrections/*
-
+#
+###
+#
 # Procedures:
 #
 # Downloading
@@ -40,30 +65,14 @@
 #  7) file the approved and corrected patches into the edits archive
 #  8) remove editing copy
 #
+###
 
 
-
-
-
-
-#
-# A $TOCHECK file is downloaded from $TOCHECK_URL and compared against
-# $CHECKED.  Checked is under svn revision control.
-#
-# The patch computed as difference from CHECKED and TOCHECK is then verified,
-# all or in part, generating approved changes that get applied to CHECKED and
-# corrections that get applied to TOCHECK and saved in PATCHDIR
-#
-# When a round of checking is finished, CHECKED is committed and all the
-# corrections are sent to the central database.
-#
-
 UNCHECKED=tags-unchecked
 SVN=tags
-MAINPATCH=patch
-PATCHDIR=corrections
 CACHEDIR=cache
 
+# Download needed data from the network
 do_downloads() {
 	UNCHECKED_URL=http://debtags.alioth.debian.org/tags/tags-current.gz
 	ALLPKGS_URL=http://people.debian.org/~enrico/AllPackages.gz
@@ -281,6 +290,7 @@
 	do_delete $FILE	
 }
 
+# Rewiew an edit, allowing to edit again, submit it or delete it
 do_review_edit() {
 	FILE=${1:?"Usage: do_review_edit file"}
 	ANS=""

Modified: tagdb/stattags
==============================================================================
--- tagdb/stattags	(original)
+++ tagdb/stattags	Thu Mar  2 12:58:52 2006
@@ -1,5 +1,9 @@
 #!/usr/bin/perl -w
 
+# Compute various kinds of statistics from a tagged collection.
+# This is used mainly to support ./process where bash and tagcoll can't easily
+# go
+
 use strict;
 use warnings;