perlxs.pod: update EXAMPLES section

Rewrite this section:

     =head1 EXAMPLES

Basically, delete the one big example in this section and instead
provide links to various other examples already present in this document
instead.

Author: iabyn

dist/ExtUtils-ParseXS/lib/perlxs.pod

@@ -4789,77 +4789,44 @@ structure than a C<dMY_CXT> in another source file.
 
 =head1 EXAMPLES
 
-File C<RPC.xs>: Interface to some ONC+ RPC bind library functions.
+Fairly complete examples of XS files can be found elsewhere in this
+document:
 
-    #define PERL_NO_GET_CONTEXT
-    #include "EXTERN.h"
-    #include "perl.h"
-    #include "XSUB.h"
-
-    /* Note: On glibc 2.13 and earlier, this needs be <rpc/rpc.h> */
-    #include <tirpc/rpc.h>
-
-    typedef struct netconfig Netconfig;
-
-    MODULE = RPC  PACKAGE = RPC
-
-    SV *
-    rpcb_gettime(host = "localhost")
-        char   *host
-      PREINIT:
-        time_t  timep;
-      CODE:
-        ST(0) = sv_newmortal();
-        if (rpcb_gettime(host, &timep))
-            sv_setnv(ST(0), (double)timep);
-
-
-    Netconfig *
-    getnetconfigent(netid="udp")
-        char *netid
+=over
 
+=item *
 
-    MODULE = RPC  PACKAGE = NetconfigPtr  PREFIX = rpcb_
+L</T_PTROBJ and opaque handles>
 
-    void
-    rpcb_DESTROY(netconf)
-        Netconfig *netconf
-      CODE:
-        printf("NetconfigPtr::DESTROY\n");
-        free(netconf);
+=item *
 
-File C<typemap>: Custom typemap for RPC.xs. (cf. L<perlxstypemap>)
+L</A complete C++ example>
 
-     TYPEMAP
-     Netconfig * T_PTROBJ
+=item *
 
-File C<RPC.pm>: Perl module for the RPC extension.
+L</Safely Storing Static Data in XS>
 
-    package RPC;
+=back
 
-    require Exporter;
-    require DynaLoader;
-    @ISA    = qw(Exporter DynaLoader);
-    @EXPORT = qw(rpcb_gettime getnetconfigent);
+while L</SYNOPSIS> contains an overview of an XS file and L<perlxstut>
+contains various worked examples.
 
-    bootstrap RPC;
-    1;
+You can of course look at existing XS distributions on CPAN for
+inspiration, although bear in mind that many of these will have been
+created before this document was rewritten in 2025, and so may not follow
+current best practices.
 
-File C<rpctest.pl>: Perl test program for the RPC extension.
+Note that when wrapping a real library, you'll often need to add a line
+like this to the .xs file:
 
-    use RPC;
+    #include <foobar.h>
 
-    $netconf = getnetconfigent();
-    $a = rpcb_gettime();
-    print "time = $a\n";
-    print "netconf = $netconf\n";
+and add entries like:
 
-    $netconf = getnetconfigent("tcp");
-    $a = rpcb_gettime("poplar");
-    print "time = $a\n";
-    print "netconf = $netconf\n";
+    LIBS  => ['-lfoo', '-lbar'],
 
-In Makefile.PL add -ltirpc and -I/usr/include/tirpc.
+to F<Makefile.PL> or similar. And don't forget to add test scripts under
+t/.
 
 =head1 CAVEATS