/* $Id$
 *
 * 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.commons.digester3.rulesbinder;

/**
 * Builder chained when invoking {@link LinkedRuleBuilder#objectCreate(String)}.
 */
public interface LinkedCallMethodBuilder extends LinkedRuleBuilder {

    /**
     * Sets the location of the target object.
     * 
     * Positive numbers are relative to the top of the digester object stack.
     * Negative numbers are relative to the bottom of the stack. Zero implies the top object on the stack.
     *
     * @param targetOffset location of the target object.
     * @return
     */
    LinkedCallMethodBuilder withTargetOffset(int targetOffset);

    /**
     * Sets the Java classes that represent the parameter types of the method arguments.
     * 
     * If you wish to use a primitive type, specify the corresonding Java wrapper class instead,
     * such as {@code java.lang.Boolean.TYPE} for a {@code boolean} parameter.
     *
     * @param paramTypes The Java classes that represent the parameter types of the method arguments
     * @return
     */
    LinkedCallMethodBuilder withParamTypes(Class<?>...paramTypes);

}

@@ -1071,26 +1071,25 @@
 ject.%0A     *
- 
 %0A
+
      * Posit
@@ -1332,32 +1332,54 @@
 .%0A     * @return
+ this builder instance
 %0A     */%0A    Lin
@@ -1539,17 +1539,16 @@
 .%0A     *
- 
 %0A     * 
@@ -1824,16 +1824,16 @@
 guments%0A
-
      * @
@@ -1838,16 +1838,38 @@
  @return
+ this builder instance
 %0A     */

added missing @return sentences