Template:sa-conj/documentation

Uses Module:sa-verb as backend.

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.

One of the uses of this argument is to provide the strong stem. If the 3s form alone is not sufficient, supplemental information can be supplied by suffixing extra data delimited by "<...>"; see below for details.

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 (the verb is not necessarily assumed to be athematic if the passive stem is provided, since the passive stem of thematic verbs is often different from the non-passive stem). 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 stem information extracted from 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 aorist and precative forms tables are slightly different. The contrast between strong and weak is the same as active versus middle. The first non-keyword argument is the third-person singular active, and the second non-keyword argument is the third-person singular middle. The seven different aorist formations cannot always be distinguished on the basis of the 3s, and therefore the formation can be identified by aor, as follows:

The non-finite forms table is special and takes at most two non-keyword arguments
 * the first required argument is the infinitive form of the verb (with a possible bracketed stem). For, we would write.
 * the second optional argument is the past passive participle (masculine/neuter) form of the verb (with a possible bracketed stem). For, we would write.

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".

Other sandhi-related arguments are:
 * "h_to_g=1": to convert h > g before {t, th, d, dh} (duh + -tá = dugdhá) instead of h + t > ḍh (lih + -tá = līḍhá)
 * "j_to_z=1": to convert j > ṣ before {t, th} instead of j > k
 * "diaspirate=1": for verbs from diaspirate roots, like

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

 * injunctive
 * subjunctive