diff -r bf5a899a5d7c Doc/extending/newtypes.rst
--- a/Doc/extending/newtypes.rst	Sun Apr 12 17:56:34 2015 -0400
+++ b/Doc/extending/newtypes.rst	Sun Apr 12 21:06:38 2015 -0400
@@ -383,7 +383,7 @@
 can't guarantee that the initializer is called.  The initializer isn't called
 when unpickling objects and it can be overridden.  Our initializer accepts
 arguments to provide initial values for our instance. Initializers always accept
-positional and keyword arguments.
+positional and keyword arguments. Initializers should return either 0 on success or -1 on error.
 
 Initializers can be called multiple times.  Anyone can call the :meth:`__init__`
 method on our objects.  For this reason, we have to be extra careful when
diff -r bf5a899a5d7c Doc/library/sys.rst
--- a/Doc/library/sys.rst	Sun Apr 12 17:56:34 2015 -0400
+++ b/Doc/library/sys.rst	Sun Apr 12 21:06:38 2015 -0400
@@ -1001,6 +1001,9 @@
    function for further tracing in that scope), or ``None`` to turn off tracing
    in that scope.
 
+   If an exception is raised in the execution of the trace function, system
+   tracing will be disabled to prevent subsequent errors.
+
    The events have the following meaning:
 
    ``'call'``