Author: lwall
Date: 2009-10-06 02:47:27 +0200 (Tue, 06 Oct 2009)
New Revision: 28632
Modified:
docs/Perl6/Spec/S32-setting-library/IO.pod
Log:
[IO] clarify semantics and usage of note()
Modified: docs/Perl6/Spec/S32-setting-library/IO.pod
===================================================================
--- docs/Perl6/Spec/S32-setting-library/IO.pod 2009-10-05 23:51:25 UTC (rev
28631)
+++ docs/Perl6/Spec/S32-setting-library/IO.pod 2009-10-06 00:47:27 UTC (rev
28632)
@@ -22,7 +22,7 @@
Created: 19 Feb 2009 extracted from S29-functions.pod; added stuff from
S16-IO later
- Last Modified: 1 Oct 2009
+ Last Modified: 5 Oct 2009
Version: 8
The document is a draft.
@@ -448,8 +448,14 @@
=item multi note (*...@list --> Bool)
-Does a "say" to C<$*ERR>.
+Does a "say" to C<$*ERR>, more or less. Like C<warn>, it adds a
+newline only if the message does not already end in newline. Unlike
+C<warn>, it is not trappable as a resumable exception because it
+outputs directly to C<$*ERR>. You can suppress notes in a lexical
+scope by declaring:
+ only note(*@) {}
+
=item method printf ($self: Str $fmt, *...@list --> Bool)
=item multi printf (Str $fmt, *...@list --> Bool)
