[perl #120841] ERRSV is undocumented

On Wed, 03 Jul 2019 18:37:43 -0700, tonyc wrote:
> On Tue, 06 Oct 2015 03:57:18 -0700, davem wrote:
> > On Sat, Dec 21, 2013 at 03:05:50PM -0800, bulk88 wrote:
> > > ERRSV is used extensively in perlcall, yet undocumented in perlapi or 
> > > perlintern. The only public API alternative to ERRSV is, "sv = 
> > > get_sv("@", 0);" and that doesn't work if something did a PP "delete 
> > > $::{'@'};" earlier. Please decide whether it is public api or private 
> > > api and document it in perlapi or perlintern.
> > 
> > Well its used in several examples in perlcall.pod and elsewhere, so I
> > think it needs to be regarded as part of the API.
> > 
> > Do you want to contribute a pod entry? Perhaps one for CLEAR_ERRSV() too?
> > 
> 
> Patch attached.
> 
> I also documented the errno handling macros for internal use.

That errno handling documentation had an error, which I've fixed, pushed the ERRSV docs as 40bec302ee56bcc8f5c96ebd2c336d1194e713a6, the fixed errno handling macro docs as 131e4949745cb53db2d0dec8d7649c20ea51f0b8 and an update to apidoc.pl to make it complain a little more loudly in 256dda502eca71f547885c73901e8e8b42d47174.

Tony

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

• [perl #120841] ERRSV is undocumented by Tony Cook via RT