summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2020-11-05 17:39:40 -0700
committerKarl Williamson <khw@cpan.org>2020-11-06 08:27:52 -0700
commitd1b9805ed0a3e2e5eeb6d14466adb0cd9f9a0166 (patch)
tree2ebb08f50b88b85e156aacd7f78e84d949948a3c
parent74ab7b797f72da8e6aad6d2db8a99cde4a1b98bb (diff)
downloadperl-d1b9805ed0a3e2e5eeb6d14466adb0cd9f9a0166.tar.gz
perlapi: Split section Display and Dump
into Debugging and Display sections
-rw-r--r--autodoc.pl8
-rw-r--r--dump.c3
-rw-r--r--util.c5
3 files changed, 9 insertions, 7 deletions
diff --git a/autodoc.pl b/autodoc.pl
index f4331297e6..f52264c3f9 100644
--- a/autodoc.pl
+++ b/autodoc.pl
@@ -111,7 +111,8 @@ my $concurrency_scn = 'Concurrency';
my $COP_scn = 'COP Hint Hashes';
my $CV_scn = 'CV Handling';
my $custom_scn = 'Custom Operators';
-my $dump_scn = 'Display and Dump functions';
+my $debugging_scn = 'Debugging';
+my $display_scn = 'Display functions';
my $embedding_scn = 'Embedding and Interpreter Cloning';
my $errno_scn = 'Errno';
my $exceptions_scn = 'Exception Handling (simple) Macros';
@@ -180,7 +181,8 @@ my %valid_sections = (
},
$custom_scn => {},
- $dump_scn => {},
+ $debugging_scn => {},
+ $display_scn => {},
$embedding_scn => {},
$errno_scn => {},
$exceptions_scn => {},
@@ -1033,7 +1035,7 @@ sub parse_config_h {
$configs{$name}{'section'} = $formats_scn;
}
elsif ($name =~ / BACKTRACE /x) {
- $configs{$name}{'section'} = $dump_scn;
+ $configs{$name}{'section'} = $debugging_scn;
}
elsif ($name =~ / ALLOC $sb /x) {
$configs{$name}{'section'} = $memory_scn;
diff --git a/dump.c b/dump.c
index e395790b1b..0004f49959 100644
--- a/dump.c
+++ b/dump.c
@@ -21,7 +21,7 @@
*
* It also holds the debugging version of the runops function.
-=for apidoc_section Display and Dump functions
+=for apidoc_section $display
*/
#include "EXTERN.h"
@@ -639,6 +639,7 @@ S_opdump_link(pTHX_ const OP *base, const OP *o, PerlIO *file)
}
/*
+=for apidoc_section $debugging
=for apidoc dump_all
Dumps the entire optree of the current program starting at C<PL_main_root> to
diff --git a/util.c b/util.c
index c1a441c2cc..5989a582c0 100644
--- a/util.c
+++ b/util.c
@@ -1508,7 +1508,7 @@ Perl_form_nocontext(const char* pat, ...)
#endif /* PERL_IMPLICIT_CONTEXT */
/*
-=for apidoc_section Display and Dump functions
+=for apidoc_section $display
=for apidoc form
=for apidoc_item form_nocontext
@@ -6340,7 +6340,7 @@ static void atos_symbolize(atos_context* ctx,
#endif /* #ifdef PERL_DARWIN */
/*
-=for apidoc_section Display and Dump functions
+=for apidoc_section $debugging
=for apidoc get_c_backtrace
Collects the backtrace (aka "stacktrace") into a single linear
@@ -6592,7 +6592,6 @@ Deallocates a backtrace received from get_c_backtrace.
*/
/*
-=for apidoc_section Display and Dump functions
=for apidoc get_c_backtrace_dump
Returns a SV containing a dump of C<depth> frames of the call stack, skipping