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 =over 4
  15
  16 =item enter_nci_method
  17
  18 This function is being renamed to register_nci_method. The original name was
  19 confusing (see #40801).
  20
  21 =back
  22
  23 =head1 Deprecated methods
  24
  25 =over 4
  26
  27 =item PGE
  28
  29 PGE::P6Regex is now a registered compiler, and should be used like so:
  30
  31  <@pmichaud> it's easy; instead of  $P0 = find_global "PGE", "p6rule"
  32    one now does  $P0 = compreg "PGE::P6Regex"
  33
  34 This syntax is also true for PGE::Glob and PGE::P5Regex
  35
  36 =back
  37
  38 =head1 Deprecated ops
  39
  40 From http://www.parrotcode.org/docs/ops/var.html, the following ops are
  41 deprecated:
  42
  43 =over 4
  44
  45 =item store_global
  46
  47 =item find_global
  48
  49 =item find_name
  50
  51 =back
  52
  53 There are several variants of some of the above ops; all are deprecated,
  54 and are replaced by the ops {set,get}_[hll,root]_global. See also
  55 http://www.parrotcode.org/docs/ops/var.html.
  56
  57 Additionally, the following (unimplemented) ops are going to be removed:
  58
  59 =over 4
  60
  61 =item adddoes
  62
  63 =item removedoes
  64
  65 =item singleton
  66
  67 =back
  68
  69
  70 =head1 Deprecated vtable methods
  71
  72 The following vtable methods are deprecated:
  73
  74 =over 4
  75
  76 =item void become_parent(PMC* class)
  77
  78 =item PMC* subclass(PMC* name)
  79
  80 =item PMC* get_anonymous_subclass()
  81
  82 =item PMC* new_singleton()
  83
  84 =back
  85
  86
  87 =head1 FUTURE changes
  88
  89 Not yet deprecated, but it's recommended to use the new syntax and
  90 gradually change the old.
  91
  92 =over 4
  93
  94 =item PMC Class name IDs [#41237]
  95
  96 ... will require a dot in front
  97
  98   $P0 = new Integer               => $P0 = new .Integer
  99
 100 =item Assignment syntax with opcodes [#36283]
 101
 102 When the first argument of an opcode is C<OUT>, then the assignment syntax
 103 will be allowed, as it is today.
 104
 105 In any other case (i.e. C<INOUT>, C<IN>), this will become
 106 a syntax error. For example:
 107
 108     $S0 = print
 109     $P0 = substr 1, 2, "x"
 110
 111 Will have to be:
 112
 113     print $S0
 114     substr $P0, 1, 2, "x"
 115
 116 =back