Suggest using default values for __init__ arguments to make classes

unpicklable.

diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index 579992f049d5ad9fbd2604cc376a64a257047fa8..128b29de468ea82456cbc5e473ba38254f716b76 100644 (file)
--- a/Doc/lib/libpickle.tex
+++ b/Doc/lib/libpickle.tex
@@ -86,7 +86,9 @@ First of all, the class must be defined at the top level in a module.
 \renewcommand{\indexsubitem}{(pickle protocol)}
 
 Next, it must normally be possible to create class instances by
-calling the class without arguments.  If this is undesirable, the
+calling the class without arguments.  Usually, this is best
+accomplished by providing default values for all arguments to its
+\code{__init__} method (if it has one).  If this is undesirable, the
 class can define a method \code{__getinitargs__()}, which should
 return a {\em tuple} containing the arguments to be passed to the
 class constructor (\code{__init__()}).

diff --git a/Doc/libpickle.tex b/Doc/libpickle.tex
index 579992f049d5ad9fbd2604cc376a64a257047fa8..128b29de468ea82456cbc5e473ba38254f716b76 100644 (file)
--- a/Doc/libpickle.tex
+++ b/Doc/libpickle.tex
@@ -86,7 +86,9 @@ First of all, the class must be defined at the top level in a module.
 \renewcommand{\indexsubitem}{(pickle protocol)}
 
 Next, it must normally be possible to create class instances by
-calling the class without arguments.  If this is undesirable, the
+calling the class without arguments.  Usually, this is best
+accomplished by providing default values for all arguments to its
+\code{__init__} method (if it has one).  If this is undesirable, the
 class can define a method \code{__getinitargs__()}, which should
 return a {\em tuple} containing the arguments to be passed to the
 class constructor (\code{__init__()}).