2009-08-12 Marek Safar <marek.safar@gmail.com>
[mono.git] / mcs / mcs / TODO
index 6dadc39f734493d01a90b16ba42f097f6aec5e6d..1abb0382b7bdc02b935afae54b8f06a9774130fe 100644 (file)
-BUGS
-----
-
-* Implenment Array Initialization
-
-* FindMembers
-
-       Move our utility FindMembers from TypeContainer to Decl, because interfaces
-       are also scanned with it.
-
-* Visibility
+===========================================
 
-       I am not reporting errors on visibility yet.
+* Value Parameter
 
-* Enumerations
+       I believe that `Value Parameter' might have been introduced
+       after C# 1.0, also notice than in the treatment of Value Parameter
+       the parameters are defined in four categories:
 
-       They currently can not be defined in terms of other enumerations
-       or constants.
+       Section 9.3 in the latest spec.
 
-* Interfaces
 
-       For indexers, the output of ix2.cs is different from our
-       compiler and theirs.  They use a DefaultMemberAttribute, which
-       I have yet to figure out:
+Large project:
+--------------
 
-       .class interface private abstract auto ansi INTERFACE
-       {
-               .custom instance void [mscorlib]System.Reflection.DefaultMemberAttribute::.ctor(string) 
-               = ( 01 00 04 49 74 65 6D 00 00 )                      // ...Item..
-               ...
-       }
-
-* Interface indexers
-
-       I have not figured out why the Microsoft version puts an
-       `instance' attribute, and I am not generating this `instance' attribute.
+New
+---
 
-       Explanation: The reason for the `instance' attribute on
-       indexers is that indexers only apply to instances
+       It would be nice to optimize the case of:
 
-* In class.cs: Method.Define
+               Method (new ValueType ())
 
-       Need to use FindMembers to lookup the member for reporting
-       whether a new is needed or not.  
+       So that no temporary is created, and we only use a newobj call
+       that remains on the stack, as opposed to ldloca, initobj, ldloc
+       call.
 
-* Foreach on structure returns does not work
+NEW NOTES:
+----------
 
-       I am generating invalid code instead of calling ldarga for the
-       structure, I am calling ldarg:
+       ImplicitStandardConversionExists and ImplicitStandardConversion
+       should always be the same, but there are a few diverging lines that
+       must be studied:
 
-       struct X {
-               public IEnumerator GetEnumerator ();
-       }
-
-       X x;
+                       if (expr_type == target_type && !(expr is NullLiteral))
+                               return expr;
 
-       foreach (object a in x){
-               ...
-       }
+       vs:
 
-       I need to get the address of that bad boy
+                       if (expr_type == target_type)
+                               return true;
 
-* Handle destructors specially
+****************************************************************************************
+* 
+*   The information on the rest of this file is mostly outdated, and its kept here for
+*   historical reasons
+*
+****************************************************************************************
+Error Reporting:
+----------------
 
-       Turn ~X () { a () } into:
-       void Finalize () { try { a (); } finally { base.Finalize (); } }
+       * Make yyerror show a nice syntax error, instead of the current mess.
 
-* Method Names
+Optimization ideas
+------------------
 
-       Method names could be; `IFACE.NAME' in the method declaration,
-       stating that they implement a specific interface method.
+       Currently when we build a type cache, it contains private members,
+       internal members, and internal protected members;   We should trim
+       these out, as it shows up on the profile.
 
-       We currently fail to parse it.
+       We create too many Arraylists;  When we know the size, we should create
+       an array;
 
-* Namespaces
+       During parsing we use arraylists to accumulate data, like this:
 
-       Apparently:
+               thing:
+               
+               thing_list
+                       : thing { $$ =new ArrayList (); $$.Add ($1); }
+                       | thing_list thing { ArrayList a = $1; a.Add ($2); $$ = a; }
 
-               namespace X {
-               }
+       We probably could start using "Pairs" there:
 
