DEPRECATED.pod

   1 =head1 .imc file extension
   2
   3 http://xrl.us/jc4u
   4
   5  IMC vs. PIR
   6  Two names enter
   7  One name leaves
   8
   9  /me giggles
  10  -- Chip Salzenberg
  11
  12 =head1 Deprecated C APIs
  13
  14 Currently no C APIs are deprecated.
  15
  16 =head1 Deprecated methods
  17
  18 =over 4
  19
  20 =item PGE
  21
  22 PGE::P6Regex is now a registered compiler, and should be used like so:
  23
  24  <@pmichaud> it's easy; instead of  $P0 = find_global "PGE", "p6rule"
  25    one now does  $P0 = compreg "PGE::P6Regex"
  26
  27 This syntax is also true for PGE::Glob and PGE::P5Regex
  28
  29 =back
  30
  31 =head1 Deprecated ops
  32
  33 From http://www.parrotcode.org/docs/ops/var.html, the following ops are
  34 deprecated:
  35
  36 =over 4
  37
  38 =item store_global
  39
  40 =item find_global
  41
  42 =item find_name
  43
  44 =back
  45
  46 There are several variants of some of the above ops; all are deprecated,
  47 and are replaced by the ops {set,get}_[hll,root]_global. See also
  48 http://www.parrotcode.org/docs/ops/var.html.
  49
  50
  51 =head1 Deprecated Class Features
  52
  53 =over 4
  54
  55 =item 1
  56
  57 Type IDs will go away in 0.5.0.
  58
  59 =item 2
  60
  61 The C<classname> op is deprecated and will be removed in the 0.5.0 release.
  62 It's an exact duplicate of the string return variant of the C<typeof> op.
  63
  64 =item 3
  65
  66 The experimental C<instantiate> opcode is deprecated and will be removed in the
  67 0.5.0 release.
  68
  69 (The C<instantiate> vtable function becomes core in 0.5.0, but is accessed via
  70 the "new" opcode for the PMCs that use it.)
  71
  72 =item 4
  73
  74   PMC* subclass(PMC* name)
  75
  76 The subclass vtable method is deprecated and will be removed in the 0.5.0 release.
  77
  78 =item 5
  79
  80 The PMC union struct is deprecated and will be removed once all core PMCs have
  81 been updated.
  82
  83 =back
  84
  85 =head1 FUTURE changes
  86
  87 Not yet deprecated, but it's recommended to use the new syntax and
  88 gradually change the old.
  89
  90 =over 4
  91
  92 =item PMC Class name IDs
  93
  94 Instead of:
  95
  96   $P0 = new Integer
  97
  98 or
  99
 100   $P0 = new .Integer # better, but ...
 101
 102 we are moving to use:
 103
 104   $P0 = new 'Integer'
 105
 106 =item Assignment syntax with opcodes [#36283]
 107
 108 When the first argument of an opcode is C<OUT>, then the assignment syntax
 109 will be allowed, as it is today.
 110
 111 In any other case (i.e. C<INOUT>, C<IN>), this will become
 112 a syntax error. For example:
 113
 114     $S0 = print
 115     $P0 = substr 1, 2, "x"
 116
 117 Will have to be:
 118
 119     print $S0
 120     substr $P0, 1, 2, "x"
 121
 122 =back
 123
 124 =head1 Deprecated compiler tools
 125
 126 =over 4
 127
 128 =item compilers/past and compilers/post [#44011]
 129
 130 The compilers/past and compilers/post tools are deprecated in
 131 favor of compilers/past-pm and compilers/pct .  They are expected
 132 to be completely removed from the repository in an upcoming release.
 133
 134 =back
 135