package Torello.JavaDoc.Annotations;

import java.lang.annotation.*;

// @CSSLinks Annotation
// 
// EXPORTS:
//      public String[] FileNames();
//      public String[] FullPathFileNames();
// 
// package Torello.JDUInternal.Features.USER_SUPPLIED_JAVASCRIPT
//      The classes in this package do the processing for inserting the '.js' Files which the user
//      has requested be placed into his Java-Doc '.html' Web-Page.  These '.js' Files must be
//      located in the '../upgrade-files/script/' directory.  These '.css' Files must either:
// 
//          1) obey the standard naming convention and have the exact same file-name as the
//          Java-Class which has been annotated by the @CSSLinks Annotation
// 
//          2) have a name equal to one of the names provided to the Annotation-Element "FileNames"

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.SOURCE)
public @interface JavaScriptImport
{
    /**
     * The File Names which should be passed via this {@code String[]}-Array must be relative to
     * precisely one of your package's {@code '[src-dir]/upgrade-files/script/'} directories.  Keep
     * in mind that although Java's "Class Path" allows Source-Files for any given package to be 
     * distributed to multiple locations, {@code '.js'}-Files can only match precisely one 
     * {@code ../upgrade-files/script/*.js'} File on disk, or the the Annotation Processing system
     * wil flag this annotation as an error.
     */
    public String[] FileNames() default {};

    /**
     * The File Names which are passed using this Element may refer to any {@code '.js'} File any 
     * where on the File-System.  These Java-Script Files do not have to reside within the 
     * {@code ../upgrade-files/script/} directory.
     */
    public String[] FullPathFileNames() default {};
}