C backtrace tweaks.

Rename the environment variable that triggers the backtrace before
warns and croaks as PERL_USE_C_BACKTRACE_ON_ERROR (and correspondingly,
the define as USE_C_BACKTRACE_ON_ERROR).

Pod cleanups and updates, and move the needed #includes from perl.h
to util.c since that's the only place where they are needed.

1 files changed, 6 insertions, 0 deletions

diff --git a/util.h b/util.h
index 57a3ad0b65..736f978edf 100644
--- a/util.h
+++ b/util.h
@@ -121,6 +121,12 @@ typedef struct {
      * output - quite disgusting.  And that won't work if the
      * Developer Tools isn't installed. */
 
+    /* FreeBSD notes: execinfo.h exists, but probably would need also
+     * the library -lexecinfo.  BFD exists if the pkg devel/binutils
+     * has been installed, but there seems to be a known problem that
+     * the "bfd.h" getting installed refers to "ansidecl.h", which
+     * doesn't get installed. */
+
     /* Win32 notes: as moral equivalents of backtrace() + dladdr(),
      * one could possibly first use GetCurrentProcess() +
      * SymInitialize(), and then CaptureStackBackTrace() +