working on API documentation

lib/resource-1.0/abstract/Adjective.gf

@@ -1,25 +1,30 @@
+--1 Adjectives and adjectival phrases
+
 abstract Adjective = Cat ** {
 
   fun
 
-    PositA  : A -> AP ;
-    ComparA : A -> NP -> AP ;
+-- The principal ways of forming an adjectival phrase are
+-- positive, comparative, relational, reflexive-relational, and
+-- elliptic-relational.
+-- (The superlative use is covered in [Noun Noun.html].$SuperlA$.)
 
--- $SuperlA$ belongs to determiner syntax in $Noun$.
+    PositA  : A -> AP ;         -- warm
+    ComparA : A -> NP -> AP ;   -- warmer than Spain
+    ComplA2 : A2 -> NP -> AP ;  -- divisible by 2
+    ReflA2  : A2 -> AP ;        -- divisible by itself
+    UseA2   : A2 -> A ;         -- divisible
 
-    ComplA2 : A2 -> NP -> AP ;
+-- Sentence and question complements defined for all adjectival
+-- phrases, although the semantics is only clear for some adjective.
+ 
+    SentAP  : AP -> SC -> AP ;  -- great that she won, uncertain if she did
 
-    ReflA2  : A2 -> AP ;
+-- An adjectival phrase can be modified by an *adadjective*, such as "very".
 
-    SentAP  : AP -> S  -> AP ;
-    QuestAP : AP -> QS -> AP ;
+    AdAP    : AdA -> AP -> AP ; -- very uncertain
 
-    AdAP : AdA -> AP -> AP ;
-
--- $AdvA$ that forms adverbs belongs to $Adverb$.
-
--- Elliptic constructions as usual.
-
-    UseA2 : A2 -> A ;
+-- The formation of adverbs from adjective (e.g. "quickly") is covered
+-- by [Adverb Adverb.html].
 
 }

lib/resource-1.0/abstract/Adverb.gf

@@ -1,19 +1,34 @@
+--1 Adverbs and adverbial phrases
+
 abstract Adverb = Cat ** {
 
   fun
 
-    PositAdvAdj   : A -> Adv ;
-    ComparAdvAdj  : CAdv -> A -> NP -> Adv ;
-    ComparAdvAdjS : CAdv -> A -> S -> Adv ;
+-- The two main ways of formins adverbs is from adjectives and by
+-- prepositions from noun phrases.
 
-    PrepNP : Prep -> NP -> Adv ;
+    PositAdvAdj : A -> Adv ;                 -- quickly
+    PrepNP      : Prep -> NP -> Adv ;        -- in the house
 
-    AdAdv  : AdA -> Adv -> Adv ;
 
-    SubjS : Subj -> S -> Adv ;
-    AdvSC : SC -> Adv ;
+-- Comparative adverbs have a noun phrase or a sentence as object of
+-- comparison.
 
-    AdnCAdv : CAdv -> AdN ;
+    ComparAdvAdj  : CAdv -> A -> NP -> Adv ; -- more quickly than John
+    ComparAdvAdjS : CAdv -> A -> S -> Adv ;  -- more quickly than he runs
+
+-- Adverbs can be modified by 'adadjectives', just like adjectives.
+
+    AdAdv  : AdA -> Adv -> Adv ;             -- very quickly
+
+-- Subordinate clauses can function as adverbs.
+
+    SubjS : Subj -> S -> Adv ;               -- when he arrives
+    AdvSC : SC -> Adv ;                      ---- REMOVE THIS?
+
+-- Comparison adverbs also work as numeral adverbs.
+
+    AdnCAdv : CAdv -> AdN ;                  -- more (than five)
 
 
 }

lib/resource-1.0/abstract/Noun.gf

@@ -109,9 +109,8 @@ abstract Noun = Cat ** {
 
 -- Nouns can also be modified by embedded sentences and questions.
 -- For some nouns this makes little sense, but we leave this for applications
--- to decide.
+-- to decide. Sentential complements are defined in [Verb Verb.html].
 
-    SentCN  : CN -> S  -> CN ;    -- fact that John smokes
-    QuestCN : CN -> QS -> CN ;    -- question whether John smokes
+    SentCN  : CN -> SC  -> CN ;   -- fact that John smokes, question if he does
 
 } ;