cleaned up API comments for document

lib/resource-1.0/abstract/Common.gf

@@ -4,12 +4,12 @@
 -- ${s : Str}$ in all languages. 
 
 -- Moreover, this module defines the abstract parameters of tense, polarity, and
--- anteriority, which are used in [Phrase Phrase.html] to generate different
--- forms of sentences. Together they give 2 x 4 x 4 = 16 sentence forms.
+-- anteriority, which are used in [``Phrase`` Phrase.html] to generate different
+-- forms of sentences. Together they give 4 x 2 x 2 = 16 sentence forms.
 
 -- These tenses are defined for all languages in the library. More tenses
 -- can be defined in the language extensions, e.g. the "passé simple" of
--- Romance languages.
+-- Romance languages in [``ExtraRomance`` ../romance/ExtraRomance.gf].
 
 abstract Common = {
 
@@ -17,25 +17,25 @@ abstract Common = {
 
 --2 Top-level units
 
--- Constructed in [Text Text.html]: $Text$.
+-- Constructed in [``Text`` Text.html]: $Text$.
 
     Text ;  -- text consisting of several phrases  e.g. "He is here. Why?"
 
--- Constructed in [Phrase Phrase.html]:
+-- Constructed in [``Phrase`` Phrase.html]:
 
     Phr ;   -- phrase in a text                    e.g. "but be quiet please"
     Utt ;   -- sentence, question, word...         e.g. "be quiet"
     Voc ;   -- vocative or "please"                e.g. "my darling"
     PConj ; -- phrase-beginning conj.              e.g. "therefore"
 
--- Constructed in [Sentence Sentence.html]:
+-- Constructed in [``Sentence`` Sentence.html]:
 
     SC ;    -- embedded sentence or question       e.g. "that it rains"
 
 --2 Adverbs
 
--- Constructed in [Adverb Adverb.html].  
--- Many adverbs are constructed in [Structural Structural.html].
+-- Constructed in [``Adverb`` Adverb.html].  
+-- Many adverbs are constructed in [``Structural`` Structural.html].
 
     Adv ;   -- verb-phrase-modifying adverb,       e.g. "in the house"
     AdV ;   -- adverb directly attached to verb    e.g. "always"