Author: jalkanen
Date: Sat Jun 14 14:10:18 2008
New Revision: 667885

URL: http://svn.apache.org/viewvc?rev=667885&view=rev
Log:
Javadoc fixes.

Modified:
    incubator/jspwiki/trunk/ChangeLog
    
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/login/AbstractLoginModule.java
    
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/user/AbstractUserDatabase.java

Modified: incubator/jspwiki/trunk/ChangeLog
URL: 
http://svn.apache.org/viewvc/incubator/jspwiki/trunk/ChangeLog?rev=667885&r1=667884&r2=667885&view=diff
==============================================================================
--- incubator/jspwiki/trunk/ChangeLog (original)
+++ incubator/jspwiki/trunk/ChangeLog Sat Jun 14 14:10:18 2008
@@ -24,6 +24,9 @@
         * JSPWIKI-57: Should resolve NotSerializableExceptions when container
         goes up or down.
         
+        * JSPWIKI-292: Comment.jsp didn't compile.  Oops!  Thanks to Harry 
Metske
+        for the patch.
+        
 2007-06-14 Dirk Frederickx <[EMAIL PROTECTED]>
 
         * 2.7.0-svn-41  Many template fixes, added ajaxed edit preview, 
improved IE6/IE7 compat.

Modified: 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/login/AbstractLoginModule.java
URL: 
http://svn.apache.org/viewvc/incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/login/AbstractLoginModule.java?rev=667885&r1=667884&r2=667885&view=diff
==============================================================================
--- 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/login/AbstractLoginModule.java
 (original)
+++ 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/login/AbstractLoginModule.java
 Sat Jun 14 14:10:18 2008
@@ -240,7 +240,7 @@
      * Returns <code>true</code> if the number of principals
      * contained in [EMAIL PROTECTED] #m_principals} is non-zero;
      * <code>false</code> otherwise.
-     * @return
+     * @return True, if a login has succeeded.
      */
     private final boolean succeeded()
     {

Modified: 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/user/AbstractUserDatabase.java
URL: 
http://svn.apache.org/viewvc/incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/user/AbstractUserDatabase.java?rev=667885&r1=667884&r2=667885&view=diff
==============================================================================
--- 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/user/AbstractUserDatabase.java
 (original)
+++ 
incubator/jspwiki/trunk/src/com/ecyrd/jspwiki/auth/user/AbstractUserDatabase.java
 Sat Jun 14 14:10:18 2008
@@ -119,21 +119,25 @@
     }
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#findByEmail(java.lang.String)
      */
     public abstract UserProfile findByEmail( String index ) throws 
NoSuchPrincipalException;
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#findByFullName(java.lang.String)
      */
     public abstract UserProfile findByFullName( String index ) throws 
NoSuchPrincipalException;
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#findByLoginName(java.lang.String)
      */
     public abstract UserProfile findByLoginName( String index ) throws 
NoSuchPrincipalException;
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#findByWikiName(java.lang.String)
      */
     public abstract UserProfile findByWikiName( String index ) throws 
NoSuchPrincipalException;
@@ -151,6 +155,7 @@
      *            [EMAIL PROTECTED] UserProfile#getLoginName()}method.
      * @return the array of Principals representing the user
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#getPrincipals(java.lang.String)
+     * @throws [EMAIL PROTECTED]
      */
     public Principal[] getPrincipals( String identifier ) throws 
NoSuchPrincipalException
     {
@@ -179,6 +184,7 @@
     }
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#initialize(com.ecyrd.jspwiki.WikiEngine,
 java.util.Properties)
      */
     public abstract void initialize( WikiEngine engine, Properties props ) 
throws NoRequiredPropertyException;
@@ -186,6 +192,8 @@
     /**
      * Factory method that instantiates a new DefaultUserProfile with a new, 
distinct
      * unique identifier.
+     * 
+     * @return A new, empty profile.
      */
     public UserProfile newProfile()
     {
@@ -193,6 +201,7 @@
     }
 
     /**
+     * [EMAIL PROTECTED]
      * @see 
com.ecyrd.jspwiki.auth.user.UserDatabase#save(com.ecyrd.jspwiki.auth.user.UserProfile)
      */
     public abstract void save( UserProfile profile ) throws 
WikiSecurityException;
@@ -268,7 +277,9 @@
 
     /**
      * Generates a new random user identifier (uid) that is guaranteed to be 
unique.
-     * @return
+     * 
+     * @param db The database for which the UID should be generated.
+     * @return A random, unique UID.
      */
     protected static long generateUid( UserDatabase db )
     {


Reply via email to