dotgnu-pnet-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Dotgnu-pnet-commits] CVS: pnet/doc pnet_faq.html,1.7,1.8


From: Rhys Weatherley <address@hidden>
Subject: [Dotgnu-pnet-commits] CVS: pnet/doc pnet_faq.html,1.7,1.8
Date: Thu, 21 Nov 2002 20:48:13 -0500

Update of /cvsroot/dotgnu-pnet/pnet/doc
In directory subversions:/tmp/cvs-serv26074

Modified Files:
        pnet_faq.html 
Log Message:


More updates to the FAQ.


Index: pnet_faq.html
===================================================================
RCS file: /cvsroot/dotgnu-pnet/pnet/doc/pnet_faq.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -r1.7 -r1.8
*** pnet_faq.html       22 Nov 2002 00:46:20 -0000      1.7
--- pnet_faq.html       22 Nov 2002 01:48:11 -0000      1.8
***************
*** 24,29 ****
  &nbsp;&nbsp;&nbsp;&nbsp;1.8. <a href="#q1_8">What do all these acronyms mean? 
 IL, CLI, CLR?</a><br>
  2. <a href="#q2">Installing DotGNU Portable.NET</a><br>
! &nbsp;&nbsp;&nbsp;&nbsp;2.1. <a href="#q2_1">How do I install DotGNU 
Portable.NET?</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;2.2. <a href="#q2_2">How do I access the source via 
CVS?</a><br>
  3. <a href="#q3">Using the runtime engine</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;3.1. <a href="#q3_1">How do I run IL programs?</a><br>
--- 24,30 ----
  &nbsp;&nbsp;&nbsp;&nbsp;1.8. <a href="#q1_8">What do all these acronyms mean? 
 IL, CLI, CLR?</a><br>
  2. <a href="#q2">Installing DotGNU Portable.NET</a><br>
! &nbsp;&nbsp;&nbsp;&nbsp;2.1. <a href="#q2_1">Where can I get the most recent 
version of DotGNU Portable.NET?</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;2.2. <a href="#q2_2">How do I access the source via 
CVS?</a><br>
+ &nbsp;&nbsp;&nbsp;&nbsp;2.3. <a href="#q2_3">How do I install DotGNU 
Portable.NET?</a><br>
  3. <a href="#q3">Using the runtime engine</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;3.1. <a href="#q3_1">How do I run IL programs?</a><br>
***************
*** 39,43 ****
  &nbsp;&nbsp;&nbsp;&nbsp;4.6. <a href="#q4_6">I've heard that you can compile 
C# to the JVM.  Is that correct?</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;4.7. <a href="#q4_7">Why don't you use gcc as the 
basis for your C# compiler?</a><br>
! &nbsp;&nbsp;&nbsp;&nbsp;4.8. <a href="#q4_8">What does "<code>cscc</code>" 
stand for?</a><br>
  5. <a href="#q5">Other tools</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;5.1. <a href="#q5_1">How do I assemble .il 
files?</a><br>
--- 40,44 ----
  &nbsp;&nbsp;&nbsp;&nbsp;4.6. <a href="#q4_6">I've heard that you can compile 
C# to the JVM.  Is that correct?</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;4.7. <a href="#q4_7">Why don't you use gcc as the 
basis for your C# compiler?</a><br>
! &nbsp;&nbsp;&nbsp;&nbsp;4.8. <a href="#q4_8">What does "cscc" stand 
for?</a><br>
  5. <a href="#q5">Other tools</a><br>
  &nbsp;&nbsp;&nbsp;&nbsp;5.1. <a href="#q5_1">How do I assemble .il 
files?</a><br>
***************
*** 83,96 ****
  to build a suite of free software tools to build and execute Common
  Language Infrastructure (CLI) applications.  The initial target platform
! is GNU/Linux, with other platforms to follow in the future.<p>
  
  DotGNU Portable.NET is built in accordance with the requirements of
