Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Give all non-experimental items in api.yaml a deprecated tag
  • Loading branch information
leto committed Jan 29, 2011
1 parent 42c4347 commit 3e163b9
Showing 1 changed file with 42 additions and 6 deletions.
48 changes: 42 additions & 6 deletions docs/changes/api.yaml
Expand Up @@ -5,24 +5,28 @@
tags:
- PIR
- syntax
- deprecated
ticket: https://trac.parrot.org/parrot/ticket/1896
'":load" and ":init" Sub flags doing different things':
eligible: 3.1
note: 'Currently, ":init" and ":load" flagged Subs get called depending on the way a PIR file has been loaded. This distinction is silly and will cease to be. The ":load" flag will be triggered both for scenarios. ":init" becomes a no-op for a deprecation cycle (see below).'
tags:
- deprecated
- PIR
- syntax
ticket: https://trac.parrot.org/parrot/ticket/1895
':main Sub behaviour and selection.':
eligible: 2.7
note: 'Currently, if no :main sub is found, the first .sub in a file is used as main. Also, arguments are passed to the main sub regardless of the .param declarations in that sub. After this change, if no sub is marked with :main, an exception will be raised. Multiple :main declarations will be still be allowed, and all but the first will be ignored. This change will also force all subs, including :main, to have their arguments checked - to allow an arbitrary number of arguments, have this be the only .param declaration in the sub.'
tags:
- deprecated
- PIR
- syntax
ticket: https://trac.parrot.org/parrot/ticket/1705
Action methods in rules:
note: 'Per Synopsis 5, all regexes will have an implied {*} token at the end which cause invocation of an action method if a ":action" object is supplied.'
tags:
- deprecated
- compiler
ticket: https://trac.parrot.org/parrot/ticket/843
'Archive::Tar & Archive::Zip':
Expand All @@ -38,20 +42,23 @@ Action methods in rules:
eligible: 2.4
note: E.g. will not auto-vivify nested hashes and return PMCNULL early.
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/1561
'C API coding standards cleanup':
eligible: 1.1
note: "All C API functions that aren't currently named according to the 'Parrot_<system>_*' scheme will be renamed. A list of renamed functions will be kept in the ticket at:"
tags:
- deprecated
- functions
ticket: https://trac.parrot.org/parrot/ticket/443
'Complex PMC':
eligible: 3.1
note: This perennially broken PMC will be removed.
tags:
- deprecated
- PMC
ticket: http://trac.parrot.org/parrot/ticket/1892
ticket: https://trac.parrot.org/parrot/ticket/1892
'Cross-HLL library loading':
tags:
- library
Expand All @@ -61,8 +68,9 @@ Action methods in rules:
eligible: 3.1
note: All PIR ops and internal semantics related to timely destruction of PMCs is deprecated.
tags:
- deprecated
- functions
ticket: http://trac.parrot.org/parrot/ticket/1800
ticket: https://trac.parrot.org/parrot/ticket/1800
'GC_SYS_NAME option to interpinfo_s_i':
note: Ability to get the string name of the current GC core from the interpinfo_s_i. See r43900 and r43904 for details.
tags:
Expand All @@ -77,17 +85,19 @@ Action methods in rules:
'JSON and Config;JSON':
eligible: 1.5
tags:
- deprecated
- library
ticket: https://trac.parrot.org/parrot/ticket/508
'LWP, HTTP::Message, URI & URI::Escape':
'LWP, https::Message, URI & URI::Escape':
tags:
- library
- experimental
ticket: http://trac.parrot.org/parrot/ticket/1637
ticket: https://trac.parrot.org/parrot/ticket/1637
'ManagedStruct reallocations based on shape changes':
eligible: 2.4
note: 'Since shape changes may simply be used for re-interpreting data, and may also occur in several steps, re-allocating after any one shape change may be undesirable. In stead, an explicit allocate/reallocate method will be provided.'
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/1554
'MappedByteArray PMC':
Expand All @@ -98,7 +108,9 @@ Action methods in rules:
'Meta-model implementation used by PCT':
eligible: 2.7
note: 'PCT is set to switch to a new meta-model implementation for its classes and objects. This will most likely only affect those who rely on the interface of what is returned from .HOW, or rely on PCT objects exhibiting various other peculiarities of the P6object implementation. (Even when that is the case, the HOW API will not be changing too drastically, so for most PCT users there should be little to no upheavel.)'
ticket:
tags:
- deprecated
- compiler
'Method unescape on String':
note: This is a helper method for testing of Parrot_str_unescape_string.
Expand Down Expand Up @@ -133,18 +145,21 @@ Action methods in rules:
eligible: 1.5
note: 'The PAST::Compiler may generate the code for PAST::Val nodes (i.e., constants) at the beginning of the block (Parrot sub) instead of the location where they occur in the PAST tree.'
tags:
- deprecated
- compiler
ticket: https://trac.parrot.org/parrot/ticket/868
"PCT::HLLCompiler from Perl 5's Test::Harness":
eligible: 1.1
note: "In order to facilitate using PCT::HLLCompiler with test harnesses, the 'command_line' method of PCT::HLLCompiler object exits silently if it detects that it is being run in a sample run from Perl's Test::Harness. Currently this detection is done by checking the second command line argument for @INC; future releases may use a different detection mechanism or eliminate it altogether."
tags:
- deprecated
- compiler
ticket: https://trac.parrot.org/parrot/ticket/463
'PCT::HLLCompiler stages':
eligible: 1.1
note: 'The interface of various methods for adding, removing, and modifying the list stages in a PCT::HLLCompiler object is subject to change. The existing actual stages will remain; only the mechanism for specifying the order of individual stages is likely to change.'
tags:
- deprecated
- compiler
ticket: https://trac.parrot.org/parrot/ticket/462
'PMC Attributes Allocation Functions':
Expand Down Expand Up @@ -177,18 +192,21 @@ Action methods in rules:
eligible: 2.7
note: Use P6Object instead.
tags:
- deprecated
- library
ticket: http://trac.parrot.org/parrot/ticket/1337
ticket: https://trac.parrot.org/parrot/ticket/1337
'STRING COW':
eligible: 2.4
note: COW strings are to be removed. All "inplace" string modification functions and all "inplace" string ops are deprecated.
tags:
- deprecated
- functions
ticket: https://trac.parrot.org/parrot/ticket/1540
'STRING Out parameters in Parrot_str_* functions':
eligible: 2.1
note: All STRING modification functions will return a STRING pointer; capture and use this rather than relying on in-place modification of an existing pointer.
tags:
- deprecated
- functions
ticket: https://trac.parrot.org/parrot/ticket/1584
'Threads and Parallelism':
Expand All @@ -199,36 +217,42 @@ Action methods in rules:
eligible: 2.4
note: 'These will no longer refer to the byte length of the buffer, but to the number of times the struct is repeated; emulating an array of structs.'
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/1553
'UnManagedStruct handling nested structure':
eligible: 2.4
note: 'UnManagedStruct will be simplified to only support flat structures. This means that elements which themselves have structure - struct pointers and function pointers will be stored as "void *" and "void (*)(void)" respectively. To use these, they will need to be cast to the appropriate signature on access.'
tags:
- PMC
- deprecated
ticket: https://trac.parrot.org/parrot/ticket/1551
'UnManagedStruct initializer structure':
eligible: 2.4
note: 'The initializer structure will cease to be an array of triples. Instead, an array of flags (no counts or offsets), or a string representation of the same information may be used.'
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/1552
'charset, charsetname, find_charset, trans_charset':
eligible: 2.10
note: These opcodes will be removed. The corresponding encoding opcodes should be used instead.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1778
'continuation-based ExceptionHandlers':
eligible: 2.1
tags:
- deprecated
- PIR
- syntax
ticket: https://trac.parrot.org/parrot/ticket/1091
'dlfunc and new_callback signature string format':
eligible: 2.4
note: These will be changed to allow more flexibility in types.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1565
'finalize':
Expand All @@ -241,30 +265,35 @@ Action methods in rules:
eligible: 2.10
note: "The 'fixed_8' encoding is going away. Use 'ascii' instead. If you want to test for a fixed_8 encoding, you have to compare the encoding to 'ascii', 'iso-8859-1' and 'binary' separately."
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1778
'get_addr and set_addr':
eligible: 1.5
note: 'These opcodes are being repurposed. They will always return a unique memory address of the PMC. Uses of get_addr and set_addr that would set label values for Sub, Exception, and related PMC types will instead be handled by get_label and set_label.'
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/218
'get_results opcode order and features':
eligible: 2.1
note: get_results no longer used to fetch exception object.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1406
'implicit optional named parameters':
eligible: 2.1
tags:
- deprecated
- PIR
- syntax
ticket: https://trac.parrot.org/parrot/ticket/1103
'inplace string updates.':
eligible: 2.4
note: 'All "inplace" string update ops are deprecated. E.g. "chopn_s", etc. Part of COW removal.'
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1540
'loadlib_p_s_p':
Expand All @@ -277,27 +306,32 @@ Action methods in rules:
eligible: 2.7
note: These fall out from the logical vtables deprecation.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1655
'logical_* vtables [eligiblie in 2.7]':
note: "These can be replaced by 'get_bool' and intval ops unless you're using them for things that aren't really logical ops (don't do that!). Logical vtables are removed in r49012, and logical ops on PMCs are converted to use 'get_bool' internally. Rakudo seems to depend on logical ops on PMC."
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/1655
'mmd_cvt_to_types':
eligible: 1.1
tags:
- deprecated
- functions
ticket: https://trac.parrot.org/parrot/ticket/907
'multiple dispatch within core PMC':
eligible: 1.1
tags:
- deprecated
- PMC
ticket: https://trac.parrot.org/parrot/ticket/452
'new_callback_p_p_p_s':
eligible: 2.4
note: To be replaced with new_callback_p_p_p_p_s.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1548
'opcode numbering':
Expand All @@ -309,6 +343,7 @@ Action methods in rules:
eligible: 2.7
note: These opcodes will be removed. The open/close methods on File or the FileHandle PMC should be used instead.
tags:
- deprecated
- opcodes
ticket: https://trac.parrot.org/parrot/ticket/1697
'packfile structure':
Expand All @@ -320,5 +355,6 @@ Action methods in rules:
eligible: 3.1
note: Use "parrot_config" instead.
tags:
- deprecated
- library
ticket: http://trac.parrot.org/parrot/ticket/1853
ticket: https://trac.parrot.org/parrot/ticket/1853

0 comments on commit 3e163b9

Please sign in to comment.