User:Strife Onizuka/Sandbox/Switch/docs: Difference between revisions
m Removing all content from page |
m Undo revision 85724 by Strife Onizuka (Talk) |
||
| Line 1: | Line 1: | ||
<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> | |||
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"> | |||
{{User:Strife Onizuka/Sandbox | |||
|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 13:51, 18 August 2008
{{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 |
- ~abd
- abc~abc
- ~abd
- ~abd
- abde~abde