! the <a href="http://www.gnu.org";>GNU Project</a>
! and <a href="http://www.freedevelopers.net";>FreeDevelopers</a>.<p>
  
  DotGNU Portable.NET is focused on compatibility with the ECMA
  specifications for CLI.  There are other projects under the DotGNU
  meta-project to build other necessary pieces of infrastructure, and
! to explore non-CLI approaches to virtual machine implementation.<p>
  
  <a name="q1_1"><h3>1.2. What is pnet?</h3>
--- 84,99 ----
  to build a suite of free software tools to build and execute Common
  Language Infrastructure (CLI) applications.  The initial target platform
! is GNU/Linux, but it has been known to work under Cygwin, NetBSD, FreeBSD,
! Solaris, and MacOS X.<p>
  
  DotGNU Portable.NET is built in accordance with the requirements of
! the <a href="http://www.gnu.org";>GNU Project</a>.<p>
  
  DotGNU Portable.NET is focused on compatibility with the ECMA
  specifications for CLI.  There are other projects under the DotGNU
  meta-project to build other necessary pieces of infrastructure, and
! to explore non-CLI approaches to virtual machine implementation.  See
! <a href="http://www.dotgnu.org/";><code>http://www.dotgnu.org/</code></a>
! for more information on DotGNU.<p>
  
  <a name="q1_1"><h3>1.2. What is pnet?</h3>
***************
*** 115,119 ****
  allowing the programmer to concentrate on the specifics of language
  implementation.  A fuller account of how treecc works can be found
! at its Web site, <a 
href="http://www.southern-storm.com.au/treecc.html";>http://www.southern-storm.com.au/treecc.html</a>.<p>
  
  Other tools, such as Antlr, do have similar functionality, but we
--- 118,122 ----
  allowing the programmer to concentrate on the specifics of language
  implementation.  A fuller account of how treecc works can be found
! at its Web site, <a 
href="http://www.southern-storm.com.au/treecc.html";><code>http://www.southern-storm.com.au/treecc.html</code></a>.<p>
  
  Other tools, such as Antlr, do have similar functionality, but we
***************
*** 141,148 ****
  do, you cannot tell the author of the benchmark, or anyone else for
  that matter, what the results are.  The following is an excerpt from
! Microsoft's End User License Agreement (EULA) for their .NET Framework SDK:<p>
  
  <blockquote>
! 6.    Performance or Benchmark Testing. You may not disclose the
  results of any benchmark test of either the Server Software or
  Client Software to any third party without Microsoft's prior
--- 144,152 ----
  do, you cannot tell the author of the benchmark, or anyone else for
  that matter, what the results are.  The following is an excerpt from
! Microsoft's End User License Agreement (EULA) for their .NET Framework SDK
! redistributables:<p>
  
  <blockquote>
! Performance or Benchmark Testing. You may not disclose the
  results of any benchmark test of either the Server Software or
  Client Software to any third party without Microsoft's prior
***************
*** 221,225 ****
  <a name="q2"><h2>2. Installing DotGNU Portable.NET</h2>
  
! <a name="q2_1"><h3>2.1. How do I install DotGNU Portable.NET?</h3>
  
  There are 3 main components that you must install in the following
--- 225,251 ----
  <a name="q2"><h2>2. Installing DotGNU Portable.NET</h2>
  
! <a name="q2_1"><h3>2.1. Where can I get the most recent version of DotGNU 
Portable.NET?</h3>
! 
! The latest release version is always available from the following
! Web site:<p>
! 
! <blockquote><a 
href="http://www.southern-storm.com.au/portable_net.html";><code>http://www.southern-storm.com.au/portable_net.html</code></a></blockquote><p>
! 
! <a name="q2_2"><h3>2.2. How do I access the source via CVS?</h3>
! 
! All of the DotGNU Portable.NET code is available via CVS from
! Savannah, <a href="http://savannah.gnu.org/";>http://savannah.gnu.org/</a>.
! The main project Web page is at
! <a 
href="http://savannah.gnu.org/projects/dotgnu-pnet/";><code>http://savannah.gnu.org/projects/dotgnu-pnet/</code></a>,
 and the CVS instructions are at
