Re: Perl6: unexpected exception when printing to a writable file handle

[stevieb]

Another case of Rubber Duck Debugging... (and not reading enough docs).

From the spurt() docs:

To write to an IO::Handle, use the print method.

So I have to do this:

my $wfh = open("in.txt", :w);
$wfh.print("a\n");
$wfh.close;

...or, skip opening the file entirely, and pass the filename to spurt() directly:

spurt "in.txt", "a\n";

So I'll re-review the docs, as the example in my OP appears to be incorrect (I'll submit a patch if this turns out to be the case after more testing).

[Zoffix]

Yes, the docs are incorrect. A patch fixing them just went in: https://github.com/perl6/doc/pull/555/files

[stevieb]

As a side question, is there an official location to discuss making potential changes to the docs?

I'm speaking about many of the docs, but as an example, in Str type doc, I think it would be useful to have a very short brief of what each entry does. eg:

1. Methods:
    2. routine chomp - removes trailing newlines

If this is wanted, I'd start the process and send PRs. I feel it would help future readers, and if I start this process, it'll allow me to learn very quickly as I'd have to read every single entry (while testing it), and that'd solidify things much faster than reviewing the docs periodically (and missing/not knowing about methods and functions that I don't even know exist).

[raiph]

To chat about Perl 6 things, including use and contributions, visit #perl6 on freenode. What happens next depends. https://github.com/perl6/doc/issues is used for most doc issues.

[stevieb]

Thanks for the clarification, Zoffix! I'm glad that I was reading and understanding things properly.