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 =item * C<cmodulus> and variants [post 0.7.0]
  49
  50 See RT #58550.
  51
  52 =back
  53
  54 =head1 Opcodes
  55
  56 =over 4
  57
  58 =item * C<pioctl> [post 0.5.1]
  59
  60 See RT #48589.
  61
  62 =item * C<store_global> [post 0.5.0]
  63
  64 See RT #48016. Replace usage with set_[hll,root]_global variants.
  65
  66 =item * C<find_global> [post 0.5.0]
  67
  68 See RT #48018. Replace usage with get_[hll,root]_global variants.
  69
  70 =item * C<new>(out PMC, in INT, in STR) [post 0.5.0]
  71
  72 See RT #47011.
  73
  74 =item * C<get_mro> [post 0.5.0]
  75
  76 See RT #47976.
  77
  78 =item * C<n_*> math opcode variants [post 0.7.1]
  79
  80 See RT #58410.
  81
  82 =back
  83
  84 =head1 Class Features
  85
  86 =over 4
  87
  88 =item * Integer Type IDs [post 0.5.0]
  89
  90 See RT #48024. Instead of C<$P0 = new Integer> or C<$P0 = new .Integer>,
  91 use the following syntax, which works for both PMCs and objects.
  92
  93   $P0 = new 'Integer'
  94
  95 =item * PMC union struct [post 0.5.0]
  96
  97 See RT #48014. This will be removed once all core PMCs have been updated.
  98
  99 =back
 100
 101 =head1 PIR syntax
 102
 103 =over 4
 104
 105 =item * old-style PASM registers [post 0.6.4]
 106
 107 Old-style PASM registers without the C<$> character are deprecated; use
 108 PIR-style registers only.
 109
 110 See RT #57638.
 111
 112 =item * C<global> keyword [post 0.6.4]
 113
 114 See RT #48016
 115 and RT #48018.
 116
 117 =item * bare method names [post 0.6.4]
 118
 119 C<foo.bar()>, where C<bar> is not a local identifier (thus indicating
 120 a method name) is no longer supported.
 121
 122 See RT #45859.
 123
 124 =item * C<#line> [post 0.6.4]
 125
 126 Will be replaced by C<.line> to be more consistent with other PIR syntax.
 127
 128 See [RT#45857], [RT#43269], and [RT#47141].
 129
 130 =item * C<.pragma n_operators> [post 0.6.4]
 131
 132 See RT #57438.
 133
 134 =item * C<<.namespace <identifier> >> syntax [post 0.5.1]
 135
 136 See RT #48737.
 137
 138 =item * Use of C<::> in identifiers [post 0.5.1]
 139
 140 See RT #48735.
 141
 142 =item * C<.namespace [ "a" .. "b" ]> [post 0.5.0]
 143
 144 See RT #46715.
 145
 146 =item * C<.namespace> (without brackets) [post 0.6.2]
 147
 148 All should C<.namespace> directives without brackets should take
 149 empty brackets to indicate the root namespace.
 150 See RT #48549.
 151
 152 =item * C<.HLL_map> <string> ',' <string> [post 0.6.4]
 153
 154 This will be replaced by C<.HLL_map> <string> '=' <string>
 155
 156 See RT #57430.
 157
 158 =item * C<.HLL> <string> ',' <string> [post 0.6.4]
 159
 160 This will be replaced by C<.HLL> <string>; the second string (and
 161 comma to separate them) will no longer be accepted. Use C<.loadlib>
 162 for specifying the library name.
 163
 164 See RT #57428.
 165
 166 =item * vtable name .constants and __vtable overrides [post 0.5.2]
 167
 168 See RT #48877.
 169
 170 =item * Assignment syntax with opcodes [post ???]
 171
 172 See RT #36283.  When the first argument of an opcode is C<OUT>, then
 173 the assignment syntax will be allowed, as it is today.
 174
 175 In any other case (i.e. C<INOUT>, C<IN>), this will become
 176 a syntax error. For example:
 177
 178     $S0 = print
 179     $P0 = substr 1, 2, "x"
 180
 181 Will have to be:
 182
 183     print $S0
 184     substr $P0, 1, 2, "x"
 185
 186 =item * mmdvtregister and mmdvtablefind opcodes [post 0.7.0]
 187
 188 These opcodes are part of the old MMD system, now deprecated and to be removed
 189 when the branch is merged in after the release.
 190
 191 =item * C<addr> shortcut for C<set_addr> op [post 0.7.1]
 192
 193 The C<addr> shortcut that is mapped to the C<set_addr> will no longer be
 194 supported. Instead, use the C<set_addr> directly.
 195
 196 See RT#58238.
 197
 198 =item * C<get_*_keyed_int> VTABLE methods change the size of Resizable*Arrays
 199 [post 0.7.1]
 200
 201 The C<get_{String|PMC|Integer|Number|Boolean}_keyed_int> VTABLE methods
 202 increase the size of Resizable{String|PMC|Integer|Number|Boolean}Arrays when
 203 they're used to search for an element past the end of the array.  This behavior
 204 is deprecated and will be removed after the 0.7.1 release.
 205
 206 See RT #52778.
 207
 208 =back
 209
 210 =head1 Parrot Compiler tools
 211
 212 =head2 Capture-based objects
 213
 214 =over 4
 215
 216 =item get_array, get_hash, get_scalar deprecations [post 0.6.2]
 217
 218 See RT#54000.  The 'get_array', 'get_hash', and 'get_scalar'
 219 methods are now called 'list', 'hash', and 'item' respectively.
 220
 221 =back
 222
 223 =head2 P6object class creation
 224
 225 =over 4
 226
 227 =item P6object .new_class('Foo::Bar') will create ['Foo';'Bar'] [post 0.7.1]
 228
 229 See RT #58932.  Strings passed as class names to P6object will be
 230 automatically separated on double-colons.
 231
 232 =back
 233
 234 =cut