[Top][All Lists]
[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 ****
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>
! 2.1. <a href="#q2_1">How do I install DotGNU
Portable.NET?</a><br>
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>
3.1. <a href="#q3_1">How do I run IL programs?</a><br>
--- 24,30 ----
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>
! 2.1. <a href="#q2_1">Where can I get the most recent
version of DotGNU Portable.NET?</a><br>
2.2. <a href="#q2_2">How do I access the source via
CVS?</a><br>
+ 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>
3.1. <a href="#q3_1">How do I run IL programs?</a><br>
***************
*** 39,43 ****
4.6. <a href="#q4_6">I've heard that you can compile
C# to the JVM. Is that correct?</a><br>
4.7. <a href="#q4_7">Why don't you use gcc as the
basis for your C# compiler?</a><br>
! 4.8. <a href="#q4_8">What does "<code>cscc</code>"
stand for?</a><br>
5. <a href="#q5">Other tools</a><br>
5.1. <a href="#q5_1">How do I assemble .il
files?</a><br>
--- 40,44 ----
4.6. <a href="#q4_6">I've heard that you can compile
C# to the JVM. Is that correct?</a><br>
4.7. <a href="#q4_7">Why don't you use gcc as the
basis for your C# compiler?</a><br>
! 4.8. <a href="#q4_8">What does "cscc" stand
for?</a><br>
5. <a href="#q5">Other tools</a><br>
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>
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Dotgnu-pnet-commits] CVS: pnet/doc pnet_faq.html,1.7,1.8,
Rhys Weatherley <address@hidden> <=