Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RemotePolicyProvider.java Sun Nov 17 08:38:47 2013 @@ -47,6 +47,7 @@ import org.apache.river.api.common.Beta; /** * @author Peter Firmstone + * @since 3.0.0 */ @Beta public class RemotePolicyProvider extends AbstractPolicy implements RemotePolicy,
Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/RevocablePolicy.java Sun Nov 17 08:38:47 2013 @@ -71,6 +71,7 @@ import net.jini.security.policy.DynamicP * @see PermissionGrant * @see DelegatePermission * @see DelegateSecurityManager + * @since 3.0.0 */ public interface RevocablePolicy extends DynamicPolicy { @@ -84,11 +85,13 @@ public interface RevocablePolicy extends * * @param p * @return true if successful + * @since 3.0.0 */ public boolean grant(PermissionGrant p); /** - * + * Checks if policy supports revocation. * @return true - If Revoke supported by underlying policy. + * @since 3.0.0 */ public boolean revokeSupported(); } Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/ScalableNestedPolicy.java Sun Nov 17 08:38:47 2013 @@ -29,6 +29,7 @@ import java.util.List; * an order that avoids unnecessary reverse DNS calls for example. * * @author Peter Firmstone + * @since 3.0.0 */ public interface ScalableNestedPolicy { Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Segment.java Sun Nov 17 08:38:47 2013 @@ -19,10 +19,6 @@ package org.apache.river.api.security; import org.apache.river.impl.Messages; -import java.util.ArrayList; -import java.util.Collection; -import java.util.Collections; -import java.util.List; import java.util.Properties; import org.apache.river.api.security.PolicyUtils.ExpansionFailedException; @@ -45,6 +41,7 @@ import org.apache.river.api.security.Pol * is completed, so initially should be stored in an unsorted Collection. * * @author Peter Firmstone. + * @since 3.0.0 */ class Segment implements Comparable { private Segment previous; @@ -143,11 +140,10 @@ class Segment implements Comparable { * Segments the current String by find Properties between the START_MARK and * END_MARK and replacing them with their values, splitting them into separate * Strings (that remain encapsulated in the Segment) if regex is non null. - * @param START_MART + * @param START_MARK * @param END_MARK - * @param splitter + * @param regex * @param p - * @return */ public void divideAndReplace(String START_MARK, String END_MARK, String regex, Properties p) throws ExpansionFailedException{ Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/SubjectDomain.java Sun Nov 17 08:38:47 2013 @@ -67,6 +67,7 @@ import javax.security.auth.Subject; * @see org.apache.river.api.security.ConcurrentPolicyFile * * @author Peter Firmstone + * @since 3.0.0 */ public interface SubjectDomain { Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/URIGrant.java Sun Nov 17 08:38:47 2013 @@ -36,8 +36,9 @@ import java.util.logging.Logger; import org.apache.river.api.net.Uri; /** - * + * RFC3986 URI PermissionGrant * @author Peter Firmstone + * @since 3.0.0 */ class URIGrant extends CertificateGrant { private static final long serialVersionUID = 1L; Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/UnresolvedPrincipal.java Sun Nov 17 08:38:47 2013 @@ -17,7 +17,7 @@ /** * @author Alexey V. Varlamov -* @version $Revision$ +* @since 3.0.0 */ package org.apache.river.api.security; @@ -37,7 +37,7 @@ import java.security.Principal; * acceptable principal and compares it with the actual principal. * * @see PermissionGrant - * @see org.apache.river.imp.security.policy.se.ConcurrentPolicyFile + * @see org.apache.river.api.security.ConcurrentPolicyFile */ final class UnresolvedPrincipal implements Principal { Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/Util.java Sun Nov 17 08:38:47 2013 @@ -17,6 +17,11 @@ package org.apache.river.api.security; +/** + * + * @author peter + * @since 3.0.0 + */ class Util { static String toUpperCase(String s) { Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/security/package.html Sun Nov 17 08:38:47 2013 @@ -33,5 +33,8 @@ further disk access and minimises networ </p><p> Disk access of policy files is performed serially. </p> + +@since 3.3.0 + </body> </html> Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Commission.java Sun Nov 17 08:38:47 2013 @@ -23,9 +23,9 @@ package org.apache.river.api.util; * export or any other activity after construction is complete, required to put * the object into an operational state. * - * @see ServiceDescriptor - * @see Exporter - * + * @see com.sun.jini.start.ServiceDescriptor + * @see net.jini.export.Exporter + * @since 3.0.0 */ public interface Commission { /** Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/Facade.java Sun Nov 17 08:38:47 2013 @@ -21,7 +21,7 @@ package org.apache.river.api.util; /** * Interface definition of the facade pattern. * @author Peter Firmstone. - * @since 2.3.0 + * @since 3.0.0 */ public interface Facade<T> { /** @@ -42,7 +42,7 @@ public interface Facade<T> { * an IllegalArgumentException. * * @param o - * @return + * @return true if equal */ @Override public boolean equals(Object o); Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/api/util/ResultStream.java Sun Nov 17 08:38:47 2013 @@ -28,6 +28,7 @@ import java.io.IOException; * by returning a null value. * * @author Peter Firmstone + * @since 3.0.0 */ public interface ResultStream<T> { /** Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/Messages.java Sun Nov 17 08:38:47 2013 @@ -19,6 +19,7 @@ * THE FILE HAS BEEN AUTOGENERATED BY MSGTOOL TOOL. * All changes made to this file manually will be overwritten * if this tool runs again. Better make changes in the template file. + * - Shamelessly taken from Apache Harmony. */ package org.apache.river.impl; @@ -44,7 +45,7 @@ import java.util.ResourceBundle; * is looked up, or resource bundle support is not available, the key itself * will be returned as the associated message. This means that the <em>KEY</em> * should a reasonable human-readable (english) string. - * + * @since 3.0.0 */ public class Messages { Modified: river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java URL: http://svn.apache.org/viewvc/river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java?rev=1542661&r1=1542660&r2=1542661&view=diff ============================================================================== --- river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java (original) +++ river/jtsk/skunk/qa_refactor/trunk/src/org/apache/river/impl/net/UriString.java Sun Nov 17 08:38:47 2013 @@ -32,6 +32,7 @@ import java.util.logging.Logger; * * @author Peter Firmstone. */ +@Deprecated public class UriString { private static Logger logger = Logger.getLogger("org.apache.river.impl.net"); @@ -131,7 +132,7 @@ public class UriString { * * @param array * @param character - * @return + * @return index */ public static int index(char [] array, char character){ int l = array.length; @@ -150,7 +151,7 @@ public class UriString { * No normalisation or platform specific changes are performed. * * @param str - * @return + * @return encoded String. * @throws URISyntaxException */ public static String escapeIllegalCharacters(String str) throws URISyntaxException { @@ -268,7 +269,7 @@ public class UriString { * @param path - * file path. * @return - the resulting URI. - * @throw URISyntaxException + * @throws URISyntaxException */ private static URI filePathToURI(String path) throws URISyntaxException { if (File.separatorChar == '\\') {
