improve doc for better epydoc generation.

1 files changed, 7 insertions, 17 deletions

diff --git a/cache.py b/cache.py
index 5a966e8..7ee697f 100644
--- a/cache.py
+++ b/cache.py
@@ -1,21 +1,11 @@
-# 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.
-""" Copyright (c) 2002-2003 LOGILAB S.A. (Paris, FRANCE).
- http://www.logilab.fr/ -- mailto:contact@logilab.fr
+"""Cache module, with a least recently used algorithm for the management of the
+deletion of entries.
 
- Cache module, with a least recently used algorithm for the management of the
- deletion of entries.
+:copyright: 2002-2008 LOGILAB S.A. (Paris, FRANCE), all rights reserved.
+:contact: http://www.logilab.fr/ -- mailto:contact@logilab.fr
+:license: General Public License version 2 - http://www.gnu.org/licenses
 """
+__docformat__ = "restructuredtext en"
 
 from threading import Lock
 
@@ -24,7 +14,7 @@ from logilab.common.decorators import locked
 _marker = object()
 
 class Cache:
-    """ a dictionnary like cache
+    """A dictionnary like cache.
 
     inv:
         len(self._usage) <= self.size