search

Raku / doc

🦋 Raku documentation
https://docs.raku.org/
Artistic License 2.0
286 stars 293 forks source link

Update heredoc discussion #3972

Open tbrowder opened 2 years ago

tbrowder commented 2 years ago

Rakudo issue #4539 illuminated doc problems with the implication a heredoc could have its terminator following a block. Such is not the intent as @jnthn noted.

Rakudo has been changed per @jnthn's suggestion and the docs need a bit more detail (with examples) about intended and proper use.

JJ commented 2 years ago

Is that spec?

tbrowder commented 2 years ago

Hm, I haven’t checked the old speculations, I was using @jnthn’s comments. But I will look and add the results hither and yon. Thanks for the reminder.

tbrowder commented 2 years ago

Okay, I did find more info on the situation and will visit the PR again.

Thanks!

tbrowder commented 2 years ago

I'm happy with the Rakudo PR (which is consistent and corrects existing code per existing Synopses) and have asked @jnthn to review it. If approved, I will start working on adding more detail (with examples) for the docs.

tbrowder commented 2 years ago

@jnthn approved the PR and it's been merged.

coke commented 1 year ago

https://github.com/rakudo/rakudo/issues/4539