! <a 
href="http://savannah.gnu.org/cvs/?group_id=353";><code>http://savannah.gnu.org/cvs/?group_id=353</code></a>.<p>
! 
! The repository name for DotGNU Portable.NET is "<code>dotgnu-pnet</code>",
! and it contains four modules: "<code>pnet</code>", "<code>pnetlib</code>",
! "<code>treecc</code>", and "<code>cscctest</code>".<p>
! 
! When reporting bugs, it is best to check against the CVS version first,
! as we may have already fixed the problem since the last release.<p>
! 
! <a name="q2_3"><h3>2.3. How do I install DotGNU Portable.NET?</h3>
  
  There are 3 main components that you must install in the following
***************
*** 262,277 ****
  install configuration options.<p>
  
- <a name="q2_2"><h3>2.2. How do I access the source via CVS?</h3>
- 
- All of the DotGNU Portable.NET code is available via CVS from
- Savannah, <a href="http://savannah.gnu.org/";>http://savannah.gnu.org/</a>.
- The main project Web page is at
- <a 
href="http://savannah.gnu.org/projects/dotgnu-pnet/";>http://savannah.gnu.org/projects/dotgnu-pnet/</a>,
 and the CVS instructions are at
- <a 
href="http://savannah.gnu.org/cvs/?group_id=353";>http://savannah.gnu.org/cvs/?group_id=353</a>.<p>
- 
- The repository name for DotGNU Portable.NET is "<code>dotgnu-pnet</code>",
- and it contains four modules: "<code>pnet</code>", "<code>pnetlib</code>",
- "<code>treecc</code>", and "<code>cscctest</code>".<p>
- 
  <a name="q3"><h2>3. Using the runtime engine</h2>
  
--- 288,291 ----
***************
*** 294,304 ****
  to provide library facilities.  A pre-compiled version of this file
  can be found in the "<code>samples</code>" directory on the
! "<code>pnet</code>" distribution.<p>
  
! The "<code>mscorlib.dll</code>" file should either be placed in the
! same directory as the program you are running, or in the system-wide
! location "<code>PREFIX/lib/cscc/lib</code>", where "<code>PREFIX</code>"
! is the directory where you installed DotGNU Portable.NET
! (e.g. "<code>/usr/local</code>").
  
  <a name="q3_2"><h3>3.2. Can I avoid typing "ilrun"?</h3>
--- 308,316 ----
  to provide library facilities.  A pre-compiled version of this file
  can be found in the "<code>samples</code>" directory on the
! "<code>pnet</code>" distribution, or you can build your own from
! "<code>pnetlib</code>".<p>
  
! System assemblies, such as "<code>mscorlib.dll</code>" are usually
! installed in "<code>/usr/local/lib/cscc/lib</code>".<p>
  
  <a name="q3_2"><h3>3.2. Can I avoid typing "ilrun"?</h3>
***************
*** 410,414 ****
  <blockquote><code>cscc -o hello hello.c</code></blockquote>
  
! All of the usual "<code>cc</code>" command-line options can be used,
  including pre-processor and linker options.<p>
  
--- 422,426 ----
  <blockquote><code>cscc -o hello hello.c</code></blockquote>
  
! The usual "<code>gcc</code>" command-line options can be used,
  including pre-processor and linker options.<p>
  
***************
*** 421,425 ****
  of "<code>ilrun</code>" without needing recompilation.  But there is some
  extra memory overhead involved in using a 64-bit ABI.  If you really want
! to use a 32-bit API, you can supply the option "<code>-m32bit-only</code>".
  The resulting IL binary will run fine on 32-bit versions of
  "<code>ilrun</code>", but won't work on 64-bit engines.<p>
--- 433,437 ----
  of "<code>ilrun</code>" without needing recompilation.  But there is some
  extra memory overhead involved in using a 64-bit ABI.  If you really want
! to use a 32-bit ABI, you can supply the option "<code>-m32bit-only</code>".
  The resulting IL binary will run fine on 32-bit versions of
  "<code>ilrun</code>", but won't work on 64-bit engines.<p>
