From 10a4597703f4b044d3f968bf3923644ea2387f5c Mon Sep 17 00:00:00 2001 From: Ricardo Signes Date: Wed, 5 Mar 2014 20:39:07 -0500 Subject: officially discourage the use of threads some language borrowed from a larger patch by Christian Walde --- dist/threads/lib/threads.pm | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'dist') diff --git a/dist/threads/lib/threads.pm b/dist/threads/lib/threads.pm index b8ee2294ce..fcefbcc1fb 100644 --- a/dist/threads/lib/threads.pm +++ b/dist/threads/lib/threads.pm @@ -5,7 +5,7 @@ use 5.008; use strict; use warnings; -our $VERSION = '1.92'; +our $VERSION = '1.93'; my $XS_VERSION = $VERSION; $VERSION = eval $VERSION; @@ -136,6 +136,16 @@ threads - Perl interpreter-based threads This document describes threads version 1.92 +=head1 WARNING + +The "interpreter-based threads" provided by Perl are not the fast, lightweight +system for multitasking that one might expect or hope for. Threads are +implemented in a way that make them easy to misuse. Few people know how to +use them correctly or will be able to provide help. + +The use of interpreter-based threads in perl is officially +L. + =head1 SYNOPSIS use threads ('yield', -- cgit v1.2.1