lotsa files

doc strings, dont we love em?

Signed-off-by: Joerg Jaspert <joerg@debian.org>

diff --git a/dak/check_archive.py b/dak/check_archive.py
index 26a85cb5b42003ef68cfd84a5cd9b072b2ba302c..004fcddd8c25694cc2d24130d75b99171fd83cdf 100755 (executable)
--- a/dak/check_archive.py
+++ b/dak/check_archive.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Various different sanity checks
+""" Various different sanity checks """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/check_overrides.py b/dak/check_overrides.py
old mode 100644 (file)
new mode 100755 (executable)
index f276dba..ff01306
--- a/dak/check_overrides.py
+++ b/dak/check_overrides.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Cruft checker and hole filler for overrides
+""" Cruft checker and hole filler for overrides """
 # Copyright (C) 2000, 2001, 2002, 2004, 2006  James Troup <james@nocrew.org>
 # Copyright (C) 2005  Jeroen van Wolffelaar <jeroen@wolffelaar.nl>
 

diff --git a/dak/check_proposed_updates.py b/dak/check_proposed_updates.py
index 05728ab84149446f74c2e537066f7ecee1cf3c52..5b9283f712e3cee0d54711991ec795cb2c760ea8 100755 (executable)
--- a/dak/check_proposed_updates.py
+++ b/dak/check_proposed_updates.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Dependency check proposed-updates
+""" Dependency check proposed-updates """
 # Copyright (C) 2001, 2002, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/clean_proposed_updates.py b/dak/clean_proposed_updates.py
index b408184e180885601f5407cc8e5d131e0c50354b..0e9c0b6eec2bf5c283317a0f28840ad2d87af27b 100755 (executable)
--- a/dak/clean_proposed_updates.py
+++ b/dak/clean_proposed_updates.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Remove obsolete .changes files from proposed-updates
+""" Remove obsolete .changes files from proposed-updates """
 # Copyright (C) 2001, 2002, 2003, 2004, 2006, 2008  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/clean_queues.py b/dak/clean_queues.py
index 9f771b7261e6fbd8c846c9966327fe43d4ebfff4..34d90473a1b345715996029b6bb50ad2541b317c 100755 (executable)
--- a/dak/clean_queues.py
+++ b/dak/clean_queues.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Clean incoming of old unused files
+""" Clean incoming of old unused files """
 # Copyright (C) 2000, 2001, 2002, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/clean_suites.py b/dak/clean_suites.py
index fc4b8473669e6554ee7ab2d343a81880755a9d10..5523d63353bfa34f1eddb44174f6e74b8aed18de 100755 (executable)
--- a/dak/clean_suites.py
+++ b/dak/clean_suites.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Cleans up unassociated binary and source packages
+""" Cleans up unassociated binary and source packages """
 # Copyright (C) 2000, 2001, 2002, 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/compare_suites.py b/dak/compare_suites.py
index 8c367582663622701c48ea49803931050ccb846c..ab0ab3c0d6d8c04f5456c15cf72258321ef3e572 100755 (executable)
--- a/dak/compare_suites.py
+++ b/dak/compare_suites.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Check for fixable discrepancies between stable and unstable
+""" Check for fixable discrepancies between stable and unstable """
 # Copyright (C) 2000, 2001, 2002, 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/control_overrides.py b/dak/control_overrides.py
old mode 100644 (file)
new mode 100755 (executable)
index 78ae68d..730ce25
--- a/dak/control_overrides.py
+++ b/dak/control_overrides.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Bulk manipulation of the overrides
+""" Bulk manipulation of the overrides """
 # Copyright (C) 2000, 2001, 2002, 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/control_suite.py b/dak/control_suite.py
old mode 100644 (file)
new mode 100755 (executable)
index 4b704b9..95b24bc
--- a/dak/control_suite.py
+++ b/dak/control_suite.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Manipulate suite tags
+""" Manipulate suite tags """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/cruft_report.py b/dak/cruft_report.py
index f8695df70ce6edb7ca7a1b5fc30521dd0ca64831..d88c799b019d857ecaf689530a2ce6174e58a994 100755 (executable)
--- a/dak/cruft_report.py
+++ b/dak/cruft_report.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Check for obsolete binary packages
+""" Check for obsolete binary packages """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/dakdb/update1.py b/dak/dakdb/update1.py
old mode 100644 (file)
new mode 100755 (executable)
index 3f0aa80..7778b1b
--- a/dak/dakdb/update1.py
+++ b/dak/dakdb/update1.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Debian Archive Kit Database Update Script
+""" Database Update Script - Saner DM db schema """
 # Copyright (C) 2008  Michael Casadevall <mcasadevall@debian.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/dakdb/update2.py b/dak/dakdb/update2.py