***************
*** 488,495 ****
  own plug-in from scratch, without using any of the existing code.<p>
  
  <a name="q4_6"><h3>4.6. I've heard that you can compile C# to the JVM.  Is 
that correct?</h3>
  
  Yes.  The cscc compiler is architected so that it can compile to either
! IL or JVM bytecode.  Adding other output formats would be quite easy.<p>
  
  <a name="q4_7"><h3>4.7. Why don't you use gcc as the basis for your C# 
compiler?</h3>
--- 500,515 ----
  own plug-in from scratch, without using any of the existing code.<p>
  
+ It is not essential that the plugin be written in C.  You could
+ write it in C#, Java, Python, or assembly code if you wish.  The
+ only requirement is that the plugin can be launched with the
+ "<code>exec</code>" system call.  You may need to wrap the plugin
+ in a small shell script to achieve this.<p>
+ 
  <a name="q4_6"><h3>4.6. I've heard that you can compile C# to the JVM.  Is 
that correct?</h3>
  
  Yes.  The cscc compiler is architected so that it can compile to either
! IL or JVM bytecode.  Adding other output formats would be quite easy.
! There is still some work to be done in assembling JVM bytecode, but
! most of the support code is in place.<p>
  
  <a name="q4_7"><h3>4.7. Why don't you use gcc as the basis for your C# 
compiler?</h3>
***************
*** 630,634 ****
  or it may not.<p>
  
! <a name="q4_8"><h3>4.8. What does "<code>cscc</code>" stand for?</h3>
  
  Originally, "<code>cscc</code>" was short for "C Sharp Compiler Collection".
--- 650,654 ----
  or it may not.<p>
  
! <a name="q4_8"><h3>4.8. What does "cscc" stand for?</h3>
  
  Originally, "<code>cscc</code>" was short for "C Sharp Compiler Collection".
***************
*** 684,688 ****
  
  This converts the text resources in "<code>hello.txt</code>" into
! IL binary resources in the file "<code>hello.resources</code>".<p>
  
  <a name="q5_5"><h3>5.5. How do I extract documentation from C# sources?</h3>
--- 704,711 ----
  
  This converts the text resources in "<code>hello.txt</code>" into
! IL binary resources in the file "<code>hello.resources</code>".
! They can be linked against an application as follows:<p>
! 
! <blockquote><code>cscc -o hello.exe -fresources=hello.resources 
hello.cs</code></blockquote><p>
  
  <a name="q5_5"><h3>5.5. How do I extract documentation from C# sources?</h3>
***************
*** 712,716 ****
  
  The "<code>csant</code>" program is similar to, but not quite as powerful as
