Module:User:Dragonoid76/sa-verb/documentation

Basic Usage
If you are unfamiliar with Sanskrit verbs, this, this, and this serve as great guides to get familiar with conjugations.

This template can be called in eight different ways:
 * : a table with the infinitive, gerund, gerundives, and past passive participle
 * : a table with the present tense (incl. the indicative, optative, imperative, and active participles)
 * : a table with the imperfect tense
 * : a table with the future tense (incl. the simple, peripherastic, and active participles)
 * : a table with the conditional tense
 * : a table with the aorist tense
 * : a table with the benedictive/precative, originally the optative of the aorist
 * : a table with the perfect tense (incl. active participles)

The first argument is always the third-person singular indicative active-voice form (or optative, in the case of the benedictive) of the verb in that tense. For instance, will produce a table for the present-tense conjugation of. will likewise produce a table for the imperfect-tense conjugation of that verb.

If no other non-keyword arguments are passed, the verb is assumed to be thematic, and this is all that is necessary. If a second argument is passed, the verb is assumed to be athematic and the the second argument should be the third-person plural indicative active-voice form (or optative, in the case of the benedictive) of the verb. If a third argument is passed, it should be the third-person singular indicative passive-voice form (or optative, in the case of the benedictive) of the verb. For instance, will produce a table for the present-tense athematic conjugation of. For aorist and benedictive tables, the passive stem must be provided if it is different from the active stem, but the middle/weak stem is unused; hence produces the aorist table for.

The "<...>" in that example encloses the stem of the verb. In the case of "leḍhi", the stem "leh" cannot be inferred from the third-person tense due to internal sandhi. Hence, we must provide the stem in brackets like that. All non-keyword arguments can take a stem like this, and, if provided, will be used in place of the third-person form (although the third-person form should still be provided so the module can infer the class of the verb). ALSO, the bracketed stem argument must be provided if the third-person form is irregular.

The non-finite forms table is special and only takes a single non-keyword argument: the infinitive form of the verb (with a possible bracketed stem). For, we would write.

Disabling Sandhi
Usually, like in the case of, this module is smart and will apply a variety of sandhi rules to produce a correct output. Occasionally, though, this is not welcome. For instance, in, the internal sandhi rules will try to eliminate the स in the root. To avoid this, use the argument "auto_sandhi=false".

Limiting Voices
A number of Sanskrit verbs are deponent (only middle voice), active-only, or have no passive. By default, this module will conjugate as many voices as each tense has. To limit the voices, use the argument "n=...". "a" stands for "active", "m" stands for "middle", and "p" stands for "passive", so "n=amp" will produce all three voices, "n=m" will produce just the middle voice, and "n=am" will produce both the active and middle voices, for example.

Overriding Arguments
Occasionally, the automatic sandhi is unable to predict the right form in a particular case or the verb has some special cases. To handle this, every single cell of the table can be completely overridden by a keyword argument to the table. It should be of the form:
 * "[mood]_[voice]_[person]_[number]" for finite forms
 * "part_[voice]" for participles
 * "inf" for the infinitive, "gerundive_mn" for the masculine/neuter gerundive, "gerundive_f" for the feminine gerundive, "part_mn" for the masculine/neuter past passive participle, and "part_f" for the feminine past passive participle

where
 * "[mood]" is one of "indic", "optat", "imper"
 * "[voice]" is one of "av", "mv", "pv"
 * "[person]" is one "1", "2", "3"
 * and "[number]" is one of "s", "d", "p"

For instance, in, the second-person singular indicative present form will be *अस्सि by default, but it is actually irregular and is असि. Hence, we override the default value by providing the arg "indic_av_2_s=asi" in.

khelati
For (thematic, class 1, no ablaut),

asti
For (athematic, class 2), ("<ās>" is provided as the form "āsīt" is irregular).

leḍhi
For (athematic, class 2, irregular),

riṇakti
For (athematic, class 7),

TODO

 * support accent marks (i.e. the shifting of accent onto the passive stem in Class 4 aorists)
 * third and first person occasional irregular forms for perfect verbs have to be provided separately
 * third-person plural ending in -uh if the root ends in -ā
 * siṣ aorist