Documentation for sub note

Documentation for sub note, assembled from the following types:

role IO

From IO

(IO) sub note

Print the given text, followed by a newline "\n" on $*ERR (standard error). Before printing, call the .gist method on any non-Str objects.

note is effectively say, only it writes its output to the standard error stream. For instance:

if ("path/to/pirate/treasure".IO.e{
    say "Found pirate treasure!";
}
else {
    note "Could not find pirate treasure.  Are you sure it exists?";
}

will report (on the standard output stream) that treasure has been found if it exists or will note on the error stream that it couldn't be found if it doesn't exist.