Difference between revisions of "Category talk:LSL Functions"

From Second Life Wiki
Jump to navigation Jump to search
 
(26 intermediate revisions by 9 users not shown)
Line 1: Line 1:
== Nice page to have, not really that helpful tho ==
Just having a long list of all the functions is ok, but it would be a lot nicer if they were given some headings related to their natural categories or groupings, even repeating some if needed, and it would be nice to either have columns for them, instead of one long list, OR have short explanations to the side of each.  But simply as it is..... its not really helpful as a guide.
[[User:Trinity Coulter|Trinity Coulter]] 06:25, 20 September 2009 (UTC)
:I like the idea of having a short explanation next to the names but organizing by use/category doesn't scale. The problem is a substantial number of functions exist in two or three categories. We should just point the user to those categories, where there is dedicated space to explain those functions in the context of the category. Just to give you an idea of the scale of the problem, there are more than 100 LSL function categories; which makes me nervous about adding their links to the page... I don't want to make this article too huge.
:I know a few categories ({{LSLGC|List}} for example) give information about function use. As long as it doesn't make this page too huge, we could add short explanations as to function use. -- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 01:17, 22 September 2009 (UTC)
== Removed clutter from page ==
I've moved this stuff away from the main page: that is for hard info. To Do lists and abuse belong here on the discussion page. [[User:EF Klaar|EF Klaar]] 02:09, 8 July 2007 (PDT)
Todo:
#fill in 'spec' field when applicable.
#write 'examples' (see {{LSLGC|Needs Example}})
#write 'notes'
#write 'caveats'.
To coordinate your work, see [[LSL_Portal_To-do]]. Use [[Template:LSL_Function]] to for page entries and be sure to look at it to familiarize yourself with the features supported.
When the task of initially creating the pages is finished, delete the to-do list at the top.
There is apparently a bug in the wiki that may mess up the alphabetic order. Just editing and saving a page that is out of order is enough to put it back in order. The ordering bug rears it's ugly head when the templates used on every function page are changed (fix bugs in the templates etc).
:I have what might work as a solution to this problem but I don't want to deploy it just yet. I still don't fully understand why this bug occurs. And implementing it would cause the re-rendering of 500+ pages. --[[User:Strife Onizuka|Strife Onizuka]] 23:28, 19 April 2007 (PDT)
Mr Strife Onizuka , whould you please dont write your name here any more, thats not your personal Blog!
----
Most of the content from the header had been there since LSL portion of the wiki was in its infancy. During that time, it was not a usable resource and putting notes on article pages to coordinate the work was reasonable. At this time, the content has mostly stabilized to a usable state. As to the comment about the sort order, it is infact a bug in the wiki and if you review the page history, multiple people posted comments about it on the article page, hence the comment. At this point, you are right, it is not appropriate and it's removal is called for. The attack on me personally while containing some validity (thou the spelling and grammar could use work) was not called for and ill advised, I am the largest contributor after all. -- [[User:Strife Onizuka|Strife Onizuka]] 13:01, 8 July 2007 (PDT)
==P cont.==
==P cont.==
I can't edit this so whoever can needs to put '''P cont.''' instead of the '''P''' heading. [[User:Valence Sojourner|Valence Sojourner]] 05:49, 5 March 2007 (PST)
I can't edit this so whoever can needs to put '''P cont.''' instead of the '''P''' heading. [[User:Valence Sojourner|Valence Sojourner]] 05:49, 5 March 2007 (PST)
:The headings are automatically generated by the Wiki software, which appears to have been programmed to assume that the first heading on a page cannot be a continuation. This is a bug in the software and should be reported as such, but I really can't be bothered to find out how to do that. [[User:EF Klaar|EF Klaar]] 02:09, 8 July 2007 (PDT)
==deprecated==
==deprecated==
Should deprecated functions be included in this list? Should we organize another list for ''active'' functions or something? I'm not sure how organizational stuff is done... --[[User:Anthony Reisman|Anthony Reisman]] 18:32, 16 March 2007 (PDT)
Should deprecated functions be included in this list? Should we organize another list for ''active'' functions or something? I'm not sure how organizational stuff is done... --[[User:Anthony Reisman|Anthony Reisman]] 18:32, 16 March 2007 (PDT)
Line 9: Line 43:
llEmail and llList2Integer are under S instead of where they should be. -- [[User:Omei Turnbull|Omei Turnbull]]
llEmail and llList2Integer are under S instead of where they should be. -- [[User:Omei Turnbull|Omei Turnbull]]
:Thats a known issue, a rather annoying one at that. Editing any pages that are out of order fixes the problem for that page. This bug shows up when ever several hundred pages are forced to update all at once (as a result of updating one of the main templates). I try to combine updates to the main templates to limit how often this happens. [[User:Strife Onizuka|Strife Onizuka]] 01:22, 21 March 2007 (PDT)
:Thats a known issue, a rather annoying one at that. Editing any pages that are out of order fixes the problem for that page. This bug shows up when ever several hundred pages are forced to update all at once (as a result of updating one of the main templates). I try to combine updates to the main templates to limit how often this happens. [[User:Strife Onizuka|Strife Onizuka]] 01:22, 21 March 2007 (PDT)
Another one in this category would be llResetScript that is ordered under G. [[User:Jisel Cortes|Jisel Cortes]], May 08, 2008.
== Any reason why llSetText is not in this list? ==
I tried to fix it myself but did not succeed - Catherine Pfeffer
It is - just not where it belongs.  llAtan2 is in the wrong place as well.  See the above note about it being a bug in the wiki software. There's quite a few of these, and I'm not sure if, from what the above comment says, simply going in and making a do-nothing edit to them would fix the problem. - TaraLi Jie
:I have a new theory why it is happening, something to do with the page rebuilding service being split across two web servers not being properly synced. -- [[User:Strife Onizuka|Strife Onizuka]] 22:28, 4 August 2007 (PDT)
==Missing Functions - question==
I've updated all the out of order entries I could find, and hopefully all entries are being listed, but I have a question. do we have a master list of functions somewhere we can refer to when checking to make sure all entries are present? currently, if the function category pages are to be believed there are 334 functions. does that sound right? I tried a few searches but was unable to nail down a search that would return all the function pages except 'll' and that returns damn near every page in the wiki =)
oh one other small annoyance... it seems the wiki sorts category pages all caps first (byte sorting), instead of letter first (-eg 'X' comes before 'c')... in some cases not so bad, in others they make the entry seem out of place and hard to find for the average person familiar with alphabetical order. any chance of this behavior being modified? (I know the wiki runs slow enough as it is, so understand if the answer is no) -- {{User|Void Singer}}
:In the future please sign you comments. The reason the categories are screwed up I believe is because the wiki is rendered by two servers and on massive renderings of the pages (like when a template is changed), the category tables get out of sync between the two servers. You don't have to make any meaningful changes to the pages, just get the server to rebuild it. The sort variable isn't needed, it gets autogenerated (I've been trying to get people to stop using it).
:I setup the categories as they are (with the constants being listed as lower case) so it would be easy to find things. It's not fun having to dig through a mess of constants to find a function or vice versa, it's more useful to have them separate. I deemed it more important to have it be useful then having it be lexicographically correct. Or is this some other sort issue with functions? I'll put it on the ToDo list to examine the outcome of making the function sort keys uppercase. We should accrue some other proposed changes for the template before doing this, it eats a lot of CPU time to render all the pages and it screws up the category listings.
:As to your question of where a complete function list can be found, see: http://svn.secondlife.com/trac/linden/browser/release/indra/lscript/lscript_library/lscript_library.cpp
:When the function pages were first created I filled them with information from the before mentioned file (with permission from LL). You will note on close examination that there are discrepancies between the tooltips and the wiki. In the vast majority of those cases the tooltips are incorrect (the official LSL documentation should never be fully trusted). Always experiment and test. -- [[User:Strife Onizuka|Strife Onizuka]] 10:46, 12 November 2007 (PST)
::whoops forgot the sig =) I tried an absolute do nothing edit(open edit, save edit) but it didn't seem to force an update to the listing. Didn't see any notes about not using the sort flag, in the future if it won't update, I'll remove that flag to force it. is there any way that the servers can be made to pause while updating, before trying to resynch? or check an update version # from one to the other beforehand? not familiar with the software so I couldn't guess.
::I like the idea of sorting functions by all uppercase, in fact I had a similar thought on the way to bed (using the sort flag), I really think it'd help people newer to the wiki. thanks for the link to the function list (all 333 acounted for, despite my off number above), and yes very aware the tooltips are off in some cases =/
::side note is there a strict definition of what constitiutes a minor edit ( I couldn't find one), I've been marking example= and also= additions this way, figuring if it doesn't mess w/ the core of the definition it must be minor anyways thanks (and I'll trim those edit decriptions down ;) [[User:Void Singer|Void Singer]] 22:37, 12 November 2007 (PST)
:::I don't really use the minor-edit flag properly, half the time i don't use it when i should and a quarter of the time i check it by accident. As to what exactly constitutes a minor edit, I am sure there is a Wikipedia article on it. You might try purging the page (append ?action=purge) to the url, I forget if it works. If the sort is messed up on an article I try to find something to add to the article besides just pushing it's internals around. As to edit descriptions, don't use me as a role model, i am not in the habit of writing edit descriptions; I really should get in it. -- [[User:Strife Onizuka|Strife Onizuka]] 00:22, 13 November 2007 (PST)
:llGetPos() appears to be missing. --[[User:Clang Bailey|Clang Bailey]] 21:15, 10 February 2008 (PST)
::Nevermind. Just sorted weird. Nice if that could be fixed, though.--[[User:Clang Bailey|Clang Bailey]] 21:17, 10 February 2008 (PST)
== not a category ==
The article seems to have defeated the point in it being a category- it effectively duplicates everything, making the actual auto-list pointless.
<br />[[User:SignpostMarv Martin|SignpostMarv Martin]] 13:35, 21 August 2008 (PDT)
:The old category bug is getting really out of hand. It's missing functions, it's got functions listed that aren't in the category and now it's taking 3 pages. -- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 15:02, 21 August 2008 (PDT)
Has there been any improvement on the previous category bug? it would be nice if we could go back to the simpler method.<br/>-- '''[[User:Void_Singer|Void]]''' <sup><small>([[User_talk:Void_Singer|talk]]|[[Special:Contributions/Void_Singer|contribs]])</small></sup> 12:20, 24 September 2011 (PDT)
:I recently pushed some changes to the function template and I didn't see any outrageous miscategorizations. I went through most of the categories and every instance of a non-english LSL article in an english cat was due to user error. I'm not saying the bug is gone I just haven't seen it yet. -- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 18:37, 26 September 2011 (PDT)
== Pathfinding functions missing ==
It seems that all pathfinding functions (llCreateCharacter...) are missing from the functions list --[[User:MartinRJ Fayray|MartinRJ Fayray]] 09:28, 25 February 2013 (PST)

Latest revision as of 09:28, 25 February 2013

Nice page to have, not really that helpful tho

Just having a long list of all the functions is ok, but it would be a lot nicer if they were given some headings related to their natural categories or groupings, even repeating some if needed, and it would be nice to either have columns for them, instead of one long list, OR have short explanations to the side of each. But simply as it is..... its not really helpful as a guide. Trinity Coulter 06:25, 20 September 2009 (UTC)

I like the idea of having a short explanation next to the names but organizing by use/category doesn't scale. The problem is a substantial number of functions exist in two or three categories. We should just point the user to those categories, where there is dedicated space to explain those functions in the context of the category. Just to give you an idea of the scale of the problem, there are more than 100 LSL function categories; which makes me nervous about adding their links to the page... I don't want to make this article too huge.
I know a few categories (List for example) give information about function use. As long as it doesn't make this page too huge, we could add short explanations as to function use. -- Strife (talk|contribs) 01:17, 22 September 2009 (UTC)

Removed clutter from page

I've moved this stuff away from the main page: that is for hard info. To Do lists and abuse belong here on the discussion page. EF Klaar 02:09, 8 July 2007 (PDT)

Todo:

  1. fill in 'spec' field when applicable.
  2. write 'examples' (see Needs Example)
  3. write 'notes'
  4. write 'caveats'.

To coordinate your work, see LSL_Portal_To-do. Use Template:LSL_Function to for page entries and be sure to look at it to familiarize yourself with the features supported.

When the task of initially creating the pages is finished, delete the to-do list at the top.

There is apparently a bug in the wiki that may mess up the alphabetic order. Just editing and saving a page that is out of order is enough to put it back in order. The ordering bug rears it's ugly head when the templates used on every function page are changed (fix bugs in the templates etc).

I have what might work as a solution to this problem but I don't want to deploy it just yet. I still don't fully understand why this bug occurs. And implementing it would cause the re-rendering of 500+ pages. --Strife Onizuka 23:28, 19 April 2007 (PDT)

Mr Strife Onizuka , whould you please dont write your name here any more, thats not your personal Blog!


Most of the content from the header had been there since LSL portion of the wiki was in its infancy. During that time, it was not a usable resource and putting notes on article pages to coordinate the work was reasonable. At this time, the content has mostly stabilized to a usable state. As to the comment about the sort order, it is infact a bug in the wiki and if you review the page history, multiple people posted comments about it on the article page, hence the comment. At this point, you are right, it is not appropriate and it's removal is called for. The attack on me personally while containing some validity (thou the spelling and grammar could use work) was not called for and ill advised, I am the largest contributor after all. -- Strife Onizuka 13:01, 8 July 2007 (PDT)

P cont.

I can't edit this so whoever can needs to put P cont. instead of the P heading. Valence Sojourner 05:49, 5 March 2007 (PST)

The headings are automatically generated by the Wiki software, which appears to have been programmed to assume that the first heading on a page cannot be a continuation. This is a bug in the software and should be reported as such, but I really can't be bothered to find out how to do that. EF Klaar 02:09, 8 July 2007 (PDT)

deprecated

Should deprecated functions be included in this list? Should we organize another list for active functions or something? I'm not sure how organizational stuff is done... --Anthony Reisman 18:32, 16 March 2007 (PDT)

I'm inclined to leave them listed, they are still in the compiler after all. The current list isn't optimal. It would be good to have a table with functions and a brief description. There are more important things that need to be done IMHO right now (like writing examples). Strife Onizuka 19:01, 16 March 2007 (PDT)

Misplaced functions

llEmail and llList2Integer are under S instead of where they should be. -- Omei Turnbull

Thats a known issue, a rather annoying one at that. Editing any pages that are out of order fixes the problem for that page. This bug shows up when ever several hundred pages are forced to update all at once (as a result of updating one of the main templates). I try to combine updates to the main templates to limit how often this happens. Strife Onizuka 01:22, 21 March 2007 (PDT)

Another one in this category would be llResetScript that is ordered under G. Jisel Cortes, May 08, 2008.

Any reason why llSetText is not in this list?

I tried to fix it myself but did not succeed - Catherine Pfeffer

It is - just not where it belongs. llAtan2 is in the wrong place as well. See the above note about it being a bug in the wiki software. There's quite a few of these, and I'm not sure if, from what the above comment says, simply going in and making a do-nothing edit to them would fix the problem. - TaraLi Jie

I have a new theory why it is happening, something to do with the page rebuilding service being split across two web servers not being properly synced. -- Strife Onizuka 22:28, 4 August 2007 (PDT)

Missing Functions - question

I've updated all the out of order entries I could find, and hopefully all entries are being listed, but I have a question. do we have a master list of functions somewhere we can refer to when checking to make sure all entries are present? currently, if the function category pages are to be believed there are 334 functions. does that sound right? I tried a few searches but was unable to nail down a search that would return all the function pages except 'll' and that returns damn near every page in the wiki =)

oh one other small annoyance... it seems the wiki sorts category pages all caps first (byte sorting), instead of letter first (-eg 'X' comes before 'c')... in some cases not so bad, in others they make the entry seem out of place and hard to find for the average person familiar with alphabetical order. any chance of this behavior being modified? (I know the wiki runs slow enough as it is, so understand if the answer is no) -- Void Singer

In the future please sign you comments. The reason the categories are screwed up I believe is because the wiki is rendered by two servers and on massive renderings of the pages (like when a template is changed), the category tables get out of sync between the two servers. You don't have to make any meaningful changes to the pages, just get the server to rebuild it. The sort variable isn't needed, it gets autogenerated (I've been trying to get people to stop using it).
I setup the categories as they are (with the constants being listed as lower case) so it would be easy to find things. It's not fun having to dig through a mess of constants to find a function or vice versa, it's more useful to have them separate. I deemed it more important to have it be useful then having it be lexicographically correct. Or is this some other sort issue with functions? I'll put it on the ToDo list to examine the outcome of making the function sort keys uppercase. We should accrue some other proposed changes for the template before doing this, it eats a lot of CPU time to render all the pages and it screws up the category listings.
As to your question of where a complete function list can be found, see: http://svn.secondlife.com/trac/linden/browser/release/indra/lscript/lscript_library/lscript_library.cpp
When the function pages were first created I filled them with information from the before mentioned file (with permission from LL). You will note on close examination that there are discrepancies between the tooltips and the wiki. In the vast majority of those cases the tooltips are incorrect (the official LSL documentation should never be fully trusted). Always experiment and test. -- Strife Onizuka 10:46, 12 November 2007 (PST)
whoops forgot the sig =) I tried an absolute do nothing edit(open edit, save edit) but it didn't seem to force an update to the listing. Didn't see any notes about not using the sort flag, in the future if it won't update, I'll remove that flag to force it. is there any way that the servers can be made to pause while updating, before trying to resynch? or check an update version # from one to the other beforehand? not familiar with the software so I couldn't guess.
I like the idea of sorting functions by all uppercase, in fact I had a similar thought on the way to bed (using the sort flag), I really think it'd help people newer to the wiki. thanks for the link to the function list (all 333 acounted for, despite my off number above), and yes very aware the tooltips are off in some cases =/
side note is there a strict definition of what constitiutes a minor edit ( I couldn't find one), I've been marking example= and also= additions this way, figuring if it doesn't mess w/ the core of the definition it must be minor anyways thanks (and I'll trim those edit decriptions down ;) Void Singer 22:37, 12 November 2007 (PST)
I don't really use the minor-edit flag properly, half the time i don't use it when i should and a quarter of the time i check it by accident. As to what exactly constitutes a minor edit, I am sure there is a Wikipedia article on it. You might try purging the page (append ?action=purge) to the url, I forget if it works. If the sort is messed up on an article I try to find something to add to the article besides just pushing it's internals around. As to edit descriptions, don't use me as a role model, i am not in the habit of writing edit descriptions; I really should get in it. -- Strife Onizuka 00:22, 13 November 2007 (PST)
llGetPos() appears to be missing. --Clang Bailey 21:15, 10 February 2008 (PST)
Nevermind. Just sorted weird. Nice if that could be fixed, though.--Clang Bailey 21:17, 10 February 2008 (PST)

not a category

The article seems to have defeated the point in it being a category- it effectively duplicates everything, making the actual auto-list pointless.
SignpostMarv Martin 13:35, 21 August 2008 (PDT)

The old category bug is getting really out of hand. It's missing functions, it's got functions listed that aren't in the category and now it's taking 3 pages. -- Strife (talk|contribs) 15:02, 21 August 2008 (PDT)

Has there been any improvement on the previous category bug? it would be nice if we could go back to the simpler method.
-- Void (talk|contribs) 12:20, 24 September 2011 (PDT)

I recently pushed some changes to the function template and I didn't see any outrageous miscategorizations. I went through most of the categories and every instance of a non-english LSL article in an english cat was due to user error. I'm not saying the bug is gone I just haven't seen it yet. -- Strife (talk|contribs) 18:37, 26 September 2011 (PDT)

Pathfinding functions missing

It seems that all pathfinding functions (llCreateCharacter...) are missing from the functions list --MartinRJ Fayray 09:28, 25 February 2013 (PST)