Per gonz's request, dropping my ugly mug up on the site. I know he will

[mono.git] / doc / documentation

diff --git a/doc/documentation b/doc/documentation
index 8a3a92b37de10186d4ad62734c6493ffef81ca69..10a838acbc3b26553d6c0b1c3b4cb79f4759338a 100644 (file)
--- a/doc/documentation
+++ b/doc/documentation
@@ -25,7 +25,11 @@
                  libraries as well as the class libraries produced by
                  the project).
 
-               * Tutorials on Mono and the specifics of running it. 
+               * Tutorials on Mono and the specifics of running it
+                 (The <a href="http://www.monohispano.org">Mono
+                 Hispano</a> team has produced lots of <a
+                 href="http://www.monohispano.org/tutoriales.php">tutorials
+                 in spanish</a>
 
                * A guide to Mono as compared to the Microsoft.NET
                  Framework SDK
@@ -55,7 +59,7 @@
        repository (on gtk-sharp/doc) and we need volunteers to help
        populate the documentation for it.  Since Gtk# is a wrapper
        for Gtk, plenty of documentation exists in the <a
-       href="http://developer.gnome.org/doc/API/2.0/">Gnome developer
+       href="http://developer.gnome.org/doc/API">Gnome developer
        site</a>.
 
        To get started:
@@ -111,17 +115,17 @@
         use inside the summary and remarks sections, these are:
 
 <pre>        
-        <para> </para>
+&lt;para&gt; &lt;/para&gt;
 </pre>
                Used to separate paragraphs.
       
 <pre>  
-        <paramref name="param_name"/>
+&lt;paramref name="param_name"/&gt;
 </pre>
                Used to reference a formal parameter to a function.
 
 <pre>  
-        <see cref="T:SomeTypeName"/>
+&lt;see cref="T:SomeTypeName"/&gt;
 </pre>
                Use this to reference a type, this will include an hyper
                link to the page for type SomeTypeName.
@@ -129,11 +133,11 @@
                For example, to reference "System.Enum", do:
         
 <pre>
-               <see cref="T:System.Enum"/>
+       &lt;see cref="T:System.Enum"/&gt;
 </pre>
 
 <pre>
-        <see cref="P:SomeTypeName.Property"/>
+&lt;see cref="P:SomeTypeName.Property"/&gt;
 </pre>
                Use this to reference a property, this will include an hyper
                link to the page for the property `Property' of type `SomeTypeName'.
@@ -141,11 +145,11 @@
                For example, to reference the BaseType property in System.Type, do:
         
 <pre>
-               <see cref="P:System.Type.BaseType"/>
+       &lt;see cref="P:System.Type.BaseType"/&gt;
 </pre>
 
 <pre>
-        <see cref="M:SomeTypeName.Method(type,type)"/>
+&lt;see cref="M:SomeTypeName.Method(type,type)"/&gt;
 </pre>
                Use this to reference a method, this will include an hyper
                link to the page for the method `Method' of type `SomeTypeName'.
@@ -153,31 +157,31 @@
                For example, to reference the ToString method in System.Object, do:
         
 <pre>
-               <see cref="M:System.Object.ToString()"/>
+       &lt;see cref="M:System.Object.ToString()"/&gt;
 </pre>
         
 <pre>
-        <see langword="keywrod"/>
+&lt;see langword="keyword"/&gt;
 </pre>
                Use this to link to a keyword in the C# language, for
                example to link to `true', do:
 
 <pre>
-                       <see langword="true"/>
+       &lt;see langword="true"/&gt;
 </pre>
         
 <pre>
-        <example> ... </example>
+&lt;example&gt; ... &lt;/example&gt;
 </pre>        
                Use example to insert an example.  The example can 
                contain explanatory text and code.
         
 <pre>
-        <code lang="C#">.. </code>
+&lt;code lang="C#"&gt;.. &lt;/code&gt;
 </pre>
         
                Use this to provide a sample C# program, typically used
-               within the <example> tags.
+               within the &lt;example&gt; tags.
 
                When providing examples, try to provide a full example,
                we would like to be able to have a button to compile and
@@ -187,38 +191,38 @@
                You can link to an example like this:
 
 <pre>
-               <code lang="C#" source="file.cs"> </code>
+       &lt;code lang="C#" source="file.cs"&gt; &lt;/code&gt;
 </pre>
 
 <pre>
-        <item>
+&lt;item&gt;
 </pre>
                
 <pre>
-        <list type="bullet">  </list>
+&lt;list type="bullet"&gt;  &lt;/list&gt;
 </pre>
         
-               Use this to create lists.  Lists contains <item>
-               elements
+               Use this to create lists.  Lists contains &lt;item&gt;
+               elements which have to contain &lt;term&gt; containers.
         
 <pre>
-        <list type="table"> </lits>
-                    <listheader>
-                      <term>YOUR FIRST COLUMN</term>
-                      <description>YOUR DESCRIPTION</description>
-                    </listheader>
+&lt;list type="table"&gt; &lt;/lits&gt;
+            &lt;listheader&gt;
+              &lt;term&gt;YOUR FIRST COLUMN&lt;/term&gt;
+              &lt;description&gt;YOUR DESCRIPTION&lt;/description&gt;
+            &lt;/listheader&gt;
 </pre>
                For two-column tables.  Inside use:
         
 <pre>
-               <item>
-                       <term>First</term>
-                       <description>First descritpion</description>
-               </item>
-               <item>
-                       <term>Second</term>
-                       <description>Second descirption</description>
-               </item>
+&lt;item&gt;
+       &lt;term&gt;First&lt;/term&gt;
+       &lt;description&gt;First descritpion&lt;/description&gt;
+&lt;/item&gt;
+&lt;item&gt;
+       &lt;term&gt;Second&lt;/term&gt;
+       &lt;description&gt;Second descirption&lt;/description&gt;
+&lt;/item&gt;
 </pre>
 
 ** Words of warning.