Skip to content

Commit 41d2504

Browse files
committed
Reword "in future language versions"
- We *are* deprecating some features on language level in 6.d, even if the Rakudo implementation currently can't issue per-language-version deprecation warnings on methods - Just because an implementation doesn't short-circuit Junctions yet, doesn't mean that's defined behaviour on language level
1 parent 083f7c1 commit 41d2504

File tree

3 files changed

+12
-9
lines changed

3 files changed

+12
-9
lines changed

doc/Type/IO/Handle.pod6

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -97,8 +97,8 @@ C<open> to open (if C<closed>) the C<$*IN> handle if opening in read-only
9797
mode or to open the C<$*OUT> handle if opening in write-only mode. All other
9898
modes in this case will result in exception being thrown.
9999
100-
In future language versions, path C<'-'> will likely have no special meaning and
101-
relying on this behaviour in new programs is not recommended.
100+
As of B<6.d> language version, use path C<'-'> is deprecated and it will
101+
be removed in future language versions entirely.
102102
103103
The C<:out-buffer> controls output buffering and by default behaves as if
104104
it were C<Nil>. See method L<out-buffer> for details.

doc/Type/Junction.pod6

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -60,11 +60,11 @@ Note that the compiler is allowed, but not required, to parallelize
6060
autothreading (and Junction behavior in general), so it is usually an
6161
error to autothread junctions over code with side effects.
6262
63-
It is possible that I<future language versions> will include short-circuiting
64-
behaviour in Junctions. For example one or more routine calls (C<a()>, C<b()>,
65-
or C<c()>) in the code below might not get executed at all, if the result of
66-
the conditional has been fully determined from routine calls already performed
67-
(only one truthy return value is enough to know the entire Junction is true):
63+
Implementations are allowed to short-circuit Junctions. For example one or more
64+
routine calls (C<a()>, C<b()>, or C<c()>) in the code below might not get
65+
executed at all, if the result of the conditional has been fully determined
66+
from routine calls already performed (only one truthy return value is enough
67+
to know the entire Junction is true):
6868
6969
=begin code :preamble<sub a(){}; sub b(){}; sub c(){}>
7070
if a() | b() | c() {

doc/Type/Pair.pod6

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -301,8 +301,11 @@ Makes the I<value> of the C<Pair> read-only, by removing it from its L<Scalar co
301301
CATCH { default { put .^name, ': ', .Str } };
302302
# OUTPUT: «X::Assignment::RO: Cannot modify an immutable Str (apple)␤»
303303
304-
B<NOTE:> this method is proposed for removal in future language versions and its
305-
use is not recommended.
304+
B<NOTE:> this method is deprecated as of B<6.d> language version. Instead,
305+
create a new C<Pair>, with L<deconted|/language/glossary#decont> key/value.
306+
307+
=for code :preamble<my $p>
308+
$p.=Map.=head.say; # OUTPUT: «orange␤»
306309
307310
=head2 method Str
308311

0 commit comments

Comments
 (0)