Update of /cvsroot/pydispatcher/dispatch/docs
In directory sc8-pr-cvs1:/tmp/cvs-serv10644
Modified Files:
index.html
Log Message:
Clarification and expansion of notes regarding the two weakref bugs.
Index: index.html
===================================================================
RCS file: /cvsroot/pydispatcher/dispatch/docs/index.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** index.html 6 Jul 2003 23:00:47 -0000 1.4
--- index.html 31 Dec 2003 09:02:54 -0000 1.5
***************
*** 2,10 ****
<html>
<head>
! <meta http-equiv="content-type"
! content="text/html; charset=ISO-8859-1">
<title>Python Dispatch Package</title>
! <link rel="stylesheet" type="text/css" href="style/sitestyle.css">
! <meta name="author" content="Patrick K. O'Brien">
</head>
<body>
--- 2,10 ----
<html>
<head>
! <meta content="text/html; charset=ISO-8859-1"
! http-equiv="content-type">
<title>Python Dispatch Package</title>
! <link href="style/sitestyle.css" type="text/css" rel="stylesheet">
! <meta content="Patrick K. O'Brien" name="author">
</head>
<body>
***************
*** 12,16 ****
<p class="introduction">PyDispatcher provides the Python programmer
with a multiple-producer-multiple-consumer signal-registration and
! routing infrastructure for use in multiple contexts. The mechanism
of PyDispatcher started life as a highly rated <a
href="http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/87056">recipe</a>
--- 12,17 ----
<p class="introduction">PyDispatcher provides the Python programmer
with a multiple-producer-multiple-consumer signal-registration and
! routing infrastructure for use in multiple contexts. The
! mechanism
of PyDispatcher started life as a highly rated <a
href="http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/87056">recipe</a>
***************
*** 84,91 ****
the module to a directory on your PythonPath.<br>
</p>
! <p class="technical">Due to problems with the Python 2.2.2 (and
! earlier) weak reference implementation, it is <strong>strongly
! recommended</strong> that you use <strong>Python 2.2.3</strong> or later
! when using PyDispatcher.<br>
</p>
<h2>Documentation</h2>
--- 85,114 ----
the module to a directory on your PythonPath.<br>
</p>
! <p class="technical">PyDispatcher represents one of the more involved
! usage patterns for Python weakref objects. We have discovered a few
! problems in weakref operation of which users of the package should be
! aware.<br>
! </p>
! <p class="technical">Python 2.2.2 (and
! earlier) weak reference implementations have a subtle <a
! href="https://sourceforge.net/tracker/?group_id=5470&atid=105470&func=detail&aid=742911">bug</a>
! in their weakref destructor code which can cause memory access errors
! (aka segfaults) on program shutdown. If you are using Python 2.2,
! it is <strong>strongly
! recommended</strong> that you use <strong>Python 2.2.3</strong> or
! later
! when using PyDispatcher. Note that this will not address the
! following issue.<br>
! </p>
! <p class="technical">Python 2.3.2 (and earlier) has a different (even
! more subtle) <a
! href="http://cvs.sourceforge.net/viewcvs.py/python/python/dist/src/Modules/gc_weakref.txt?rev=2.1&view=auto">bug</a>
! in the weakref destructor code which, again, can cause segfaults.
! If you are using Python 2.3, it is <strong>strongly
! recommended</strong> that you use <strong>Python 2.3.3</strong> or
! later
! when using PyDispatcher. This bug-fix will not be ported back to
! the Python 2.2.x branch, so if you are using Python 2.2.3 you may
! encounter this situation.
</p>
<h2>Documentation</h2>
***************
*** 101,109 ****
</p>
<p class="footer">A SourceForge Open-Source project: <a
! href="http://sourceforge.net"><img
! src="http://sourceforge.net/sflogo.php?group_id=79755&type=1"
style="border: 0px solid ; width: 88px; height: 31px;"
! alt="SourceForge" title="" align="middle" width="88" height="31"
! border="0"></a></p>
</body>
</html>
--- 124,131 ----
</p>
<p class="footer">A SourceForge Open-Source project: <a
! href="http://sourceforge.net"><img border="0" height="31" width="88"
! align="middle" title="" alt="SourceForge"
style="border: 0px solid ; width: 88px; height: 31px;"
! src="http://sourceforge.net/sflogo.php?group_id=79755&type=1"></a></p>
</body>
</html>
|
