[PATCH 1 of 2] util: state docstring of rename more precisely

[Adrian Buehlmann]

# HG changeset patch
# User Adrian Buehlmann <adrian at cadifra.com>
# Date 1254939403 -7200
# Node ID 0a8a3f3fadbb925f0e28f716a5544b68d803709f
# Parent  98feea5659d902bdca558ea7c9fed7670eb4f5e9
util: state docstring of rename more precisely

diff --git a/mercurial/util.py b/mercurial/util.py
--- a/mercurial/util.py
+++ b/mercurial/util.py
@@ -400,7 +400,7 @@ def lexists(filename):
     return True
 
 def rename(src, dst):
-    """forcibly rename a file"""
+    '''atomically rename file src to dst, replacing dst if it exists'''
     try:
         os.rename(src, dst)
     except OSError, err: # FIXME: check err (EEXIST ?)