Hi Mark javadoc comment for DataAccessFactory ---------------------------------------- My design is somewhat similar to your design where i have a FBNDataAccessFactory which has getDataAccess(dns,port) and getDataAccess(locladb) method for getting data access in local or network mode. Now the problem is how to put javadoc comment for the class becoz being a connection factory it is returning a connection to remote data server and in local mode it is returning a connection to database and not server. Problem is of connection to data server or local database Amit [ June 25, 2002: Message edited by: Amit Kr Kumar ] [ June 25, 2002: Message edited by: Amit Kr Kumar ] [ June 25, 2002: Message edited by: Mark Spritzler ]
Mark, I see that you are using the @param <Type> <param> - <description> format instead of @param <param> <description> In one of the recent posts here, someone pinted out that this is wrong. You don't need a dash either, -- it will be generated. Any reasons that you've used your javadoc format? Eugene.
Joined: Apr 24, 2002
I elected to use the latter appraoch
@param <param> <description>
. It confused me which format to use, considering the original files seem to use both. I just picked one and stayed consistent with it throughout. Both ways seemed to work fine for when I generated the javadocs, and didn't think either way would have a big impact on my score. Mike
Actually I thought I had just copied and pasted from their code and used the same standard. Also if you don't include the type then the type didn't show up in the Javadoc, and if you look in the Java Api Javadocs they all have type in the html pages. I got 20/20 on docs, so my guess is either way will work fine. Mark
Joined: Oct 08, 2001
.. and if you look in the Java Api Javadocs they all have type in the html pages.
Actually, Java Api Javadocs don't have type. Here is a typical example from JDK 1.3.1: The following SUN source in String.java (notice that there are no types or dashes:
You just posted a constructor, they don't have return values. If you look at an actual method that returns a value you will see it. Let's also say that without it, I never got the return values to show up in my Javadocs. But when I put it in there it did show. Mark