1.1 --- a/rt/vmtest/src/main/java/org/apidesign/bck2brwsr/vmtest/Http.java	Tue Feb 26 16:54:16 2013 +0100
     1.2 +++ b/rt/vmtest/src/main/java/org/apidesign/bck2brwsr/vmtest/Http.java	Thu Feb 28 21:35:55 2013 +0100
     1.3 @@ -23,8 +23,7 @@
     1.4  import java.lang.annotation.Target;
     1.5  
     1.6  /**
     1.7 - * Exposes HTTP page or pages to the running {@link BrwsrTest}, so it can access under
     1.8 - * the relative path.
     1.9 + * Exposes an {@link Resource HTTP page} or a set of {@link #value() pages} to the running {@link BrwsrTest}.
    1.10   *
    1.11   * @author Jaroslav Tulach <jtulach@netbeans.org>
    1.12   */
    1.13 @@ -34,8 +33,10 @@
    1.14      /** Set of pages to make available */
    1.15      public Resource[] value();
    1.16      
    1.17 -    /** Exposes an HTTP page to the running {@link BrwsrTest}, so it can access
    1.18 -     * under the relative path.
    1.19 +    /** Describes single HTTP page to the running {@link BrwsrTest}, so it can be 
    1.20 +     * accessed under the specified {@link #path() relative path}. The page
    1.21 +     * content can either be specified inline via {@link #content()} or as
    1.22 +     * an external {@link #resource() resource}.
    1.23       *
    1.24       * @author Jaroslav Tulach <jtulach@netbeans.org>
    1.25       */
    1.26 @@ -44,7 +45,7 @@
    1.27      public @interface Resource {
    1.28          /** path on the server that the test can use to access the exposed resource */
    1.29          String path();
    1.30 -        /** the content of the HttpResource */
    1.31 +        /** the content of the <code>Http.Resource</code> */
    1.32          String content();
    1.33          /** resource relative to the class that should be used instead of <code>content</code>.
    1.34           * Leave content equal to empty string.