/*

* Copyright 2017, Google Inc.

* All rights reserved.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions are

* met:

*

* * Redistributions of source code must retain the above copyright

* notice, this list of conditions and the following disclaimer.

* * Redistributions in binary form must reproduce the above

* copyright notice, this list of conditions and the following disclaimer

* in the documentation and/or other materials provided with the

* distribution.

* * Neither the name of Google Inc. nor the names of its

* contributors may be used to endorse or promote products derived from

* this software without specific prior written permission.

*

* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

package com.google.api.core;

import java.lang.annotation.Documented;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

/**

* Indicates a public API that can change at any time, and has no guarantee of API stability and

* backward-compatibility.

*

* <p>

* Usage guidelines:

* <ol>

* <li>This annotation is used only on APIs with public visibility. Internal interfaces should not

* use it.</li>

* <li>This annotation should only be added to new APIs. Adding it to an existing API is considered

* API-breaking.</li>

* <li>Removing this annotation from an API gives it stable status, assuming the API doesn't have

* other annotations denoting instability (such as {@link InternalApi} or

* {@link InternalExtensionOnly}).</li>

* </ol>

*/

@BetaApi

@Retention(RetentionPolicy.RUNTIME)

@Target({

ElementType.ANNOTATION_TYPE,

ElementType.CONSTRUCTOR,

ElementType.FIELD,

ElementType.METHOD,

ElementType.PACKAGE,

ElementType.TYPE

})

@Documented

public @interface BetaApi {

/**

* Context information such as links to a discussion thread, tracking issue, etc.

*/

String value() default "";

}