Template:en-verb/documentation: difference between revisions
Content deleted Content added
→Usage: is the "legacy support" section still relevant? |
m Wiktionary:tracking/... moved to Wiktionary:Tracking/... to agree with other pages in same namespace |
||
| (35 intermediate revisions by 7 users not shown) | |||
Line 1:
{{documentation subpage}}
{{uses lua|Module:en-headword|Module:ugly hacks}}
Use this template to show the inflection line of an English verb.
Line 7 ⟶ 6:
<nowiki>{{en-verb}}</nowiki>
<nowiki>{{en-verb|...s|
<nowiki>{{en-verb|...s|
<nowiki>{{en-verb|...s|...ing|...d|past2=...t}}</nowiki>
{{isAccelerated}}
==Basic parameters==
For most regular verbs, no parameters are necessary. Examples of such verbs are:
# {{m|en|open}} (''opens'', ''opening'', ''opened'');
# {{m|en|wish}}, with present third singular in ''-es'' (''wishes'', ''wishing'', ''wished'');
# {{m|en|marry}}, with final ''-y'' converted to ''i'' before ''-s'' and ''-ed'' (''marries'', ''marrying'', ''married'');
# {{m|en|flip}}, with the final consonant doubled before ''-ing'' and ''-ed'' (''flips'', ''flipping'', ''flipped'');
# {{m|en|baptize}}, with final ''-e'' dropped before ''-ing'' and ''-ed'' (''baptizes'', ''baptizing'', ''baptized'');
# {{m|en|free}}, with final ''-e'' dropped only before ''-ed'' (''frees'', ''freeing'', ''freed'');
# {{m|en|tie}}, with final ''-ie'' converted to ''-y'' before ''-ing'' (''ties'', ''tying'', ''tied'').
For example, on the page {{m|en|flip}}, simply write:
: <code><nowiki>{{en-verb}}</nowiki></code>
which produces
{{en-verb|head=flip|pagename=flip}}
Other examples:
: of type (1) above: {{m|en|lift}}, {{m|en|pack}}, {{m|en|enjoy}}, {{m|en|flow}};
: of type (2) above: {{m|en|hiss}}, {{m|en|buzz}}, {{m|en|tax}}, {{m|en|watch}};
: of type (3) above: {{m|en|levy}}, {{m|en|cry}}, {{m|en|pacify}}, {{m|en|carry}};
: of type (4) above: {{m|en|strum}}, {{m|en|nag}}, {{m|en|trek}}, {{m|en|stop}};
: of type (5) above: {{m|en|rake}}, {{m|en|admire}}, {{m|en|love}}, {{m|en|argue}};
: of type (6) above: {{m|en|toe}}, {{m|en|canoe}}, {{m|en|referee}}, {{m|en|dye}};
: of type (7) above: {{m|en|lie}}, {{m|en|underlie}}, {{m|en|untie}}, {{m|en|vie}}.
Type (4) verbs above only have the final consonant doubled automatically if they consist of a single syllable. Type (4) verbs with more than one syllable should have the parameter <code>++</code> specified. Examples: {{m|en|refer}} (''refers'', ''referring'', ''referred''), {{m|en|abet}} (''abets'', ''abetting'', ''abetted''), {{m|en|handicap}} (''handicaps'', ''handicapping'', ''handicapped''). Specify these verbs as follows:
: <code><nowiki>{{en-verb|
For verbs that are irregular with respect to the above rules, specify the three forms explicitly (''-s'' form, ''-ing'' form, and ''-ed'' form, respectively). An example is {{m|en|stomach}}, where the above rules would produce the incorrect ''-s'' form ''stomaches'' instead of the correct form ''stomachs'':
: <code><nowiki>{{en-verb|stomachs|stomaching|stomached}}</nowiki></code>
or equivalently:
: <code><nowiki>{{en-verb|~s|+|+}}</nowiki></code>
Here, <code>~</code> stands for the verb lemma form ''stomach'', and <code>+</code> requests that the regularly derived forms ''stomaching'' and ''stomached'' be used, respectively.
Another example is {{m|en|Hail Mary}}:
: <code><nowiki>{{en-verb|Hail Marys|Hail Marying|Hail Maryed}}</nowiki></code>
or equivalently:
: <code><nowiki>{{en-verb|~s|~ing|~ed}}</nowiki></code>
==Irregular verbs==
For irregular (''[[strong]]'') verbs, specify the key forms (third-person present singular, the present participle, the simple past tense, and optionally the past participle):
# For the verb {{m|en|do}}:
#: <code><nowiki>{{en-verb|does|doing|did|done}}</nowiki></code>
#: or equivalently (because the form ''doing'' is regular):
#: <code><nowiki>{{en-verb|does||did|done}}</nowiki></code>
# For the verb {{m|en|see}}:
#: <code><nowiki>{{en-verb|sees|seeing|saw|seen}}</nowiki></code>
#: or equivalently (because the forms ''sees'' and ''seeing'' are regular):
#: <code><nowiki>{{en-verb|||saw|seen}}</nowiki></code>
# For the verb {{m|en|set}}:
#: <code><nowiki>{{en-verb|sets|setting|set}}</nowiki></code>
#: or equivalently:
#: <code><nowiki>{{en-verb|||set}}</nowiki></code>
Some irregular verbs have multiple forms for some inflections. Show additional forms or notes for any inflection:
# For the verb {{m|en|work}}:
#: <code><nowiki>{{en-verb|works|working|worked|past2=wrought|past2_qual=obsolete}}</nowiki></code>
#: or equivalently, simply:
#: <code><nowiki>{{en-verb|past2=wrought|past2_qual=obsolete}}</nowiki></code>
# For the verb {{m|en|ill}}:
#: <code><nowiki>{{en-verb|pres_ptc2=illin'}}</nowiki></code>
Some irregular verbs are [[defective]]. To indicate a missing form, use <code>-</code>, as with the modal verb {{m|en|can}}:
: <code><nowiki>{{en-verb|can|-|could|-}}</nowiki></code>
which produces
{{en-verb|head=can|can|-|could|-}}
==Multiword expressions==
By default, a multiword expression is treated just like a single word. This is correct for cases like {{m|en|belly dance}} (''belly dances'', ''belly dancing'', ''belly danced''), but not for cases like {{m|en|log on}} (''logs on'', ''logging on'', ''logged on''). Special support is available to make it easier to specify the forms of the latter type of expressions. Use <code>*</code> to indicate that only the first word is conjugated, following the normal rules above. For example, for {{m|en|log on}}, write:
: <code><nowiki>{{en-verb|*}}</nowiki></code>
which produces
{{en-verb|head=log on|pagename=log on|*}}
You can similarly use <code>++*</code> to get the combined effects of <code>++</code> and <code>*</code>, e.g. for {{m|en|commit to memory}}, write:
: <code><nowiki>{{en-verb|++*}}</nowiki></code>
which produces
{{en-verb|head=commit to memory|pagename=commit to memory|++*}}
As in other cases, individual forms can be replaced with <code>*</code> or <code>++*</code> to request that this particular form be replaced according to the normal rules for these codes. For example, for the verb {{m|en|let in}}, use:
: <code><nowiki>{{en-verb|*|*|let in}}</nowiki></code>
or equivalently
: <code><nowiki>{{en-verb|*|*|~}}</nowiki></code>
==Multiword expressions with irregular verbs==
An alternative format can be used to compactly specify the conjugation of irregular verbs in multiword expressions. For example, for the idiom {{m|en|throw a spanner in the works}}, use the following:
: <code><nowiki>{{en-verb|throw<,,threw,thrown> a spanner in the works}}</nowiki></code>
which produces
{{en-verb|throw<,,threw,thrown> a spanner in the works}}
Here, the verb to be inflected is followed by up to four comma-separated forms inside of angle brackets <code><...></code>. These four forms correspond to parameters 1 through 4: respectively the ''-s'' form (third person present singular), ''-ing'' form (present participle), ''-ed'' form (past tense) and ''-en'' form (past participle). Any of the four forms can be omitted to have them use the default rules described above, and the fourth form can be omitted if the past participle is the same as the past tense. For example, for {{m|en|hold a grudge}}, use the following:
: <code><nowiki>{{en-verb|hold<,,held> a grudge}}</nowiki></code>
Here, the fourth form is omitted because the past participle is the same as the past tense.
Links can be inserted into the text outside of angle brackets. For example, for {{m|en|see the forest for the trees}}, use the following:
: <code><nowiki>{{en-verb|[[see]]<,,saw,seen> the [[forest]] [[for]] the [[tree|trees]]}}</nowiki></code>
This will cause the terms ''see'', ''forest'' and ''for'' to be linked normally in the headword, but ''trees'' to be linked to the singular form ''tree'', and ''the'' not linked at all.
If no links are included in {{para|1}}, all words will be linked individually, just as for {{temp|head}}. To override this behavior, include links around only the terms to be linked, or use {{para|head}} to override the headword.
Multiple sets of angle brackets can be used if more than one verb in the expression inflects. For example, for {{m|en|aid and abet}}, use:
: <code><nowiki>{{en-verb|aid<> and abet<++>}}</nowiki></code>
which produces
{{en-verb|aid<> and abet<++>}}
Here, no forms are specified inside of the first set of angle brackets (because all are defaulted), and <code>++</code> is specified inside of the second set of angle brackets, just as it would be required for {{m|en|abet}} alone.
Within angle brackets, you can specify multiple alternatives for a given form by separating them with a colon (<code>:</code>). After a given form, you can attach a qualifier in brackets, i.e. <code>[...]</code>. An example that uses both is {{m|en|get over with}} (or any other expression involving {{m|en|get}}):
: <code><nowiki>{{en-verb|get<,,got,got[UK]:gotten[US]> over with}}</nowiki></code>
which produces
{{en-verb|get<,,got,got[UK]:gotten[US]> over with}}
The past participle of {{m|en|get}} is ''got'' in the UK but ''gotten'' in the US, as indicated.
Another example using colon-separated alternatives is {{m|en|wake up and smell the coffee}}:
: <code><nowiki>{{en-verb|wake<,,woke,woken> up and smell<,,:smelt> the coffee|head=[[wake up]] [[and]] [[smell]] [[the]] [[coffee]]}}</nowiki></code>
which produces
{{en-verb|wake<,,woke,woken> up and smell<,,:smelt> the coffee|head=[[wake up]] [[and]] [[smell]] [[the]] [[coffee]]}}
Here, the past tense and past participle of {{m|en|smell}} is either regular ''smelled'' (specified using an empty form, which defaults to the regular ''-ed'' form) or irregular ''smelt''. {{para|head}} is explicitly used so that {{m|en|wake up}} is linked as a single expression rather than separately linked as two words. Note how the alternative forms ''smelled'' and ''smelt'' are "distributed" across the past tense ''woke'' and past participle ''woken'', producing two past tense variants and two past participle variants.
In some cases, the entire expression can be conjugated in more than one way. For example, in the expression {{m|en|rock and roll}}, either each verb can conjugate individually (''rocking and rolling'') or the expression can be conjugated as a unit (''rock and rolling''). To express this, specify the two variants as comma-separated and surrounded by double parentheses, as follows:
: <code><nowiki>{{en-verb|((rock<> and roll<>,rock and roll<>))}}</nowiki></code>
which produces
{{en-verb|((rock<> and roll<>,rock and roll<>))}}
Finally, it is also possible to use the angle-bracket format with expressions such as {{m|en|reap what one sows}}, which have a verb in them that must always be listed in a finite tense. It is simply necessary to be careful in specifying the forms. As an example:
: <code><nowiki>{{en-verb|[[reap]]<> [[what]] [[one]] [[sow]]s<sows,sows,sowed:had sown,has sown:had sown>}}</nowiki></code>
which produces
{{en-verb|[[reap]]<> [[what]] [[one]] [[sow]]s<sows,sows,sowed:had sown,has sown:had sown>}}
Here, we cannot default any of the forms of ''sows'' (which would wrongly produce ''sowses'', ''sowsed'', etc.), and we use alternants to express the fact that the past tense can be either ''reaped what one sowed'' or ''reaped what one had sown'' (and similarly for the past participle). Similarly for {{m|en|know which side one's bread is buttered on}}:
: <code><nowiki>{{en-verb|[[know]]<,,knew,known> [[which]] [[side]] [[one's]] [[bread]] [[be|is]]<is,is,was> [[butter]]ed [[on]]}}</nowiki></code>
which produces
{{en-verb|[[know]]<,,knew,known> [[which]] [[side]] [[one's]] [[bread]] [[be|is]]<is,is,was> [[butter]]ed [[on]]}}
==All parameters==
There are two basic parameter formats. The newer format uses only {{para|1}}, specifying verb forms in angle brackets. This is documented in the [[#Multiword expressions with irregular verbs|previous section]]. (Technically, the named parameters below can be used even with this format, and override forms specified in {{para|1}}, but this is not necessary or recommended.)
The other, older format, uses distinct parameters to specify each form:
; {{para|1}}, {{para|pres_3sg2}}, {{para|pres_3sg3}}, ...
: third-person present singular form(s)
; {{para|pres_3sg_qual}}, {{para|pres_3sg2_qual}}, {{para|pres_3sg3_qual}}, ...
: corresponding third-person present singular form qualifiers
; {{para|2}}, {{para|pres_ptc2}}, {{para|pres_ptc3}}, ...
: present participle form(s)
; {{para|pres_ptc_qual}}, {{para|pres_ptc2_qual}}, {{para|pres_ptc3_qual}}, ...
: corresponding present participle form qualifiers
; {{para|3}}, {{para|past2}}, {{para|past3}}, ...
: simple past tense form(s)
; {{para|past_qual}}, {{para|past2_qual}}, {{para|past3_qual}}, ...
: corresponding simple past tense form qualifiers
; {{para|4}}, {{para|past_ptc2}}, {{para|past_ptc3}}, ...
: past participle form(s), if different from the past tense
; {{para|past_ptc_qual}}, {{para|past_ptc2_qual}}, {{para|past_ptc3_qual}}, ...
: corresponding past participle form qualifiers
'''NOTE''': Only specify past participle forms if different from the past tense. If no past participle forms are given, or all forms given are the same as the past tense forms, only the past tense forms are displayed, identified as ''simple past and past participle''; otherwise, the simple past forms and past participle forms are displayed separately.
There are no parameters for archaic forms, such as ''hast'' or ''hath'' (of {{m|en|have}}), ''dost'' or ''doth'' (of {{m|en|do}}), or ''art'', ''wast'', ''wert'' (of {{m|en|be}}). These forms can be noted in usage notes if needed, but should not be included in the headword forms.
The following parameters are additionally supported on all English headword templates, including {{tl|en-verb}}:
; {{para|head}}, {{para|head2}}, ...
: Override the headword display; used to add links to individual words in a multiword term.
; {{para|id}}
: Sense ID for linking to this headword. See {{tl|senseid}} for more information.
; {{para|nolinkhead|1}}, {{para|splithyph|1}}, {{para|nosplithyph|1}}, {{para|hyphspace|1}}
: Control how multiword terms are linked. See [[Module:en-headword/documentation]] for more information.
; {{para|nosuffix|1}}
: Prevent terms beginning with a hyphen from being interpreted as suffixes. See [[Module:en-headword/documentation#Suffix handling]] for more information.
; {{para|nomultiwordcat|1}}
: Prevent multiword terms (those with spaces or with hyphens in the middle) from being added to [[:Category:English multiword terms]].
; {{para|pagename}}
: Override the page name used to compute default values of various sorts. Useful when testing, for documentation pages, etc.
; {{para|sort}}
: Sort key. Rarely needs to be specified, as it is normally automatically generated.
==Exact rules==
For reference, the exact rules used to generate regular verb forms are as follows:
* For the ''-s'' form, use the following rules:
*# If the verb ends in ''-s'', ''-z'', ''-x'', ''-ch'' or ''-sh'', add ''-es''.
*# If the verb ends in consonant + ''-y'', drop the ''-y'' and add ''-ies''.
*# Otherwise, just add ''-s''.
* For the ''-ed'' form, use the following rules:
*# If the verb ends in ''-e'', add ''-d''.
*# If the verb ends in consonant + ''-y'', drop the ''-y'' and add ''-ied''.
*# If the verb is of the form C*VC, i.e. any number of consonants + vowel + single consonant (unless the final consonant is ''-w'', ''-x'', ''-y'' or ''-h''), double the final consonant and add ''-ed''.
*# Otherwise, just add ''-ed''.
* For the ''-ing'' form, use the following rules:
*# If the verb ends in ''-ue'', drop the ''-e'' and add ''-ing''.
*# If the verb ends in ''-ie'', drop the ''-ie'' and add ''-ying''.
*# If the verb ends in a vowel + one or more consonants + ''-e'', drop the ''-e'' and add ''-ing''.
*# If the verb is of the form C*VC, i.e. any number of consonants + vowel + single consonant (unless the final consonant is ''-w'', ''-x'', ''-y'' or ''-h''), double the final consonant and add ''-ing''.
*# Otherwise, just add ''-ing''.
==Autosplitting==
{{tl|en-verb}}, as with all English headword-line templates, implements an intelligent, customized algorithm for automatically splitting and linking the components of a multiword term. See [[Module:en-headword/documentation#Autosplitting]] for more information.
==Suffix handling==
{{tl|en-verb}}, as with all English headword-line templates, will normally interpret a term beginning with a hyphen as a suffix and handle it specially. See [[Module:en-headword/documentation#Suffix handling]] for more information.
==Link modifications==
{{tl|en-verb}}, as with all English headword-line templates, has a special mechanism for overriding the default linking behavior of individual terms in a multiword expression without having to repeat the entire expression. See [[Module:en-headword/documentation#Link modifications]] for more information.
==See also==
* [[Special:WhatLinksHere/Wiktionary:Tracking/ugly hacks/is_valid_page_name/from Template:en-verb]]
* [[Wiktionary:Phrasal verbs]]
<includeonly>
[[Category:English headword-line templates|Verb]]
| |||