working on API documentation

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)
 
 
 }