From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Fri, 1 Sep 2000 14:36:53 +0000 (+0000)
Subject: Document known deficiencies.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=33a87e586cda65bc1cb73e5531daf1795b227dda;p=p5sagit%2Fp5-mst-13.2.git

Document known deficiencies.

p4raw-id: //depot/perl@6974
---

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 97addbf..c8f2a58 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -796,6 +796,35 @@ made in other platforms.
 
 st-store.t and st-retrieve may fail with Compaq C 6.2 on OpenVMS Alpha 7.2.
 
+=head2 Threads Are Still Experimental
+
+Multithreading is still an experimental feature.  Some platforms
+emit the following message for lib/thr5005
+
+    #
+    # This is a KNOWN FAILURE, and one of the reasons why threading
+    # is still an experimental feature.  It is here to stop people
+    # from deploying threads in production. ;-)
+    #
+ 
+and another known warning is
+
+   pragma/overload......Unbalanced saves: 3 more saves than restores
+   panic: magic_mutexfree during global destruction.
+   ok
+   lib/selfloader.......Unbalanced saves: 3 more saves than restores
+   panic: magic_mutexfree during global destruction.
+   ok
+   lib/st-dclone........Unbalanced saves: 3 more saves than restores
+   panic: magic_mutexfree during global destruction.
+   ok
+
+=head2 The Compiler Suite Is Still Experimental
+
+The compiler suite is slowly getting better but is nowhere near yet.
+The backend part that has seen perhaps the most progress is the
+bytecode compiler.
+
 =back
 
 =head1 Reporting Bugs