[perl #132324] Documentation about debugger should be cleared

On Fri, 20 Oct 2017 11:15:24 GMT, kes-kes@yandex.ru wrote:
> Cc: kes-kes@yandex.ru
> To: perlbug@perl.org
> Message-Id: <5.24.0_8893_1508497451@work>
> From: kes-kes@yandex.ru
> Reply-To: kes-kes@yandex.ru
> Subject: Documentation about debugger should be cleared
> 
> 
> This is a bug report for perl from kes-kes@yandex.ru,
> generated with the help of perlbug 1.40 running under perl 5.24.0.
> 
> 
> -----------------------------------------------------------------
> [Please describe your issue here]
> 
> I have subroutine:
> 
> 614: sub create_constraint
> x615: {
> x616:     my ($c, $options) = @_;
> 617:
> x618:     my $generator = _generator($options);
> x619:     my $table_name = $c->table->qualified_name;
> .....
> 677:     }
> 678:
> x679:     return \@constraint_defs, \@fks;
> 680: }
> 
> But for this sub in %DB::sub I have next entry:
> 
> lib/SQL/Translator/Producer/PostgreSQL.pm:615-680
> 
> The subroutine consist of declaration and definition.
> https://perldoc.perl.org/perlsub.html#SYNOPSIS
> 
> But
> [documentation](https://perldoc.perl.org/perldebguts.html#Debugger-
> Internals) did not say what hash entry consist of:
> the only declaration or definition too.
> 
> Please fix debugger internals or documentation.
> 

I don't think there's anything that needs to be fixed.

In pod/perldebguts.pod, under the "Debugger Internals" section you mentioned, we have this paragraph:

#####
A hash C<%DB::sub> is maintained, whose keys are subroutine names and whose values have the form C<filename:startline-endline>. C<filename> has the form C<(eval 34)> for subroutines defined inside C<eval>s.
#####

The output you cite conforms to the 'filename:startline-endline' format described in that paragraph.  The documentation makes no claim to providing the subroutine definition.  Doing so would probably entail a complete overhaul of the debugger -- and my hunch is that there is no one who wants to take on that task at this time.

Thank you very much.

-- 
James E Keenan (jkeenan@cpan.org)

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

• [perl #132324] Documentation about debugger should be cleared by James E Keenan via RT
• [perl #132324] Documentation about debugger should be cleared by KES