-               namespace X {
-               }
+               thing_list
+                       : thing { $$ = new Pair ($1, null); }
+                       | thing_list thing { Pair p = $1; $$ = new Pair ($2, $1); }
 
-       Is failing to create a single namespace
 
-* Arrays
+EmitContext.ResolveTypeTree
+---------------------------
 
-       We need to make sure at *compile time* that the arguments in
-       the expression list of an array creation are always positive.
+       We should investigate its usage.  The problem is that by default
+       this will be set when calling FindType, that triggers a more expensive
+       lookup.
 
-* Fix access to variables of type ref/out
+       I believe we should pass the current EmitContext (which has this turned off
+       by default) to ResolveType/REsolveTypeExpr and then have the routines that
+       need ResolveType to pass null as the emit context.
 
-* Implement dead code elimination in statement.cs
+DeclareLocal audit
+------------------
 
-       It is pretty simple to implement dead code elimination in 
-       if/do/while
+       DeclareLocal is used in various statements.  The audit should be done
+       in two steps:
 
-* Implement short circuit evaluation.
+               * Identify all the declare locals.
 
-       Currently our and/or operations do not implement short circuit
-       evaluation.  
+               * Identify its uses.
 
-* Foreach and arrays
+               * Find if we can make wrapper functions for all of them.
 
-       Support foreach (T t in Array)
+       Then we can move DeclareLocal into a helper class.
 
-       And optimize to deal with the array rather than getting the enumerator
-       out of it.
+       This is required to fix foreach in iterators.
 
-* Indexer bugs:
+Ideas:
+------
 
-       the following wont work:
+       Instead of the hack that *knows* about System.Object not having any children classes,
+       we should just make it simple for a probe to know that there is no need for it.
 
-       x [0] = x [1] = N
+Dead Code Elimination bugs:
+---------------------------
 
-       if x has indexers, the value of x [N] set is set to void.  This needs to be
-       fixed.
+       I should also resolve all the children expressions in Switch, Fixed, Using.
 
-* Array declarations
+Major tasks:
+------------
+       Properties and 17.6.3: Finish it.
 
-       Multi-dim arrays are declared as [,] instead of [0..,0..]
-
-* Variables
+readonly variables and ref/out
+       
+BUGS
+----
 
-       Things like:
+* Break/Continue statements
 
-       for (int i = 0; ...; i++){
-       }
+       A finally block should reset the InLoop/LoopBegin/LoopEnd, as
+       they are logically outside the scope of the loop.
 
-       for (int i = 0; i < 10; i++){
-       }
+* Break/continue part 2.
 
