Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
tag: RELEASE_2_0_0
Fetching contributors…

Cannot retrieve contributors at this time

461 lines (273 sloc) 12.998 kb

Purpose

Provide a list of deprecated and experimental items in parrot. All items in this list should have a corresponding Trac ticket[1].

Experimental Status

These features are not considered stable, even though they may have shipped in a stable release of parrot[2]. Use them at your own risk, as they can be removed or changed in any release. These items are marked below with [experimental].

Deprecated Status

Please see docs/project/support_policy.pod for the parrot project's policy regarding deprecated features.

Each item shows the first release in which it is eligible for removal, e.g. [eligible in 1.5]. If the release listed is one that has already shipped, this feature may be removed in any upcoming release, and you should no longer rely on it.

Whenever deprecated items are removed, information regarding how to cope with the removal will be added to https://trac.parrot.org/parrot/wiki/Deprecation.

When running parrot, you can receive warnings about deprecated opcodes. Either run parrot with the -w option to enable all warnings, or specifically by including this PIR code:

 .include 'warnings.pasm'
 warningson .PARROT_WARNINGS_DEPRECATED_FLAG

PMCS

moved to dynpmc [eligible in 1.1]

AddrRegistry, CodeString, Env, Eval, File, OS, PCCMETHOD_Test, StringHandle, and Timer.

https://trac.parrot.org/parrot/ticket/448

