From 8d571ffce44dc3d972a86121a18d4129cc4cb9d8 Mon Sep 17 00:00:00 2001 From: aarne Date: Fri, 26 May 2006 15:36:54 +0000 Subject: [PATCH] updated howto --- lib/resource-1.0/doc/Resource-HOWTO.html | 88 +++--------------------- lib/resource-1.0/doc/Resource-HOWTO.txt | 9 +-- 2 files changed, 13 insertions(+), 84 deletions(-) diff --git a/lib/resource-1.0/doc/Resource-HOWTO.html b/lib/resource-1.0/doc/Resource-HOWTO.html index a4929e0c2..4435d3c8e 100644 --- a/lib/resource-1.0/doc/Resource-HOWTO.html +++ b/lib/resource-1.0/doc/Resource-HOWTO.html @@ -7,55 +7,9 @@

Resource grammar writing HOWTO

Author: Aarne Ranta <aarne (at) cs.chalmers.se>
-Last update: Wed Mar 1 16:52:09 2006 +Last update: Fri May 26 17:36:48 2006
-

-
-

- - -

-
-

The purpose of this document is to tell how to implement the GF resource grammar API for a new language. We will not cover how @@ -69,7 +23,6 @@ in GF/lib/resource-1.0/. See the resource-1.0/README for details on how this differs from previous versions.

-

The resource grammar API

The API is divided into a bunch of abstract modules. @@ -88,7 +41,6 @@ to which all the other modules conform, so that e.g. NP means the same thing in those modules that use NPs and those that constructs them.

-

Phrase category modules

The direct parents of the top will be called phrase category modules, @@ -113,7 +65,6 @@ one of a small number of different types). Thus we have

  • Idiom: idiomatic phrases such as existentials -

    Infrastructure modules

    Expressions of each phrase category are constructed in the corresponding @@ -142,7 +93,6 @@ can skip the lincat definition of a category and use the default {s : Str} until you need to change it to something else. In English, for instance, many categories do have this linearization type.

    -

    Lexical modules

    What is lexical and what is syntactic is not as clearcut in GF as in @@ -179,7 +129,6 @@ different languages on the level of a resource grammar. In other words, application grammars are likely to use the resource in different ways for different languages.

    -

    The core of the syntax

    Among all categories and functions, a handful are @@ -204,7 +153,6 @@ rules relate the categories to each other. It is intended to be a first approximation when designing the parameter system of a new language.

    -

    Another reduced API

    If you want to experiment with a small subset of the resource API first, @@ -213,7 +161,6 @@ try out the module explained in the GF Tutorial.

    -

    The present-tense fragment

    Some lines in the resource library are suffixed with the comment @@ -229,9 +176,7 @@ implementation. To compile a grammar with present-tense-only, use i -preproc=GF/lib/resource-1.0/mkPresent LangGer.gf

    -

    Phases of the work

    -

    Putting up a directory

    Unless you are writing an instance of a parametrized implementation @@ -317,7 +262,6 @@ as e.g. VerbGer.

    -

    Direction of work

    The real work starts now. There are many ways to proceed, the main ones being @@ -416,7 +360,6 @@ and dependences there are in your language, and you can now produce very much in the order you please. -

    The develop-test cycle

    The following develop-test cycle will @@ -473,7 +416,6 @@ follow soon. (You will found out that these explanations involve a rational reconstruction of the live process! Among other things, the API was changed during the actual process to make it more intuitive.)

    -

    Resource modules used

    These modules will be written by you. @@ -492,8 +434,9 @@ package.