-       Currently defines `i' for the rest of the execution after the first
-       loop, so the second loop generates an error.
+       They should transfer control to the finally block if inside a try/catch
+       block.
 
-       I think we should pop all the blocks until this point.
+*
+> // CSC sets beforefieldinit
+> class X {
+>   // .cctor will be generated by compiler
+>   public static readonly object O = new System.Object ();
+>   public static void Main () {}
+> }
+> 
 
 PENDING TASKS
 -------------
 
-       * Implement Using.
-
-       * Implement Goto.
-
-       * Implement Switch.
-
-       * Unsafe code.
-
-* Using Alias
-
-       Need to reset the aliases for each compilation unit, so an
-       alias defined in a file does not have any effect on another one:
-
-       File.cs
-       =======
-       namespace A {
-               using X = Blah;
+* Merge test 89 and test-34
 
-               class Z : X {           <-- This X is `Blah' 
-       }
-
-       File2.cs
-       namespace {
-               class Y : X {           <-- This X Is not `Blah' 
-               }
-       }
-
-       I think we can implement Aliases by having an `Alias' context in all
-       the toplevel TypeContainers of a compilation unit.  The children typecontainers
-       just chain to the parents to resolve the information.
-
-       The driver advances the Alias for each file compiled, so that each file
-       has its own alias set.
-
-* Handle volatile
+* Code cleanup
 
-* Support Re-Throw exceptions:
+       The information when registering a method in InternalParameters
+       is duplicated, you can always get the types from the InternalParameters
 
-       try {
-               X ();
-       } catch (SomeException e){
-               LogIt ();
-               throw;
-       }
-
-* Static flow analysis
+* Emit modreq for volatiles
 
-       Required to warn about reachability of code and definite
-       assignemt as well as missing returns on functions.
+       Handle modreq from public apis.
 
+* Merge tree.cs, rootcontext.cs
 
 OPTIMIZATIONS
 -------------
 
-* Emitcontext
-
-       Do we really need to instanciate this variable all the time?
-
-       It could be static for all we care, and just use it for making
-       sure that there are no recursive invocations on it.
-
-* Static-ization
-
-       Since AppDomain exists, maybe we can get rid of all the stuff
-       that is part of the `compiler instance' and just use globals
-       everywhere.
+* User Defined Conversions is doing way too many calls to do union sets that are not needed
 
+* Add test case for destructors
 
-* Constructors
+* Places that use `Ldelema' are basically places where I will be
+  initializing a value type.  I could apply an optimization to 
+  disable the implicit local temporary from being created (by using
+  the method in New).
 
-       Currently it calls the parent constructor before initializing fields.
-       It should do it the other way around.
+* Dropping TypeContainer as an argument to EmitContext
 
-* Reducer and -Literal
+       My theory is that I can get rid of the TypeBuilder completely from
+       the EmitContext, and have typecasts where it is used (from
+       DeclSpace to where it matters).  
 
-       Maybe we should never handle -Literal in Unary expressions and let
-       the reducer take care of it always?
-
-* Use of EmitBranchable
-
-       Currently I use brfalse/brtrue in the code for statements, instead of
-       using the EmitBranchable function that lives in Binary
-
-* Create an UnimplementedExpcetion
-
-       And use that instead of plain Exceptions to flag compiler errors.
-
-* ConvertImplicit
-
-       Currently ConvertImplicit will not catch things like:
-
-       - IntLiteral in a float context to generate a -FloatLiteral.
-       Instead it will perform an integer load followed by a conversion.
+       The only pending problem is that the code that implements Aliases
+       is on TypeContainer, and probably should go in DeclSpace.
 
 * Tests
 
        Write tests for the various reference conversions.  We have
        test for all the numeric conversions.
 
-* Remove the tree dumper
+* Optimizations: variable allocation.
+
+       When local variables of a type are required, we should request
+       the variable and later release it when we are done, so that
+       the same local variable slot can be reused later on.
 
-       And make all the stuff which is `public readonly' be private unless
-       required.
+* Add a cache for the various GetArrayMethod operations.
 
-* Optimizations
+* MakeUnionSet Callers
 
-       In Indexers and Properties, probably support an EmitWithDup
-       That emits the code to call Get and then leaves a this pointer
-       in the stack, so that later a Store can be emitted using that
-       this pointer (consider Property++ or Indexer++)
+       If the types are the same, there is no need to compute the unionset,
+       we can just use the list from one of the types.
 
+* Factor the lookup code for class declarations an interfaces
+  (interface.cs:GetInterfaceByName)
 
 RECOMMENDATIONS
 ---------------
@@ -266,16 +214,10 @@ RECOMMENDATIONS
 
        We need to change that to use this pattern:
 
-       TOKEN { $$ = lexer.Location } nt TERMINAL nt TERMINAL nt3 {
-               $$ = new Blah ($3, $5, $7, (Location) $2);
+       TOKEN { oob_stack.Push (lexer.Location) } nt TERMINAL nt TERMINAL nt3 {
+               $$ = new Blah ($3, $5, $7, (Location) oob_stack.Pop ());
        }
 
-       Notice how numbering of the arguments changes, as the { $$ =
-       lexer.Location } takes up a number
-
-* local_variable_declaration
-
-       Not sure that this grammar is correct, we might have to
-       resolve this during semantic analysis.
-
+       Notice how numbering of the arguments changes as the
+       { oob_stack.Push (lexer.Location) } takes a "slot"  in the productions.