Java-Gaming.org    
Featured games (79)
games approved by the League of Dukes
Games in Showcase (475)
Games in Android Showcase (106)
games submitted by our members
Games in WIP (530)
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 993 times)
0 Members and 1 Guest are viewing this topic.
Offline William Denniss

JGO Coder


Projects: 2


Fire at will


« Posted 2004-04-20 07: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:
http://odejava.org/javadoc/org/odejava/Geom.html#removeFromSpace()

cvs log:
1  
2  
3  
4  
5  
6  
7  
8  
9  
10  
11  
12  
13  
 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 :)


Cheers,

Will.

Pages: [1]
  ignore  |  Print  
 
 
You cannot reply to this message, because it is very, very old.

 

Add your game by posting it in the WIP section,
or publish it in Showcase.

The first screenshot will be displayed as a thumbnail.

ctomni231 (39 views)
2014-07-18 06:55:21

Zero Volt (36 views)
2014-07-17 23:47:54

danieldean (29 views)
2014-07-17 23:41:23

MustardPeter (32 views)
2014-07-16 23:30:00

Cero (47 views)
2014-07-16 00:42:17

Riven (48 views)
2014-07-14 18:02:53

OpenGLShaders (38 views)
2014-07-14 16:23:47

Riven (37 views)
2014-07-14 11:51:35

quew8 (33 views)
2014-07-13 13:57:52

SHC (70 views)
2014-07-12 17:50:04
HotSpot Options
by dleskov
2014-07-08 03:59:08

Java and Game Development Tutorials
by SwordsMiner
2014-06-14 00:58:24

Java and Game Development Tutorials
by SwordsMiner
2014-06-14 00:47:22

How do I start Java Game Development?
by ra4king
2014-05-17 11:13:37

HotSpot Options
by Roquen
2014-05-15 09:59:54

HotSpot Options
by Roquen
2014-05-06 15:03:10

Escape Analysis
by Roquen
2014-04-29 22:16:43

Experimental Toys
by Roquen
2014-04-28 13:24:22
java-gaming.org 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‑gaming.org
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!