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

[perl #129151] Clarify build options in perlembed doc

Thread Next
From:
James E Keenan via RT
Date:
September 1, 2016 23:00
Subject:
[perl #129151] Clarify build options in perlembed doc
Message ID:
rt-4.0.24-16003-1472770799-1993.129151-15-0@perl.org
On Wed Aug 31 05:57:30 2016, zhouzhen1@gmail.com wrote:
> 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". 

I should note that these lines are unchanged since 2001.

> But useithreads is mostly documented nowhere else. 

Actually, 'useithreads' is extensively discussed in pod/perlthrtut.pod.

> And
> today this is always equivalent to a single "-Dusethreads", which is
> mentioned in Perl INSTALL doc. 

What is your source for the equivalence of "-Dusethreads" and "-Duseithreads"?  (I'm not enough of a threads user/expert to confirm that statement.  I do know that when I do smoke tests for FreeBSD, I include '-Duseithreads' because that's how the system perl on that OS is configured.)

> IMHO mentioning both "-Dusethreads
> -Duseithreads" can confuse people. And I would suggest change these two
> places to "-Dusethreads".

I suspect you are correct, but I think we need input from people who know more about threads than I do.

> 
> 
> 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.
> 

Again, need comment from more informed people.

> Thanks,
> Zhenyi


-- 
James E Keenan (jkeenan@cpan.org)

---
via perlbug:  queue: perl5 status: new
https://rt.perl.org/Ticket/Display.html?id=129151

Thread Next


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