turn some comments back into module docstrings

mercurial/bundlerepo.py

@@ -1,13 +1,16 b''
 # bundlerepo.py - repository class for viewing uncompressed bundles
 #
-# This provides a read-only repository interface to bundles as if
-# they were part of the actual repository.
-#
 # Copyright 2006, 2007 Benoit Boissinot <[e-mail]>
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2, incorporated herein by reference.
 
+"""Repository class for viewing uncompressed bundles.
+
+This provides a read-only repository interface to bundles as if they
+were part of the actual repository.
+"""
+
 from node import nullid
 from i18n import _
 import changegroup, util, os, struct, bz2, zlib, tempfile, shutil, mdiff

mercurial/error.py

@@ -1,12 +1,16 b''
 # error.py - Mercurial exceptions
 #
-# This allows us to catch exceptions at higher levels without forcing imports
-#
 # Copyright 2005-2008 Matt Mackall <[e-mail]>
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2, incorporated herein by reference.
 
+"""Mercurial exceptions.
+
+This allows us to catch exceptions at higher levels without forcing
+imports.
+"""
+
 # Do not import anything here, please
 
 class RevlogError(Exception):

mercurial/revlog.py

@@ -1,13 +1,16 b''
 # revlog.py - storage back-end for mercurial
 #
-# This provides efficient delta storage with O(1) retrieve and append
-# and O(changes) merge between branches
-#
 # Copyright 2005-2007 Matt Mackall <[e-mail]>
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2, incorporated herein by reference.
 
+"""Storage back-end for Mercurial.
+
+This provides efficient delta storage with O(1) retrieve and append
+and O(changes) merge between branches.
+"""
+
 # import stuff from node for others to import from revlog
 from node import bin, hex, nullid, nullrev, short #@UnusedImport
 from i18n import _

mercurial/util.py

@@ -6,9 +6,12 b''
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2, incorporated herein by reference.
-#
-# This contains helper routines that are independent of the SCM core and hide
-# platform-specific details from the core.
+
+"""Mercurial utility functions and platform specfic implementations.
+
+This contains helper routines that are independent of the SCM core and
+hide platform-specific details from the core.
+"""
 
 from i18n import _
 import cStringIO, errno, re, shutil, sys, tempfile, traceback, error

mercurial/win32.py

@@ -4,11 +4,14 b''
 #
 # This software may be used and distributed according to the terms of the
 # GNU General Public License version 2, incorporated herein by reference.
-#
-# Mark Hammond's win32all package allows better functionality on
-# Windows.  this module overrides definitions in util.py.  if not
-# available, import of this module will fail, and generic code will be
-# used.
+
+"""Utility functions that use win32 API.
+
+Mark Hammond's win32all package allows better functionality on
+Windows. This module overrides definitions in util.py. If not
+available, import of this module will fail, and generic code will be
+used.
+"""
 
 import win32api