perlxstut add links and update examples

[ghost]

For #18163.

[atoomic]

LGTM

[karenetheridge]

Why is perl 5.22.2 needed? Could the commit message be a little more self-explanatory?

[Grinnz]

In general it is counter-productive to include unrelated unexplained changes.

[ghost]

The define PERL_NO_GET_CONTEXT was added to h2xs.PLon Dec 6, 2012.

The define PERL_NO_GET_CONTEXT was added to ParseXS's pods on Feb 16, 2014.

Perl 5.008008 could have been updated to 5.017007 concomitant with either of those commits.

[ghost]

3 failing checks after bb321ad.

testsuite / Windows msvc142
testsuite / Windows msvc100
testsuite / Windows mingw64

[xsawyerx]

@apparluk May I ask why you closed this PR and deleted the branch?

[ghost]

@xsawyerx

[doc] perlxs rpc (also Closed)

Here are the two files if someone else wants to take up the work.

Gist perlxstut.pod (raw) [deleted Nov 5, 2020]

Contains your code changes (the last all tests passing) and use 5.017007; but not mkmanifest.

Gist perlxs.pod (raw) [deleted Nov 5, 2020]

Run rpctest.pl and verify the correctness of the output before merging.

---

I have mostly moved on from this document. Please feel free to make whatever changes you feel are necessary to keep it up to date, or expand it as much as you like.

[khwilliamson]

#18278 has been opened to continue work on xsxtut.pod
#18279 has been opened to continue work on perlxs

[ghost]

@khwilliamson

cf: #18240 (comment)

I used 5.017007 in the .pod believing PERL_NO_GET_CONTEXT first appeared in that release.

-   use 5.008008;
+   use 5.017007;

However it would be unusual to expose the reader to a development release of perl in the .pod, and maybe using instead the >5.017007 next stable perl version would be more sensible.

---

cf: #18240 (comment)

The first failed tests on this PR occurred after bb321ad (Nov 1, 2020, 2:31 AM GMT+1).

[ddobbelaere]

The failing tests are unrelated to the commits in this PR, see #18280

[ghost]

This PR's msvc fails had the error message citing an unresolved external symbol.

[ghost]

Keep the append instruction and leave mkmanifest for another PR.

SPECIAL NOTES

Possible expansion could add a subsection on make manifest with mention of ./Build manifest.