--- Coro-Multicore/perlmulticore.h	2015/06/28 18:33:13	1.7
+++ Coro-Multicore/perlmulticore.h	2015/06/28 18:37:52	1.8
@@ -302,6 +302,20 @@
 
 =back
 
+
+=head1 DISABLING PERL MULTICORE AT COMPILE TIME
+
+You can disable the complete perl multicore API by defining the
+symbol C<PERL_MULTICORE_DISABLE> to C<1> (e.g. by specifying
+F<-DPERL_MULTICORE_DISABLE> as compiler argument).
+
+This will leave no traces of the API in the compiled code, suitable
+"empty" C<perl_release> and C<perl_acquire> definitions will be provided.
+
+This could be added to perl's C<CPPFLAGS> when configuring perl on
+platforms that do not support threading at all for example.
+
+
 =head1 AUTHOR
 
    Marc A. Lehmann <perlmulticore@schmorp.de>