/*
 * Copyright 2014 the original author or authors.
 *
 * 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 org.gradle.platform.base;

import org.gradle.api.Incubating;

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

/**
 * Declares the tasks that build a binary.
 **/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Incubating
public @interface BinaryTasks {
}
@@ -873,30 +873,1477 @@
 ks t
-hat build a binary.%0A *
+o build a custom %7B@link org.gradle.platform.base.BinarySpec%7D binary.%0A *%0A * The following example demonstrates how to register multiple tasks for custom binary using a plugin with a%0A * %7B@link org.gradle.platform.base.BinaryTasks%7D annotation.%0A *%0A * %3Cpre autoTested='true'%3E%0A * import org.gradle.model.*%0A * import org.gradle.model.collection.*%0A *%0A * interface SampleComponent extends ComponentSpec%3CSampleBinary%3E %7B%7D%0A * interface SampleBinary extends BinarySpec %7B%7D%0A * class DefaultSampleBinary extends BaseBinarySpec implements SampleBinary %7B%7D%0A *%0A * apply plugin: MyCustomBinariesPlugin%0A *%0A * class MyCustomBinaryCreationTask extends DefaultTask%7B%0A *      %7B@literal @%7DTaskAction void build()%7B%0A *          //building the binary%0A *      %7D%0A * %7D%0A *%0A * class MyCustomBinariesPlugin implements Plugin%3CProject%3E %7B%0A *     void apply(final Project project) %7B%0A *%0A *     %7D%0A *%0A *     %7B@literal @%7DRuleSource%0A *     static class Rules %7B%0A *%0A *          %7B@literal @%7DBinaryType%0A *          void register(BinaryTypeBuilder%3CSampleBinary%3E builder) %7B%0A *             builder.defaultImplementation(DefaultSampleBinary)%0A *          %7D%0A *%0A *          %7B@literal @%7DBinaryTasks%0A *          void createBinaryTasks(CollectionBuilder%3CTask%3E tasks, SampleBinary binary) %7B%0A *             tasks.create(%22$%7Bbinary.name%7DTask1%22, MyCustomBinaryCreationTask)%0A *             tasks.create(%22$%7Bbinary.name%7DTask2%22)%7B%0A *                  dependsOn %22$%7Bbinary.name%7DTask1%22%0A *             %7D%0A *          %7D%0A *     %7D%0A * %7D%0A * %3C/pre%3E%0A 
 */%0A@

add autotested sample usage to BinaryTasks javadoc