Re: [perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread brian d foy via RT
Several areas of the docs then need to correct that. No matter what you
decide, a user should be able to take the tricky words in an error message
and usefully find them in the docs.


-- 
brian d foy 
http://www.pair.com/~comdog/


Re: [perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread brian d foy
Several areas of the docs then need to correct that. No matter what you
decide, a user should be able to take the tricky words in an error message
and usefully find them in the docs.


-- 
brian d foy 
http://www.pair.com/~comdog/


[perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread Larry Wall via RT
Only *@foo and *%foo are slurpy, as in "slurping up the rest of the arguments. 
But the term "variadic" refers to all optional arguments including named ones, 
so it would be incorrect to call those "slurpy", because they don't.  It's like 
the difference between * and ? in regex.

Larry

On Fri, 18 Aug 2017 07:10:52 -0700, comdog wrote:
> Consider this program which I don't expect to work (and it doesn't compile):
> 
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
> 
> show-the-arguments( 1, 3, 7 );
> 
> The error message says "variadic":
> 
> Cannot put required parameter $i after variadic parameters
> 
> But another sort of error uses a different term:
> 
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
> 
> This time the error messages say "slurpy":
> 
> Only one slurpy positional allowed
> 
> The docs almost almost always say "slurpy" and the uses of "variadic"
> only appear as synonyms next to "slurpy":
> 
> * https://github.com/perl6/doc/search?utf8=✓=variadic=
> 
> * https://github.com/perl6/doc/search?utf8=✓=slurpy=


[perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread Larry Wall via RT
Only *@foo and *%foo are slurpy, as in "slurping up the rest of the arguments. 
But the term "variadic" refers to all optional arguments including named ones, 
so it would be incorrect to call those "slurpy", because they don't.  It's like 
the difference between * and ? in regex.

Larry

On Fri, 18 Aug 2017 07:10:52 -0700, comdog wrote:
> Consider this program which I don't expect to work (and it doesn't compile):
> 
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
> 
> show-the-arguments( 1, 3, 7 );
> 
> The error message says "variadic":
> 
> Cannot put required parameter $i after variadic parameters
> 
> But another sort of error uses a different term:
> 
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
> 
> This time the error messages say "slurpy":
> 
> Only one slurpy positional allowed
> 
> The docs almost almost always say "slurpy" and the uses of "variadic"
> only appear as synonyms next to "slurpy":
> 
> * https://github.com/perl6/doc/search?utf8=✓=variadic=
> 
> * https://github.com/perl6/doc/search?utf8=✓=slurpy=


[perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread Aleks-Daniel Jakimenko-Aleksejev via RT
This could've been a LHF, except for these tests:
https://github.com/perl6/roast/blob/4bfd6d2374cb4ea1b8fa057a5f294b988e4dec44/S32-exceptions/misc.t#L180-L185

¯\_(ツ)_/¯

But yes, I think it should say “slurpy” everywhere.

On 2017-08-18 07:10:52, comdog wrote:
> Consider this program which I don't expect to work (and it doesn't compile):
>
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
>
> show-the-arguments( 1, 3, 7 );
>
> The error message says "variadic":
>
> Cannot put required parameter $i after variadic parameters
>
> But another sort of error uses a different term:
>
> sub show-the-arguments ( *@args, $i ) {
> put "The arguments are @args[]";
> }
>
> This time the error messages say "slurpy":
>
> Only one slurpy positional allowed
>
> The docs almost almost always say "slurpy" and the uses of "variadic"
> only appear as synonyms next to "slurpy":
>
> * https://github.com/perl6/doc/search?utf8=✓=variadic=
>
> * https://github.com/perl6/doc/search?utf8=✓=slurpy=


[perl #131922] [LTA] "Variadic" or "slurpy"?

2017-08-18 Thread brian d foy
# New Ticket Created by  "brian d foy" 
# Please include the string:  [perl #131922]
# in the subject line of all future correspondence about this issue. 
# https://rt.perl.org/Ticket/Display.html?id=131922 >


Consider this program which I don't expect to work (and it doesn't compile):

sub show-the-arguments ( *@args, $i ) {
put "The arguments are @args[]";
}

show-the-arguments( 1, 3, 7 );

The error message says "variadic":

Cannot put required parameter $i after variadic parameters

But another sort of error uses a different term:

sub show-the-arguments ( *@args, $i ) {
put "The arguments are @args[]";
}

This time the error messages say "slurpy":

Only one slurpy positional allowed

The docs almost almost always say "slurpy" and the uses of "variadic"
only appear as synonyms next to "slurpy":

* https://github.com/perl6/doc/search?utf8=✓=variadic=

* https://github.com/perl6/doc/search?utf8=✓=slurpy=