/*
 * Copyright 2015-2018 the original author or authors.
 *
 * All rights reserved. This program and the accompanying materials are
 * made available under the terms of the Eclipse Public License v2.0 which
 * accompanies this distribution and is available at
 *
 * http://www.eclipse.org/legal/epl-v20.html
 */

package org.junit.jupiter.api;

import static org.apiguardian.api.API.Status.STABLE;

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;

import org.apiguardian.api.API;

/**
 * {@code @Nested} is used to signal that the annotated class is a nested,
 * non-static test class (i.e., an <em>inner class</em>).
 *
 * @since 5.0
 * @see Test
 * @see TestInstance
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@API(status = STABLE, since = "5.0")
public @interface Nested {
}

@@ -626,16 +626,69 @@
 api.API;
+%0Aimport org.junit.jupiter.api.TestInstance.Lifecycle;
 %0A%0A/**%0A *
@@ -816,17 +816,608 @@
 ss%3C/em%3E)
-.
+ that can share%0A * setup and state with an instance of its %7B@linkplain Class#getEnclosingClass()%0A * enclosing class%7D. The enclosing class may be a top-level test class or%0A * another %7B@code @Nested%7D test class, and nesting can be arbitrarily deep.%0A *%0A * %3Ch3%3ETest Instance Lifecycle%3C/h3%3E%0A *%0A * %3Cul%3E%0A * %3Cli%3EA %7B@code @Nested%7D test class %3Cem%3Ecan%3C/em%3E be configured with its own%0A * %7B@link Lifecycle%7D mode which may differ from that of an enclosing test%0A * class.%3C/li%3E%0A * %3Cli%3EA %7B@code @Nested%7D test class %3Cem%3Ecannot%3C/em%3E change the %7B@link Lifecycle%7D%0A * mode of an enclosing test class.%3C/li%3E%0A * %3C/ul%3E
 %0A *%0A * @

Improve JavaDoc for @Nested