index 20154b07e007ef636d6fd5cde8713cbaf48c65c3..71b43fa701ccd73caab555e9e878097ad4a15e24 100755 (executable)
--- a/dak/dakdb/update2.py
+++ b/dak/dakdb/update2.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # coding=utf8
 
-# Debian Archive Kit Database Update Script
+""" Database Update Script - debversion """
 # Copyright © 2008  Michael Casadevall <mcasadevall@debian.org>
 # Copyright © 2008  Roger Leigh <rleigh@debian.org>
 

diff --git a/dak/dakdb/update3.py b/dak/dakdb/update3.py
index cc297863ccafcccab7a12e26e966a03b1babcd9a..df89fb9d6300710e85ec890d51a830b25f8b3a76 100755 (executable)
--- a/dak/dakdb/update3.py
+++ b/dak/dakdb/update3.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Debian Archive Kit Database Update Script
+""" Database Update Script - Remove unused versioncmp """
 # Copyright (C) 2008  Michael Casadevall <mcasadevall@debian.org>
 # Copyright (C) 2009  Joerg Jaspert <joerg@debian.org>
 

diff --git a/dak/decode_dot_dak.py b/dak/decode_dot_dak.py
old mode 100644 (file)
new mode 100755 (executable)
index 7ea342b..e6bc45b
--- a/dak/decode_dot_dak.py
+++ b/dak/decode_dot_dak.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Dump variables from a .dak file to stdout
+""" Dump variables from a .dak file to stdout """
 # Copyright (C) 2001, 2002, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/examine_package.py b/dak/examine_package.py
index 70b1f3ca3d67231c3835b5c5077a85a62f7617e5..d0e1e53aed7a0d357a67838fda6a84fe7231a977 100755 (executable)
--- a/dak/examine_package.py
+++ b/dak/examine_package.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Script to automate some parts of checking NEW packages
+""" Script to automate some parts of checking NEW packages """
 # Copyright (C) 2000, 2001, 2002, 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/find_null_maintainers.py b/dak/find_null_maintainers.py
index 652edfd2e3ef9c403b1ab812aed04bb522d631b5..c943335ab18f6b2a70024da3ca76e621893f14d5 100755 (executable)
--- a/dak/find_null_maintainers.py
+++ b/dak/find_null_maintainers.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Check for users with no packages in the archive
+""" Check for users with no packages in the archive """
 # Copyright (C) 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/generate_index_diffs.py b/dak/generate_index_diffs.py
index f3f7a4a16bfec70f48db0b62268519c36031c6e1..84b0a67cffc970f324289fb2adf097b0fdb1d0fd 100755 (executable)
--- a/dak/generate_index_diffs.py
+++ b/dak/generate_index_diffs.py
@@ -1,7 +1,8 @@
 #!/usr/bin/env python
 
+""" generates partial package updates list"""
+
 ###########################################################
-# generates partial package updates list
 
 # idea and basic implementation by Anthony, some changes by Andreas
 # parts are stolen from 'dak generate-releases'

diff --git a/dak/generate_releases.py b/dak/generate_releases.py
index a1552451051f2a189b9ab57cd8093da8ca2673fb..1c258bd5c511d292757d59f678d86fcbab0f56b3 100755 (executable)
--- a/dak/generate_releases.py
+++ b/dak/generate_releases.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Create all the Release files
+""" Create all the Release files """
 
 # Copyright (C) 2001, 2002, 2006  Anthony Towns <ajt@debian.org>
 