multiple dispatch within core PMCs [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/452

Hash changes to AssociativePMCArray [eligible in 1.5]

Also OrderedHash to OrderedAssociativePMCArray.

https://trac.parrot.org/parrot/ticket/679

Method stdhandle in ParrotInterpreter [experimental]

https://trac.parrot.org/parrot/ticket/264

various VTABLE functions [eligible in 1.5]

The get_bigint, set_bigint_*, pow, i_pow and nextkey_keyed VTABLE functions are deprecated and will be removed.

https://trac.parrot.org/parrot/ticket/866

Use of undocumented variables in class_init [eligible in 2.1]

The current implementation allows the class_init vtable function body to use local symbols from the generated part. For example, some PMC used to use the pass counter. In the future, the class_init body from the PMC file may not be inserted directly in the body of the generated one, so this usage will not be allowed.

https://trac.parrot.org/parrot/ticket/918

The visit_info structure and associated VTABLEs. [eligible in 2.1]

The current freeze/thaw implementation makes heavy use of the visit_info structure and the VTABLE interface attached to it. This structure will be replaced with a PMC of equivalent functionality and with a possibly similar interface. The freeze, thaw, and visit vtables of all PMCs should be updated to the provided interim API before this change is made.

https://trac.parrot.org/parrot/ticket/1305

Overriding vtable invoke in PIR objects [experimental]

The VTABLE invoke in object.pmc puts SELF at the start of the signature call arguments when there is no current object and is not already here. This allows the usage of $P0() instead of $P0($P0).

https://trac.parrot.org/parrot/ticket/103

All bitwise VTABLE functions [eligible in 2.1]

All bitwise VTABLE functions (all VTABLE functions containing bitwise in their names) will be removed. Equivalent functionality will by supplied by bitwise dynops.

https://trac.parrot.org/parrot/ticket/1260

Array PMC [eligible in 2.1]

This PMC is old, ill-used and is superseded by other array-like PMCs. Any code using this PMC should migrate to ResizablePMCArray or something more suitable.

https://trac.parrot.org/parrot/ticket/1303

OrderedHash PMC [eligible in 2.1]

This PMC is old, haskish and will be reimplemented with some backward incompatible changes in semantic of handling removed elements.

https://trac.parrot.org/parrot/ticket/1403

CPointer PMC [eligible in 2.1]

And all uses in the Parrot calling conventions.

https://trac.parrot.org/parrot/ticket/1407

Opcodes

moved to dynop [eligible in 1.1]

Parts or all of: bit.ops, debug.ops, io.ops, math.ops, set.ops (the obscure and rarely used parts), sys.ops.

https://trac.parrot.org/parrot/ticket/449

get_addr and set_addr [eligible in 1.5]

https://trac.parrot.org/parrot/ticket/218

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.

All bitwise ops [eligible in 2.1]

All bitwise ops (all ops containing bitwise in their names) will be provided by dynops. NOTE: Before removing the bitwise ops, make sure that the equivalent dynops are available and that the major HLLs (Rakudo, Partcl, Lua, etc) have switched to using them.

https://trac.parrot.org/parrot/ticket/1260

get_results opcode order and features [eligible in 2.1]

Move get_results to follow invoke.

https://trac.parrot.org/parrot/ticket/1405

get_results no longer used to fetch exception object.

https://trac.parrot.org/parrot/ticket/1406

dlfunc signatures [eligible in 2.1]

xv-style signatures will no longer work. See PDD16 for details.

pdds/draft/pdd16_native_call.pod

https://trac.parrot.org/parrot/ticket/1410

Bytecode

packfile structure [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/451

opcode numbering [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/451

PMC numbering [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/451

Class Features

[Nothing at this time.]

Debugger

Assigning to registers [experimental]

PIR syntax

Assignment syntax with opcodes [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/906

named class/pmc lookup in pir syntax such as new, isa, subclass, get_class, etc [eligible in 1.1]

Class PMC name resolution will be the following.

if the arg is a STRING Relative to the current Namespace

if the arg is a Array (of any sort) or Key Relative to the current HLL Namespace

if the arg is a Namespace or Class PMC The passed in class or the class attached to the passed in namespace.

https://trac.parrot.org/parrot/ticket/159

load or include paths prefixed with 'library/' or 'include/' [eligible in 1.5]

https://trac.parrot.org/parrot/ticket/511

continuation-based ExceptionHandlers [eligible in 2.1]

https://trac.parrot.org/parrot/ticket/1091

implicit optional named parameters [eligible in 2.1]

https://trac.parrot.org/parrot/ticket/1103

Functions

mmd_cvt_to_types [eligible in 1.1]

https://trac.parrot.org/parrot/ticket/907

Subs marked with :vtable/:method aren't in namespace [eligible in 1.1]

Subs marked with :vtable or :method flags are no longer given a namespace entry by default. Use the :nsentry flag to cause this to happen.

https://trac.parrot.org/parrot/ticket/389

C API coding standards cleanup [eligible in 1.1]

All C API functions that aren't currently named according to the 'Parrot_<system>_*' scheme will be renamed. If you depend on these functions in an extending/embedding interface or C-level custom PMCs, check in 1.4 or 2.0 for the new names.

https://trac.parrot.org/parrot/ticket/443

Sub/method invocation functions [eligible in 2.1]

The old 'Parrot_call_*' functions for invoking a sub/method object from C are deprecated, replaced by 'Parrot_ext_call'.

https://trac.parrot.org/parrot/ticket/1145

PMC Attributes Allocation Functions [experimental]
 Parrot_gc_allocate_pmc_attributes
 Parrot_gc_free_pmc_attributes

These items and related helper functions are added as experimental support for TT #895

PDB_compile and PDB_eval [eligible in 2.1]

The function PDB_compile doesn't work since some time, and his implementation was a hack. His functionality may be reimplemented in another way. Until the end of deprecation cycle it just throws an exception.

The PDB_eval function, that used in the debugger to support the eval command, was using PDB_compile. His functionality must be reimplemented in another way and with a name that follows current conventions, in the meantime and until the end of the deprecation cycle it just shows a diagnostic message.

https://trac.parrot.org/parrot/ticket/872

Parrot_oo_get_namespace [eligible in 2.1]

https://trac.parrot.org/parrot/ticket/1069

STRING Out parameters in Parrot_str_* functions [eligible in 2.1]

All STRING modification functions will return a STRING pointer; capture and use this rather than relying on in-place modification of an existing pointer.

Compiler tools

PASM1 compiler

PASM1 compiler [eligible in 2.1]

See PDB_compile. Note that the current version of the PASM1 compiler issues a warning and is not functional. (However, it used to segfault.)

Parrot Grammar Engine (PGE)

Action methods in rules

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.

https://trac.parrot.org/parrot/ticket/843

Parrot Compiler Toolkit

PCT::HLLCompiler stages [eligible in 1.1]

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.

https://trac.parrot.org/parrot/ticket/462

PCT::HLLCompiler from Perl 5's Test::Harness [eligible in 1.1]

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.

https://trac.parrot.org/parrot/ticket/463

PAST::Val node generation [eligible in 1.5]

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.

https://trac.parrot.org/parrot/ticket/868

Not Quite Perl (NQP)

$(...) syntax [eligible in 1.5]

The $(...) syntax for obtaining a result object from a Match object will no longer work. The new syntax is to invoke the .ast method on the Match object.

https://trac.parrot.org/parrot/ticket/459

Quoted items [eligible in 1.5]

Double-quoted strings will interpret unescaped $-names as interpolated variables in the string. Bare slashes will introduce regular expressions. The <foo bar> syntax will produce an array of strings instead of a single string.

https://trac.parrot.org/parrot/ticket/837

PIR q:to:<xyz> inline PIR [eligible in 1.5]

The PIR q:to:<xyz> form of inline PIR in NQP scripts is deprecated. Use Q:PIR { ... } or Q:PIR {{ ... }} instead.

https://trac.parrot.org/parrot/ticket/842

build tools

tools/build/dynoplibs.pl and tools/build/dynpmc.pl [eligible in 1.1]

Replaced with makefiles.

https://trac.parrot.org/parrot/ticket/338

Parrot library

MT19937 [eligible in 2.1]

https://trac.parrot.org/parrot/ticket/1278 - latest version now hosted at http://github.com/fperrad/parrot-MT19937. After 2.0, users will have to install via plumage.

JSON, JSON, and Config;JSON [eligible in 1.5]

https://trac.parrot.org/parrot/ticket/508

Cross-HLL library loading [experimental]

https://trac.parrot.org/parrot/ticket/754

OpenGL bindings and libraries [experimental]

https://trac.parrot.org/parrot/ticket/852

Library name changes [eligible in 2.1]

The use of :: a namespace separator is deprecated. Core libraries will change to use multi-level keys instead. For example, Getopt::Obj will change to Getopt; Obj. Affected libraries include Data::Dumper, Getopt::Obj, Parrot::Coroutine, SDL, Test::Builder, YAML::Dumper, and PCRE::NCI.

As well, anything under examples/ is subject to this change.

Footnotes

  1. Trac is parrot's primary issue tracking system.
  2. For an item to be considered experimental, it can never have shipped in a stable release without the [experimental] tag; otherwise, it must be deprecated normally before removal or incompatible change.
Jump to Line
Something went wrong with that request. Please try again.