/*
 * Copyright 2014-present Facebook, Inc.
 *
 * 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.facebook.litho.annotations;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.CLASS)
public @interface Param {

}

@@ -724,16 +724,1191 @@
 olicy;%0A%0A
+/**%0A * Params can be used together with %7B@link Event%7D callbacks i.e. %7B@code EventHandler%7D. An argument%0A * in the event handler annotated with %7B@code Param%7D will add it in the generated %7B@code Component%7D.%0A * This will allow to pass relevant arguments to the event handler while dispatching events. This is%0A * especially useful when event handlers can be reused.%0A *%0A * %3Cp%3E%3Cb%3EFor Example:%3C/b%3E %3Cbr%3E%0A *%0A * %3Cpre%3E%3Ccode%3E%7B@literal @LayoutSpec%7D%0A * class FacePileComponentSpec %7B%0A *%0A *  %7B@literal @OnCreateLayout%7D%0A *   static Component onCreateLayout(%0A *       LayoutContext c,%0A *      %7B@literal @Prop%7D Uri%5B%5D faces) %7B%0A *%0A *     Component.Builder builder = Column.create(c);%0A *     for (Uri face : faces) %7B%0A *       builder.child(%0A *           FrescoImage.create(c)%0A *               .uri(face)%0A *               .clickHandler(FacePileComponent.onFaceClicked(c, face));%0A *     %7D%0A *%0A *     return builder.build();%0A *   %7D%0A *%0A *  %7B@literal @OnEvent(ClickEvent.class)%7D%0A *   static void onFaceClicked(%0A *       ComponentContext c,%0A *      %7B@literal @Param%7D Uri face) %7B%0A *%0A *     // Use the param face here%0A *     Log.d(%22FacePileComponent%22, %22Face clicked: %22 + face);%0A *   %7D%0A * %7D%3C/code%3E%3C/pre%3E%0A */%0A
 @Retenti
@@ -1958,12 +1958,10 @@
  Param %7B
-%0A%0A
 %7D%0A

Add JavaDoc to Param