diff --git a/dak/import_archive.py b/dak/import_archive.py
index 00b5d1b6b5d8f1673bf2bf9cc5358244694c9d9a..d87d6ca9e3fd98e638620807aed50be1929cbdb3 100755 (executable)
--- a/dak/import_archive.py
+++ b/dak/import_archive.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Populate the DB
+""" Populate the DB """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/import_keyring.py b/dak/import_keyring.py
index c8013d6e7f10c598414a3b77690f9f0160c33efe..ca325d0da290da53abf7e818ba8c047988461a9a 100755 (executable)
--- a/dak/import_keyring.py
+++ b/dak/import_keyring.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Imports a keyring into the database
+""" Imports a keyring into the database """
 # Copyright (C) 2007  Anthony Towns <aj@erisian.com.au>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/import_ldap_fingerprints.py b/dak/import_ldap_fingerprints.py
index 1fac652c74e0fe56c7740bd76402e405d3c43e2b..cdffbd0a6894adc3437197e22fa3f2d22dfbccaf 100755 (executable)
--- a/dak/import_ldap_fingerprints.py
+++ b/dak/import_ldap_fingerprints.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Sync fingerprint and uid tables with a debian.org LDAP DB
+""" Sync fingerprint and uid tables with a debian.org LDAP DB """
 # Copyright (C) 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/import_users_from_passwd.py b/dak/import_users_from_passwd.py
index b182f604ea01e6875a468c85f88c28e8f47f2fd4..d38a3c93fa3b9a982fa497abcd216a6ba4752f5b 100755 (executable)
--- a/dak/import_users_from_passwd.py
+++ b/dak/import_users_from_passwd.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Sync PostgreSQL users with system users
+""" Sync PostgreSQL users with system users """
 # Copyright (C) 2001, 2002, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/ls.py b/dak/ls.py
index baf137335739ea4fb313e07db41602e560a85c50..b9753b483e265303246ac6e533059c550790ec93 100755 (executable)
--- a/dak/ls.py
+++ b/dak/ls.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Display information about package(s) (suite, version, etc.)
+""" Display information about package(s) (suite, version, etc.) """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/make_maintainers.py b/dak/make_maintainers.py
index 55cc4a9b6324b020efa6b9658914df065798bca2..913537500c47688e8cbe53275f8c69d45fd63e8b 100755 (executable)
--- a/dak/make_maintainers.py
+++ b/dak/make_maintainers.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Generate Maintainers file used by e.g. the Debian Bug Tracking System
+""" Generate Maintainers file used by e.g. the Debian Bug Tracking System """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/make_overrides.py b/dak/make_overrides.py
index 2ed4f4bafeabac1fec9f84da65b4776402d341fb..176e563f6358ff45a7b4f0923903831e3165b45a 100755 (executable)
--- a/dak/make_overrides.py
+++ b/dak/make_overrides.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Output override files for apt-ftparchive and indices/
+""" Output override files for apt-ftparchive and indices/ """
 # Copyright (C) 2000, 2001, 2002, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/make_suite_file_list.py b/dak/make_suite_file_list.py
index dbbab7ec4712bcc3eacfe28ee55e2dadd99a0d91..d6dbf9d0c9a5da876a2058aa3d6b266213290e40 100755 (executable)
--- a/dak/make_suite_file_list.py
+++ b/dak/make_suite_file_list.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Generate file lists used by apt-ftparchive to generate Packages and Sources files
+""" Generate file lists used by apt-ftparchive to generate Packages and Sources files """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/new_security_install.py b/dak/new_security_install.py
index 98951d416c4d8020189e7ca82c3edf8219ff8aaa..b1a47dba8f2527bbe733afea5f014f064acf4634 100755 (executable)
--- a/dak/new_security_install.py
+++ b/dak/new_security_install.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Wrapper for Debian Security team
+""" Wrapper for Debian Security team """
 # Copyright (C) 2006  Anthony Towns <ajt@debian.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/override.py b/dak/override.py
index 0bda5e769996f64f6cbaed6996aa4e3190178277..4b92ae1105bf989eef06e41642c674de29c3de49 100755 (executable)
--- a/dak/override.py
+++ b/dak/override.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Microscopic modification and query tool for overrides in projectb
+""" Microscopic modification and query tool for overrides in projectb """
 # Copyright (C) 2004, 2006  Daniel Silverstone <dsilvers@digital-scurf.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/poolize.py b/dak/poolize.py
