Various docs fixes.

It turns out we weren't documenting o3djs.math.matrix4
because it was missing an @namespace tag. I tried to
find a way to flag this as an error but as far as can 
tell there, in jsdoctoolkit there is nothing I can use
to distinguish between a function with no parameters
and returns nothing and an un tagged namespace.

In other words

/**
 * no tag here
 */
o3djs.foo.someNamespace = { };

..and..

/**
 * Some func.
 */
o3djs.foo.someFunc = function() { };

Look exactly the same when they get to the doc generation
part of jsdoctoolkit. Both are members of o3djs.foo.
Both have no params and no return type. So I can't tell
that the first one is an error (a non function with no tags)
and the second one is not.

I guess we just have to be vigilant.

Also, a BIG error was I wasn't generated o3djs docs at all
in build_docs.py. Fixed that.

Finally I changed the format some. My opinion was the
summary docs at the top of each module/class were hard
to read so I put them in tables. Will have to check with
Josie once it's checked it now they actually appear on
her test server.

Also made it so for module methods and properties they
get documented as

o3djs.module.method
o3djs.module.property

but for object methods and properties they get documented

ObjectName.method
ObjectName.property

Both used to be documented as just 

method
property

Which I found hard to read since there is no context.



Review URL: http://codereview.chromium.org/149523

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@20511 0039d316-1c4b-4281-b951-d872f2087c98

0 files changed, 0 insertions, 0 deletions