From: Zac Medico <zmedico@gentoo.org>
Date: Sun, 31 Oct 2010 06:32:42 +0000 (-0700)
Subject: Update docstring for LazyItemsDict.__deepcopy__()
X-Git-Tag: v2.2.0_alpha3~2
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=631043f4b2fcb6021bc3dff016270a3999df699f;p=portage.git

Update docstring for LazyItemsDict.__deepcopy__()
---

diff --git a/pym/portage/util/__init__.py b/pym/portage/util/__init__.py
index a0f578eb4..51c35d385 100644
--- a/pym/portage/util/__init__.py
+++ b/pym/portage/util/__init__.py
@@ -1315,23 +1315,10 @@ class LazyItemsDict(UserDict):
 
 	def __deepcopy__(self, memo=None):
 		"""
-		WARNING: If any of the lazy items contains a bound method then it's
-		typical for deepcopy() to raise an exception like this:
-
-			File "/usr/lib/python2.5/copy.py", line 189, in deepcopy
-				y = _reconstruct(x, rv, 1, memo)
-			File "/usr/lib/python2.5/copy.py", line 322, in _reconstruct
-				y = callable(*args)
-			File "/usr/lib/python2.5/copy_reg.py", line 92, in __newobj__
-				return cls.__new__(cls, *args)
-			TypeError: instancemethod expected at least 2 arguments, got 0
-
-		If deepcopy() needs to work, this problem can be avoided by
-		implementing lazy items with normal (non-bound) functions.
-
-		If deepcopy() raises a TypeError for a lazy item that has been added
-		via a call to addLazySingleton(), the singleton will be automatically
-		evaluated and deepcopy() will instead be called on the result.
+		This forces evaluation of each contained lazy item, and deepcopy of
+		the result. A TypeError is raised if any contained lazy item is not
+		a singleton, since it is not necessarily possible for the behavior
+		of this type of item to be safely preserved.
 		"""
 		if memo is None:
 			memo = {}