old mode 100644 (file)
new mode 100755 (executable)
index cefdcae..ef41d74
--- a/dak/poolize.py
+++ b/dak/poolize.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Poolify (move packages from "legacy" type locations to pool locations)
+""" Poolify (move packages from "legacy" type locations to pool locations) """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/process_accepted.py b/dak/process_accepted.py
index a29c892185c6f93626e2c8563a26dd6ba13bddcc..683b1191ad6974ecbe72673ffeda85d6e5e5da88 100755 (executable)
--- a/dak/process_accepted.py
+++ b/dak/process_accepted.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Installs Debian packages from queue/accepted into the pool
+""" Installs Debian packages from queue/accepted into the pool """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/process_new.py b/dak/process_new.py
index 9eea0ec56bb121544b9c7b1a0a08ef1dfa7011c7..8741d25ec887e0e19304b174473772ab47ae5119 100755 (executable)
--- a/dak/process_new.py
+++ b/dak/process_new.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # vim:set et ts=4 sw=4:
 
-# Handles NEW and BYHAND packages
+""" Handles NEW and BYHAND packages """
 # Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/process_unchecked.py b/dak/process_unchecked.py
index 43fc087a441d8df66ecd29c083a3b05dcd7f7a65..6761a419fa4ef0887ee3b3a125df07700ec28313 100755 (executable)
--- a/dak/process_unchecked.py
+++ b/dak/process_unchecked.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Checks Debian packages from Incoming
+""" Checks Debian packages from Incoming """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/queue_report.py b/dak/queue_report.py
index 29d0788124082c672d84eebebca86670d2a8608d..fe8a4a1b2ffab54bfda37ef7759ff8a2a464982c 100755 (executable)
--- a/dak/queue_report.py
+++ b/dak/queue_report.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Produces a report on NEW and BYHAND packages
+""" Produces a report on NEW and BYHAND packages """
 # Copyright (C) 2001, 2002, 2003, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/reject_proposed_updates.py b/dak/reject_proposed_updates.py
index c3345017a121e0ea57f0cc9d847e66231e6792cd..7770f66ec4bba695e78422f3df4704062d79d8da 100755 (executable)
--- a/dak/reject_proposed_updates.py
+++ b/dak/reject_proposed_updates.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Manually reject packages for proprosed-updates
+""" Manually reject packages for proprosed-updates """
 # Copyright (C) 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/rm.py b/dak/rm.py
index 9c76155435a679983361fd6bc3f8be3548e1591a..005653e536727858f859b2aef4a26ab9a23d9a04 100755 (executable)
--- a/dak/rm.py
+++ b/dak/rm.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# General purpose package removal tool for ftpmaster
+""" General purpose package removal tool for ftpmaster """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/show_deferred.py b/dak/show_deferred.py
index 8c13d677befdf1d6d4f56db80ed9cbdcb4f7c819..e9266bcc03f4aa33a60483b9dc24779e5b146323 100755 (executable)
--- a/dak/show_deferred.py
+++ b/dak/show_deferred.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# based on queue-report
+""" Overview of the DEFERRED queue, based on queue-report """
 #    Copyright (C) 2001, 2002, 2003, 2005, 2006  James Troup <james@nocrew.org>
 # Copyright (C) 2008 Thomas Viehmann <tv@beamnet.de>
 

diff --git a/dak/show_new.py b/dak/show_new.py
index f650f9aa03aae6271eee09fb6f8c42c6c296f603..e355c37f7f42c4a119fdbcc081b0aa573cd7a898 100755 (executable)
--- a/dak/show_new.py
+++ b/dak/show_new.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Output html for packages in NEW
+""" Output html for packages in NEW """
 # Copyright (C) 2007 Joerg Jaspert <joerg@debian.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/split_done.py b/dak/split_done.py
index 5f8faddaf8e4041e05fffdc1b0ef7915ed91547b..8b5b57fe2ef2db0cf2b1a882ad7aa30615eb3422 100755 (executable)
--- a/dak/split_done.py
+++ b/dak/split_done.py
@@ -1,6 +1,8 @@
 #!/usr/bin/env python
 
+""" Split queue/done into date based subdirectories """
 # Copyright (C) 2004, 2005, 2006  James Troup <james@nocrew.org>
