[Perl/perl5] 13e8b5: perlxstut.pod: Fix a path, simplify

[email protected] (Harald Jörg via perl5-changes) Tue, 03 Mar 2026 12:08:26 -0800

Newsgroups	perl.perl5.changes
Message-ID	<Perl/perl5/push/refs/heads/blead/[email protected]>

  Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: 13e8b5a0390e6b9c5a5387aaa73225a7ca5c5e20
      https://github.com/Perl/perl5/commit/13e8b5a0390e6b9c5a5387aaa73225a7ca5c5e20
  Author: Harald Jörg <[email protected]>
  Date:   2026-03-03 (Tue, 03 Mar 2026)

  Changed paths:
    M dist/ExtUtils-ParseXS/lib/perlxstut.pod

  Log Message:
  -----------
  perlxstut.pod: Fix a path, simplify

I walked through perlxstut.pod yesterday, here are some
suggestions to improve it:

* Example 1:

  Change VERSION_FROM values from 'Mytest.pm' to 'lib/Mytest.pm'
  (also in Example 4)

  Remove the shebang line which makes assumptions where the Perl
  executable is located and adjust the program invocation
  accordingly

* Example 2:

  Delete a paragraph to re-generate the Makefile which is not needed
  at this point.  Running make, as documented, is good enough

* Example 4:

  Eliminate an ampersand before a function call to Mytest2::TESTVAL

  Removed a paragraph recommending to move exports to EXPORT_OK.
  This would break the test created by h2xs unless the tests are
  changed to import the constants.

* Troubleshooting these Examples

  Deleted some paragraphs describing issues of Perl 5.001 and 5.002



To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications