Template:Lslfunc/doc
From OpenSimulator
(Difference between revisions)
CodyCooper (Talk | contribs) |
CodyCooper (Talk | contribs) |
||
Line 1: | Line 1: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<pre> | <pre> | ||
− | {{ | + | {{LSL_Function |
− | | | + | |func |
− | | | + | |func_id |
− | | | + | |func_sleep |
− | | | + | |func_energy |
− | | | + | |func_desc |
− | | | + | |func_footnote |
− | | | + | |return_type |
− | | | + | |return_text |
+ | |p1_type|p1_name|p1_desc|p1_hover | ||
+ | |p2_type|p2_name|p2_desc|p2_hover | ||
+ | |p3_type|p3_name|p3_desc|p3_hover | ||
+ | |p4_type|p4_name|p4_desc|p4_hover | ||
+ | |p5_type|p5_name|p5_desc|p5_hover | ||
+ | |p6_type|p6_name|p6_desc|p6_hover | ||
+ | |p7_type|p7_name|p7_desc|p7_hover | ||
+ | |p8_type|p8_name|p8_desc|p8_hover | ||
+ | |p9_type|p9_name|p9_desc|p9_hover | ||
+ | |p10_type|p10_name|p10_desc|p10_hover | ||
+ | |p11_type|p11_name|p11_desc|p11_hover | ||
+ | |p12_type|p12_name|p12_desc|p12_hover | ||
+ | |constants | ||
+ | |spec | ||
+ | |caveats | ||
+ | |examples | ||
+ | |helpers | ||
+ | |also_header | ||
+ | |also_functions | ||
+ | |also_tests | ||
+ | |also_events | ||
+ | |also_articles | ||
+ | |also_footer | ||
+ | |notes | ||
+ | |mode | ||
+ | |deprecated | ||
+ | |location | ||
+ | |cat1 | ||
+ | |cat2 | ||
+ | |cat3 | ||
+ | |cat4 | ||
+ | |cat5 | ||
+ | |cat6 | ||
}} | }} | ||
</pre> | </pre> | ||
− | {| | + | The LSL_Function template is a intermediate template for LSL_Generic, which handles the formating for both functions and events (LSL_Event is also an intermediate template). The main job of this template is to change the parameter, names & setup the right-side floater. Also makes permission requirements a part of the template. |
− | |- | + | |
− | + | {| {{Prettytable}} | |
+ | |-{{Hl2}} | ||
+ | !parameter | ||
+ | !desc | ||
+ | !example | ||
|- | |- | ||
− | | | + | |func |
+ | |Function name | ||
|- | |- | ||
− | | | + | |func_id |
+ | |{{LSLG|Function ID}} | ||
+ | |1.0 | ||
|- | |- | ||
− | | | + | |func_sleep |
+ | |{{LSLG|Delay}} | ||
+ | |0.0 | ||
|- | |- | ||
− | | | + | |func_energy |
+ | |{{LSLG|Energy}} | ||
+ | |10.0 | ||
|- | |- | ||
− | | | + | |func_desc |
+ | |Function description text. | ||
+ | |Gives the monkey a banana | ||
|- | |- | ||
− | | | + | |func_footnote |
+ | |Function footnote (appears after the parameters text). | ||
+ | |Has the side effect of causing the avatar to run in circles shouting like on fire. | ||
|- | |- | ||
− | | | + | |return_type |
+ | |return type | ||
+ | |integer | ||
|- | |- | ||
− | | | + | |return_text |
+ | |"Returns a return_type return_text" in most cases return_text can be used instead of func_desc. | ||
+ | |that is a monkey | ||
+ | |- | ||
+ | |p1_type | ||
+ | |first parameter type | ||
+ | |- | ||
+ | |p1_name | ||
+ | |first parameter name | ||
+ | |- | ||
+ | |p1_desc | ||
+ | |first parameter desc | ||
+ | |- | ||
+ | |p1_hover | ||
+ | |first parameter hover, if not included it defaults to p1_desc | ||
+ | |- | ||
+ | |p2_type | ||
+ | |second parameter type | ||
+ | |- | ||
+ | |p2_name | ||
+ | |second parameter name | ||
+ | |- | ||
+ | |p2_desc | ||
+ | |second parameter desc | ||
+ | |- | ||
+ | |p2_hover | ||
+ | |second parameter hover, if not included it defaults to p2_desc | ||
+ | |- | ||
+ | |... | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |p12_type | ||
+ | |twelfth parameter type | ||
+ | | | ||
+ | |- | ||
+ | |p12_name | ||
+ | |twelfth parameter name | ||
+ | |- | ||
+ | |p12_desc | ||
+ | |twelfth parameter desc | ||
+ | |- | ||
+ | |p12_hover | ||
+ | |twelfth parameter hover, if not included it defaults to p12_desc | ||
+ | |- | ||
+ | |constants | ||
+ | |constants area, no box, please use a table for this section. | ||
+ | | | ||
+ | |- | ||
+ | |spec | ||
+ | |spec box | ||
+ | | | ||
+ | |- | ||
+ | |caveats | ||
+ | |caveats box | ||
+ | | | ||
+ | |- | ||
+ | |examples | ||
+ | |examples box | ||
+ | | | ||
+ | |- | ||
+ | |helpers | ||
+ | |helper functions box | ||
+ | | | ||
+ | |- | ||
+ | |also_header | ||
+ | |also header | ||
+ | | | ||
+ | |- | ||
+ | |also_functions | ||
+ | |also functions indent | ||
+ | | | ||
+ | |- | ||
+ | |also_events | ||
+ | |also events indent | ||
+ | | | ||
+ | |- | ||
+ | |also_articles | ||
+ | |also articles indent | ||
+ | | | ||
+ | |- | ||
+ | |also_tests | ||
+ | |also tests indent | ||
+ | | | ||
+ | |- | ||
+ | |also_footer | ||
+ | |also footer | ||
+ | | | ||
+ | |- | ||
+ | |notes | ||
+ | |notes box | ||
+ | | | ||
+ | |- | ||
+ | |mode | ||
+ | |If mode equals 'god' then it is tagged as requiring godmode. If set to 'request' marks the page as a feature request. If set to 'user' avoids function being added to LSL Function Index, thus enabling usage of this template for documentation of User Functions. | ||
+ | | | ||
+ | |- | ||
+ | |deprecated | ||
+ | |Marks the function as deprecated. Set the value to the replacement functions name or 'none'. If it is not set to none and it is infact set, it will include a link to the replacement function. | ||
+ | |- | ||
+ | |self | ||
+ | |Special field that you only set if you don't want the function to be included in any categories. | ||
+ | | | ||
+ | |- | ||
+ | |cat1 | ||
+ | |An LSL specific category and sets the proper sort. (example would add the function to the "LSL Stub" category) | ||
+ | |Stub | ||
+ | |- | ||
+ | |cat2 | ||
+ | |" | ||
+ | |- | ||
+ | |cat3 | ||
+ | |" | ||
+ | |- | ||
+ | |cat4 | ||
+ | |" | ||
+ | |- | ||
+ | |cat5 | ||
+ | |" | ||
+ | |- | ||
+ | |cat6 | ||
+ | |" | ||
+ | |- | ||
+ | |sort | ||
+ | |not required but used to specify the sort order, if excluded the wiki will calculate this value for you. | ||
+ | |- | ||
+ | |location | ||
+ | |optional: location box, used to say which source file it is defined in. | ||
+ | |- | ||
+ | |history | ||
+ | |a box for function history | ||
|} | |} | ||
− | + | <div id="box"> | |
− | + | {{LSL_Function | |
− | + | |func=MyFunction | |
− | + | |func_id=-1 | |
− | + | |func_sleep=100.5 | |
− | * | + | |func_energy=0.0 |
− | * | + | |func_desc=A fictitious function{{Footnote|Footnote test}} |
− | * | + | |func_footnote=func_footnote |
+ | |return_type=void | ||
+ | |return_text=(aka nadda, nothing). | ||
+ | |p1_type=integer|p1_name=i|p1_desc | ||
+ | |p2_type=float|p2_name=f|p2_desc | ||
+ | |p3_type=string|p3_name=s|p3_desc | ||
+ | |p4_type=key|p4_name=k|p4_desc | ||
+ | |p5_type=list|p5_name=l|p5_desc | ||
+ | |p6_type=vector|p6_name=v|p6_desc | ||
+ | |p7_type=rotation|p7_name=r|p7_desc | ||
+ | |constants=constants | ||
+ | |spec=spec | ||
+ | |caveats=caveats | ||
+ | |examples=examples | ||
+ | |helpers=helpers | ||
+ | |also_header=also_header | ||
+ | |also_events=*also_events | ||
+ | |also_functions=*also_functions | ||
+ | |also_articles=*also_articles | ||
+ | |also_tests=*also_tests | ||
+ | |also_footer=also_footer | ||
+ | |notes=notes | ||
+ | |mode | ||
+ | |self=self | ||
+ | |location=location | ||
+ | |history=history | ||
+ | }} | ||
+ | </div> |
Revision as of 10:21, 12 March 2019
{{LSL_Function |func |func_id |func_sleep |func_energy |func_desc |func_footnote |return_type |return_text |p1_type|p1_name|p1_desc|p1_hover |p2_type|p2_name|p2_desc|p2_hover |p3_type|p3_name|p3_desc|p3_hover |p4_type|p4_name|p4_desc|p4_hover |p5_type|p5_name|p5_desc|p5_hover |p6_type|p6_name|p6_desc|p6_hover |p7_type|p7_name|p7_desc|p7_hover |p8_type|p8_name|p8_desc|p8_hover |p9_type|p9_name|p9_desc|p9_hover |p10_type|p10_name|p10_desc|p10_hover |p11_type|p11_name|p11_desc|p11_hover |p12_type|p12_name|p12_desc|p12_hover |constants |spec |caveats |examples |helpers |also_header |also_functions |also_tests |also_events |also_articles |also_footer |notes |mode |deprecated |location |cat1 |cat2 |cat3 |cat4 |cat5 |cat6 }}
The LSL_Function template is a intermediate template for LSL_Generic, which handles the formating for both functions and events (LSL_Event is also an intermediate template). The main job of this template is to change the parameter, names & setup the right-side floater. Also makes permission requirements a part of the template.
parameter | desc | example |
---|---|---|
func | Function name | |
func_id | Function ID | 1.0 |
func_sleep | Delay | 0.0 |
func_energy | Energy | 10.0 |
func_desc | Function description text. | Gives the monkey a banana |
func_footnote | Function footnote (appears after the parameters text). | Has the side effect of causing the avatar to run in circles shouting like on fire. |
return_type | return type | integer |
return_text | "Returns a return_type return_text" in most cases return_text can be used instead of func_desc. | that is a monkey |
p1_type | first parameter type | |
p1_name | first parameter name | |
p1_desc | first parameter desc | |
p1_hover | first parameter hover, if not included it defaults to p1_desc | |
p2_type | second parameter type | |
p2_name | second parameter name | |
p2_desc | second parameter desc | |
p2_hover | second parameter hover, if not included it defaults to p2_desc | |
... | ||
p12_type | twelfth parameter type | |
p12_name | twelfth parameter name | |
p12_desc | twelfth parameter desc | |
p12_hover | twelfth parameter hover, if not included it defaults to p12_desc | |
constants | constants area, no box, please use a table for this section. | |
spec | spec box | |
caveats | caveats box | |
examples | examples box | |
helpers | helper functions box | |
also_header | also header | |
also_functions | also functions indent | |
also_events | also events indent | |
also_articles | also articles indent | |
also_tests | also tests indent | |
also_footer | also footer | |
notes | notes box | |
mode | If mode equals 'god' then it is tagged as requiring godmode. If set to 'request' marks the page as a feature request. If set to 'user' avoids function being added to LSL Function Index, thus enabling usage of this template for documentation of User Functions. | |
deprecated | Marks the function as deprecated. Set the value to the replacement functions name or 'none'. If it is not set to none and it is infact set, it will include a link to the replacement function. | |
self | Special field that you only set if you don't want the function to be included in any categories. | |
cat1 | An LSL specific category and sets the proper sort. (example would add the function to the "LSL Stub" category) | Stub |
cat2 | " | |
cat3 | " | |
cat4 | " | |
cat5 | " | |
cat6 | " | |
sort | not required but used to specify the sort order, if excluded the wiki will calculate this value for you. | |
location | optional: location box, used to say which source file it is defined in. | |
history | a box for function history |