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

Jump to bottom

Add documentation for "trying" method #4049

Closed
sdondley opened this issue Apr 7, 2022 · 2 comments
Closed

Add documentation for "trying" method #4049

sdondley opened this issue Apr 7, 2022 · 2 comments
Labels
docs Documentation issue (primary issue type)

Comments

@sdondley
Copy link
Contributor

sdondley commented Apr 7, 2022

Looking at the die X::IO::DoesNotExist.new(:path("foo/bar"), :trying("zombie copy")); line in the code example at https://docs.raku.org/language/exceptions#Typed_exceptions

It's not obvious what, exactly, the nature of the trying argument is. At first glance, it looks like an arbitrary string, but judging by the output of the error message, a zombie method is run based based on the string passed to trying.

There does not appear to be any documentation for the signature for the trying method to understand what might be happening.

Suggestions

Document the trying method more thoroughly at https://docs.raku.org/type/X::IO::DoesNotExist
@sdondley sdondley added the docs Documentation issue (primary issue type) label Apr 7, 2022
@sdondley sdondley changed the title Improve documentation of "trying" method Add documentation of "trying" method Apr 7, 2022
@sdondley sdondley changed the title Add documentation of "trying" method Add documentation for "trying" method Apr 7, 2022
lizmat added a commit that referenced this issue Apr 7, 2022
@lizmat
Some tweaks on CATCH
1312f06 
In resoponse to #4049
@lizmat lizmat mentioned this issue Apr 7, 2022
Merged
@lizmat
Copy link
Collaborator

lizmat commented Apr 7, 2022

The emphasis on "trying" is all wrong. Hope #4050 makes it clearer

JJ pushed a commit that referenced this issue Apr 9, 2022
@lizmat @coke
Some tweaks on CATCH (#4050)
dd2c13d 
* Some tweaks on CATCH

In resoponse to #4049

* typo

* Pass example compilation test

declare some items in preamble. Cheat on the method invocation.
use =begin on nearby block for consistent source formatting

Co-authored-by: Coke <will@coleda.com>
@coke
Copy link
Collaborator

coke commented Apr 10, 2022

PR merged, closing this ticket.

@coke coke closed this as completed Apr 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
docs Documentation issue (primary issue type)
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@coke @lizmat @sdondley