/*
 * Copyright 2015 Adaptris Ltd.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
*/

package com.adaptris.core.management.webserver;

import org.eclipse.jetty.security.SecurityHandler;

/**
 * This is a proxy interface for the Jetty Security Handler implementation.
 * <p>
 * There is only one supported implementation at this time, which is {@link HashUserRealmProxy}
 * </p>
 * 
 * @author lchan
 * 
 */
public interface SecurityHandlerWrapper {

  /**
   * Create a security handler implementation.
   * 
   * @return a Jetty SecurityHandler implementation
   * @throws Exception wrapping other exceptions.
   */
  SecurityHandler createSecurityHandler() throws Exception;

}

@@ -788,100 +788,181 @@
 %0A * 
-There is only one supported implementation at this time, which is %7B@link HashUserRealmProxy%7D
+Generally you will configure a %7B@link com.adaptris.core.http.jetty.ConfigurableSecurityHandler%7D in your config file to create a%0A * %7B@code SecurityHandler%7D at the right time.
 %0A * 

Fix up javadoc errors.