[Mono-docs-list] Monkeyguide Update Patches
Jonathan Kessler
Jwkpiano1@comcast.net
Sun, 07 Dec 2003 14:14:52 -0600
--=-KbNaeUC/o8rNoPw8pU62
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
Here are patches for the updates I have made so far to the Mono
Handbook. I am still working on the rest, but this is what I've got
right now.
Jon Kessler
--=-KbNaeUC/o8rNoPw8pU62
Content-Disposition: attachment; filename=architecture.html.patch
Content-Type: text/x-patch; name=architecture.html.patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: architecture.html
===================================================================
RCS file: /mono/monkeyguide/html/en/architecture/architecture.html,v
retrieving revision 1.11
diff -u -r1.11 architecture.html
--- architecture.html 5 Sep 2003 10:14:45 -0000 1.11
+++ architecture.html 7 Dec 2003 07:09:09 -0000
@@ -2,10 +2,10 @@
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:monodoc="http://www.go-mono.org/xml/monodoc">
<head>
- <title>.Net Framework Architecture</title>
+ <title>.NET Framework Architecture</title>
<meta name = "DC.Description" content = "" />
- <meta name = "DC.Contributor" content = "Norman Lorrain" />
+ <meta name = "DC.Contributor" content = "Norman Lorrain, Jon Kessler" />
<link rel="stylesheet" type="text/css" href="../style.css" />
</head>
@@ -14,10 +14,10 @@
<h2>The Big Picture</h2>
-When approaching something as complex as .Net, it helps to have
+When approaching something as complex as .NET, it helps to have
some idea of how it relates to your work. The following diagram
provides some context for where your application fits into the Mono
-/ .Net framework.<br />
+/ .NET framework.<br />
<br />
<p><img style="border: 0px solid ; width: 600px; height: 393px;"
alt="context diagram" title="" align="left" name="Graphic2"
@@ -36,22 +36,22 @@
<span style="font-style: italic;">Common Language
Specification</span>.</p>
<p>The class library is structured into
-<span style="font-style: italic;">Namespaces,</span> and deployed
+<span style="font-style: italic;">Namespaces</span> and deployed
in shared libraries known as
<span style="font-style: italic;">Assemblies.</span><br />
-When we speak of the .Net framework , we are primarily referring to
+When we speak of the .NET framework , we are primarily referring to
this class library.<br /></p>
<h3><a name="Namespaces" id="Namespaces"></a>Namespaces</h3>
<p>Namespaces are a mechanism for logically grouping similar
classes into a hierarchical structure. This prevents naming
conflicts. The structure is implemented using dot-separated words.
-The top level namespace for most of the .Net framework is
+The top level namespace for most of the .NET framework is
<span style="font-weight: bold;">System</span>. Under the System
namespace you'll find the following:<br /></p>
<ul>
<li>System.IO</li>
-<li>System.Net</li>
-<li>System.Net.Sockets</li>
+<li>System.NET</li>
+<li>System.NET.Sockets</li>
<li>System.Reflection</li>
<li>System.Threading</li>
<li>...and many others. For a complete list, see the
@@ -69,7 +69,7 @@
are <span style="font-style: italic;">.dll</span> files, but don't
confuse them with Win32 shared libraries. Examples are<br />
<ul>
-<li>corlib.dll</li>
+<li>mscorlib.dll</li>
<li>System.dll</li>
<li>System.Data.dll</li>
<li>Accessibility.dll</li></ul>
@@ -87,32 +87,30 @@
this is implemented by the Mono executable. This runtime is used to
execute the compiled .NET application. The common language
infrastructure is defined by ECMA standard
-<a href="http://www.ecma.ch/ecma1/STAND/ecma-335.htm">ECMA-335</a>.<br />
+<a href="http://www.ecma-international.org/publications/standards/ECMA-335.HTM">ECMA-335</a>.<br />
</p>
<p>To run your application, you must invoke the runtime with the
relevant parameters.</p>
<h2><a name="Common_Language_Specification"
id="Common_Language_Specification"></a>4. Common Language
Specification</h2>
-<p>This is specified in ECMA-335,chapter 6. It defines the
-interface to the CLI; e.g. conventions such as the underlying types
-for Enum.</p>
+<p>This is specified in ECMA-335, chapter 6. It defines the
+interface to the CLI (e.g. conventions such as the underlying types
+for Enum).</p>
<p>The Mono compiler generates an image that conforms to the CLS.
This is the <span style="font-weight: bold;">Common Intermediate
-Language</span>. The mono runtime takes this image and runs it.</p>
+Language</span>. The Mono runtime takes this image and runs it.</p>
<p>The ECMA standard formally defines a library that conforms to
the CLS as a
<span style="font-style: italic;"><span style="font-weight: bold;">framework</span></span>.</p>
<h2><a name="Bibilography" id="Bibilography"></a>5.
Bibliography</h2>
-<p>MSDN documentation for
-<a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/netstart/html/sdkstart.asp">
-.Net SDK</a>, framework is
+<p>MSDN documentation for the .NET framework is
<a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpconinsidenetframework.asp">
here.</a></p>
-<p>O'Reilly
+<p>O'Reilly's
<a href="http://www.oreilly.com/catalog/csharpnut/chapter/ch01.html">
-C# in a Nutshell</a>, Definitely recommended..<br /></p>
+C# in a Nutshell</a> is definitely recommended.<br /></p>
</body>
</html>
--=-KbNaeUC/o8rNoPw8pU62
Content-Disposition: attachment; filename=dotnet.html.patch
Content-Type: text/x-patch; name=dotnet.html.patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: dotnet.html
===================================================================
RCS file: /mono/monkeyguide/html/en/mono/dotnet.html,v
retrieving revision 1.14
diff -u -r1.14 dotnet.html
--- dotnet.html 5 Sep 2003 10:14:48 -0000 1.14
+++ dotnet.html 6 Dec 2003 03:35:56 -0000
@@ -5,59 +5,58 @@
<title>What is .NET?</title>
<meta name = "DC.Description" content = "People who contributed to this document" />
- <meta name = "DC.Contributor" content = "Johannes Roith" />
+ <meta name = "DC.Contributor" content = "Johannes Roith, Jon Kessler" />
<link rel="stylesheet" type="text/css" href="../style.css" />
</head>
<body>
<h1>What is .NET?</h1>
-<p>.NET is a product family, shipped by Microsoft in 2001, as a
-response to the successful Java from Sun. It's not a clone, but a
-complete redesign, with some exciting new features, like language
-independence, great Database support, broad XML support, well
-designed WebServices and WebApplications support and a big upgrade
+<p>.NET is a product family shipped by Microsoft in 2001 as a
+response to the successful Java from Sun. It's not a clone, but rather a
+complete redesign, with some exciting new features like language
+independence, great Database support, broad XML support, well-designed
+WebServices and WebApplications support and a big upgrade
to the VisualBasic language, including object orientation. To this
family they also count Services and the Microsoft Servers.</p>
-<p>Microsoft .NET is in fact 3 things. It is important not to confuse
+<p>Microsoft .NET is in fact 3 different things. It is important not to confuse
them.</p>
<ul>
<li>The .NET Framework</li>
<li>Services (MyServices, Passport)</li>
<li>Other things with the label ".NET"</li></ul>
Mono is just an implementation of the .NET Framework. The .NET
-Framework is a "software platform", similiar to Java. The technical
-aspect will be discussed in "Architecture".
-<p><b>Language independence</b>. Perhaps the most important factor
-is, that all languages "are created eval". Yes, that's the right
-word. There are not one or two languages, that can be consumed by
-others, if you want to be independent from language. (A bit wired.)
-Example: All Gnome APIs are written in C. This ensures, that you
-can write an applicaton in Python, by accessing these C libraries
+Framework is a "software platform" similar to Java. Its technical
+aspects will be discussed in "Architecture".
+<p><b>Language independence</b>. The most important factor
+may be that all languages "are created eval." Yes, that's the right
+word. There aren't any languages that can be consumed by others
+if you want to be independent from language.
+Example: All Gnome APIs are written in C. This ensures that you
+can write an applicaton in Python by accessing these C libraries
through bindings. But you cannot access Python programs through C.
-In the .NET world this is possible. Write in C#, MonoBasic, or
-whatever, you can without any problems reuse those classes.
-Great!</p>
+The .NET world has made this possible. No matter if you write in C#,
+MonoBasic, or another language, you can reuse all of your classes without any trouble.</p>
<p><b>Platform independence.</b> .NET code is not compiled to
-machine code, but has an intermediate form. You can copy binaries
-across platforms just like in Java. Only native code invokation can
-stop this, but it will disappear, when in time.</p>
-<p><b>Class library.</b> .NET has a big, big class library, for
-almost any task. Especially the high-level classes are interesting.
-XML-Support, Database-Support, WebServices-Support and Webpages
+machine code; it has an intermediate form. You can copy binaries
+across platforms just like in Java. Only native code invocation can
+stop this, but it will disappear when in time.</p>
+<p><b>Class library.</b> .NET has a huge class library for
+almost any task. The high-level classes are especially interesting.
+XML support, Database support, WebServices support and Webpages
support are a few examples.</p>
-<p><b>C# language.</b> C# is a very beatiful, clean, effective
+<p><b>The C# language.</b> C# is a very beautiful, clean, and effective
language.</p>
-<p><b>VB.NET language.</b> Microsoft has finally fixed the
-Basic language here. It is now just as feature-full as C# or any
-other .NET langauge is and Basic classes can be reused in C# like
-C# classes in Basic.</p>
-<p><b>web applications.</b>With ASP.NET Microsoft ships the next
+<p><b>The VB.NET language.</b> Microsoft has finally fixed its
+Visual Basic language. It is now just as full of features as C# or any
+other .NET langauge, and Visual Basic classes can be reused in C# as well as
+C# classes in Visual Basic.</p>
+<p><b>Web applications.</b>With ASP.NET, Microsoft shipped the next
generation web page framework. It benefits from language
-independence, so finally you can write your we pages with pascal or
-C++ as well as LOGO and so on. Also it's the first framework to
-break with 100% HTML code programming and makes HTML accessible as
-objects, while also introducing complex things like claendars.</p>
+independence, so finally you can write your we pages with Pascal or
+C++, as well as LOGO, and so on. Also, it's the first framework to
+break with 100% HTML code programming, and its makes HTML accessible as
+objects, while also introducing complex things like calendars.</p>
</body>
</html>
--=-KbNaeUC/o8rNoPw8pU62
Content-Description:
Content-Disposition: attachment; filename=history.html.patch
Content-Type: text/x-patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: history.html
===================================================================
RCS file: /mono/monkeyguide/html/en/mono/history.html,v
retrieving revision 1.1
diff -u -r1.1 history.html
--- history.html 15 Oct 2003 10:55:19 -0000 1.1
+++ history.html 7 Dec 2003 00:25:52 -0000
@@ -16,7 +16,7 @@
<h2>Emails</h2>
-<h3>When did it start</h3>
+<h3>When did it start?</h3>
<pre>
From: Miguel de Icaza < miguel at ximian.com >
--=-KbNaeUC/o8rNoPw8pU62
Content-Disposition: attachment; filename=mono.html.patch
Content-Type: text/x-patch; name=mono.html.patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: mono.html
===================================================================
RCS file: /mono/monkeyguide/html/en/mono/mono.html,v
retrieving revision 1.14
diff -u -r1.14 mono.html
--- mono.html 5 Sep 2003 10:14:48 -0000 1.14
+++ mono.html 6 Dec 2003 23:46:13 -0000
@@ -5,7 +5,7 @@
<title>Mono</title>
<meta name = "DC.Description" content = "People who contributed to this document" />
- <meta name = "DC.Contributor" content = "Miguel de Icaza" />
+ <meta name = "DC.Contributor" content = "Miguel de Icaza, Jon Kessler" />
<link rel="stylesheet" type="text/css" href="../style.css" />
</head>
@@ -15,19 +15,19 @@
<p>Mono is an open source implementation of the Microsoft .NET
Framework.</p>
- <p>Mono includes: a compiler for the C# language, an ECMA-compatible
+ <p>Mono includes the following: a compiler for the C# language, an ECMA-compatible
runtime engine for the Common Language Infrastructure (also referred
- as the CLR) and class libraries: both Microsoft.NET compatible as
- well as many more. The runtime can be embedded into your
- application.</p>
+ as the CLR) and class libraries, including both Microsoft.NET's libraries as
+ well as many others. The runtime can be embedded into your
+ applications.</p>
- <p>Mono has implementations of both ADO.NET,
- and ASP.NET> as part of its distribution.</p>
+ <p>Mono has implementations of both ADO.NET
+ and ASP.NET as part of its distribution.</p>
<h2>Mono project background</h2>
- <p>The GNOME project goal was to bring missing technologies to
- Unix and make it competitive in the current market place for
+ <p>The GNOME project's goal was to bring missing technologies to
+ Unix and make it competitive in the current marketplace for
desktop applications. We also realized early on that language
independence was important, and that is why GNOME APIs were
coded using a standard that allowed the APIs to be easily
@@ -35,11 +35,11 @@
programming languages on Unix (Perl, Python, Scheme, C++,
Objective-C, Ada). </p>
- <p>Later on we decided to use better methods for encapsulating
+ <p>Later on, we decided to use better methods for encapsulating
our APIs, and we started to use CORBA to define interfaces to
components. We complemented it with policy and a set of
standard GNOME interfaces for easily creating reusable,
- language independent components, controls and compound
+ language independent components, controls, and compound
documents. This technology is known as <a
href="http://developer.ximian.com/articles/whitepapers/bonobo">Bonobo</a>.
Interfaces to Bonobo exist for C, Perl, Python, and
@@ -48,43 +48,43 @@
<p>CORBA is good when you define coarse interfaces, and most
Bonobo interfaces are coarse. The only problem is that
Bonobo/CORBA interfaces are not good for small interfaces.
- For example, an XML parsing Bonobo/CORBA component would be
+ For example, an XML-parsing Bonobo/CORBA component would be
inefficient compared to a C API.</p>
<h3> The Common Language Infrastructure platform. </h3>
<p>Microsoft has created a new development platform. The
- highlights of this new development platform are:</p>
+ highlights of this new development platform are the following:</p>
<ul>
<li>A runtime environment that provides garbage
collection, threading and a virtual machine
- specification (The Virtual Execution System, VES)</li>
+ specification (The Virtual Execution System, VES).</li>
<li>A comprehensive class library. </li>
<li>A new language, C#. Very similar to Java, C#
- allows programmers to use all the features available
+ allows programmers to use all of the features available
on the .NET runtime.</li>
<li>A language specification that compilers can
follow if they want to generate classes and code
that can interoperate with other programming
- languages (The Common Language Specification: CLS)</li>
+ languages (The Common Language Specification: CLS).</li>
</ul>
- <p>The Common Language Infrastructure platform is similar to the
- goals we had in GNOME of giving language independence to
- programmers. It is more mature, documented, larger in scope,
+ <p>The Common Language Infrastructure platform fulfills the
+ goals we had in GNOME of giving language independence to
+ programmers. It is more mature, more documented, larger in scope,
and has a consistent design.</p>
<p>Any API that is written using a CLS provider language can be
used by any language that is a CLS consumer. Compilers
generate code in a format called Common Intermediate Language
- (CIL) which is an intermediate representation of a compiled
- program and is easy to compile to native code or compiled
+ (CIL), which is an intermediate representation of a compiled
+ program. It is easy to compile it to native code or to compile it
using Just-in-Time (JIT) engines. The restrictions placed by
- the runtime on the CIL byte codes ensures that it is possible
+ the runtime on the CIL bytecodes ensures that it is possible
to do a good job at optimizing the code in a JIT compiler.</p>
<h3>ECMA standards.</h3>
@@ -92,18 +92,18 @@
<p>Microsoft has submitted the
specifications of C#, the runtime, the metadata and the
other various bits of the .NET development platform to the
- <a href="http://www.ecma.ch">ECMA</a> for standarization.</p>
+ <a href="http://www.ecma-international.org">ECMA</a> for standardization.</p>
<p>You can get a copy of the specifications submitted to ECMA
- from: <a href="http://www.dotnetexperts.com/ecma">http://www.dotnetexperts.com/ecma</a></p>
+ from: <a href="http://www.dotnetexperts.com/ecma">http://www.dotnetexperts.com/ecma</a>.</p>
-<h3>Mono: an Open Source Common Language Infrastructure implementation. </h3>
+<h3>Mono: an Open Source Common Language Infrastructure implementation.</h3>
<p>Ximian has begun work on Mono, a project that aims to bring
the Common Language Infrastructure platform to free systems. </p>
<p>The .NET development platform is a very rich, powerful, and
- well designed platform that would help improve the free
+ well-designed platform that will help improve the free
software development platform. Just like the GNU project
began to clone Unix sixteen years ago, we will be cloning the
.NET development platform because it is a great platform to
--=-KbNaeUC/o8rNoPw8pU62
Content-Disposition: attachment; filename=preface.html.patch
Content-Type: text/x-patch; name=preface.html.patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: preface.html
===================================================================
RCS file: /mono/monkeyguide/html/en/preface.html,v
retrieving revision 1.13
diff -u -r1.13 preface.html
--- preface.html 11 Aug 2003 09:14:52 -0000 1.13
+++ preface.html 4 Dec 2003 04:45:13 -0000
@@ -5,23 +5,23 @@
<title>Preface</title>
<meta name = "DC.Description" content = "" />
- <meta name = "DC.Contributor" content = "Johannes Roith" />
+ <meta name = "DC.Contributor" content = "Johannes Roith, Jon Kessler" />
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body>
-<p>X - The Mono Handbook is a collection of guides and tutorials, that
-might help you to get started with mono. It covers the mono
-runtime, the C# language, tools like the debugger, certain parts of
-the class library, the Database layer ADO.NET, and the Website
-Framework ASP.NET, as well as Gtk#. It is not meant as a complete
-documentation.</p>
+<p>The Mono Handbook is a collection of guides and tutorials that
+should help you get started with Mono. It covers the Mono
+runtime, the C# language, and tools like the debugger, certain parts of
+the class libraries, the Database layer ADO.NET, and the Website
+Framework ASP.NET, as well as Gtk#. It is not meant as the complete
+documentation of Mono.</p>
<h3>How to read this guide</h3>
-<p> can read from the beginning to the end or you can skip around
-from topic to topic, no problemo.</p>
+<p>Beginners should probably read this guide in its entirety, but experts
+will probably only need to read about the information they don't know already.</p>
</body>
</html>
--=-KbNaeUC/o8rNoPw8pU62
Content-Description:
Content-Disposition: attachment; filename=target.html.patch
Content-Type: text/x-patch; charset=UTF-8
Content-Transfer-Encoding: 7bit
Index: target.html
===================================================================
RCS file: /mono/monkeyguide/html/en/target.html,v
retrieving revision 1.11
diff -u -r1.11 target.html
--- target.html 11 Aug 2003 09:14:52 -0000 1.11
+++ target.html 4 Dec 2003 04:57:29 -0000
@@ -5,7 +5,7 @@
<title>Contributing</title>
<meta name = "DC.Description" content = "People who contributed to this document" />
- <meta name = "DC.Contributor" content = "Johannes Roith" />
+ <meta name = "DC.Contributor" content = "Johannes Roith, Jon Kessler" />
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
@@ -14,14 +14,11 @@
<p>Monekyguide aims to target:</p>
<ul>
- <li>people coming from Windows, who know .NET and want to get known to the mono tools</li>
- <li>people coming from Windows, who want to program Gnome 2 applications</li>
- <li>people switching from another language (C, Java, etc.)</li>
- <li>newbie programmers, that want to learn coding</li>
+ <li>people coming from Windows who know .NET and want to get known to the mono tools</li>
+ <li>people coming from Windows who want to program Gnome 2 applications</li>
+ <li>people switching from another language (C++, Java, etc.)</li>
+ <li>new programmers that want to learn how to program</li>
</ul>
-
-<p>No matter how much you already know, this guide is for
-<b>you</b>. Experienced people can always skip boring chapters.</p>
</body>
</html>
--=-KbNaeUC/o8rNoPw8pU62--