wrote on resource in tutorial

3 files changed, 93 insertions, 16 deletions

diff --git a/doc/tutorial/Multi.png b/doc/tutorial/Multi.png
new file mode 100644
index 000000000..37308de48
--- /dev/null
+++ b/doc/tutorial/Multi.png
diff --git a/doc/tutorial/gf-tutorial2.html b/doc/tutorial/gf-tutorial2.html
index 85d69fbcb..d2f5b31a0 100644
--- a/doc/tutorial/gf-tutorial2.html
+++ b/doc/tutorial/gf-tutorial2.html
@@ -7,7 +7,7 @@
 <P ALIGN="center"><CENTER><H1>Grammatical Framework Tutorial</H1>
 <FONT SIZE="4">
 <I>Author: Aarne Ranta &lt;aarne (at) cs.chalmers.se&gt;</I><BR>
-Last update: Mon Dec 19 17:31:35 2005
+Last update: Mon Dec 19 18:00:23 2005
 </FONT></CENTER>
 
 <P></P>
@@ -96,8 +96,8 @@ Last update: Mon Dec 19 17:31:35 2005
       </UL>
     <LI><A HREF="#toc63">More features of the module system</A>
       <UL>
-      <LI><A HREF="#toc64">Resource grammars and their reuse</A>
-      <LI><A HREF="#toc65">Interfaces, instances, and functors</A>
+      <LI><A HREF="#toc64">Interfaces, instances, and functors</A>
+      <LI><A HREF="#toc65">Resource grammars and their reuse</A>
       <LI><A HREF="#toc66">Restricted inheritance and qualified opening</A>
       </UL>
     <LI><A HREF="#toc67">More concepts of abstract syntax</A>
@@ -2050,16 +2050,59 @@ they can be used as arguments. For example:
 <A NAME="toc63"></A>
 <H2>More features of the module system</H2>
 <A NAME="toc64"></A>
+<H3>Interfaces, instances, and functors</H3>
+<A NAME="toc65"></A>
 <H3>Resource grammars and their reuse</H3>
 <P>
-See 
-<A HREF="../../lib/resource/doc/gf-resource.html">resource library documentation</A>
+A resource grammar is a grammar built on linguistic grounds,
+to describe a language rather than a domain.
+The GF resource grammar library contains resource grammars for
+10 languages, is described more closely in the following
+documents:
+</P>
+<UL>
+<LI><A HREF="../../lib/resource/doc/gf-resource.html">Resource library API documentation</A>:
+  for application grammarians using the resource.
+<LI><A HREF="../../lib/resource-1.0/doc/Resource-HOWTO.html">Resource writing HOWTO</A>:
+  for resource grammarians developing the resource.
+</UL>
+
+<P>
+However, to give a flavour of both using and writing resource grammars,
+we have created a miniature resource, which resides in the
+subdirectory <A HREF="resource"><CODE>resource</CODE></A>. Its API consists of the following
+modules:
+</P>
+<UL>
+<LI><A HREF="resource/Syntax.gf">Syntax</A>: syntactic structures, language-independent
+<LI><A HREF="resource/LexEng.gf">LexEng</A>: lexical paradigms, English
+<LI><A HREF="resource/LexIta.gf">LexIta</A>: lexical paradigms, Italian
+</UL>
+
+<P>
+Only these three modules should be <CODE>open</CODE>ed in applications.
+The implementations of the resource are given in the following four modules:
+</P>
+<UL>
+<LI><A HREF="resource/MorphoEng.gf">MorphoEng</A>,
+  <A HREF="resource/MorphoIta.gf">MorphoIta</A>: low-level morphology
+<LI>{SyntaxEng resource/SyntaxEng.gf].
+  <A HREF="resource/SyntaxIta.gf">SyntaxIta</A>: definitions of syntactic structures
+</UL>
+
+<P>
+An example use of the resource resides in the
+subdirectory <A HREF="applications"><CODE>applications</CODE></A>.
+It implements the abstract syntax 
+<A HREF="applications/FoodComments.gf"><CODE>FoodComments</CODE></A> for English and Italian.
+The following diagram shows the module structure, indicating by
+colours which modules are written by the grammarian. The two blue modules
+form the abstract syntax. The three red modules form the concrete syntax.
+The two green modules are trivial instantiations of a functor.
+The rest of the modules (black) come from the resource.
 </P>
-<A NAME="toc65"></A>
-<H3>Interfaces, instances, and functors</H3>
 <P>
-See an
-<A HREF="../../examples/mp3/mp3-resource.html">example built this way</A>
+<IMG ALIGN="middle" SRC="Multi.png" BORDER="0" ALT="">
 </P>
 <A NAME="toc66"></A>
 <H3>Restricted inheritance and qualified opening</H3>
diff --git a/doc/tutorial/gf-tutorial2.txt b/doc/tutorial/gf-tutorial2.txt
index 4eed17774..25b731dd9 100644
--- a/doc/tutorial/gf-tutorial2.txt
+++ b/doc/tutorial/gf-tutorial2.txt
@@ -1752,17 +1752,51 @@ they can be used as arguments. For example:
 %--!
 ==More features of the module system==
 
+===Interfaces, instances, and functors===
 
-===Resource grammars and their reuse===
-
-See 
-[resource library documentation  ../../lib/resource/doc/gf-resource.html]
 
+===Resource grammars and their reuse===
 
-===Interfaces, instances, and functors===
+A resource grammar is a grammar built on linguistic grounds,
+to describe a language rather than a domain.
+The GF resource grammar library contains resource grammars for
+10 languages, is described more closely in the following
+documents:
+- [Resource library API documentation ../../lib/resource/doc/gf-resource.html]:
+  for application grammarians using the resource.
+- [Resource writing HOWTO ../../lib/resource-1.0/doc/Resource-HOWTO.html]:
+  for resource grammarians developing the resource.
+
+
+However, to give a flavour of both using and writing resource grammars,
+we have created a miniature resource, which resides in the
+subdirectory [``resource`` resource]. Its API consists of the following
+modules:
+- [Syntax resource/Syntax.gf]: syntactic structures, language-independent
+- [LexEng resource/LexEng.gf]: lexical paradigms, English
+- [LexIta resource/LexIta.gf]: lexical paradigms, Italian
+
+
+Only these three modules should be ``open``ed in applications.
+The implementations of the resource are given in the following four modules:
+- [MorphoEng resource/MorphoEng.gf],
+  [MorphoIta resource/MorphoIta.gf]: low-level morphology
+- {SyntaxEng resource/SyntaxEng.gf].
+  [SyntaxIta resource/SyntaxIta.gf]: definitions of syntactic structures
+
+
+An example use of the resource resides in the
+subdirectory [``applications`` applications].
+It implements the abstract syntax 
+[``FoodComments`` applications/FoodComments.gf] for English and Italian.
+The following diagram shows the module structure, indicating by
+colours which modules are written by the grammarian. The two blue modules
+form the abstract syntax. The three red modules form the concrete syntax.
+The two green modules are trivial instantiations of a functor.
+The rest of the modules (black) come from the resource.
+
+[Multi.png]
 
-See an
-[example built this way ../../examples/mp3/mp3-resource.html]
 
 
 ===Restricted inheritance and qualified opening===