GMod Wiki has gone full retard

[KD007]

Is it just me or has the GMod wiki gone fully retarded?

[IMG]http://i51.tinypic.com/xfafl5.png[/IMG]
Here's the actual page: [url]http://wiki.garrysmod.com/?title=G.DynamicLight[/url]

So apparently (so I heard from a brother's friend) that there are actually 14 iterations from 0 to 13 inclusive.

I'm really concerned, since the GMod wiki is the only place you can find the documentation for GMod Lua. A good portion of the function descriptions are horribly done (the page I have shown you is actually one of the nicer ones).
Imagine your javadoc like this:

public void clearRect( int x, int y, int w, int h, Color c )
Yo man! Word on the web is that this methy clears a good portion of you screen in the numbers you give it.
Returns ScreenClearMessageThing thing but maybe thats just me cause some ppl told me it returns null. Oh wel oh no wait its a void sorry

Pretty? I didn't think so. Sure, the javadoc example is a no-brainer, but what if somebody really doesn't know what they're doing? People complain about Lua 'noobs' all the time, yet they themselves do not wish to properly hand down any knowledge to the poor minges. I would contribute, but seeing as Garry made those off the top of his head, I suppose the only way to get proper documentation is to get Team Garry to contribute most of it.

[garry]

It's a wiki, if you care enough you can fix it.

[KD007]

[QUOTE=garry;31778986]It's a wiki, if you care enough you can fix it.[/QUOTE]

Trust me, I [i]would[/i]. But my question is how? Where else can I find info on GLua? Short of hacking you just to read your source.

[editline]17th August 2011[/editline]

Aw crap the drone agree's are shitpiling already...

[pdp]

[QUOTE=KD007;31779017]Aw crap the drone agree's are shitpiling already...[/QUOTE]

People are agreeing with him because he's right.

[KD007]

Well, my ever correct friends, where's the answer to my original question:
How can people even contribute, without a single other place to find out the documentation to GLua?

Stop and open your eyes: Garry's answer isn't correct, since he does not answer the question at all. Should I just magically going to find out the documentation to... say... [i]Player.AnimSetGestureWeight(...) [/i]? Try doing it... you won't be able to.

If anyone from Team Garry (including Garry himself) will spew out the doc to that function, then it would simply be proving my point. Please read my initial post to the end this time.

[editline]17th August 2011[/editline]

54 views : 5 posts (3 my own)

stumped, gentlemen?

[garry]

So you want me to go through the wiki and fix everything?

Why don't I just close the wiki down and document the whole thing using something else? What's the point in having a wiki if I'm the person that has to document everything.

[Jookia]

[QUOTE=garry;31779634]What's the point in having a wiki if I'm the person that has to document everything.[/QUOTE]

As I understand it, you're the only person with the updated documentation, and nobody else can produce it short of decompiling GMod.

[KD007]

[QUOTE=garry;31779634]So you want me to go through the wiki and fix everything?

Why don't I just close the wiki down and document the whole thing using something else? What's the point in having a wiki if I'm the person that has to document everything.[/QUOTE]

Wait, I didn't choose to put the doc in the wiki either...

[garry]

[QUOTE=Jookia;31779738]As I understand it, you're the only person with the updated documentation, and nobody else can produce it short of decompiling GMod.[/QUOTE]

So ask me what parameters a function takes and you can update the wiki with the right information?

I'm not going to trawl the wiki looking for wrong entries.

[Teddi]

Garrysmod still has to use C functions for the lua hooks to perform the tasks they can do. You can find correlation between the lua functions and the C functions on the [URL="http://developer.valvesoftware.com/wiki/Main_Page"]Valve Developer Wiki[/URL].

[Wizard of Ass]

Hey OP, atleast I took the time to figure this shit out, since I didn't know it was the color Fx I tested every single mode and tried to interpret it.

And then I'm making a single mistake(wrong number) and you make a thread about it?

Seriously, fuck you.

[Pantho]

The op is right, however he should go about it more politely ;)

[Wizard of Ass]

If you want be helpful give the a list of the Render FX constants or a link to them.

[editline]17th August 2011[/editline]

There, I added the Render FX page removed this ugly list and replaced it by a link to the Render FX page, you could have done the same without wasting garry's time.

[KD007]

I'm just discussing, though. I didn't even realize that Garry would step in o.0

[Yashirmare]

[QUOTE=KD007;31798018]I'm just discussing, though. I didn't even realize that Garry would step in o.0[/QUOTE]

Well you should expect the unexpected...

[disseminate]

[QUOTE=KD007;31779226]Should I just magically going to find out the documentation to... say... [i]Player.AnimSetGestureWeight(...) [/i]? Try doing it... you won't be able to.[/QUOTE]

Well let's see, how about using common sense?

First let's see if it's in the valve developer wiki. Searched for "AnimSetGestureWeight", no results.

OK, so it's not on the wiki. Fine, it's a wiki, fair enough. Let's try the source 2007 SDK next which you can get by creating a blank mod.
Used notepad++ to find in files. Same as the wiki, no results. This must mean it's a semi-custom function by garry.

Let's look for examples, shall we? [url]http://luabin.overvprojects.nl/[/url] is a wonderful place to look. And lo and behold, two results! One from TTT and one from base gamemode, let's look at base gamemode.

[lua]function GM:GrabEarAnimation( ply )

ply.ChatGestureWeight = ply.ChatGestureWeight or 0

if ( ply:IsSpeaking() ) then
ply.ChatGestureWeight = math.Approach( ply.ChatGestureWeight, 1, FrameTime() * 10.0 );
else
ply.ChatGestureWeight = math.Approach( ply.ChatGestureWeight, 0, FrameTime() * 10.0 );
end

if ( ply.ChatGestureWeight > 0 ) then

ply:AnimRestartGesture( GESTURE_SLOT_CUSTOM, ACT_GMOD_IN_CHAT )
ply:AnimSetGestureWeight( GESTURE_SLOT_CUSTOM, ply.ChatGestureWeight )

end

end[/lua]

Which is called from

[lua]function GM:UpdateAnimation( ply, velocity, maxseqgroundspeed )
...
if ( CLIENT ) then
GAMEMODE:GrabEarAnimation( ply )
end
...
end[/lua]

Wow! It's called on the client from UpdateAnimation, with three arguments - the player, the player's gesture slot, and a weight from 0.0 to 1.0 after setting the gesture with AnimRestartGesture( slot, activity ). It's used on the 'hand to ear' animation when speaking over mic, so I'd pretty much say that weight represents the strength of the gesture! Perhaps this works on any gesture slot with AnimRestartGesture! This is the point where you go into gmod and try it yourself using lua_run and lua_run_cl.

After you find out what you were looking for, you're feeling so great about yourself that you go and update the wiki with the knowledge you just gained.

Congratulations! You've documented Player.AnimSetGestureWeight()!

This took me about 60 seconds from start to finish. Don't complain about not knowing documentation when you have stuff like these links and google.

[TCB]

[QUOTE=KD007;31798018]I'm just discussing, though. I didn't even realize that Garry would step in o.0[/QUOTE]
It's his forum, why wouldn't he? He shows up in all sorts of threads.