develooper Front page | perl.perl5.porters | Postings from August 2016

[perl #129151] Clarify build options in perlembed doc

Thread Previous
From:
Zhenyi Zhou
Date:
August 31, 2016 12:57
Subject:
[perl #129151] Clarify build options in perlembed doc
Message ID:
rt-4.0.24-8290-1472648250-1647.129151-75-0@perl.org
# New Ticket Created by  Zhenyi Zhou 
# Please include the string:  [perl #129151]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/Ticket/Display.html?id=129151 >


https://metacpan.org/source/RJBS/perl-5.24.0/pod/perlembed.pod#L920
https://metacpan.org/source/RJBS/perl-5.24.0/pod/perlembed.pod#L933

At above lines in perlembed doc it mentions options "-Dusethreads
-Duseithreads". But useithreads is mostly documented nowhere else. And
today this is always equivalent to a single "-Dusethreads", which is
mentioned in Perl INSTALL doc. IMHO mentioning both "-Dusethreads
-Duseithreads" can confuse people. And I would suggest change these two
places to "-Dusethreads".


btw, while that paragraph at
https://metacpan.org/source/RJBS/perl-5.24.0/pod/perlembed.pod#L933 talks
about running multiple interpreters in multiple OS threads, the example
after it (at
https://metacpan.org/source/RJBS/perl-5.24.0/pod/perlembed.pod#L941) is
just about interleaving two interpreters in one thread. I wonder if we can
add an example for multiple OS threads.

Thanks,
Zhenyi


Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About