2002-11-19 Daniel Morgan <danmorg@sc.rr.com>
[mono.git] / doc / asp-net
index 258c9725be64c654a11e05f395a29a9a39860938..a8727b26cfefd4cfc3841fa06d91a746c21d88d5 100755 (executable)
@@ -1,9 +1,27 @@
 * ASP.NET
 
-       The classes for running ASP.NET are being actively written.
-       Gaurav, Leen and Patrik have been building the classes
-       required to run ASP.NET web application as well as a small
-       embeddable web server.
+       ASP.NET support is divided in two pieces:
+       <ul>
+               * Web Forms (Web Applications infrastructure).
+
+               * Web Services (the SOAP-based rpc system).
+       </ul>
+
+       There is work underway for both systems.  The Web Forms
+       support is more advanced at this point, and various ".aspx"
+       programs can be run using the Mono runtime and the XSP page
+       parser.
+
+       We are now working HttpRuntime and related classes to make our
+       implementation mostly compatible with MS.
+
+       Tim started work on the Web Services.  Although we have a
+       SoapFormatter as part of the remoting infrastructure already
+       (contributed by Jesus), most people will be using the ASP.NET
+       Web Services support.  Work for the supporting class libraries
+       just started recently.
+
+* Web Forms: The pieces
 
        There are a couple of components to the puzzle:
 
        files and generated the code required to run them (the code lives in
        module `xsp' along with a little web server for testing).
 
-       Most of the runtime support was mostly written by Patrik Torstensson
+       Most of the runtime support was written by Patrik Torstensson
        (now at Intel).  This was interesting, because in order to implement
        some of its features, Patrik had to go into the runtime/JIT engine and
        he spent a few weeks doing work there.
 
+       The classes for running ASP.NET are being actively written.
+       Gaurav, Leen and Patrik worked in the core of the classes
+       required to run ASP.NET web application as well as a small
+       embeddable web server.
+
        Duncan got our System.Web assembly to compile.
 
 ** HttpRuntime
 
        Patrik has authored most of the HttpRuntime support (both on
-       the System.Web and on the foundation) but it is still not
-       ready to run.
+       the System.Web and on the foundation).
+
+       We are currently working on this.
 
 ** XSP
 
-       Currently XSP provides the .aspx compiler to C#.  It would be
-       interesting to see if it makes sense to extend the ASP.NET
-       syntax to make it simpler to develop applications.
+       This is where initial development of the .aspx compiler to C#
+       took place. That compiler is now integrated in System.Web classes
+       mostly under System.Web.Compilation namespace.
+
+       We still keep the compiler and the initial web server used to debug
+       HtmlControls and WebControls under xsp/src directory. This will
+       stop working some time soon in favor of a new server, that is also
+       compatible with MS runtime.
+
+       There is also a bunch of .aspx pages to test the server along with
+       a few user controls under xsp/test.
 
-       Gonzalo is in charge of the compiler.
+       We added a new web server that works with MS runtime and is being
+       used to debug our classes. Currently it does not work with mono
+       runtime, but will do :-). It resides in xsp/server. A couple of
+       classes of this new server can be reused/extended to make an apache
+       module/cgi using mono (MonoWorkerRequest and MonoApplicationHost).
+
+       The C# code generator has been moved to System.Web.Compilation 
 
 ** Controls
 
        implement the controls (UI.HtmlControls and UI.WebControls),
        but they have been coded mostly in the dark, and without being
        able to test them in real life: Gaurav and Leen worked very
-       hard on this namespace, but needs to be finished.
+       hard on this namespace.
 
-       We can now render all HtmlControls and some WebControls. Work is
-       ongoing to make all WebControls render HTML.
+       We can now render all HtmlControls and almost all WebControls.
+       DataGrid and DataList controls are being finished by Gaurav.
+       Xml control needs some work on System.Xml related to XSL.
 
 ** Extending ASP.NET
 
            but using our generated page.   
 
         4. Run the sample with our classes with the .NET runtime.
-       <b>We are here</b>.
 
-        5. Finish HttpRuntime.
+        5. Run the samples with our classes with the our runtime (without
+       using HttpRuntime).
+
+        6. Finish HttpRuntime.
+       <b>We are here</b>.
        
-        6. Running our sample code with our classes with our runtime.
+        7. Running our sample code with our classes with our runtime.
 
 ** How to Help
 
-        Currently we are testing and fixing HtmlControls, WebControls and
-        validators.
+        Testing and fixing HtmlControls, WebControls and validators is an
+       easy way to help.
 
         In the CVS module XSP you can find the aspx to C# page parser,
         a little web server used for testing and a directory containing
         file of each directory. They explain how to test our System.Web.
         Testing is really easy!
 
+       We will soon get the new server working with our runtime. This way
+       we'll have a server that runs on both MS and mono runtime and will
+       make it easier to check the functionally against both runtimes.
+