+# Copyright (C) 2008  Joerg Jaspert <joerg@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

diff --git a/dak/stats.py b/dak/stats.py
index 20a02b55cac3c0d4345efe5f8d4017ed5a2f02e2..105bf6c9f64aec6347a728f8acb5bf8c9ecf49b0 100755 (executable)
--- a/dak/stats.py
+++ b/dak/stats.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Various statistical pr0nography fun and games
+""" Various statistical pr0nography fun and games """
 # Copyright (C) 2000, 2001, 2002, 2003, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/transitions.py b/dak/transitions.py
index 7c47f880a4e922f2e1621641ceafaeeb2106d55b..750d146b872b9fa67266e6a07fded87b0e1c1f68 100755 (executable)
--- a/dak/transitions.py
+++ b/dak/transitions.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Display, edit and check the release manager's transition file.
+""" Display, edit and check the release manager's transition file. """
 # Copyright (C) 2008 Joerg Jaspert <joerg@debian.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/dak/update_db.py b/dak/update_db.py
index d4aefe24c93b64b8404835f77e98a9cdf0c5dd85..f9b6e478fd6686ecde9d3b15f56b8f61ded2a645 100755 (executable)
--- a/dak/update_db.py
+++ b/dak/update_db.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Debian Archive Kit Database Update Script
+""" Database Update Main Script """
 # Copyright (C) 2008  Michael Casadevall <mcasadevall@debian.org>
 
 # This program is free software; you can redistribute it and/or modify
@@ -53,7 +53,7 @@ Updates dak's database schema to the lastest version. You should disable crontab
 ################################################################################
 
     def update_db_to_zero(self):
-        # This function will attempt to update a pre-zero database schema to zero
+        """ This function will attempt to update a pre-zero database schema to zero """
 
         # First, do the sure thing, and create the configuration table
         try:

diff --git a/daklib/dak_exceptions.py b/daklib/dak_exceptions.py
old mode 100644 (file)
new mode 100755 (executable)
index 9404ee9..2fe87a0
--- a/daklib/dak_exceptions.py
+++ b/daklib/dak_exceptions.py
@@ -1,4 +1,6 @@
-# Exception classes used in dak
+#!/usr/bin/env python
+
+""" Exception classes used in dak """
 
 # Copyright (C) 2008  Mark Hymers <mhy@debian.org>
 

diff --git a/daklib/database.py b/daklib/database.py
index e2c596a6feb89bf3d9fc367b11f71268fedca7ac..095b13980ca5696d0f2984d4fbb7076487ef4102 100755 (executable)
--- a/daklib/database.py
+++ b/daklib/database.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# DB access fucntions
+""" DB access fucntions """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/daklib/extensions.py b/daklib/extensions.py
old mode 100644 (file)
new mode 100755 (executable)
index 9befa7b..668cc27
--- a/daklib/extensions.py
+++ b/daklib/extensions.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Utility functions for extensions
+""" Utility functions for extensions """
 # Copyright (C) 2008 Anthony Towns <ajt@dbeian.org>
 
 ################################################################################

diff --git a/daklib/logging.py b/daklib/logging.py
old mode 100644 (file)
new mode 100755 (executable)
index f0dcd9c..125aa4a
--- a/daklib/logging.py
+++ b/daklib/logging.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-# Logging functions
+""" Logging functions """
 # Copyright (C) 2001, 2002, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/daklib/queue.py b/daklib/queue.py
index 5bebe8efd32c8a2fa812d1b5f2b1333c71536587..3010c9d6a8037c52a696441a204efd2394cdf7e0 100755 (executable)
--- a/daklib/queue.py
+++ b/daklib/queue.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # vim:set et sw=4:
 
-# Queue utility functions for dak
+""" Queue utility functions for dak """
 # Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 # This program is free software; you can redistribute it and/or modify

diff --git a/daklib/utils.py b/daklib/utils.py
index be4bcff79cda567d1eb5a3ed8fc0e9da8c7e7c05..dbc8c16c0fce391c8b8f5fc9764f57223d15bd22 100755 (executable)
--- a/daklib/utils.py
+++ b/daklib/utils.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # vim:set et ts=4 sw=4:
 
-# Utility functions
+""" Utility functions """
 # Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 
 ################################################################################