@OptionsPanelController.TopLevelRegistration(

    categoryName="#CTL_General_Options",

    iconBase="org/netbeans/modules/options/resources/generalOptions.png",

    keywords="#KW_General",

    keywordsCategory="General",

//    title="#CTL_General_Options_Title",

//    description="#CTL_General_Options_Description",

    position=100

)

    /**

     * Generates an instance file that is <em>not initialized</em> with an instance.

     * Useful for {@link LayerGeneratingProcessor}s which define layer fragments

     * which indirectly instantiate Java objects from the annotated code via a generic factory method.

     * Invoke the factory using {@link File#methodvalue} on {@code instanceCreate}

     * and configure it with a {@link File#instanceAttribute} appropriate to the factory.

     * <p>While you can pick a specific instance file name, if possible you should pass null for {@code name}

     * as using the generated name will help avoid accidental name collisions between annotations.

     * @param path path to folder of instance file, e.g. {@code "Menu/File"}

     * @param name instance file basename, e.g. {@code "my-menu-Item"}, or null to pick a name according to the element

     * @return an instance file (call {@link File#write} to finalize)

     * @throws IllegalArgumentException if the builder is not associated with exactly one

     *                                  {@linkplain TypeElement class} or {@linkplain ExecutableElement method}

     * @throws LayerGenerationException if the associated element would not be loadable as an instance 

     * @since XXX

     */

    public File instanceFile(String path, String name) throws IllegalArgumentException, LayerGenerationException {

        String[] clazzOrMethod = instantiableClassOrMethod(null);

        String clazz = clazzOrMethod[0];

        String method = clazzOrMethod[1];

        String basename;

        if (name == null) {

            basename = clazz.replace('.', '-');

            if (method != null) {

                basename += "-" + method;

            }

        } else {

            basename = name;

        }

        return file(path + "/" + basename + ".instance");

    }

cp.extra=${nb_all}/apisupport.harness/external/openjdk-javac-6-b12.jar

import org.netbeans.spi.options.OptionsPanelController.SubRegistration;

import org.netbeans.spi.options.OptionsPanelController.TopLevelRegistration;

    @SuppressWarnings("deprecation")

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Sun in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2009 Sun Microsystems, Inc.

 */

package org.netbeans.modules.options;

import java.util.Set;

import javax.annotation.processing.Processor;

import javax.annotation.processing.RoundEnvironment;

import javax.annotation.processing.SupportedAnnotationTypes;

import javax.annotation.processing.SupportedSourceVersion;

import javax.lang.model.SourceVersion;

import javax.lang.model.element.Element;

import javax.lang.model.element.TypeElement;

import org.netbeans.spi.options.AdvancedOption;

import org.netbeans.spi.options.OptionsCategory;

import org.netbeans.spi.options.OptionsPanelController;

import org.netbeans.spi.options.OptionsPanelController.SubRegistration;

import org.netbeans.spi.options.OptionsPanelController.TopLevelRegistration;

import org.openide.filesystems.annotations.LayerBuilder.File;

import org.openide.filesystems.annotations.LayerGeneratingProcessor;

import org.openide.filesystems.annotations.LayerGenerationException;

import org.openide.util.lookup.ServiceProvider;

@ServiceProvider(service=Processor.class)

@SupportedSourceVersion(SourceVersion.RELEASE_6)

@SupportedAnnotationTypes({

    "org.netbeans.spi.options.OptionsPanelController.TopLevelRegistration",

    "org.netbeans.spi.options.OptionsPanelController.SubRegistration"

})

public class OptionsPanelControllerProcessor extends LayerGeneratingProcessor {

    protected boolean handleProcess(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) throws LayerGenerationException {

        if (roundEnv.processingOver()) {

            return false;

        }

        for (Element e : roundEnv.getElementsAnnotatedWith(TopLevelRegistration.class)) {

            TopLevelRegistration r = e.getAnnotation(TopLevelRegistration.class);

            File file = layer(e).instanceFile("OptionsDialog", r.id()).

                    methodvalue("instanceCreate", OptionsCategory.class.getName(), "createCategory").

                    instanceAttribute("controller", OptionsPanelController.class).

                    bundlevalue("categoryName", r.categoryName()).

                    // XXX verify that the icon exists

                    stringvalue("iconBase", r.iconBase()).

                    position(r.position());

            keywords(e, r.keywords(), r.keywordsCategory(), file);

            file.write();

        }

        for (Element e : roundEnv.getElementsAnnotatedWith(SubRegistration.class)) {

            SubRegistration r = e.getAnnotation(SubRegistration.class);

            if (r.position() != Integer.MAX_VALUE && r.location().equals("Advanced")) {

                throw new LayerGenerationException("position ignored for Advanced subpanels", e);

            }

            File file = layer(e).instanceFile("OptionsDialog/" + r.location(), r.id()).

                    methodvalue("instanceCreate", AdvancedOption.class.getName(), "createSubCategory").

                    instanceAttribute("controller", OptionsPanelController.class).

                    bundlevalue("displayName", r.displayName()).

                    position(r.position());

            keywords(e, r.keywords(), r.keywordsCategory(), file);

            file.write();

        }

        return true;

    }

