fix javadoc

Author: Vladimir Kotal

src/org/opensolaris/opengrok/authorization/IAuthorizationPlugin.java

@@ -61,8 +61,8 @@ public interface IAuthorizationPlugin {
      * It is up to the implementor if the standard request attributes like
      * session, user principal and others are used or not.
      *
-     * @param request
-     * @param project
+     * @param request servlet request
+     * @param project project to test
      * @return true if request is allowed to see this project
      */
     boolean isAllowed(HttpServletRequest request, Project project);
@@ -78,8 +78,8 @@ public interface IAuthorizationPlugin {
      * projects, repositories. You must include those in the isAllowed method
      * for project if you want to display content of the group.
      *
-     * @param request
-     * @param group
+     * @param request servlet request
+     * @param group group to test
      * @return true if request is allowed to see this group of projects
      */
     boolean isAllowed(HttpServletRequest request, Group group);

src/org/opensolaris/opengrok/configuration/ConfigMerge.java

@@ -47,7 +47,7 @@ public class ConfigMerge {
      * Merge base and new configuration.
      * @param cfgBase base configuration
      * @param cfgNew new configuration, will receive properties from the base configuration
-     * @throws Exception
+     * @throws Exception exception
      */
     public static void merge(Configuration cfgBase, Configuration cfgNew) throws Exception {
         Configuration cfgDefault = new Configuration();

src/org/opensolaris/opengrok/configuration/RuntimeEnvironment.java

@@ -2029,6 +2029,7 @@ public void maybeRefreshIndexSearchers() {
      *
      * @param proj project
      * @return SearcherManager for given project
+     * @throws IOException I/O exception
      */
     public SuperIndexSearcher getIndexSearcher(String proj) throws IOException {
         SearcherManager mgr = searcherManagerMap.get(proj);

src/org/opensolaris/opengrok/configuration/messages/Message.java

@@ -78,7 +78,7 @@ public abstract class Message implements Comparable<Message> {
      *
      * @param env the runtime environment
      * @return possible output for this application, null if no output
-     * @throws java.lang.Exception
+     * @throws java.lang.Exception exception
      */
     final public byte[] apply(RuntimeEnvironment env) throws Exception {
         validate();
@@ -90,7 +90,7 @@ final public byte[] apply(RuntimeEnvironment env) throws Exception {
      *
      * @param env the runtime environment
      * @return possible output for this application, null if no output
-     * @throws java.lang.Exception
+     * @throws java.lang.Exception exception
      */
     protected abstract byte[] applyMessage(RuntimeEnvironment env) throws Exception;
 
@@ -99,7 +99,7 @@ final public byte[] apply(RuntimeEnvironment env) throws Exception {
      * valid. Further implementation can override this method to get the message
      * into a state they would expect.
      *
-     * @throws Exception
+     * @throws Exception exception
      */
     public void validate() throws Exception {
         if (getCreated() == null) {
@@ -280,7 +280,7 @@ public boolean equals(Object obj) {
      *
      * @param host host
      * @param port port number
-     * @throws IOException
+     * @throws IOException if I/O exception occurred
      *
      * @see #throwIfError(int c, String message)
      *

src/org/opensolaris/opengrok/configuration/messages/ProjectMessage.java

@@ -295,7 +295,7 @@ protected byte[] applyMessage(RuntimeEnvironment env) throws Exception {
     /**
      * Validate ProjectMessage.
      * Tags are project names, text is command (add/delete)
-     * @throws Exception 
+     * @throws Exception exception
      */
     @Override
     public void validate() throws Exception {

src/org/opensolaris/opengrok/configuration/messages/RepositoryMessage.java

@@ -70,7 +70,7 @@ protected byte[] applyMessage(RuntimeEnvironment env) throws Exception {
     /**
      * Validate the message.
      * Tag is repository path, text is command.
-     * @throws Exception 
+     * @throws Exception exception
      */
     @Override
     public void validate() throws Exception {

src/org/opensolaris/opengrok/history/BazaarRepository.java

@@ -160,7 +160,7 @@ public InputStream getHistoryGet(String parent, String basename, String rev) {
      * @param file file to annotate
      * @param revision revision to annotate
      * @return file annotation
-     * @throws java.io.IOException
+     * @throws java.io.IOException if I/O exception occurred
      */
     @Override
     public Annotation annotate(File file, String revision) throws IOException {

src/org/opensolaris/opengrok/history/ClearCaseRepository.java

@@ -205,7 +205,7 @@ private static void drainStream(InputStream in) throws IOException {
      * @param file file to annotate
      * @param revision revision to annotate
      * @return file annotation
-     * @throws java.io.IOException
+     * @throws java.io.IOException if I/O exception occurred
      */
     @Override
     public Annotation annotate(File file, String revision) throws IOException {

src/org/opensolaris/opengrok/history/GitRepository.java

@@ -299,7 +299,7 @@ public String get() {
      * @param fullpath file path
      * @param changeset changeset
      * @return original filename
-     * @throws java.io.IOException
+     * @throws java.io.IOException if I/O exception occurred
      */
     protected String findOriginalName(String fullpath, String changeset)
             throws IOException {
@@ -374,7 +374,7 @@ protected String findOriginalName(String fullpath, String changeset)
      * @param file file to annotate
      * @param revision revision to annotate
      * @return file annotation
-     * @throws java.io.IOException
+     * @throws java.io.IOException if I/O exception occurred
      */
     @Override
     public Annotation annotate(File file, String revision) throws IOException {

src/org/opensolaris/opengrok/history/HistoryEntry.java

@@ -62,7 +62,10 @@ public HistoryEntry() {
         changeRequests = new ArrayList<String>();
     }
 
-    /** Copy constructor */
+    /**
+     * Copy constructor
+     * @param that HistoryEntry object
+     */
     public HistoryEntry(HistoryEntry that) {
         this.revision = that.revision;
         this.date = that.date;