how to order multiple tags in Java document comments

from: http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html (how to write doc comments)

Ordering Multiple Tags
We employ the following conventions when a tag appears more than once in a documentation comment. If desired, groups of tags, such as multiple @see tags, can be separated from the other tags by a blank line with a single asterisk.

Multiple @author tags should be listed in chronological order, with the creator of the class listed at the top.

Multiple @param tags should be listed in argument-declaration order. This makes it easier to visually match the list to the declaration.

Multiple @throws tags (also known as @exception) should be listed alphabetically by the exception names.  

Multiple @see tags should be ordered as follows, which is roughly the same order as their arguments are searched for by javadoc , basically from nearest to farthest access, from least-qualified to fully-qualified, The following list shows this progression. Notice the methods and constructors are in "telescoping" order, which means the "no arg" form first, then the "1 arg" form, then the "2 arg" form, and so forth. Where a second sorting key is needed, they could be listed either alphabetically or grouped logically.

   @see #field

   @see #Constructor(Type, Type...)

   @see #Constructor(Type id, Type id...)

   @see #method(Type, Type,...)

   @see #method(Type id, Type, id...)

   @see Class

   @see Class#field

   @see Class#Constructor(Type, Type...)

   @see Class#Constructor(Type id, Type id)

   @see Class#method(Type, Type,...)

   @see Class#method(Type id, Type id,...)

   @see package.Class

   @see package.Class#field

   @see package.Class#Constructor(Type, Type...)

   @see package.Class#Constructor(Type id, Type id)

   @see package.Class#method(Type, Type,...)

   @see package.Class#method(Type id, Type, id)

   @see package