Hi !
Featured games (90)
games approved by the League of Dukes
Games in Showcase (777)
Games in Android Showcase (231)
games submitted by our members
Games in WIP (856)
games currently in development
News: Read the Java Gaming Resources, or peek at the official Java tutorials
    Home     Help   Search   Login   Register   
Pages: [1]
  ignore  |  Print  
  [Odejava] new javadoc tag  (Read 1644 times)
0 Members and 1 Guest are viewing this topic.
Offline William Denniss

JGO Coder

Projects: 2

Fire at will

« Posted 2004-04-20 05:06:58 »

Guess what?  In light of the ODE focus of Odejava (that is maintain a tight binding to the underlying API - not trying to work around limitations etc...)  I have added a new tag to the ant javadoc task and created a taglet in java code.

The tag is @ode.  Odejava API developers such as Jani and I can use it to inform the users though the javadoc which ODE methods are used and why.

This is important because as I discovered - there are some oddities of ODE that can cause strange bugs.  At least this way you can basically work out what ODE methods are being called for debugging.

It also means you can quickly lookup the ODE docs to check what the function does if it isn't clear.  So basically it can remove some assumptions and guesswork for the user.

A further step when I add log4j logging to Odejava would be to actually log every single call to ODE, again for debugging (only if turned on however...).

An example can be seen on this method:

cvs log:
 added new @ode tag to the javadoc task.

The tag can be used to document which ODE methods are called and why.

For example:  

The method Body.delete calls  Ode.dBodyDestroy(bodyId);  So in it's javadoc comment, you would add the line:

@ode dBodyDestroy destroys the body

The comment that you add describes the USE of the ODE method - NOT the  function of that method (as people should look up the docs for this).  

Please use this tag :)



Pages: [1]
  ignore  |  Print  

hadezbladez (337 views)
2018-11-16 13:46:03

hadezbladez (180 views)
2018-11-16 13:41:33

hadezbladez (336 views)
2018-11-16 13:35:35

hadezbladez (83 views)
2018-11-16 13:32:03

EgonOlsen (2177 views)
2018-06-10 19:43:48

EgonOlsen (2206 views)
2018-06-10 19:43:44

EgonOlsen (1378 views)
2018-06-10 19:43:20

DesertCoockie (2011 views)
2018-05-13 18:23:11

nelsongames (1655 views)
2018-04-24 18:15:36

nelsongames (2300 views)
2018-04-24 18:14:32
Deployment and Packaging
by mudlee
2018-08-22 18:09:50

Java Gaming Resources
by gouessej
2018-08-22 08:19:41

Deployment and Packaging
by gouessej
2018-08-22 08:04:08

Deployment and Packaging
by gouessej
2018-08-22 08:03:45

Deployment and Packaging
by philfrei
2018-08-20 02:33:38

Deployment and Packaging
by philfrei
2018-08-20 02:29:55

Deployment and Packaging
by philfrei
2018-08-19 23:56:20

Deployment and Packaging
by philfrei
2018-08-19 23:54:46 is not responsible for the content posted by its members, including references to external websites, and other references that may or may not have a relation with our primarily gaming and game production oriented community. inquiries and complaints can be sent via email to the info‑account of the company managing the website of java‑
Powered by MySQL Powered by PHP Powered by SMF 1.1.18 | SMF © 2013, Simple Machines | Managed by Enhanced Four Valid XHTML 1.0! Valid CSS!