diff --git a/docs/rakudo-nqp-and-pod-notes.md b/docs/rakudo-nqp-and-pod-notes.md index 109b204e052..372191a630c 100644 --- a/docs/rakudo-nqp-and-pod-notes.md +++ b/docs/rakudo-nqp-and-pod-notes.md @@ -14,8 +14,12 @@ + **DO use 'nqp::die'** - As opposed to '**say**', '**die**' does need to be qualified with '**nqp::**'. If used without the '**nqp::**' prefix, you sometimes may get a very unhelpful error message. -+ **DO NOT use '$\' inside a sub with a '$/' arg** - Use the full syntax for ++ **BE WARNED about '$\' inside a sub with a '$/' arg** - Use the full syntax for a match variable ('**/$+' versus '$\\*\*1'** - The '+' will result in a concatenated object + while the '\*\*' form will result in an array. Either form may be appropriate for the situation, + but proper handling will vary for each. + **BE WARNED about "return if (...)" statements** - Sometimes they work and sometimes not. But the failure message is usually good enough to find the offending code.