    private void keywords(Element e, String keywords, String keywordsCategory, File file) throws LayerGenerationException {

        if (keywords.length() > 0) {

            if (keywordsCategory.length() == 0) {

                throw new LayerGenerationException("Must specify both keywords and keywordsCategory", e);

            }

            file.bundlevalue("keywords", keywords).bundlevalue("keywordsCategory", keywordsCategory);

        } else {

            if (keywordsCategory.length() > 0) {

                throw new LayerGenerationException("Must specify both keywords and keywordsCategory", e);

            }

        }

    }

}

     * @deprecated Use {@link OptionsPanelController.SubRegistration} instead.

     */

    @Deprecated

    protected AdvancedOption() {}

    /**

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

     * @deprecated Use {@link OptionsCategory}{@code .createCategory} with {@code advancedOptionsFolder} instead.

    @Deprecated

    /**

     * Registers a simple panel at the top level of the Options dialog.

     * Should be placed on a {@link OptionsPanelController} instance.

     * @see OptionsCategory

     * @since XXX

     */

    @Target({ElementType.TYPE, ElementType.METHOD})

    @Retention(RetentionPolicy.SOURCE)

    public @interface TopLevelRegistration {

        /**

         * Optional path that can be used in {@link OptionsDisplayer#open(String)}.

         */

        String id() default "";

        /** Label shown on the button. You may use {@code #key} syntax. */

        String categoryName();

        /** Path to icon for the button. */

        String iconBase();

        /**

         * Optional keywords (separated by commas) for use with Quick Search (must also specify {@link #keywordCategory}).

         * You may use {@code #key} syntax.

         */

        String keywords() default "";

        /** Keyword category for use with Quick Search (must also specify {@link #keywords}). */

        String keywordsCategory() default "";

        /** Position relative to other top-level panels. */

        int position() default Integer.MAX_VALUE;

    }

    /**

     * Registers a subpanel inside a top-level container panel in the Options dialog.

     * Should be placed on a {@link OptionsPanelController} instance.

     * @see AdvancedOption

     * @since XXX

     */

    @Target({ElementType.TYPE, ElementType.METHOD})

    @Retention(RetentionPolicy.SOURCE)

    public @interface SubRegistration {

        /**

         * Optional path that can be used (with {@link #location}) in {@link OptionsDisplayer#open(String)}.

         */

        String id() default "";

        /**

         * Location of this panel inside some top-level panel.

         * If unspecified, placed in the Miscellaneous panel.

         */

        String location() default "Advanced";

        /** Label shown on the tab. You may use {@code #key} syntax. */

        String displayName();

        /**

         * Optional keywords (separated by commas) for use with Quick Search (must also specify {@link #keywordCategory}).

         * You may use {@code #key} syntax.

         */

        String keywords() default "";

        /** Keyword category for use with Quick Search (must also specify {@link #keywords}). */

        String keywordsCategory() default "";

        /**

         * Position relative to sibling subpanels.

         * Accepted only for non-default {@link #location} (Miscellaneous panel is sorted alphabetically).

         */

        int position() default Integer.MAX_VALUE;

    }

    @SuppressWarnings("deprecation")

    @SuppressWarnings("deprecation")

    public Subcategory1() {}

    @SuppressWarnings("deprecation")

    public Subcategory2() {}

import org.netbeans.modules.php.project.ui.options.PhpOptionsPanelController;

import org.netbeans.modules.php.api.util.UiUtils;

@OptionsPanelController.SubRegistration(

    displayName="#LBL_GeneralOptions",

//    toolTip="#LBL_GeneralOptionsTooltip",

    id=PhpOptionsPanelController.ID,

    location=UiUtils.OPTIONS_PATH,

    position=100

)

    public static final String ID = "General";