! NAnt (<a 
href="http://nant.sourceforge.net/";>http://nant.sourceforce.net/</a>).
  But because "<code>csant</code>" is written in C, it can be very useful
  for bootstrapping C# applications without the aid of a CLR.<p>
--- 735,739 ----
  
  The "<code>csant</code>" program is similar to, but not quite as powerful as
! NAnt (<a 
href="http://nant.sourceforge.net/";><code>http://nant.sourceforce.net/</code></a>).
  But because "<code>csant</code>" is written in C, it can be very useful
  for bootstrapping C# applications without the aid of a CLR.<p>
***************
*** 731,734 ****
--- 754,760 ----
        <dd>Validate an IL binary against an XML documentation file that
                describes what it should be implementing.</dd>
+ <dt><code>csunit</code></dt>
+       <dd>A C# application that assists with automated regression testing
+               of "<code>pnetlib</code>".</dd>
  <dt><code>ilalink</code></dt>
        <dd>Link IL object files and libraries together to form an
***************
*** 738,746 ****
        <dd>Compare the runtime engine, <code>ilrun</code>, against an
                IL binary to determine if all internalcall methods in the
!               binary have been properly implemented by the engine.</dd>
  <dt><code>ildiff</code></dt>
        <dd>Compare two IL binaries and show their differences.</dd>
  <dt><code>ilfind</code></dt>
        <dd>Find named symbols within an IL binary.</dd>
  <dt><code>ilnative</code></dt>
        <dd>Print information for all native methods that are declared
--- 764,780 ----
        <dd>Compare the runtime engine, <code>ilrun</code>, against an
                IL binary to determine if all internalcall methods in the
!               binary have been properly implemented by the engine.
!               This is mostly obsolete now due to the new internalcall
!               handling system in the engine.</dd>
! <dt><code>ildd</code></dt>
!       <dd>Displays the dependencies that an IL application has on other
!               assemblies and PInvoke functions.</dd>
  <dt><code>ildiff</code></dt>
        <dd>Compare two IL binaries and show their differences.</dd>
  <dt><code>ilfind</code></dt>
        <dd>Find named symbols within an IL binary.</dd>
+ <dt><code>ilheader</code></dt>
+       <dd>Generates .h files from C# assemblies, that allows them to be
+               imported and called from C.</dd>
  <dt><code>ilnative</code></dt>
        <dd>Print information for all native methods that are declared
***************
*** 853,860 ****
  
  The biggest area that needs to be tackled is the C# library,
! <a href="http://www.southern-storm.com.au/portable_net_lib.html";>pnetlib</a>.
! Pick a class, any class, implement it, and send us the changes.
! See the question on "Standards" for information on obtaining
! the ECMA class library documentation.<p>
  
  We could also use some assistance with documentation of the API's
--- 887,894 ----
  
  The biggest area that needs to be tackled is the C# library,
! "<code>pnetlib</code>".  Pick a class, any class, implement it, and send
! us the changes.  Or write a test case for our regression test suite.
! See the question on "Standards" for information on obtaining the ECMA
! class library documentation.<p>
  
  We could also use some assistance with documentation of the API's
***************
*** 871,875 ****
  The latest status of pnetlib can be viewed at the following Web page:
  
! <blockquote><a 
href="http://www.dotgnu.org/pnetlib-status/";>http://www.dotgnu.org/pnetlib-status/</a></blockquote>
  
  This page is updated periodically based on the compiled pnetlib binaries.<p>
--- 905,909 ----
  The latest status of pnetlib can be viewed at the following Web page:
  
! <blockquote><a 
href="http://www.dotgnu.org/pnetlib-status/";><code>http://www.dotgnu.org/pnetlib-status/</code></a></blockquote>
  
  This page is updated periodically based on the compiled pnetlib binaries.<p>
***************
*** 893,897 ****
  All discussion of DotGNU Portable.NET happens on the
  "<code>address@hidden</code>" mailing list.  See
! <a href="http://www.dotgnu.org/";>http://www.dotgnu.org/</a>
  for subscription details.<p>
  
--- 927,931 ----
  All discussion of DotGNU Portable.NET happens on the
  "<code>address@hidden</code>" mailing list.  See
! <a href="http://www.dotgnu.org/";><code>http://www.dotgnu.org/</code></a>
  for subscription details.<p>
  
***************
*** 975,980 ****
  
  <blockquote>
! <a 
href="http://www.ecma.ch/ecma1/STAND/ECMA-334.htm";>http://www.ecma.ch/ecma1/STAND/ECMA-334.htm</a>
 (C#)<br>
! <a 
href="http://www.ecma.ch/ecma1/STAND/ECMA-335.htm";>http://www.ecma.ch/ecma1/STAND/ECMA-335.htm</a>
 (CLI)<br>
  </blockquote>
  
--- 1009,1014 ----
  
  <blockquote>
! <a 
href="http://www.ecma.ch/ecma1/STAND/ECMA-334.htm";><code>http://www.ecma.ch/ecma1/STAND/ECMA-334.htm</code></a>
 (C#)<br>
! <a 
href="http://www.ecma.ch/ecma1/STAND/ECMA-335.htm";><code>http://www.ecma.ch/ecma1/STAND/ECMA-335.htm</code></a>
 (CLI)<br>
  </blockquote>
  
***************
*** 983,987 ****
  
  <blockquote>
! <a 
href="ftp://ftp.ecma.ch/ecma-st/Ecma-335-xml.zip";>ftp://ftp.ecma.ch/ecma-st/Ecma-335-xml.zip</a>
  </blockquote>
  
--- 1017,1021 ----
  
  <blockquote>
! <a 
href="ftp://ftp.ecma.ch/ecma-st/Ecma-335-xml.zip";><code>ftp://ftp.ecma.ch/ecma-st/Ecma-335-xml.zip</code></a>
  </blockquote>
  
***************
*** 1005,1016 ****
  conflicts with Microsoft's actual implementation.<p>
  
  <a name="q10"><h2>10. Other .NET efforts</h2>
  
  <a name="q10_1"><h3>10.1. What is Mono?</h3>
  
! The <a href="http://www.go-mono.com";>Mono</a> project that is
! run by <a href="http://www.ximian.com";>Ximian</a> has many of
! the same goals as DotGNU Portable.NET.  See their Web site
! for further details.<p>
  
  <a name="q10_2"><h3>10.2. What is the relationship with Mono?</h3>
--- 1039,1056 ----
  conflicts with Microsoft's actual implementation.<p>
  
+ The symbol "<code>ECMA_COMPAT</code>" may be defined when compiling
+ "<code>pnetlib</code>" to force it to strictly conform to the ECMA
+ requirements.<p>
+ 
  <a name="q10"><h2>10. Other .NET efforts</h2>
  
  <a name="q10_1"><h3>10.1. What is Mono?</h3>
  
! The Mono project that is run by Ximian has many of the same goals as
! DotGNU Portable.NET.  See their Web site for further details:<p>
! 
! <blockquote>
! <a href="http://www.go-mono.com/";><code>http://www.go-mono.com/</code></a>
! </blockquote>
  
  <a name="q10_2"><h3>10.2. What is the relationship with Mono?</h3>
***************
*** 1035,1039 ****
  
  <blockquote>
! <a href="http://ocl.sourceforge.net/";>http://ocl.sourceforge.net/</a>
  </blockquote>
  
--- 1075,1079 ----
  
  <blockquote>
! <a 
href="http://ocl.sourceforge.net/";><code>http://ocl.sourceforge.net/</code></a>
  </blockquote>
  
***************
*** 1044,1048 ****
  
  <blockquote>
! <a href="http://msdn.microsoft.com/";>http://msdn.microsoft.com/</a>
  </blockquote>
  
--- 1084,1088 ----
  
  <blockquote>
! <a 
href="http://msdn.microsoft.com/";><code>http://msdn.microsoft.com/</code></a>
  </blockquote>
  
***************
*** 1101,1108 ****
  <a name="q10_6"><h3>10.6. What other free software and open source .NET 
efforts are there?</h3>
  
! We are not aware of any other projects that are tackling the
! entire .NET platform at present, but there are some that are tackling
! tools such as decompilers, widget toolkits, IDE's, etc.  Mono's FAQ
! contains some pointers to get you started.<p>
  
  <a name="q11"><h2>11. Other random questions</h2>
--- 1141,1147 ----
  <a name="q10_6"><h3>10.6. What other free software and open source .NET 
efforts are there?</h3>
  
! There are various projects that are tackling tools such as decompilers,
! widget toolkits, IDE's, etc.  Mono's FAQ contains some pointers to get
! you started.<p>
  
  <a name="q11"><h2>11. Other random questions</h2>
***************
*** 1131,1138 ****
  but we need someone to volunteer to do it first.<p>
  
! If your application is written in C, you can recompile it using
! the C language front-end for "<code>cscc</code>".  The resulting
! binary is likely to be more portable than that produced by Visual
! Studio.NET.<p>
  
  <a name="q11_3"><h3>11.3. Why don't you just use Java?</h3>
--- 1170,1177 ----
  but we need someone to volunteer to do it first.<p>
  
! If your application is written in C, and does not depend upon Windows-specific
! features, then you can recompile it using the C language front-end for
! "<code>cscc</code>".  The resulting binary is likely to be more portable
! than that produced by Visual Studio.NET.<p>
  
  <a name="q11_3"><h3>11.3. Why don't you just use Java?</h3>





reply via email to

[Prev in Thread] Current Thread [Next in Thread]