Skip to content

Conversation

schultzdavid
Copy link
Collaborator

@schultzdavid schultzdavid commented Oct 16, 2025

(The first three commits have already been merged to Raku:main via my pull request 4648 last week.)

This new bunch does a couple of things:

  • In the section Type captures, I added an example that combines type captures with type coercion (taken from roast github.com/Raku/roast/blob/master/S06-signature/type-capture.t), and I further examples combining that with type constraints (conformant with the 4th example in this section, although strictly speaking I don't know if the examples are supposed to work as they do (there seem to be no roast for type constraints on captures)).
  • In the introductory section, to keep it about only the most relevant things, I moved the part about the invocant marker : to the next section ("Parameter separators") by merging the two very similar examples into one.
    • Still to do: In a future commit (tomorrow probably) I will add a part about slurpy parameters in the intro section.
  • I fixed some links, e.g. one link was broken because "Typesystem" was erroneously capitalized.
  • I shuffled some words and sentences around, although that's probably debatable

@schultzdavid
Copy link
Collaborator Author

schultzdavid commented Oct 17, 2025

These last two commits fix a sentence relationship that got a bit out of order through the addition of material in commit c286df1. Also, the examples should now be easier to digest as they each illustrate one new point at a time.

@schultzdavid
Copy link
Collaborator Author

schultzdavid commented Oct 18, 2025

About the last 4 commits and the next one: That one can use type captures as return types, is indeed intended (e.g. S06-signature/type-capture.t#L98).

…ype captures' up, and sections on slurpies down.

Moving section 'Type captures' up keeps the material on type constraints together.
Moving sections on slurpies down so that the more elementary section 'Positional vs. named arguments' appears first.
@schultzdavid schultzdavid marked this pull request as ready for review October 18, 2025 18:38
@schultzdavid schultzdavid changed the title Draft: In signatures.rakudoc: New material on type captures; work on introduction and parameter separators; some fixes here and there In signatures.rakudoc: New material on type captures; work on introduction and parameter separators; some fixes here and there Oct 18, 2025
@schultzdavid
Copy link
Collaborator Author

These last two commits (adding text on slurpies to the introduction) are now really the last ones to this PR.

@coke coke merged commit cfd86f8 into Raku:main Oct 20, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants