This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 470dd22
authorMatthew Horsfall (alh) <wolfsage@gmail.com>
Thu, 12 Jun 2014 17:05:35 +0000 (13:05 -0400)
committerMatthew Horsfall (alh) <wolfsage@gmail.com>
Thu, 12 Jun 2014 17:05:35 +0000 (13:05 -0400)
pod/perldelta.pod

index dcf52e7..325c70f 100644 (file)
@@ -27,6 +27,24 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
+=head2 Experimental C Backtrace API
+
+Starting from Perl 5.21.1, on some platforms Perl supports retrieving
+the C level backtrace (similar to what symbolic debuggers like gdb do).
+
+The backtrace returns the stack trace of the C call frames,
+with the symbol names (function names), the object names (like "perl"),
+and if it can, also the source code locations (file:line).
+
+The supported platforms are Linux and OS X (some *BSD might work at
+least partly, but they have not yet been tested).
+
+The feature needs to be enabled with C<Configure -Dusecbacktrace>.
+
+Also included is a C API to retrieve backtraces.
+
+See L<perlhacktips/"C backtrace"> for more information.
+
 =head2 C<qr/foo/x> now ignores any Unicode pattern white space
 
 The C</x> regular expression modifier allows the pattern to contain