DEPRECATED.pod

   1 # $Id$
   2
   3 =head1 Deprecation in Parrot
   4
   5 This is a list of currently deprecated features of Parrot.  Every deprecation
   6 has an associated RT ticket.  Each item indicates the last release it's
   7 guaranteed to appear in.  Items marked with a release of ??? are still
   8 deprecated, but a firm deadline for their removal has not yet been established.
   9
  10 When deprecated items are removed, all usage of the feature in the
  11 repository should be updated or removed; including documentation.
  12
  13 When deprecating opcodes, in addition to the ticket, be sure to mark the
  14 opcode with the :deprecated flag; this will allow users to enable deprecation
  15 warnings selectively with:
  16
  17  .include 'include/warnings.pasm'
  18  warningson .PARROT_WARNINGS_DEPRECATED_FLAG
  19
  20 And then receive runtime warnings if they are using any deprecated opcodes.
  21 The C<-w> command line option for parrot can also be used to enable all
  22 warnings.
  23
  24 =head1 vtable entries
  25
  26 =over 4
  27
  28 =item * C<type_keyed> [post 0.5.2]
  29
  30 See RT #48577.
  31
  32 =item * C<type_keyed_int> [post 0.5.2]
  33
  34 See RT #48579.
  35
  36 =item * C<type_keyed_str> [post 0.5.2]
  37
  38 See RT #48581.
  39
  40 =item * C<type> [post 0.5.2]
  41
  42 See RT #48567.
  43
  44 =item * C<new_from_string> [post 0.5.0]
  45
  46 See RT #47011.
  47
  48 =back
  49
  50 =head1 Opcodes
  51
  52 =over 4
  53
  54 =item * C<pioctl> [post 0.5.1]
  55
  56 See RT #48589.
  57
  58 =item * C<store_global> [post 0.5.0]
  59
  60 See RT #48016. Replace usage with set_[hll,root]_global variants.
  61
  62 =item * C<find_global> [post 0.5.0]
  63
  64 See RT #48018. Replace usage with get_[hll,root]_global variants.
  65
  66 =item * C<new>(out PMC, in INT, in STR) [post 0.5.0]
  67
  68 See RT #47011.
  69
  70 =item * C<get_mro> [post 0.5.0]
  71
  72 See RT #47976.
  73
  74 =back
  75
  76 =head1 Class Features
  77
  78 =over 4
  79
  80 =item * Integer Type IDs [post 0.5.0]
  81
  82 See RT #48024. Instead of C<$P0 = new Integer> or C<$P0 = new .Integer>,
  83 use the following syntax, which works for both PMCs and objects.
  84
  85   $P0 = new 'Integer'
  86
  87 =item * PMC union struct [post 0.5.0]
  88
  89 See RT #48014. This will be removed once all core PMCs have been updated.
  90
  91 =back
  92
  93 =head1 PIR syntax
  94
  95 =over 4
  96
  97 =item * old-style PASM registers [post 0.6.4]
  98
  99 Old-style PASM registers without the C<$> character are deprecated; use
 100 PIR-style registers only.
 101
 102 See RT #57638.
 103
 104 =item * C<global> keyword [post 0.6.4]
 105
 106 See RT #48016
 107 and RT #48018.
 108
 109 =item * bare method names [post 0.6.4]
 110
 111 C<foo.bar()>, where C<bar> is not a local identifier (thus indicating
 112 a method name) is no longer supported.
 113
 114 See RT #45859.
 115
 116 =item * C<#line> [post 0.6.4]
 117
 118 Will be replaced by C<.line> to be more consistent with other PIR syntax.
 119
 120 See [RT#45857], [RT#43269], and [RT#47141].
 121
 122 =item * C<.pragma n_operators> [post 0.6.4]
 123
 124 See RT #57438.
 125
 126 =item * C<<.namespace <identifier> >> syntax [post 0.5.1]
 127
 128 See RT #48737.
 129
 130 =item * Use of C<::> in identifiers [post 0.5.1]
 131
 132 See RT #48735.
 133
 134 =item * C<.namespace [ "a" .. "b" ]> [post 0.5.0]
 135
 136 See RT #46715.
 137
 138 =item * C<.namespace> (without brackets) [post 0.6.2]
 139
 140 All should C<.namespace> directives without brackets should take
 141 empty brackets to indicate the root namespace.
 142 See RT #48549.
 143
 144 =item * C<.HLL_map> <string> ',' <string> [post 0.6.4]
 145
 146 This will be replaced by C<.HLL_map> <string> '=' <string>
 147
 148 See RT #57430.
 149
 150 =item * C<.HLL> <string> ',' <string> [post 0.6.4]
 151
 152 This will be replaced by C<.HLL> <string>; the second string (and
 153 comma to separate them) will no longer be accepted. Use C<.loadlib>
 154 for specifying the library name.
 155
 156 See RT #57428.
 157
 158 =item * vtable name .constants and __vtable overrides [post 0.5.2]
 159
 160 See RT #48877.
 161
 162 =item * Assignment syntax with opcodes [post ???]
 163
 164 See RT #36283.  When the first argument of an opcode is C<OUT>, then
 165 the assignment syntax will be allowed, as it is today.
 166
 167 In any other case (i.e. C<INOUT>, C<IN>), this will become
 168 a syntax error. For example:
 169
 170     $S0 = print
 171     $P0 = substr 1, 2, "x"
 172
 173 Will have to be:
 174
 175     print $S0
 176     substr $P0, 1, 2, "x"
 177
 178 =item * mmdvtregister and mmdvtablefind opcodes [post 0.7.0]
 179
 180 These opcodes are part of the old MMD system, now deprecated and to be removed
 181 when the branch is merged in after the release.
 182
 183 =back
 184
 185 =head1 Parrot Compiler tools
 186
 187 =head2 Capture-based objects
 188
 189 =over 4
 190
 191 =item get_array, get_hash, get_scalar deprecations [post 0.6.2]
 192
 193 See RT#54000.  The 'get_array', 'get_hash', and 'get_scalar'
 194 methods are now called 'list', 'hash', and 'item' respectively.
 195
 196 =back
 197
 198 =cut