German documentation

[ppski]

I am using the German RGL in my grammar, specifically ParadigmsGer.gf. The mkA overload function uses three functions with different inputs.

Would it be possible to add a README or more comments to the .gf files that defines the input into the overload functions? I (selfishly) care most about the mkA functions, but I imagine that there are other functions that would benefit from more documentation.

For example, I can guess that mk3A takes the nominative base form, comparative, and superlative forms.

  mk3A : (gut,besser,beste : Str) -> A = \a,b,c ->
    let aa : Str = case a of {...} in 
    MorphoGer.mkA a aa b (init c) ** {lock_A = <>} ;

To understand the paradigms, I have been using the existing adjectives in LexiconGer.gf and using the resulting tables (which I've pasted a snippet of below).

> cc -table  mk3A "gut" "besser" "beste"
s . ParamX.Posit => ResGer.APred => gut
s . ParamX.Compar => ResGer.APred => besser
s . ParamX.Superl => ResGer.APred => am besten
s . ParamX.Superl => ResGer.AMod (ResGer.GSg ResGer.Fem) ResGer.Nom => beste
s . ParamX.Superl => ResGer.AMod ResGer.GPl ResGer.Nom => beste
s . ParamX.Superl => ResGer.AMod ResGer.GPl ResGer.Acc => beste
s . ParamX.Superl => ResGer.AMod (ResGer.GSg ResGer.Masc) ResGer.Acc => besten
s . ParamX.Superl => ResGer.AMod (ResGer.GSg ResGer.Masc) ResGer.Gen => besten

My guess looks reasonable, though I'm not sure about the superlative form (should I just ignore the "am" of the predicative and the final "n"?).

I've been doing similar tests with the other adjective functions (taking examples from the existing lexicon, checking with the output table), but I feel uneasy about "guessing" the forms and consulting German speakers hasn't demystified the functions completely.

[ppski]

This is related to task 120, but I think some additional notes (not necessarily a finished README) would be helpful.

[aarneranta]

Paula,

This is a very good idea, and I have put it into my to do list to add this kind of documentation to German and also to other paradigms. I noticed moreover that sometimes the information is there but it is misleading: certainly even worse that no documentation at all

Aarne