/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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 org.apache.sling.scripting;

import org.apache.sling.component.Component;


// this is a service interface. components required to register
public interface ScriptHandler {

    // initialize the script handler with a prepared ServletConfig
    // --> really, or should the handler build the config from its
    // bundle/component context ??

    // return the script types supported by this handler
    String getType();

    // return a ComponentRenderer for the script
    ComponentRenderer getComponentRenderer(Component component, String scriptName);
}

@@ -885,331 +885,456 @@
 %0A%0A%0A/
-/ this is a service interface. components required to register%0Apublic interface ScriptHandler %7B%0A%0A    // initialize the script handler with a prepared ServletConfig%0A    // --%3E really, or should the handler build the config from its%0A    // bundle/component context ??%0A%0A    // return the script types supported by this handler
+**%0A * The %3Ccode%3EScriptHandler%3C/code%3E service interface may be implemented by%0A * bundles implementing support for scripting languages such as JSP, ECMA%0A * or JSR-223 scripting.%0A */%0Apublic interface ScriptHandler %7B%0A%0A    /**%0A     * Returns the type of script supported by this handler. This value is%0A     * compared to the script type of the ScriptedComponent.%0A     * %3Cp%3E%0A     * For example a handler for JSP scripts might return %3Cem%3Ejsp%3C/em%3E.%0A     */
 %0A   
@@ -1362,19 +1362,35 @@
    /
-/ r
+**%0A     * R
 eturn
+s
  a 
+%7B@link 
 Comp
@@ -1406,23 +1406,116 @@
 erer
- for the script
+%7D called by the ScriptedComponent%0A     * to actually executed the script on behalf of the component.%0A     */
 %0A   

Add some JavaDoc