Skip Menu |
Report information
Id: 126202
Status: open
Priority: 0/
Queue: perl6

Owner: Nobody
Requestors: rob [at] hoelz.ro
Cc:
AdminCc:

Severity: (no value)
Tag: (no value)
Platform: (no value)
Patch Status: (no value)
VM: (no value)



Subject: LTA results for trailing declarative docs
Download (untitled) / with headers
text/plain 292b
In this example: class Foo { method bar { } #= baz }; say Foo.^find_method('bar')[0].WHY The comment 'baz' is attached to the class Foo, rather than the method bar. This is the correct behavior given the specification, but I can see how that would be confusing to a beginner.
Subject: Re: [perl #126202] LTA results for trailing declarative docs
Date: Sun, 27 Sep 2015 09:27:56 -0400
To: perl6-compiler [...] perl.org
From: Parrot Raiser <1parrota [...] gmail.com>
Download (untitled) / with headers
text/plain 701b
Change " class Foo { method bar { } #= baz " to " class Foo { method bar { } #= Some comment about Foo "? On 9/26/15, Rob Hoelz <perl6-bugs-followup@perl.org> wrote: Show quoted text
> # New Ticket Created by Rob Hoelz > # Please include the string: [perl #126202] > # in the subject line of all future correspondence about this issue. > # <URL: https://rt.perl.org/Ticket/Display.html?id=126202 > > > > In this example: > > class Foo { method bar { } #= baz > }; > > say Foo.^find_method('bar')[0].WHY > > The comment 'baz' is attached to the class Foo, rather than the method bar. > This is the correct behavior given the specification, but I can see how that > would be confusing to a beginner. >
Download (untitled) / with headers
text/plain 972b
The issue is that some new users might think that the comment is going to be attached to the bar method, but the actual behavior is the comment being attached to the Foo class. On 2015-09-27 06:28:22, 1parrota@gmail.com wrote: Show quoted text
> Change " > class Foo { method bar { } #= baz > " to " > class Foo { method bar { } #= Some comment about Foo > "? > > On 9/26/15, Rob Hoelz <perl6-bugs-followup@perl.org> wrote:
> > # New Ticket Created by Rob Hoelz > > # Please include the string: [perl #126202] > > # in the subject line of all future correspondence about this issue. > > # <URL: https://rt.perl.org/Ticket/Display.html?id=126202 > > > > > > > In this example: > > > > class Foo { method bar { } #= baz > > }; > > > > say Foo.^find_method('bar')[0].WHY > > > > The comment 'baz' is attached to the class Foo, rather than the > > method bar. > > This is the correct behavior given the specification, but I can see > > how that > > would be confusing to a beginner. > >


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

For issues related to this RT instance (aka "perlbug"), please contact perlbug-admin at perl.org