docs/BROKEN.pod

   1 =head1 NAME
   2
   3 What's Broken in Parrot Right Now
   4
   5 =head1 PURPOSE
   6
   7 This is a list of items we think are broken in Parrot at the current revision.
   8 It's not a list of bugs -- it's a list of missing and broken features that
   9 prevent developers from working on their parts of the system.
  10
  11 Committers, please add to the list as you find things and remove from the list
  12 as you resolve things.
  13
  14 =head2 Missing Features
  15
  16 Ways to emulate these would be nice too.
  17
  18 =over 4
  19
  20 =item * Lexical Classes
  21
  22 =item * Anonymous Classes
  23
  24 =item * Submethods
  25
  26 =item * ParrotIO objects that work on strings
  27
  28 It should be possible to redirect input from and output to ParrotIO objects
  29 that don't actually perform IO, instead working with memory.  Unfortunately, it
  30 looks like there are no vtable methods for read and write operations.
  31
  32 See the C<setstdout> and C<setstderr> ops.
  33
  34 =back
  35
  36 =head2 Broken Features
  37
  38 =over 4
  39
  40 =item * Existing Code Marked As Broken
  41
  42 Lots of comments in the code read C<XXX>, C<???>, C<FIXME>, or
  43 C<UNIMPL>.  Fix them.
  44
  45 =item * Nested *Struct PMCs Share State
  46
  47 chromatic has a test case almost ready to show this.
  48
  49 =item * C<setattribute> Sometimes Misses
  50
  51 https://rt.perl.org/rt3//Ticket/Display.html?id=36411
  52
  53 =back
  54
  55 =head2 Unfinished Opcodes
  56
  57 None at this time.
  58
  59 =head2 Missing Vtables
  60
  61 =over 4
  62
  63 =item * ResizableIntegerArray
  64
  65 # XXX This is the wrong ticket number.
  66 https://rt.perl.org/rt3//Ticket/Display.html?id=32374
  67
  68 =item * splice
  69
  70 https://rt.perl.org/rt3//Ticket/Display.html?id=34394
  71
  72 =back
  73
  74 =head2 Missing PDDs
  75
  76 =over
  77
  78 =item * Embedding (PDD 10)
  79
  80 https://rt.perl.org/rt3//Ticket/Display.html?id=33918
  81
  82 =item * Assembly (PDD 12)
  83
  84 https://rt.perl.org/rt3//Ticket/Display.html?id=33919
  85
  86 =item * Bytecode (PDD 13)
  87
  88 https://rt.perl.org/rt3//Ticket/Display.html?id=33920
  89
  90 =back
  91
  92 =head2 Language-Specific Items
  93
  94 =over 4
  95
  96 =item * Make Perl a F</language>
  97
  98 =over 4
  99
 100 =item * Don't have Perl deps in static classes
 101
 102 https://rt.perl.org/rt3//Ticket/Display.html?id=32642
 103
 104 =item * Make Perl PMCs dynamic
 105
 106 https://rt.perl.org/rt3//Ticket/Display.html?id=32646
 107
 108 =back
 109
 110 =item * Let languages be self contained
 111
 112 https://rt.perl.org/rt3//Ticket/Display.html?id=31633
 113
 114 Right now many languages are in the  F<MANIFEST>, using the global config, etc.
 115 As far as Perl goes, this  could let us move Perl PMCs into
 116 F<languages/perl[6]>).
 117
 118 =back
 119
 120 =head2 Obsolete Features
 121
 122 =over 4
 123
 124 =item * Everything in F<DEPRECATED.pod>
 125
 126 =back
 127
 128 =head2 Miscellaneous
 129
 130 =over 4
 131
 132 =item * Generate accurate file/line number information in stack traces.
 133
 134 =item * Get name of C<parrot> executable
 135
 136 https://rt.perl.org/rt3//Ticket/Display.html?id=33923
 137
 138 =item * Give invokable PMCs a canonical way to store their associated HLL
 139 source and argument information.
 140
 141 =item * Allow Runtime Compiler Registration
 142
 143 Leo suggests an eventual startup sequence of:
 144
 145 =over 4
 146
 147 =item * start main in F<src/parrot.c>
 148
 149 =item * determine source file type to compile/run
 150
 151 =item * handle execution over to xxx-compiler or to pbc-run.
 152
 153 =back
 154
 155 Currently F<src/parrot.c> does nothing and startup occurs in F<imcc/main.c>.
 156
 157 =back