Reputation: 181
I am in the middle of making/generating javadocs. I need some help regarding the coding/commenting javadocs.
Why doesnt this or any class shows an auther name http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ConcurrentHashMap.html while in the source code. theres @author Doug Lea or some other
This is just an example. It happens for every class.
How can I make the doc show the author name and more details?
code found in src.zip of hotspot oracle jdk:
package java.util.concurrent; import java.util.Map;
/**
* A {@link java.util.Map} providing additional atomic
* <tt>putIfAbsent</tt>, <tt>remove</tt>, and <tt>replace</tt> methods.
*
* <p>Memory consistency effects: As with other concurrent
* collections, actions in a thread prior to placing an object into a
* {@code ConcurrentMap} as a key or value
* <a href="package-summary.html#MemoryVisibility"><i>happen-before</i></a>
* actions subsequent to the access or removal of that object from
* the {@code ConcurrentMap} in another thread.
*
* <p>This interface is a member of the
* <a href="{@docRoot}/../technotes/guides/collections/index.html">
* Java Collections Framework</a>.
*
* @since 1.5
* @author Doug Lea <------------this
* @param <K> the type of keys maintained by this map
* @param <V> the type of mapped values
*/
public interface ConcurrentMap<K, V> extends Map<K, V> {
The api docs: http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ConcurrentHashMap.html
Like Hashtable but unlike HashMap, this class does not allow null to be used as a key or value.
This class is a member of the Java Collections Framework.
Since:
1.5
See Also:
Serialized Form
No author here ^
Upvotes: 1
Views: 343
Reputation: 691715
Look at the documentation for javadoc:
-author
Includes the @author text in the generated docs.
Upvotes: 2