Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

results for trailing declarative docs #4597

Open
p6rt opened this issue Sep 26, 2015 · 4 comments
Open

results for trailing declarative docs #4597

p6rt opened this issue Sep 26, 2015 · 4 comments
Labels
LTA Less Than Awesome; typically an error message that could be better

Comments

@p6rt
Copy link

p6rt commented Sep 26, 2015

Migrated from rt.perl.org#126202 (status was 'open')

Searchable as RT126202$

@p6rt
Copy link
Author

p6rt commented Sep 26, 2015

From @hoelzro

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.

@p6rt
Copy link
Author

p6rt commented Sep 27, 2015

From 1parrota@gmail.com

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-archive.perl.org/perl6/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.

@p6rt
Copy link
Author

p6rt commented Sep 27, 2015

The RT System itself - Status changed from 'new' to 'open'

@p6rt
Copy link
Author

p6rt commented Sep 28, 2015

From @hoelzro

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​:

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-archive.perl.org/perl6/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.

@p6rt p6rt added the LTA Less Than Awesome; typically an error message that could be better label Jan 5, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
LTA Less Than Awesome; typically an error message that could be better
Projects
None yet
Development

No branches or pull requests

1 participant