Raku / doc

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

No examples of native arrays anywhere in documentation #2183

Open lizmat opened 6 years ago

lizmat commented 6 years ago

The problem

The strings "int @", "str @" or "num @" do not occur anywhere in the documentation.

There is a https://docs.perl6.org/language/nativetypes section, but that appears to be geared towards use with NativeCall. While native arrays have a perfect use without having to use NativeCall or even know about it.

Suggestions

I'm not sure how to tackle this. The reason I found this, is because I was trying to find the place to document the :wrap named variable on the .sum method on native integer arrays (which is 20x as fast as without :wrap, but will wrap if the sum value exceeds 64bits).

I will, for now, document it with List.sum.

JJ commented 4 years ago

Good try, but probably not the best looking at #2257 Now they can be found, although maybe a bit too much...