[rt.cpan.org #89468] $Win32::API::DEBUG is not documented

Mon Oct 14 12:40:20 2013: Request 89468 was acted upon.
Transaction: Correspondence added by BULKDD
       Queue: Win32-API
     Subject: $Win32::API::DEBUG is not documented
   Broken in: (no value)
    Severity: (no value)
       Owner: Nobody
  Requestors: [email protected]
      Status: new
 Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=89468 >


On Mon Oct 14 06:03:17 2013, MITHALDU wrote:
> As the title says. :)

Why should it be documented?

If you ever turn it on, every sub call to a PP Win32::API sub will generate 1-3 pages of logs in your console. It has a 2nd counterpart, controlled separately, in the C side called WIN32_API_DEBUG, which will also produce 1-3 pages of logs. It needs a recompile, and can't be runtime controlled (and shouldn't due to performance loss). The debugging code was added for authors/maintainers of Win32::API to use when debugging a problem on a remote user's installation where they can't step Perl or C code.