You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@netbeans.apache.org by GitBox <gi...@apache.org> on 2018/01/11 08:32:09 UTC
[GitHub] vieiro closed pull request #6: Converting mediawiki files to AsciiDoc
vieiro closed pull request #6: Converting mediawiki files to AsciiDoc
URL: https://github.com/apache/incubator-netbeans-tools/pull/6
This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:
As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):
diff --git a/.gitignore b/.gitignore
index bb49592..be539e7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,6 @@
/wiki-export/dist/
/wiki-export/build/
/target/**
+/wiki-convert/target/
+*.swp
+*.swo
diff --git a/README.md b/README.md
index a61b254..cdba674 100644
--- a/README.md
+++ b/README.md
@@ -10,3 +10,5 @@ Repository of tools created and used by the Apache NetBeans community.
* [licensereviewsite](https://github.com/apache/incubator-netbeans-tools/tree/master/licensereviewsite): Tool consisting of a Maven plugin to generate report for crosschecking Jenkins / Confluence for external and licence. ([More details](https://github.com/apache/incubator-netbeans-tools/pull/2).)
* [wiki-export](https://github.com/apache/incubator-netbeans-tools/tree/master/wiki-export): Tool for extracting WikiText data from wiki.netbeans.org. ([More details](https://github.com/apache/incubator-netbeans-tools/pull/4).)
+
+ * [wiki-convert](https://github.com/apache/incubator-netbeans-tools/tree/master/wiki-convert): Tool for converting extracted WikiText data to AsciiDoc, suitable for using with the jBake static generator tool.
diff --git a/wiki-convert/nb-configuration.xml b/wiki-convert/nb-configuration.xml
new file mode 100644
index 0000000..e767c48
--- /dev/null
+++ b/wiki-convert/nb-configuration.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project-shared-configuration>
+ <!--
+This file contains additional configuration written by modules in the NetBeans IDE.
+The configuration is intended to be shared among all the users of project and
+therefore it is assumed to be part of version control checkout.
+Without this configuration present, some functionality in the IDE may be limited or fail altogether.
+-->
+ <properties xmlns="http://www.netbeans.org/ns/maven-properties-data/1">
+ <!--
+Properties that influence various parts of the IDE, especially code formatting and the like.
+You can copy and paste the single properties, into the pom.xml file and the IDE will pick them up.
+That way multiple projects can share the same settings (useful for formatting rules for example).
+Any value defined here will override the pom.xml file value but is only applicable to the current project.
+-->
+ <netbeans.hint.license>apache20</netbeans.hint.license>
+ </properties>
+</project-shared-configuration>
diff --git a/wiki-convert/nbactions.xml b/wiki-convert/nbactions.xml
new file mode 100644
index 0000000..832e4ea
--- /dev/null
+++ b/wiki-convert/nbactions.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<actions>
+ <action>
+ <actionName>run</actionName>
+ <packagings>
+ <packaging>jar</packaging>
+ </packagings>
+ <goals>
+ <goal>process-classes</goal>
+ <goal>org.codehaus.mojo:exec-maven-plugin:1.5.0:exec</goal>
+ </goals>
+ <properties>
+ <exec.args>-classpath %classpath wikimedia.html.conversion.Converter ../wiki-export/wiki-wikimedia wiki-html</exec.args>
+ <exec.executable>java</exec.executable>
+ <exec.workingdir>/home/antonio/WORK/REPOSITORIES/incubator-netbeans-tools/wiki-convert</exec.workingdir>
+ </properties>
+ </action>
+ <action>
+ <actionName>debug</actionName>
+ <packagings>
+ <packaging>jar</packaging>
+ </packagings>
+ <goals>
+ <goal>process-classes</goal>
+ <goal>org.codehaus.mojo:exec-maven-plugin:1.5.0:exec</goal>
+ </goals>
+ <properties>
+ <exec.args>-agentlib:jdwp=transport=dt_socket,server=n,address=${jpda.address} -classpath %classpath wikimedia.html.conversion.Converter ../wiki-export/wiki-wikimedia wiki-html</exec.args>
+ <exec.executable>java</exec.executable>
+ <jpda.listen>true</jpda.listen>
+ <exec.workingdir>/home/antonio/WORK/REPOSITORIES/incubator-netbeans-tools/wiki-convert</exec.workingdir>
+ </properties>
+ </action>
+ <action>
+ <actionName>profile</actionName>
+ <packagings>
+ <packaging>jar</packaging>
+ </packagings>
+ <goals>
+ <goal>process-classes</goal>
+ <goal>org.codehaus.mojo:exec-maven-plugin:1.5.0:exec</goal>
+ </goals>
+ <properties>
+ <exec.args>-classpath %classpath wikimedia.html.conversion.Converter ../wiki-export/wiki-wikimedia wiki-html</exec.args>
+ <exec.executable>java</exec.executable>
+ <exec.workingdir>/home/antonio/WORK/REPOSITORIES/incubator-netbeans-tools/wiki-convert</exec.workingdir>
+ </properties>
+ </action>
+ </actions>
diff --git a/wiki-convert/pom.xml b/wiki-convert/pom.xml
new file mode 100644
index 0000000..1fb87f8
--- /dev/null
+++ b/wiki-convert/pom.xml
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>com.mycompany</groupId>
+ <artifactId>wiki-convert</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>jar</packaging>
+ <properties>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <maven.compiler.source>1.8</maven.compiler.source>
+ <maven.compiler.target>1.8</maven.compiler.target>
+ </properties>
+
+ <dependencies>
+ <dependency>
+ <groupId>org.eclipse.mylyn.docs</groupId>
+ <artifactId>org.eclipse.mylyn.wikitext</artifactId>
+ <version>3.0.20</version>
+ </dependency>
+ <dependency>
+ <groupId>org.eclipse.mylyn.docs</groupId>
+ <artifactId>org.eclipse.mylyn.wikitext.mediawiki</artifactId>
+ <version>3.0.20</version>
+ </dependency>
+ <dependency>
+ <groupId>org.eclipse.mylyn.docs</groupId>
+ <artifactId>org.eclipse.mylyn.wikitext.asciidoc</artifactId>
+ <version>3.0.20</version>
+ </dependency>
+ <dependency>
+ <groupId>org.eclipse.mylyn.docs</groupId>
+ <artifactId>org.eclipse.mylyn.wikitext.markdown</artifactId>
+ <version>3.0.20</version>
+ </dependency>
+ </dependencies>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>exec-maven-plugin</artifactId>
+ <version>1.6.0</version>
+ <executions>
+ <execution>
+ <!-- mvn >= 3.3.1 mvn exec:java@asciidoc -->
+ <id>asciidoc</id>
+ <goals>
+ <goal>java</goal>
+ </goals>
+ <configuration>
+ <mainClass>wikimedia.html.conversion.Converter</mainClass>
+ <arguments>
+ <argument>asciidoc</argument>
+ <argument>../wiki-export/wiki-wikimedia</argument>
+ <argument>wiki-asciidoc</argument>
+ </arguments>
+ </configuration>
+ </execution>
+ <execution>
+ <!-- mvn >= 3.3.1 mvn exec:java@html -->
+ <id>html</id>
+ <goals>
+ <goal>java</goal>
+ </goals>
+ <configuration>
+ <mainClass>wikimedia.html.conversion.Converter</mainClass>
+ <arguments>
+ <argument>html</argument>
+ <argument>../wiki-export/wiki-wikimedia</argument>
+ <argument>wiki-html</argument>
+ </arguments>
+ </configuration>
+ </execution>
+ <execution>
+ <!-- mvn >= 3.3.1 mvn exec:java@github_markdown -->
+ <id>github_markdown</id>
+ <goals>
+ <goal>java</goal>
+ </goals>
+ <configuration>
+ <mainClass>wikimedia.html.conversion.Converter</mainClass>
+ <arguments>
+ <argument>github_markdown</argument>
+ <argument>../wiki-export/wiki-wikimedia</argument>
+ <argument>wiki-markdown</argument>
+ </arguments>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
\ No newline at end of file
diff --git a/wiki-convert/src/main/java/wikimedia/html/conversion/Converter.java b/wiki-convert/src/main/java/wikimedia/html/conversion/Converter.java
new file mode 100644
index 0000000..9ae0f19
--- /dev/null
+++ b/wiki-convert/src/main/java/wikimedia/html/conversion/Converter.java
@@ -0,0 +1,258 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+package wikimedia.html.conversion;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileFilter;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import javax.xml.parsers.DocumentBuilderFactory;
+import javax.xml.transform.Source;
+import javax.xml.transform.Transformer;
+import javax.xml.transform.TransformerConfigurationException;
+import javax.xml.transform.TransformerFactory;
+import javax.xml.transform.stream.StreamSource;
+import org.eclipse.mylyn.wikitext.mediawiki.MediaWikiLanguage;
+import org.eclipse.mylyn.wikitext.parser.MarkupParser;
+import org.eclipse.mylyn.wikitext.parser.builder.HtmlDocumentBuilder;
+
+/**
+ * Converts mediawiki files in a source directory to html files in a destination
+ * directory.
+ *
+ * @author Antonio Vieiro <vi...@apache.org>
+ */
+public class Converter {
+
+ private static enum FORMAT {
+ html,
+ asciidoc,
+ github_markdown;
+ }
+ private static final String APACHE_LICENSE_HEADER = ""
+ + "\n"
+ + " Licensed to the Apache Software Foundation (ASF) under one\n"
+ + " or more contributor license agreements. See the NOTICE file\n"
+ + " distributed with this work for additional information\n"
+ + " regarding copyright ownership. The ASF licenses this file\n"
+ + " to you under the Apache License, Version 2.0 (the\n"
+ + " \"License\"); you may not use this file except in compliance\n"
+ + " with the License. You may obtain a copy of the License at\n"
+ + "\n"
+ + " http://www.apache.org/licenses/LICENSE-2.0\n"
+ + "\n"
+ + " Unless required by applicable law or agreed to in writing,\n"
+ + " software distributed under the License is distributed on an\n"
+ + " \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n"
+ + " KIND, either express or implied. See the License for the\n"
+ + " specific language governing permissions and limitations\n"
+ + " under the License.\n\n";
+
+ private static final Logger LOG = Logger.getLogger(Converter.class.getName());
+ private static final FileFilter MEDIAWIKI_FILES = (file) -> {
+ return file.isFile() && file.getName().endsWith(".mediawiki");
+ };
+ private static Transformer transformer;
+ private static DocumentBuilderFactory documentBuilderFactory;
+
+ private static void convert(FORMAT format, File src, File dest) throws Exception {
+ LOG.log(Level.INFO, "Converting from {0} to {1}", new Object[]{src.getAbsolutePath(), dest.getAbsolutePath()});
+ File[] mediawiki_files = src.listFiles(MEDIAWIKI_FILES);
+ if (mediawiki_files == null || mediawiki_files.length == 0) {
+ LOG.log(Level.WARNING, "No *.mediawiki files found in {0}", src.getAbsolutePath());
+ } else {
+ MediaWikiLanguage mediaWikiLanguage = new MediaWikiLanguage();
+ int fileCount = 0;
+ for (File mediawiki : mediawiki_files) {
+ switch (format) {
+ case html:
+ File html = new File(dest, mediawiki.getName().replaceAll("\\.mediawiki", ".html"));
+ convertMediaWikiToHTML(mediaWikiLanguage, mediawiki, html);
+ break;
+ case asciidoc:
+ File asciidoc = new File(dest, mediawiki.getName().replaceAll("\\.mediawiki", ".asciidoc"));
+ convertMediaWikiToAsciidoc(mediaWikiLanguage, mediawiki, asciidoc);
+ break;
+ case github_markdown:
+ File github_markdown_file = new File(dest, mediawiki.getName().replaceAll("\\.mediawiki", ".md"));
+ convertMediaWikiToGithubMarkdown(mediaWikiLanguage, mediawiki, github_markdown_file);
+ break;
+ }
+ fileCount++;
+ }
+ LOG.log(Level.INFO, "Converted {0} files.", fileCount);
+ }
+ }
+
+ private static DocumentBuilderFactory getDocumentBuilderFactory() {
+ if (documentBuilderFactory == null) {
+ documentBuilderFactory = DocumentBuilderFactory.newInstance();
+ documentBuilderFactory.setNamespaceAware(true);
+ documentBuilderFactory.setValidating(false);
+ }
+ return documentBuilderFactory;
+ }
+
+ private Transformer getTransformer() throws TransformerConfigurationException {
+ if (transformer == null) {
+ TransformerFactory factory = TransformerFactory.newInstance();
+ Source xslt = new StreamSource(Converter.class.getResourceAsStream("xhtml2confluence.xsl"));
+ transformer = factory.newTransformer(xslt);
+ }
+ return transformer;
+ }
+
+ private static void convertMediaWikiToHTML(MediaWikiLanguage mediaWikiLanguage, File mediawikiFile, File htmlFile) throws Exception {
+ // Convert *.wikimedia to strict xhtml
+ try ( BufferedWriter output = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(htmlFile), "utf-8"), 16 * 1024); BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(mediawikiFile), "utf-8"))) {
+ LOG.log(Level.INFO, " {0} > {1}", new Object[]{mediawikiFile.getName(), htmlFile.getName()});
+ HtmlDocumentBuilder htmlBuilder = new HtmlDocumentBuilder(output);
+ htmlBuilder.setEmitAsDocument(true);
+ htmlBuilder.setXhtmlStrict(true);
+ htmlBuilder.setEncoding("utf-8");
+ htmlBuilder.setTitle(mediawikiFile.getName().replaceAll("\\.mediawiki", ""));
+ MarkupParser parser = new MarkupParser(mediaWikiLanguage, htmlBuilder);
+ parser.parse(reader);
+ }
+ }
+
+ private static String asciidocHeader = null;
+
+ private static String getAsciidocHeader() {
+ if (asciidocHeader == null) {
+ StringBuilder sb = new StringBuilder();
+ String [] lines = APACHE_LICENSE_HEADER.split("\n");
+ for (String line : lines) {
+ sb.append("// ").append(line).append("\n");
+ }
+ sb.append("//\n\n");
+ asciidocHeader = sb.toString();
+ }
+ return asciidocHeader;
+ }
+
+ private static ThreadLocal<SimpleDateFormat> sdf = null;
+
+ private static final synchronized SimpleDateFormat getSimpleDateFormat() {
+ if (sdf == null) {
+ SimpleDateFormat d = new SimpleDateFormat("yyyy-MM-dd");
+ sdf = new ThreadLocal<>();
+ sdf.set(d);
+ }
+ return sdf.get();
+ }
+
+ private static void convertMediaWikiToAsciidoc(MediaWikiLanguage mediaWikiLanguage, File mediawikiFile, File asciidoc) throws Exception {
+ // Convert *.wikimedia to asciidoc
+ try ( BufferedWriter output = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(asciidoc), "utf-8"), 16 * 1024); BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(mediawikiFile), "utf-8"))) {
+ output.write(getAsciidocHeader());
+ String title = mediawikiFile.getName().replace(".mediawiki", "");
+ output.write("= " + title + "\n");
+ output.write(":jbake-type: wiki\n");
+ output.write(":jbake-tags: wiki, devfaq, needsreview\n");
+ output.write(":jbake-status: published\n\n");
+ CustomAsciiDocDocumentBuilder asciidocBuilder = new CustomAsciiDocDocumentBuilder(output);
+ MarkupParser parser = new MarkupParser(mediaWikiLanguage, asciidocBuilder);
+ parser.parse(reader);
+ output.write("\n");
+ output.write("*NOTE:* This document was automatically converted to the AsciiDoc format on " + getSimpleDateFormat().format(new Date()) + ", and needs to be reviewed.\n");
+ }
+ }
+
+ private static void convertMediaWikiToGithubMarkdown(MediaWikiLanguage mediaWikiLanguage, File mediawikiFile, File markdownFile) throws Exception {
+ // Convert *.wikimedia to asciidoc
+ try ( BufferedWriter output = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(markdownFile), "utf-8"), 16 * 1024); BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(mediawikiFile), "utf-8"))) {
+ // LOG.log(Level.INFO, " {0} > {1}", new Object[]{mediawikiFile.getName(), markdownFile.getName()});
+ // JBAKE STUFF
+ boolean jbake = false;
+ if (jbake) {
+ String wikiPageName = markdownFile.getName().replace(".md", "");
+ output.write("title=" + wikiPageName + "\n");
+ output.write("type=wiki\n");
+ output.write("tags=wiki, devfaq\n");
+ output.write("status=published\n");
+ output.write("~~~~~~\n");
+ }
+ output.write("<!--\n");
+ output.write(APACHE_LICENSE_HEADER);
+ output.write("-->");
+ GithubMarkdownDocumentBuilder markdownBuilder = new GithubMarkdownDocumentBuilder(output);
+ MarkupParser parser = new MarkupParser(mediaWikiLanguage, markdownBuilder);
+ parser.parse(reader);
+ }
+ }
+
+ private static final void checkDirectory(File dir) throws Exception {
+ String error = null;
+ if (!dir.exists()) {
+ error = dir.getAbsolutePath() + " does not exist.";
+ }
+ if (error == null && !dir.isDirectory()) {
+ error = dir.getAbsolutePath() + " is not a directory.";
+ }
+ if (error == null && !dir.canRead()) {
+ error = dir.getAbsolutePath() + " is not readable.";
+ }
+ if (error != null) {
+ throw new IllegalArgumentException(error);
+ }
+ }
+
+ private static void usage() {
+ System.err.println("Use: java " + Converter.class.getName() + " format inputDirectory outputDirectory");
+ System.err.println(" where format is one of 'html', 'asciidoc' or 'github_markdown'");
+ System.exit(1);
+ }
+
+ public static void main(String[] args) throws Exception {
+ if (args.length != 3) {
+ usage();
+ }
+
+ FORMAT format = FORMAT.valueOf(args[0].trim());
+ if (format == null) {
+ usage();
+ }
+
+ File src = new File(args[1]);
+ checkDirectory(src);
+
+ File dest = new File(args[2]);
+ if (!dest.exists()) {
+ if (!dest.mkdirs()) {
+ throw new IllegalStateException("Cannot create directory " + dest.getAbsolutePath());
+ }
+ }
+ checkDirectory(dest);
+ if (!dest.canWrite()) {
+ throw new IllegalStateException("Cannot write to " + dest.getAbsolutePath());
+ }
+
+ convert(format, src, dest);
+ }
+
+}
diff --git a/wiki-convert/src/main/java/wikimedia/html/conversion/CustomAsciiDocDocumentBuilder.java b/wiki-convert/src/main/java/wikimedia/html/conversion/CustomAsciiDocDocumentBuilder.java
new file mode 100644
index 0000000..6481c65
--- /dev/null
+++ b/wiki-convert/src/main/java/wikimedia/html/conversion/CustomAsciiDocDocumentBuilder.java
@@ -0,0 +1,206 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+package wikimedia.html.conversion;
+
+import java.io.IOException;
+import java.io.StringWriter;
+import java.io.Writer;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import org.eclipse.mylyn.wikitext.asciidoc.internal.AsciiDocDocumentBuilder;
+import org.eclipse.mylyn.wikitext.parser.Attributes;
+import org.eclipse.mylyn.wikitext.parser.LinkAttributes;
+
+/**
+ * An AsciiDocDocumentBuilder that fixes some wiki-specific problems.
+ *
+ * @author Antonio Vieiro <vi...@apache.org>
+ */
+public class CustomAsciiDocDocumentBuilder extends AsciiDocDocumentBuilder {
+
+ class AsciiDocContentBlock extends NewlineDelimitedBlock {
+
+ protected String prefix;
+ protected String suffix;
+
+ AsciiDocContentBlock(BlockType blockType, String prefix, String suffix) {
+ this(blockType, prefix, suffix, 1, 1);
+ }
+
+ AsciiDocContentBlock(BlockType blockType, String prefix, String suffix, int leadingNewlines, int trailingNewlines) {
+ super(blockType, leadingNewlines, trailingNewlines);
+ this.prefix = prefix;
+ this.suffix = suffix;
+ }
+
+ AsciiDocContentBlock(String prefix, String suffix, int leadingNewlines, int trailingNewlines) {
+ this(null, prefix, suffix, leadingNewlines, trailingNewlines);
+ }
+
+ @Override
+ public void write(int c) throws IOException {
+ CustomAsciiDocDocumentBuilder.this.emitContent(c);
+ }
+
+ @Override
+ public void write(String s) throws IOException {
+ CustomAsciiDocDocumentBuilder.this.emitContent(s);
+ }
+
+ @Override
+ public void open() throws IOException {
+ super.open();
+ pushWriter(new StringWriter());
+ }
+
+ @Override
+ public void close() throws IOException {
+ Writer thisContent = popWriter();
+ String content = thisContent.toString();
+ if (content.length() > 0) {
+ emitContent(content);
+ }
+ super.close();
+ }
+
+ protected void emitContent(final String content) throws IOException {
+ CustomAsciiDocDocumentBuilder.this.emitContent(prefix);
+ CustomAsciiDocDocumentBuilder.this.emitContent(content);
+ CustomAsciiDocDocumentBuilder.this.emitContent(suffix);
+ }
+ }
+
+ private class LinkBlock extends AsciiDocContentBlock {
+
+ private final LinkAttributes attributes;
+
+ LinkBlock(LinkAttributes attributes) {
+ super("", "", 0, 0); //$NON-NLS-1$ //$NON-NLS-2$
+ this.attributes = attributes;
+ }
+
+ @Override
+ protected void emitContent(String content) throws IOException {
+ // link:http://url.com[label]
+ CustomAsciiDocDocumentBuilder.this.emitContent("link:"); //$NON-NLS-1$
+ String href = attributes.getHref();
+ if (href.startsWith("/wiki/")) {
+ href = href.substring(6) + ".html";
+ }
+ CustomAsciiDocDocumentBuilder.this.emitContent(href);
+ CustomAsciiDocDocumentBuilder.this.emitContent('[');
+ if (content != null) {
+ CustomAsciiDocDocumentBuilder.this.emitContent(content);
+ }
+ CustomAsciiDocDocumentBuilder.this.emitContent(']');
+ }
+
+ }
+
+ class AsciiDocPreformatted extends AsciiDocContentBlock {
+
+ private String language;
+
+ AsciiDocPreformatted(String language) {
+ super(BlockType.PREFORMATTED, "", "", 1, 1);
+ this.language = language;
+ }
+
+ @Override
+ protected void emitContent(String content) throws IOException {
+ if (language == null) {
+ /* No language specified, try to guess... */
+ if (content.indexOf("/>") != -1 || content.indexOf("</") != -1) {
+ language = "xml";
+ } else {
+ language = "java";
+ }
+ }
+ // [label](http://url.com) or
+ // [label](http://url.com "title")
+ CustomAsciiDocDocumentBuilder.this.emitContent("[source," + language + "]\n");
+ CustomAsciiDocDocumentBuilder.this.emitContent("----\n");
+ CustomAsciiDocDocumentBuilder.this.emitContent(content.startsWith("\n") ? content : "\n" + content);
+ CustomAsciiDocDocumentBuilder.this.emitContent("----\n");
+ }
+ }
+
+ public CustomAsciiDocDocumentBuilder(Writer out) {
+ super(out);
+ }
+
+ private static final String[][] MARKUP_FIXES = {
+ {"-----", ""},
+ {"<b>", "*"},
+ {"</b>", "*"},
+ {"<tt>", "`"},
+ {"</tt>", "`"},
+ {"<code>", "`"},
+ {"</code>", "`"},
+ };
+
+ @Override
+ protected void emitContent(String str) throws IOException {
+ for (String[] pairs : MARKUP_FIXES) {
+ if (str.indexOf(pairs[0]) != 1) {
+ str = str.replaceAll(pairs[0], pairs[1]);
+ }
+ }
+ super.emitContent(str);
+ }
+
+ @Override
+ protected Block computeSpan(SpanType type, Attributes attributes) {
+ switch (type) {
+ case LINK:
+ if (attributes instanceof LinkAttributes) {
+ return new LinkBlock((LinkAttributes) attributes);
+ }
+ return new AsciiDocContentBlock("", "", 0, 0); //$NON-NLS-1$ //$NON-NLS-2$
+ default:
+ return super.computeSpan(type, attributes);
+ }
+ }
+
+ @Override
+ protected Block
+ computeBlock(BlockType type, Attributes attributes) {
+ switch (type) {
+ case CODE:
+ case PREFORMATTED:
+ String language = null;
+
+ if (attributes.getCssClass() != null) {
+ if (attributes.getCssClass().equals("source-java")) {
+ language = "java";
+
+ } else if (attributes.getCssClass().equals("source-xml")) {
+ language = "xml";
+
+ } else if (attributes.getCssClass().equals("source-properties")) {
+ language = "yaml";
+
+ }
+ }
+ return new AsciiDocPreformatted(language);
+ default:
+ return super.computeBlock(type, attributes);
+ }
+ }
+}
diff --git a/wiki-convert/src/main/java/wikimedia/html/conversion/GithubMarkdownDocumentBuilder.java b/wiki-convert/src/main/java/wikimedia/html/conversion/GithubMarkdownDocumentBuilder.java
new file mode 100644
index 0000000..1df7344
--- /dev/null
+++ b/wiki-convert/src/main/java/wikimedia/html/conversion/GithubMarkdownDocumentBuilder.java
@@ -0,0 +1,322 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+package wikimedia.html.conversion;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+import java.io.IOException;
+import java.io.StringWriter;
+import java.io.Writer;
+import java.util.regex.Pattern;
+import org.eclipse.mylyn.wikitext.markdown.internal.MarkdownDocumentBuilder;
+import org.eclipse.mylyn.wikitext.parser.Attributes;
+import org.eclipse.mylyn.wikitext.parser.LinkAttributes;
+
+/**
+ * A MarkdownDocumentBuilder that properly handles some block types that the
+ * default Mylyn MarkdownDocumentBuilder just ignores. This is version specific,
+ * as mylyn documentation is very poor.
+ *
+ * @author Antonio Vieiro <vi...@apache.org>
+ */
+public class GithubMarkdownDocumentBuilder extends MarkdownDocumentBuilder {
+
+ private static final Pattern PATTERN_LINE_BREAK = Pattern.compile("(.*(\r\n|\r|\n)?)?");
+
+ private class GithubMarkdownBlock extends NewlineDelimitedBlock {
+
+ protected String prefix;
+ protected String suffix;
+
+ GithubMarkdownBlock(BlockType type, String prefix, String suffix) {
+ this(type, prefix, suffix, 1, 1);
+ }
+
+ GithubMarkdownBlock(String prefix, String suffix, int leadingNewlines, int trailingNewlines) {
+ this(null, prefix, suffix, leadingNewlines, trailingNewlines);
+ }
+
+ GithubMarkdownBlock(BlockType type, String prefix, String suffix, int beforeLineCount, int afterLineCount) {
+ super(type, beforeLineCount, afterLineCount);
+ this.prefix = prefix;
+ this.suffix = suffix;
+ }
+
+ @Override
+ public void write(int c) throws IOException {
+ GithubMarkdownDocumentBuilder.this.emitContent(c);
+ }
+
+ @Override
+ public void write(String s) throws IOException {
+ GithubMarkdownDocumentBuilder.this.emitContent(s);
+ }
+
+ @Override
+ public void open() throws IOException {
+ super.open();
+ pushWriter(new StringWriter());
+ }
+
+ @Override
+ public void close() throws IOException {
+ Writer thisContent = popWriter();
+ String content = thisContent.toString();
+ if (content.length() > 0) {
+ emitContent(content);
+ }
+ super.close();
+ }
+
+ protected void emitContent(final String content) throws IOException {
+ GithubMarkdownDocumentBuilder.this.emitContent(prefix);
+ GithubMarkdownDocumentBuilder.this.emitContent(content);
+ GithubMarkdownDocumentBuilder.this.emitContent(suffix);
+ }
+ }
+
+ private class GithubDefinitionListBlock extends GithubMarkdownBlock {
+
+ GithubDefinitionListBlock() {
+ super(BlockType.DEFINITION_LIST, "", "");
+ }
+ }
+
+ private class GithubDefinitionTermBlock extends GithubMarkdownBlock {
+
+ private GithubDefinitionTermBlock() {
+ super(BlockType.DEFINITION_TERM, "- ", " ", 1, 0);
+ }
+
+ }
+
+ private class GithubDefinitionItem extends GithubMarkdownBlock {
+
+ private GithubDefinitionItem() {
+ super(BlockType.DEFINITION_ITEM, "", "", 0, 1);
+ }
+ }
+
+ private class GithubTable extends GithubMarkdownBlock {
+
+ private int count = 0;
+
+ GithubTable(Attributes attributes) {
+ super(BlockType.TABLE, "", "");
+ }
+
+ protected void addRow(GithubTableRow row) {
+ checkNotNull(row);
+ count++;
+ }
+
+ protected int getCount() {
+ return count;
+ }
+
+ }
+
+ private class GithubTableRow extends GithubMarkdownBlock {
+
+ boolean header = false;
+ int cellCount = 0;
+
+ GithubTableRow(Attributes attributes) {
+ super(BlockType.TABLE_ROW, "", "");
+ }
+
+ void addCell(GithubTableCellHeader header) {
+ cellCount++;
+ }
+
+ void setHeader(boolean header) {
+ this.header = header;
+ }
+
+ @Override
+ protected void emitContent(String content) throws IOException {
+ super.emitContent(content + "|\n");
+ if (header) {
+ for (int i = 0; i < cellCount; i++) {
+ super.emitContent("|---");
+ }
+ super.emitContent("|\n");
+ }
+ }
+ }
+
+ private class GithubTableCellHeader extends GithubMarkdownBlock {
+
+ GithubTableCellHeader(Attributes attributes) {
+ super(BlockType.TABLE_CELL_HEADER, "|", "", 0, 0);
+ }
+
+ @Override
+ public void open() throws IOException {
+ super.open();
+ if (getPreviousBlock() instanceof GithubTableRow) {
+ GithubTableRow row = (GithubTableRow) getPreviousBlock();
+ row.setHeader(true);
+ row.addCell(this);
+ }
+ }
+ }
+
+ private class GithubTableCellNormal extends GithubMarkdownBlock {
+
+ GithubTableCellNormal(Attributes attributes) {
+ super(BlockType.TABLE_CELL_NORMAL, "|", "", 0, 0);
+ }
+
+ }
+
+ private class GithubPreformattedContentBlock extends GithubMarkdownBlock {
+
+ private String language;
+
+ GithubPreformattedContentBlock(String language) {
+ super(BlockType.PREFORMATTED, "", ""); //```" + (language == null ? "" : " " + language) + "\n", "```");
+ this.language = language;
+ }
+
+ @Override
+ protected void emitContent(String content) throws IOException {
+ if (language == null) {
+ /* No language specified, try to guess... */
+ if (content.indexOf("/>") != -1 || content.indexOf("</") != -1) {
+ language = "xml";
+ } else {
+ language = "java";
+ }
+ }
+
+ // [label](http://url.com) or
+ // [label](http://url.com "title")
+ GithubMarkdownDocumentBuilder.this.emitContent("``` " + language);
+ GithubMarkdownDocumentBuilder.this.emitContent(content.startsWith("\n") ? content : "\n" + content);
+ GithubMarkdownDocumentBuilder.this.emitContent("\n```");
+ }
+ }
+
+ private class LinkBlock extends GithubMarkdownBlock {
+
+ private final LinkAttributes attributes;
+
+ LinkBlock(LinkAttributes attributes) {
+ super("", "", 0, 0);
+ this.attributes = attributes;
+ }
+
+ @Override
+ protected void emitContent(String content) throws IOException {
+ // [label](http://url.com) or
+ // [label](http://url.com "title")
+ GithubMarkdownDocumentBuilder.this.emitContent('[');
+ GithubMarkdownDocumentBuilder.this.emitContent(content);
+ GithubMarkdownDocumentBuilder.this.emitContent(']');
+
+ GithubMarkdownDocumentBuilder.this.emitContent('(');
+ if (attributes.getHref() != null && !attributes.getHref().startsWith("/wiki/")) {
+ GithubMarkdownDocumentBuilder.this.emitContent(attributes.getHref());
+ }
+ String title = attributes.getTitle();
+ if (title != null && !title.equals("")) {
+ String capitalized = Character.toUpperCase(title.charAt(0)) + title.substring(1);
+ GithubMarkdownDocumentBuilder.this.emitContent(capitalized + ".html");
+ }
+ GithubMarkdownDocumentBuilder.this.emitContent(')');
+ }
+
+ }
+
+ public GithubMarkdownDocumentBuilder(Writer out) {
+ super(out);
+ }
+
+ private static final String[][] MARKUP_FIXES = {
+ {"<b>", "**"},
+ {"</b>", "**"},
+ {"<tt>", "`"},
+ {"</tt>", "`"},};
+
+ @Override
+ protected void emitContent(String str) throws IOException {
+ for (String[] pairs : MARKUP_FIXES) {
+ if (str.indexOf(pairs[0]) != 1) {
+ str = str.replaceAll(pairs[0], pairs[1]);
+ }
+ }
+ super.emitContent(str);
+ }
+
+ @Override
+ protected Block computeSpan(SpanType type, Attributes attributes) {
+ switch (type) {
+ case LINK:
+ if (attributes instanceof LinkAttributes) {
+ return new LinkBlock((LinkAttributes) attributes);
+ }
+ return new GithubMarkdownBlock("<", ">", 0, 0); //$NON-NLS-1$ //$NON-NLS-2$
+ default:
+ return super.computeSpan(type, attributes);
+ }
+ }
+
+ @Override
+ protected Block computeBlock(BlockType type, Attributes attributes
+ ) {
+ switch (type) {
+
+ case PARAGRAPH:
+ case QUOTE:
+ case BULLETED_LIST:
+ case NUMERIC_LIST:
+ case LIST_ITEM:
+ case CODE:
+ return super.computeBlock(type, attributes);
+ case PREFORMATTED:
+ String language = null;
+ if (attributes.getCssClass() != null) {
+ if (attributes.getCssClass().equals("source-java")) {
+ language = "java";
+ } else if (attributes.getCssClass().equals("source-xml")) {
+ language = "xml";
+ } else if (attributes.getCssClass().equals("source-properties")) {
+ language = "yaml";
+ }
+ }
+ return new GithubPreformattedContentBlock(language);
+ case DEFINITION_LIST:
+ return new GithubDefinitionListBlock();
+ case DEFINITION_TERM:
+ return new GithubDefinitionTermBlock();
+ case DEFINITION_ITEM:
+ return new GithubDefinitionItem();
+ case TABLE:
+ return new GithubTable(attributes);
+ case TABLE_ROW:
+ return new GithubTableRow(attributes);
+ case TABLE_CELL_HEADER:
+ return new GithubTableCellHeader(attributes);
+ case TABLE_CELL_NORMAL:
+ return new GithubTableCellNormal(attributes);
+ default:
+ throw new IllegalStateException("Unexpected block type: " + type.name() + ":" + type);
+ }
+ }
+}
diff --git a/wiki-convert/wiki-asciidoc/Autoload.asciidoc b/wiki-convert/wiki-asciidoc/Autoload.asciidoc
new file mode 100644
index 0000000..0e122ed
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/Autoload.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= Autoload
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+The link:autoload.html[autoload] in the link:NetBeans.html[NetBeans] module system world means that certain module is turned on when _needed_. In contrast to regular modules which require some manual action (user locating a module and activating it) to turn them on, the link:autoload.html[autoload] modules are opaque for users and managed solely by the infrastructure. As soon as there is some module needing (by dependency or require/needs token) an link:autoload.html[autoload] module, the infrastructure enables it.
+
+In the link:Netigso.html[OSGi] mode, the meaning of link:autoload.html[autoload] remains as close as the original meaning. The bundle JAR is registered to the underlaying link:OSGi.html[OSGi] framework, but it is not _started_ until there is some NetBeans module which would depend on the bundle. If there is no such link:NetBeans.html[NetBeans] module, the link:OSGi.html[OSGi] bundle remains in _installed_ state (or _resolved_?).
+
+The link:autoload.html[autoload] mode is most suitable for link:OSGi.html[OSGi] bundles which shall be left in the full control of the link:OSGi.html[OSGi] container. For example there can be other link:OSGi.html[OSGi] bundles which may later _start_ such bundles. Such enablement is outside of control of the link:NetBeans.html[NetBeans] module system and is temporary (on subsequent launch of the system the module remains link:autoload.html[autoload]).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/Autoload[http://wiki.netbeans.org/Autoload] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-16T09:32:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/BrandingAboutDialog.asciidoc b/wiki-convert/wiki-asciidoc/BrandingAboutDialog.asciidoc
new file mode 100644
index 0000000..9dfb27c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/BrandingAboutDialog.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= BrandingAboutDialog
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Branding About Dialog
+
+Read the thread link:http://thread.gmane.org/gmane.comp.java.netbeans.modules.openide.devel/31632/focus=31642[Branding Help -> About]
+and see also link:http://blogs.kiyut.com/tonny/2007/10/18/customize-netbeans-platform-splash-screen-and-about-dialog/[Splash Screen and About Dialog Branding blog entry]
+
+Note: for LBL_Copyright, the email thread mentions modifying:
+
+[source,java]
+----
+
+ branding/core/core.jar/org/netbeans/core/startup/Bundle.properties
+----
+
+The second link shows the correct location:
+
+[source,java]
+----
+
+ branding/modules/org-netbeans-core.jar/org/netbeans/core/ui/Bundle.properties
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/BrandingAboutDialog[http://wiki.netbeans.org/BrandingAboutDialog] ,
+that was last modified by NetBeans user Tomwheeler
+on 2011-05-20T14:52:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/BrandingUpdaterSplash.asciidoc b/wiki-convert/wiki-asciidoc/BrandingUpdaterSplash.asciidoc
new file mode 100644
index 0000000..981259c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/BrandingUpdaterSplash.asciidoc
@@ -0,0 +1,92 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= BrandingUpdaterSplash
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Branding Updater Splash
+
+Contributed By; link:TonnyKohar.html[Tonny Kohar]
+
+
+Adapted from: link:http://blogs.kiyut.com/tonny/2007/11/19/netbeans-platform-branding-updaterjar/[http://blogs.kiyut.com/tonny/2007/11/19/netbeans-platform-branding-updaterjar/]
+<hr/>
+
+Another series of Netbeans Platform branding, but this time is branding the updater.jar. Updater.jar is used by Netbeans Platform during modules updates and update tracking and work in conjunction with Auto Update Services.
+
+After the branding of link:http://blogs.kiyut.com/tonny/2007/10/18/customize-netbeans-platform-splash-screen-and-about-dialog/[Splash Screen and About Dialog], you can also branding the updater splash image. This image will be shown by Netbeans Platform during module update and require a restart.
+
+image:branding-updater-custom_BrandingUpdaterSplash.png[]
+
+*note:* this is tested on Netbeans 6 RC1
+
+=== Customize the Updater Splash Screen
+
+In the project suite (under File, not project) expand the branding folder as show in the image.
+If the folder branding/modules/ext/updater.jar does not exist, just create it, it is just a normal folder structure.
+
+Note: updater.jar is not a jar file, it is a folder name
+
+image:branding-updater-folder_BrandingUpdaterSplash.png[]
+
+Add the following in the Bundle.properties
+
+[source,java]
+----
+
+UpdaterFrame.TextBackground_R=0
+UpdaterFrame.TextBackground_G=0
+UpdaterFrame.TextBackground_B=0
+
+UpdaterFrame.TextForeground_R=255
+UpdaterFrame.TextForeground_G=255
+UpdaterFrame.TextForeground_B=255
+
+UpdaterFrame.Background_R=0
+UpdaterFrame.Background_G=0
+UpdaterFrame.Background_B=0
+
+UpdaterFrame.outerColor_R=28
+UpdaterFrame.outerColor_G=43
+UpdaterFrame.outerColor_B=29
+
+UpdaterFrame.centerColor_R=85
+UpdaterFrame.centerColor_G=73
+UpdaterFrame.centerColor_B=16
+
+UpdaterFrame.isGradient=false
+----
+
+The above bundles properties values are example only, you may need to change it to reflects your own branding color scheme.
+
+Then create any image file that you like to be a replacement for the default splash. In Netbeans 6 RC1, there is no size limit or constraints for the updater splash image, although I use the size of 400?191. However, it must be named *updatersplash.gif*
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/BrandingUpdaterSplash[http://wiki.netbeans.org/BrandingUpdaterSplash] ,
+that was last modified by NetBeans user Mithun gonsalvez
+on 2011-08-19T06:41:46Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/CustomPanelDialog.png b/wiki-convert/wiki-asciidoc/CustomPanelDialog.png
new file mode 100644
index 0000000..2ecad4a
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/CustomPanelDialog.png differ
diff --git a/wiki-convert/wiki-asciidoc/DefFaqMapApisToTasks.asciidoc b/wiki-convert/wiki-asciidoc/DefFaqMapApisToTasks.asciidoc
new file mode 100644
index 0000000..ac7a19f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DefFaqMapApisToTasks.asciidoc
@@ -0,0 +1,97 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DefFaqMapApisToTasks
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== What API do I use for ...
+
+Here is a list of common things people need to do, and a very short description of how you do them. From here, use the Javadoc and tutorials to get more information.
+
+== I want to ...
+
+=== Show my component in the main window
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/overview-summary.html[Window System API]. You will want to create a subclass of link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html[TopComponent], a JPanel-like class, and call its `open()` method to show it.
+
+=== Write to the output window
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-io/overview-summary.html[I/O API]. Call `IOProvider.getDefault().getInputOutput("Something")`. The object returned has getters for standard output, standard error and input streams which write to and read from a tab in the output window.
+
+=== Show a Tree, List or other control with a list of some objects
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/overview-summary.html[Nodes API] to create a hierarchy of link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/Node.html[Node] objects, each representing one object in your data model. Then use the link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/overview-summary.html[Explorer API] to show the Nodes - it contains tree, list, table, combo box and other controls which can show a hierarchy of Nodes. Nodes are very easy to add popup menus to, decorate with icons and html-ized display names, etc. and are a lot less work than using Swing components directly. See also the link:http://platform.netbeans.org/tutorials/nbm-nodesapi2.html[Nodes API Tutorial].
+
+=== Provide an Editor for a particular kind of file
+
+Use the new File Type template. You will end up using the link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/overview-summary.html[Data Systems API] (DataObject, DataLoader, etc.) and link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/overview-summary.html[Nodes API] primarily, plus the link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/overview-summary.html[Filesystems API] for accessing and parsing the file. The link:http://bits.netbeans.org/dev/javadoc/org-openide-text/overview-summary.html[Text API] provides general support for creating editors for files.
+
+=== Add a menu item to the main menu
+
+No specific NetBeans APIs are needed - you can just create a subclass of Swing's `AbstractAction`, and link:DevFaqActionAddMenuBar.html[register it in your modules layer.xml file]. Or, use the new Action template in the IDE to generate a subclass of `SystemAction` for you and all the registration code, and fill in the action-performing logic.
+
+=== Show content in the Navigator window when a file of a certain type is selected
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-spi-navigator/overview-summary.html[Navigator API] to create a navigator panel provider; you then somehow parse the file and can create any component you want to show in the Navigator, and populate it with whatever you want.
+
+=== Show a progress bar
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-api-progress/overview-summary.html[Progress API] - call `ProgressHandleFactory` to create a `ProgressHandle` for you. That is an object with methods for setting the progress, status text, number of steps, etc. and is fairly self-explanatory. Remember to make sure the code showing progress is not running in the AWT Event thread.
+
+=== Set the main window's statusbar text
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/overview-summary.html[UI Utilities API]. Simply call `StatusDisplayer.getDefault().setStatusText()`.
+
+=== Allow other modules to register objects and then find those objects dynamically at runtime
+
+Define a folder in the link:DevFaqSystemFilesystem.html[System Filesystem] in the XML layer file of your module. Other modules can register instances of whatever class you specify by declaring `.instance` files in their own XML layer files. You can find them at runtime using `Lookups.forPath("path/to/my/folder")` to get an instance of link:DevFaqLookup.html[Lookup] that you can query for these objects.
+
+=== Save some settings persistently
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-util/overview-summary.html[Utilities API], specifically link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbPreferences.html[NbPreferences] - which is just an implementation of the JDK's Preferences API which stores things in the user's settings directory rather than globally. It's just like using standard JDK Preferences.
+
+=== Run some code at application startup/shutdown
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/overview-summary.html[Module System API]. Implement a subclass of link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html[ModuleInstall] and override `restored()`, `close()`, etc. Remember it is best to avoid running code on startup unless you really need to.
+
+=== Add a Panel to the Options dialog
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/overview-summary.html[Options API], implementing link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsCategory.html[OptionsCategory] to define the category in the dialog and link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.html[OptionsPanelController] to manage the UI component.
+
+=== Find/listen to/manipulate the set of open projects
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/overview-summary.html[Project UI API], specifically link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/api/project/ui/OpenProjects.html[OpenProjects].
+
+=== Create a graph editor such as the Mobility Pack uses
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/overview-summary.html[Visual Library], which builds on top of Swing to make animated, graph-oriented UIs easy to build. More info, tutorials and webcasts can be found in the link:http://platform.netbeans.org/graph[platform.netbeans.org/graph] project.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DefFaqMapApisToTasks[http://wiki.netbeans.org/DefFaqMapApisToTasks] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-13T23:52:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaq2SrcPaths.asciidoc b/wiki-convert/wiki-asciidoc/DevFaq2SrcPaths.asciidoc
new file mode 100644
index 0000000..ef0462c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaq2SrcPaths.asciidoc
@@ -0,0 +1,70 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaq2SrcPaths
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I have two source directories within one module?
+
+Adding an extra source directories is possible in case you need to create a separate output JARs (besides the module itself), generally with its own special classpath.
+
+In your module's `project.xml`, add a declaration of the source root just before `</data>`:
+
+[source,xml]
+----
+
+<extra-compilation-unit>
+ <package-root>othersrc</package-root>
+ <classpath>...anything it might need to compile against...</classpath>
+ <built-to>build/otherclasses</built-to>
+ <built-to>${cluster}/modules/ext/other.jar</built-to>
+</extra-compilation-unit>
+----
+
+This declaration has no effect on the build, but lets you work with the sources in the IDE's code editor.
+
+You will separately need to add a target to your `build.xml` to compile and package these sources however you like.
+(You can name your target `netbeans-extra` and it will get run automatically toward the end of the module's build cycle.)
+If you define properties like a special classpath in `project.properties`,
+you can use the values in both `build.xml` and `project.xml` to minimize duplication.
+
+You can also create a plain Java SE project in a subdirectory of your module
+and bundle its JAR. link:DevFaqWrapperModules.html[DevFaqWrapperModules] describes a related technique.
+
+Read the `harness/README` file under your Netbeans installation directory
+for information about issues like this one.
+The build harness has many capabilities not exposed through the GUI.
+
+--
+Applies to: NetBeans IDE 6.x
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaq2SrcPaths[http://wiki.netbeans.org/DevFaq2SrcPaths] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:33:06Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesUsingMercurial.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesUsingMercurial.asciidoc
new file mode 100644
index 0000000..a837ba1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesUsingMercurial.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAccessSourcesUsingMercurial
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get access to NetBeans sources using Mercurial (hg)?
+
+First, make sure you have link:http://www.selenic.com/mercurial/[Mercurial] installed on your machine, along with its requirements such as Python.
+
+Then, from the command line, you run
+
+[source,java]
+----
+
+hg clone http://hg.netbeans.org/main/
+cd main
+----
+
+to get the full Platform and IDE sources. If you also want the `contrib/` modules:
+
+[source,java]
+----
+
+hg clone http://hg.netbeans.org/main/contrib/
+----
+
+To build, simply run `ant`.
+The build will appear in `nbbuild/netbeans/`.
+
+link:HgHowTos.html[More info about using Mercurial with NetBeans sources...]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAccessSourcesUsingMercurial[http://wiki.netbeans.org/DevFaqAccessSourcesUsingMercurial] ,
+that was last modified by NetBeans user Jglick
+on 2009-11-12T22:37:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesWeb.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesWeb.asciidoc
new file mode 100644
index 0000000..9d884ee
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAccessSourcesWeb.asciidoc
@@ -0,0 +1,62 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAccessSourcesWeb
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get access to zipped NetBeans sources for a periodic build?
+
+(as of June, 2010)
+
+1. Go to the nightly build download site:
+
+[source,java]
+----
+
+ link:http://bits.netbeans.org/dev/nightly/[http://bits.netbeans.org/dev/nightly/]
+----
+
+2. Click the link for the build you want.
+
+3. You will be shown an index page where you can find a link to the folder with ZIP archives of binary builds and sources.
+
+4. Click the link or add "zip/" to the end of the URL in your browser's address bar manually and hit enter. In other words, the complete URL might look like this:
+
+[source,java]
+----
+
+ link:http://bits.netbeans.org/dev/nightly/2010-06-11_00-01-15/zip/[http://bits.netbeans.org/dev/nightly/2010-06-11_00-01-15/zip/]
+----
+
+5. There are about a dozen links on that page. The one you want begins with "netbeans-trunk-nightly" and ends with "-src.zip" Click
+that link to download the source archive.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAccessSourcesWeb[http://wiki.netbeans.org/DevFaqAccessSourcesWeb] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2010-06-11T14:32:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddAnyFolder.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddAnyFolder.asciidoc
new file mode 100644
index 0000000..7966ca7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddAnyFolder.asciidoc
@@ -0,0 +1,69 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddAnyFolder
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I add actions to all folder nodes?
+
+Register to *Loaders/folder/any/Actions*
+
+
+Example:
+
+[source,java]
+----
+
+@ActionID(
+ category = "Build",
+ id = "com.foo.bar.OnAnyFolderAction")
+@ActionRegistration(
+ displayName = "#CTL_OnAnyFolderAction")
+@ActionReferences({
+ @ActionReference(path = "Loaders/folder/any/Actions", position = 0)
+})
+@Messages("CTL_OnAnyFolderAction=ActionOnAnyFolder")
+public final class OnAnyFolderAction implements ActionListener {
+
+ private final DataFolder context;
+
+ public OnAnyFolderAction(DataFolder context) {
+ this.context = context;
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent ev) {
+ JOptionPane.showMessageDialog(null, context.toString());
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddAnyFolder[http://wiki.netbeans.org/DevFaqActionAddAnyFolder] ,
+that was last modified by NetBeans user Markiewb
+on 2013-07-07T19:41:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddDataObject.asciidoc
new file mode 100644
index 0000000..8b09555
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddDataObject.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to my custom node type ?
+
+Override the `public Actionlink:_.html[ ] getActions(boolean context)` method of your node (99% of the time you can ignore the boolean parameter).
+
+If this node is really a `DataNode` for your own file type, instead see
+link:DevFaqActionAddFileMime.html[DevFaqActionAddFileMime].
+
+=== See also:
+
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder?]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu?]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the NetBeans menu bar?]
+* link:DevFaqActionAddToolBar.html[How do I add an action to the NetBeans tool bar?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddDataObject[http://wiki.netbeans.org/DevFaqActionAddDataObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:33:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddEditorPopup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddEditorPopup.asciidoc
new file mode 100644
index 0000000..9c7f777
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddEditorPopup.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddEditorPopup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to a the popup menu of the Java editor?
+
+The simplest way is to run New Action Wizard (File > New... > Module Development > Action) which creates an action for you and registers it in your `layer.xml`.
+
+1. On the first tab, choose *Conditionally Enabled* action and select `EditorCookie` as the cookie class.
+2. On the second tab, check *Editor Context Menu Item* and choose MIME type (`text/x-java` in this case) and position.
+
+OR
+use
+
+[source,java]
+----
+
+@ActionReference(path="Editors/text/x-java/Popup")
+----
+
+ for an action with the `EditorCookie` as context object
+<hr/>
+
+=== See also:
+
+* link:DevFaqActionAddToContextMenuOfAllEditors.html[How do I add an action to the context menu of all editors?]
+* link:DevFaqActionAddFileMime.html[How do I add an action to a file of a given mime-type? ]
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder? ]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu? ]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the NetBeans menu bar? ]
+* link:DevFaqActionAddToolBar.html[How do I add an action to the NetBeans tool bar? ]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node? ]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddEditorPopup[http://wiki.netbeans.org/DevFaqActionAddEditorPopup] ,
+that was last modified by NetBeans user Markiewb
+on 2014-12-31T11:45:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddFileMime.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddFileMime.asciidoc
new file mode 100644
index 0000000..ac60d43
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddFileMime.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddFileMime
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to a file of a given mime-type?
+
+The simplest way is to run *File* > *New...* > *Module Development* > *Action* which creates an action for you and registers it in your `layer.xml`.
+
+1. On the first tab, choose *Conditionally Enabled* action and select `DataObject` as the cookie class.
+2. On the second tab, check *File Type Context Menu Item* and choose the MIME type and position.
+
+You can use `text/html`, `text/x-java`, `text/x-ant+xml`, `text/x-jsp`, `image/png`, etc.
+
+=== See also:
+
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder?]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu?]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the NetBeans menu bar?]
+* link:DevFaqActionAddToolBar.html[How do I add an action to the NetBeans tool bar?]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddFileMime[http://wiki.netbeans.org/DevFaqActionAddFileMime] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:10:43Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddFolder.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddFolder.asciidoc
new file mode 100644
index 0000000..f0c22ba
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddFolder.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddFolder
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to a folder?
+
+Use @ActionReference.
+
+=== See also:
+
+* link:DevFaqActionAddFileMime.html[How do I add an action to a file of a given mime-type?]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu?]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the NetBeans menu bar?]
+* link:DevFaqActionAddToolBar.html[How do I add an action to the NetBeans tool bar?]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddFolder[http://wiki.netbeans.org/DevFaqActionAddFolder] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:15:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddJavaPackage.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddJavaPackage.asciidoc
new file mode 100644
index 0000000..713d721
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddJavaPackage.asciidoc
@@ -0,0 +1,69 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddJavaPackage
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I to add actions to the Java package node?
+
+Register to *Projects/package/Actions*
+
+
+Example:
+
+[source,java]
+----
+
+@ActionID(
+ category = "Build",
+ id = "com.foo.bar.OnJavaPackageAction")
+@ActionRegistration(
+ displayName = "#CTL_OnJavaPackageAction")
+@ActionReferences({
+ @ActionReference(path = "Projects/package/Actions", position = 0)
+})
+@Messages("CTL_OnJavaPackageAction=OnJavaPackageAction")
+public final class OnJavaPackageAction implements ActionListener {
+
+ private final DataFolder context;
+
+ public OnJavaPackageAction(DataFolder context) {
+ this.context = context;
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent ev) {
+ JOptionPane.showMessageDialog(null, context.toString());
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddJavaPackage[http://wiki.netbeans.org/DevFaqActionAddJavaPackage] ,
+that was last modified by NetBeans user Markiewb
+on 2013-07-07T19:43:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddMenuBar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddMenuBar.asciidoc
new file mode 100644
index 0000000..13c8d5e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddMenuBar.asciidoc
@@ -0,0 +1,48 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddMenuBar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to the menu bar?
+
+The simplest way is to run New Action Wizard (File > New... > Module Development > Action) which creates an action for you and registers it in your layer.xml file.
+
+=== See also:
+
+* link:DevFaqActionsFolder.html[An example how to register action manually ]
+* link:DevFaqActionAddFileMime.html[How do I add an action to a file of a given mime-type? ]
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder? ]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu? ]
+* link:DevFaqActionAddToolBar.html[How do I add an action to the NetBeans tool bar? ]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node? ]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddMenuBar[http://wiki.netbeans.org/DevFaqActionAddMenuBar] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:34:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizer.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizer.asciidoc
new file mode 100644
index 0000000..c495400
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizer.asciidoc
@@ -0,0 +1,60 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddProjectCustomizer
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add a new panel to a Project Properties dialog?
+
+Create and register the panel (here for Java SE projects):
+
+[source,java]
+----
+
+@ProjectCustomizer.CompositeCategoryProvider.Registration(
+ projectType="org-netbeans-modules-java-j2seproject")
+public class BlaPanelProvider implements ProjectCustomizer.CompositeCategoryProvider {
+ public @Override Category createCategory(Lookup context) {
+ return ProjectCustomizer.Category.create(
+ "Bla",
+ "Bla",
+ null,
+ null);
+ }
+ public @Override JComponent createComponent(Category category, Lookup context) {
+ return new BlaPanel();
+ }
+}
+----
+
+See also link:http://blogs.sun.com/gridbag/entry/project_properties_gui_for_custom[Project Properties GUI for custom project templates] and link:http://netbeans.dzone.com/new-tabs-netbeans-project-props[Adding New Tabs to the Project Properties Dialog in NetBeans IDE].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddProjectCustomizer[http://wiki.netbeans.org/DevFaqActionAddProjectCustomizer] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T23:00:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizerToMultipleTypes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizerToMultipleTypes.asciidoc
new file mode 100644
index 0000000..78b4917
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectCustomizerToMultipleTypes.asciidoc
@@ -0,0 +1,60 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddProjectCustomizerToMultipleTypes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I register a "ProjectCustomizer" to multiple project types?
+
+Use the *@Registrations* annotation to group the multiple *@Registration* annotations.
+
+For example
+
+[source,java]
+----
+
+@ProjectCustomizer.CompositeCategoryProvider.Registrations({
+ @ProjectCustomizer.CompositeCategoryProvider.Registration(projectType = "org-netbeans-modules-java-j2seproject"),
+ @ProjectCustomizer.CompositeCategoryProvider.Registration(projectType = "org-netbeans-modules-web-project"),
+ @ProjectCustomizer.CompositeCategoryProvider.Registration(projectType = "org-netbeans-modules-maven")
+})
+public class MyPluginPanelProvider implements ProjectCustomizer.CompositeCategoryProvider {
+//...
+}
+----
+
+--
+Applies to: NetBeans IDE 7.x
+Platforms: All
+
+See link:http://platform.netbeans.org/tutorials/nbm-projecttype.html#projectcustomizer[http://platform.netbeans.org/tutorials/nbm-projecttype.html#projectcustomizer]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddProjectCustomizerToMultipleTypes[http://wiki.netbeans.org/DevFaqActionAddProjectCustomizerToMultipleTypes] ,
+that was last modified by NetBeans user Markiewb
+on 2012-10-07T13:56:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectOwnTypePopUp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectOwnTypePopUp.asciidoc
new file mode 100644
index 0000000..fe7fb1c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectOwnTypePopUp.asciidoc
@@ -0,0 +1,99 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddProjectOwnTypePopUp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I add an action to a project node's popup menu of my own project type?
+
+* To add the Copy/Delete/Move/Rename action to your project's node, you should:
+1. Implement the corresponding interface such as `org.netbeans.spi.project.CopyOperationImplementation`.
+2. Implement `org.netbeans.spi.project.ActionProvider`:
+[source,java]
+----
+
+public final class AddActionActions implements ActionProvider {
+ private final AddActionProject project; //suppose this is your project
+ public AddActionActions(AddActionProject project) {
+ this.project = project;
+ }
+ public String[] getSupportedActions() {
+ return new String[] {
+ ActionProvider.COMMAND_COPY
+ };
+ }
+ public boolean isActionEnabled(String command, Lookup context) {
+ if (command.equals(ActionProvider.COMMAND_COPY)) {
+ return true;
+ } else {
+ throw new IllegalArgumentException(command);
+ }
+ }
+ public void invokeAction(String command, Lookup context) {
+ if (command.equalsIgnoreCase(ActionProvider.COMMAND_COPY)){
+ DefaultProjectOperations.performDefaultCopyOperation(project);
+ }
+ }
+}
+
+----
+
+1. 1. Add these implementations to your project's lookup:
+[source,java]
+----
+
+lookup = Lookups.fixed(
+ // ... as before
+ new AddActionOperation(this),
+ new AddActionActions(this),
+);
+
+----
+
+1. 1. Register the actions into the project node's context menu:
+[source,xml]
+----
+
+public @Override Action[] getActions(boolean context) {
+ Action[[ | ]] nodeActions = new Action[2];
+ nodeActions[0] = CommonProjectActions.copyProjectAction();
+ nodeActions[1] = CommonProjectActions.closeProjectAction();
+ return nodeActions;
+}
+
+----
+
+* To add the other actions specified in the Project API such as `closeProjectAction`, just add it to the list of actions of your node.
+* To add an action you created yourself, just add it to the list of actions of your node.
+
+See also: link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/support/CommonProjectActions.html[Common Project Actions]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddProjectOwnTypePopUp[http://wiki.netbeans.org/DevFaqActionAddProjectOwnTypePopUp] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:31:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectPopUp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectPopUp.asciidoc
new file mode 100644
index 0000000..ffcbb7c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectPopUp.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddProjectPopUp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to a project popup menu?
+
+Just use `@ActionReference(path="Projects/Actions")`. The action should take a context parameter in its constructor.
+
+See also link:DevFaqActionAddProjectTypePopUp.html[How do I add an action to a project popup menu of a specific project type?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddProjectPopUp[http://wiki.netbeans.org/DevFaqActionAddProjectPopUp] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:12:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectTypePopUp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectTypePopUp.asciidoc
new file mode 100644
index 0000000..47b2f0f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddProjectTypePopUp.asciidoc
@@ -0,0 +1,90 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddProjectTypePopUp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to a project popup menu of a specific project type?
+
+==== Generic approach
+
+You can install an action into the context menu of _all_ projects simply by adding to your layer under the folder `Projects/Actions/`. Your action should be context-sensitive, meaning it should be a placeholder which implements `ContextAwareAction`; the context-aware derived action will do the real work. Generally it will look for an instance of `Project` in the supplied `Lookup` (context).
+
+If you just override `isEnabled` on the derived action based on the context, the menu item will always be present, though it will be greyed out in the case of inappropriate projects. If you want to _hide_ the menu item for all but relevant projects, you need to set an additional flag (available starting in 6.9).
+
+The following trivial action shows the location of a project so long as its name comes in the first half of the alphabet:
+
+[source,java]
+----
+
+@ActionID(...)
+@ActionRegistration(...)
+@ActionReference(path="Projects/Actions")
+public class DemoAction extends AbstractAction implements ContextAwareAction {
+ public @Override void actionPerformed(ActionEvent e) {assert false;}
+ public @Override Action createContextAwareInstance(Lookup context) {
+ return new ContextAction(context);
+ }
+ private static final class ContextAction extends AbstractAction {
+ private final Project p;
+ public ContextAction(Lookup context) {
+ p = context.lookup(Project.class);
+ String name = ProjectUtils.getInformation(p).getDisplayName();
+ // TODO state for which projects action should be enabled
+ char c = name.charAt(0);
+ setEnabled(c >= 'A' && c <= 'M');
+ putValue(DynamicMenuContent.HIDE_WHEN_DISABLED, true);
+ // TODO menu item label with optional mnemonics
+ putValue(NAME, "&Info on " + name);
+ }
+ public @Override void actionPerformed(ActionEvent e) {
+ // TODO what to do when run
+ String msg = "Project location: "
+ + FileUtil.getFileDisplayName(p.getProjectDirectory());
+ DialogDisplayer.getDefault().notify(new NotifyDescriptor.Message(msg));
+ }
+ }
+}
+
+----
+
+==== Specific approach
+
+Certain project types also read their context menu actions from type-specific folders.
+
+For example
+<ul>
+<li>Maven: `Projects/org-netbeans-modules-maven/Actions`</li>
+</ul>
+
+Applies to: NetBeans 7.0+
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddProjectTypePopUp[http://wiki.netbeans.org/DevFaqActionAddProjectTypePopUp] ,
+that was last modified by NetBeans user Markiewb
+on 2017-02-08T22:29:09Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddTabPopup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddTabPopup.asciidoc
new file mode 100644
index 0000000..ff9bbfa
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddTabPopup.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddTabPopup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I add an action to the global popup menu of tabs?
+
+@ActionReference(path="Editors/TabActions")
+
+--
+Applies to: NetBeans IDE 7.1 and above
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddTabPopup[http://wiki.netbeans.org/DevFaqActionAddTabPopup] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:16:38Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddToContextMenuOfAllEditors.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddToContextMenuOfAllEditors.asciidoc
new file mode 100644
index 0000000..b5ad53c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddToContextMenuOfAllEditors.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddToContextMenuOfAllEditors
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add an action to the context menu of all editors?
+
+Use
+
+[source,java]
+----
+
+@ActionReference(path="Editors/Popup")
+----
+
+for an action with `EditorCookie` as context object
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddToContextMenuOfAllEditors[http://wiki.netbeans.org/DevFaqActionAddToContextMenuOfAllEditors] ,
+that was last modified by NetBeans user Markiewb
+on 2014-03-15T08:54:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddToEditorToolbar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddToEditorToolbar.asciidoc
new file mode 100644
index 0000000..ec390a6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddToEditorToolbar.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddToEditorToolbar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add an action to the toolbar of the editor?
+
+Use
+
+[source,java]
+----
+
+@ActionReference(path="Editors/Toolbars/Default")
+----
+
+for an action with `EditorCookie` as context object
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddToEditorToolbar[http://wiki.netbeans.org/DevFaqActionAddToEditorToolbar] ,
+that was last modified by NetBeans user Markiewb
+on 2014-03-15T08:58:41Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddToolBar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddToolBar.asciidoc
new file mode 100644
index 0000000..ad9d2a2
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddToolBar.asciidoc
@@ -0,0 +1,48 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddToolBar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to the Toolbar?
+
+The simplest way is to run New Action Wizard (File > New... > Module Development > Action) which creates an action for you and registers it in your layer.xml file.
+
+=== See also:
+
+* link:DevFaqActionsFolder.html[An example how to register action manually ]
+* link:DevFaqActionAddFileMime.html[How do I add an action to a file of a given mime-type? ]
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder? ]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the text-editor popup menu? ]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the NetBeans menu bar? ]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node? ]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddToolBar[http://wiki.netbeans.org/DevFaqActionAddToolBar] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:35:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAddTools.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAddTools.asciidoc
new file mode 100644
index 0000000..b1a1bab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAddTools.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAddTools
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to the tools menu?
+
+Register to
+
+* *UI/ToolActions/Files*
+* *UI/ToolActions/Java*
+
+NOTE: The tools menu is available in the context menu of a file in the project view/files view
+
+See link:http://bits.netbeans.org/dev/javadoc/org-openide-actions/architecture-summary.html[http://bits.netbeans.org/dev/javadoc/org-openide-actions/architecture-summary.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAddTools[http://wiki.netbeans.org/DevFaqActionAddTools] ,
+that was last modified by NetBeans user Markiewb
+on 2015-03-08T18:19:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionAllAvailableProjectTypes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionAllAvailableProjectTypes.asciidoc
new file mode 100644
index 0000000..29d11a9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionAllAvailableProjectTypes.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionAllAvailableProjectTypes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How determine all available project types?
+
+* create a new nbm-module using the "_New Project..._"-wizard and choose your target platform
+* create a layer.xml using the "_New File..._"-wizard
+* expand the nodes "_Important Files/XML Layer/<this layer in context>/Projects_" within the project view
+* the direct childnodes of "Projects" are the supported project types of the target platform (see the screenshot below)
+
+The project type can be used for extending the project properties - See link:DevFaqActionAddProjectCustomizer.html[DevFaqActionAddProjectCustomizer].
+
+==== Example of some available types in NetBeans 7.2
+
+image:ChildnodesRepresentingProjectTypes.jpg[])
+
+[source,java]
+----
+
+org-netbeans-modules-ant-freeform
+org-netbeans-modules-apisupport-project
+org-netbeans-modules-apisupport-project-suite
+org-netbeans-modules-apisupport-project-suite-jnlp
+org-netbeans-modules-apisupport-project-suite-osgi
+org-netbeans-modules-apisupport-project-suite-package
+org-netbeans-modules-autoproject
+org-netbeans-modules-j2ee-clientproject
+org-netbeans-modules-j2ee-earproject
+org-netbeans-modules-j2ee-ejbjarproject
+org-netbeans-modules-java-j2seproject
+org-netbeans-modules-maven
+org-netbeans-modules-web-project
+...
+----
+
+Note: The list is incomplete. There will be more project types, if you enable support for JS, PHP, Gradle a.s.o.
+
+--
+Applies to: NetBeans IDE 7.x
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionAllAvailableProjectTypes[http://wiki.netbeans.org/DevFaqActionAllAvailableProjectTypes] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T19:53:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionContextSensitive.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionContextSensitive.asciidoc
new file mode 100644
index 0000000..e8aa807
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionContextSensitive.asciidoc
@@ -0,0 +1,191 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionContextSensitive
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I create an Action that is automatically enabled and disabled depending on the selection?
+
+There are several ways to do this, depending on what exactly you need. The basic problems all of the available solutions are addressing is that:
+
+* An action may be created and shown in a menu, toolbar or popup menu.
+* While it is visible on-screen, the selected file (or whatever) can change.
+* If it is context sensitive, it should run against the thing it was _shown for_ not whatever is selected at the millisecond when it is actually called
+* People want to write main-menu and toolbar actions which are enabled and disabled based on what is link:DevFaqTrackGlobalSelection.html[selected] - in practice this means writing an object that enables and disables itself based on a particular _type_ — a particular class or its subclasses — being selected (each logical window in NetBeans has its own "selection"; the "global selection" is whatever is selected in whatever window currently has focus)
+
+NetBeans allows context-sensitive actions to be registered declaratively using annotations.. In the IDE, *File > New File > Module Development > Action* will generate (on the first page of the wizard, specify that you want a context sensitive action):
+
+[source,java]
+----
+
+ @ActionID(...)
+ @ActionRegistration(...)
+ @ActionReference(...)
+ public final class SomeAction implements ActionListener {
+ private final List<Project> context;
+ public SomeAction(List<Project> context) {
+ this.context = context;
+ }
+ public void actionPerformed(ActionEvent ev) {
+ for (Project project : context) {
+ // TODO use project
+ }
+ }
+ }
+
+----
+
+which will be called if and only if one or more projects is selected. The good news is that the code is lightweight, simple and works; the bad news is that it doesn't handle more complicated enablement logic.
+
+If you want to add this action into a context menu of a node you have to overwrite the getActions() method as follows:
+
+[source,java]
+----
+
+ public Action[] getActions(boolean context) {
+ List<? extends Action> myActions =
+ Utilities.actionsForPath("Actions/YOUR_FOLDER");
+ return myActions.toArray(new Action[myActions.size()]);
+ }
+
+----
+
+If you need something more featureful, there are a few options, old and new:
+
+==== NodeAction
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/util/actions/NodeAction.html[NodeAction] is somewhat more flexible, but requires more code to implement. It is just passed the array of activated nodes whenever that changes, and can choose to enable or disable itself as it wishes. Essentially this is just an action that automagically link:DevFaqTrackingExplorerSelections.html[tracks the global Node selection].
+
+==== Roll your own
+
+The following is relatively simple and affords a way to perform whatever enablement logic you like (`NodeAction` can do that too, but this might be a little more straightforward and your code doesn't have to worry about nodes at all: link:DevFaqWhatIsANode.html[DevFaqWhatIsANode]). To understand how this works, see link:DevFaqTrackGlobalSelection.html[DevFaqTrackGlobalSelection]:
+
+[source,java]
+----
+
+public class FooAction extends AbstractAction implements LookupListener, ContextAwareAction {
+ private Lookup context;
+ Lookup.Result<Whatever> lkpInfo;
+
+ public FooAction() {
+ this(Utilities.actionsGlobalContext());
+ }
+
+ private FooAction(Lookup context) {
+ putValue(Action.NAME, NbBundle.getMessage(FooAction.class, "LBL_Action"));
+ this.context = context;
+ }
+
+ void init() {
+ assert SwingUtilities.isEventDispatchThread()
+ : "this shall be called just from AWT thread";
+
+ if (lkpInfo != null) {
+ return;
+ }
+
+ //The thing we want to listen for the presence or absence of
+ //on the global selection
+ lkpInfo = context.lookupResult(Whatever.class);
+ lkpInfo.addLookupListener(this);
+ resultChanged(null);
+ }
+
+ public boolean isEnabled() {
+ init();
+ return super.isEnabled();
+ }
+
+ public void actionPerformed(ActionEvent e) {
+ init();
+ for (Whatever instance : lkpInfo.allInstances()) {
+ // use it somehow...
+ }
+ }
+
+ public void resultChanged(LookupEvent ev) {
+ setEnabled(!lkpInfo.allInstances().isEmpty());
+ }
+
+ public Action createContextAwareInstance(Lookup context) {
+ return new FooAction(context);
+ }
+}
+
+----
+
+==== Deprecated CookieAction
+
+In many older (pre-NB 6.8) examples you may find link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/util/actions/CookieAction.html[CookieAction]. It should be (but is not) deprecated. The original info is left here for reference and/or old code maintenance:
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/util/actions/CookieAction.html[CookieAction] is used to write actions that are sensitive to what is in the selected Node(s) link:DevFaqLookup.html[Lookup]. You can specify one or more classes that must be present in the selected link:DevFaqWhatIsANode.html[Node]'s Lookup, and some other semantics about enablement.
+
+Being an older class, under the hood it is using link:DevFaqLookupCookie.html[Node.getCookie()], so your action will only be sensitive to things actually returned by that method - in other words, only objects that implement the marker interface `Node.Cookie` can work here.
+
+==== Not-Yet-Official spi.actions
+
+This module is part of the platform as of 6.8, but has not yet become official API (and nobody seems to be willing to make it stable API, so judge your own decisions based on this fact). Nonetheless it is there, it is not changing and straightforward to use. The example below opens a visual editor window if an instance of RAFDataObject is selected and has a RandomAccessFile in its lookup:
+
+[source,java]
+----
+
+public final class CustomOpenAction extends org.netbeans.spi.actions.Single<RAFDataObject>
+ {
+ public CustomOpenAction() {
+ super(RAFDataObject.class, "Open", null);
+ }
+ @Override
+ protected void actionPerformed(RAFDataObject target) {
+ //If an editor is already open, just give it focus
+ for (TopComponent tc : TopComponent.getRegistry().getOpened()) {
+ if (tc instanceof RAFEditor && tc.getLookup().lookup(RAFDataObject.class) == target) {
+ tc.requestActive();
+ return;
+ }
+ }
+ //Nope, need a new editor
+ TopComponent editorWindow = null;
+ editorWindow = new RAFEditor(target);
+ editorWindow.open();
+ editorWindow.requestActive();
+ }
+ @Override
+ protected boolean isEnabled(RAFDataObject target) {
+ //Make sure there really is a file on disk
+ return target.getLookup().lookup(RandomAccessFile.class) != null;
+ }
+ }
+
+----
+
+Use `ContextAction` instead of `Single` to create actions that operate on multi-selections.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionContextSensitive[http://wiki.netbeans.org/DevFaqActionContextSensitive] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:08:16Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionNodePopupSubmenu.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionNodePopupSubmenu.asciidoc
new file mode 100644
index 0000000..e595307
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionNodePopupSubmenu.asciidoc
@@ -0,0 +1,183 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionNodePopupSubmenu
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I make my Node have a submenu on its popup menu?
+
+* Override `getActions()` of your Node subclass.
+* Create a custom subclass of `javax.swing.Action` which implements the interface `Presenter.Popup`.
+* Return a `JMenu` with whatever you want on it from `getPopupPresenter()`.
+* Return that action in the array of actions from `getActions()`.
+
+=== How do I make my Node have a submenu with context-sensitive action on its popup menu?
+
+First here is the action for the submenu. The action is registered to the project context menu. It uses the `Presenter.Popup` interface to register itself as a submenu. In the `getPopupPresenter()` method the submenu is assembled via
+`Utilities.actionsForPath`.
+
+[source,java]
+----
+
+@ActionID(
+ category = "MyActions",
+ id = "de.markiewb.netbeans.sample.PopupAction"
+)
+@ActionRegistration(
+ displayName = "#CTL_PopupAction", lazy = false
+)
+@ActionReferences({
+ @ActionReference(path = "Projects/Actions")
+})
+@Messages("CTL_PopupAction=I am a submenu")
+public final class PopupAction extends AbstractAction implements ActionListener, Presenter.Popup {
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ //NOP
+ }
+
+ @Override
+ public JMenuItem getPopupPresenter() {
+ JMenu main = new JMenu(Bundle.CTL_PopupAction());
+ List<? extends Action> actionsForPath = Utilities.actionsForPath("Actions/MyActions/SubActions");
+ for (Action action : actionsForPath) {
+ main.add(action);
+ }
+ return main;
+ }
+}
+----
+
+In the previous code snippet `Utilities.actionsForPath` has been used to resolve action(s) at `Actions/MyActions/SubActions`. Here is a context sensitive action, which is registered at this location.
+
+[source,java]
+----
+
+@ActionID(
+ category = "MyActions/SubActions",
+ id = "de.markiewb.netbeans.sample.HelloProjectsAction"
+)
+@ActionRegistration(
+ displayName = "#CTL_HelloProjectsAction"
+)
+@Messages("CTL_HelloProjectsAction=HelloProjects...")
+public final class HelloProjectsAction implements ActionListener {
+
+ private final List context;
+
+ public HelloProjectsAction(List context) {
+ this.context = context;
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent ev) {
+ JOptionPane.showMessageDialog(null, context.size() + " projects selected: " + context);
+ }
+}
+----
+
+See link:https://benkiew.wordpress.com/2015/09/01/nb-how-to-create-a-context-sensitive-action-within-a-submenu/[https://benkiew.wordpress.com/2015/09/01/nb-how-to-create-a-context-sensitive-action-within-a-submenu/]
+
+=== How to create a context-aware submenu?
+
+The requirement: "The submenu should be only?enabled, when exactly two project nodes are selected. Only if this condition is true, the submenu items should be displayed."
+
+See the following sample code. The most important part of the popup action is to emulate a context-aware action using a lookup listener.
+
+[source,java]
+----
+
+@ActionID(
+ category = "MyActions",
+ id = "de.markiewb.netbeans.sample.ContextAwarePopupAction"
+)
+@ActionRegistration(
+ displayName = "#CTL_ContextAwarePopupAction", lazy = false
+)
+@ActionReferences({
+ @ActionReference(path = "Projects/Actions")
+})
+@Messages("CTL_ContextAwarePopupAction=I am a context-aware submenu")
+public final class ContextAwarePopupAction extends AbstractAction implements ActionListener, Presenter.Popup {
+
+ private final Lookup.Result<Project> result;
+ private final transient LookupListener lookupListener;
+
+ public ContextAwarePopupAction() {
+ putValue(NAME, Bundle.CTL_ContextAwarePopupAction());
+ //disabled by default - at loading time
+ setEnabled(false);
+ //create an action, which is only enabled when exactly 2 projects are selected
+ result = Utilities.actionsGlobalContext().lookupResult(Project.class);
+ this.lookupListener = new LookupListener() {
+
+ @Override
+ public void resultChanged(LookupEvent ev) {
+ final Runnable runnable = new Runnable() {
+
+ @Override
+ public void run() {
+ int s = result.allInstances().size();
+ ContextAwarePopupAction.this.setEnabled(s == 2);
+ }
+ };
+ // to make sure that it will be executed on EDT
+ if (EventQueue.isDispatchThread()) {
+ runnable.run();
+ } else {
+ SwingUtilities.invokeLater(runnable);
+ }
+ }
+ };
+ result.addLookupListener(WeakListeners.create(LookupListener.class, this.lookupListener, result));
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ //NOP
+ }
+
+ @Override
+ public JMenuItem getPopupPresenter() {
+ JMenu main = new JMenu(this);
+ List<? extends Action> actionsForPath = Utilities.actionsForPath("Actions/MyActions/SubActions");
+ for (Action action : actionsForPath) {
+ main.add(action);
+ }
+ return main;
+ }
+}
+----
+
+See link:https://benkiew.wordpress.com/2015/09/13/nb-how-to-create-a-context-aware-submenu/[https://benkiew.wordpress.com/2015/09/13/nb-how-to-create-a-context-aware-submenu/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionNodePopupSubmenu[http://wiki.netbeans.org/DevFaqActionNodePopupSubmenu] ,
+that was last modified by NetBeans user Markiewb
+on 2015-09-13T19:53:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionsAddAtRuntime.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionsAddAtRuntime.asciidoc
new file mode 100644
index 0000000..b7751e4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionsAddAtRuntime.asciidoc
@@ -0,0 +1,151 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionsAddAtRuntime
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add an action (incl. shortcut) at runtime?
+
+Create system file system entries in the `Actions`/`Menu`/`Shortcuts` folders! See the following example
+
+Usage:
+
+[source,java]
+----
+
+ private void initActions() {
+ ActionRegistrationService ars = Lookup.getDefault().lookup(ActionRegistrationService.class);
+
+ try {
+ String menuPath = "Menu/Machine/Jog";
+
+ ars.registerAction(getMessage(this.getClass(), "JogService.xPlus") , "Machine", "M-RIGHT" , menuPath, new JogAction(this, 1, 0, 0));
+ ars.registerAction(getMessage(this.getClass(), "JogService.xMinus"), "Machine", "M-LEFT" , menuPath, new JogAction(this,-1, 0, 0));
+ ars.registerAction(getMessage(this.getClass(), "JogService.yPlus") , "Machine", "M-UP" , menuPath, new JogAction(this, 0, 1, 0));
+ } catch (IOException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ }
+----
+
+Helper-Service
+
+[source,java]
+----
+
+
+import com.google.common.base.Joiner;
+import java.io.IOException;
+import java.util.Arrays;
+import javax.swing.Action;
+import org.openide.filesystems.FileObject;
+import org.openide.filesystems.FileUtil;
+import org.openide.util.lookup.ServiceProvider;
+
+/**
+ *
+ * @author wwinder
+ */
+@ServiceProvider(service=ActionRegistrationService.class)
+public class ActionRegistrationService {
+ /**
+ * Registers an action with the platform along with optional shortcuts and
+ * menu items.
+ * @param name Display name of the action.
+ * @param category Category in the Keymap tool.
+ * @param shortcut Default shortcut, use an empty string or null for none.
+ * @param menuPath Menu location starting with "Menu", like "Menu/File"
+ * @param action an action object to attach to the action entry.
+ * @throws IOException
+ */
+ public void registerAction(String name, String category, String shortcut, String menuPath, Action action) throws IOException {
+ ///////////////////////
+ // Add/Update Action //
+ ///////////////////////
+ String originalFile = "Actions/" + category + "/" + name + ".instance";
+ FileObject in = getFolderAt("Actions/" + category);
+ FileObject obj = in.getFileObject(name, "instance");
+ if (obj == null) {
+ obj = in.createData(name, "instance");
+ }
+ action.putValue(Action.NAME, name);
+ obj.setAttribute("instanceCreate", action);
+ obj.setAttribute("instanceClass", action.getClass().getName());
+
+ /////////////////////
+ // Add/Update Menu //
+ /////////////////////
+ in = getFolderAt(menuPath);
+ obj = in.getFileObject(name, "shadow");
+ // Create if missing.
+ if (obj == null) {
+ obj = in.createData(name, "shadow");
+ obj.setAttribute("originalFile", originalFile);
+ }
+
+ /////////////////////////
+ // Add/Update Shortcut //
+ /////////////////////////
+ in = getFolderAt("Shortcuts");
+ obj = in.getFileObject(shortcut, "shadow");
+ if (obj == null) {
+ obj = in.createData(shortcut, "shadow");
+ obj.setAttribute("originalFile", originalFile);
+ }
+ }
+
+ private FileObject getFolderAt(String inputPath) throws IOException {
+ String parts[] = inputPath.split("/");
+ FileObject existing = FileUtil.getConfigFile(inputPath);
+ if (existing != null)
+ return existing;
+
+ FileObject base = FileUtil.getConfigFile(parts[0]);
+ if (base == null) return null;
+
+ for (int i = 1; i < parts.length; i++) {
+ String path = Joiner.on('/').join(Arrays.copyOfRange(parts,0,i+1));
+ FileObject next = FileUtil.getConfigFile(path);
+ if (next == null) {
+ next = base.createFolder(parts[i]);
+ }
+ base = next;
+ }
+
+ return FileUtil.getConfigFile(inputPath);
+ }
+}
+----
+
+Taken from mailing list link:http://forums.netbeans.org/topic65421.html[http://forums.netbeans.org/topic65421.html]
+Based on link:https://blogs.oracle.com/geertjan/entry/dynamically_creating_menu_items_part[https://blogs.oracle.com/geertjan/entry/dynamically_creating_menu_items_part]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionsAddAtRuntime[http://wiki.netbeans.org/DevFaqActionsAddAtRuntime] ,
+that was last modified by NetBeans user Markiewb
+on 2016-03-13T14:03:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqActionsFolder.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqActionsFolder.asciidoc
new file mode 100644
index 0000000..bb3eb10
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqActionsFolder.asciidoc
@@ -0,0 +1,75 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqActionsFolder
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the Actions folder in the system filesystem, and why should I use it?
+
+When you use @ActionRegistration the META-INF/generated-layer.xml may contain:
+
+[source,xml]
+----
+
+<folder name="Actions">
+ <folder name="Build">
+ <file name="com-foo-SomeAction.instance"/>
+ </folder>
+</folder>
+<folder name="Menu">
+ <folder name="Build">
+ <file name="pointerToComFooSomeAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Build/com-foo-SomeAction.instance"/>
+ </file>
+ </folder>
+</folder>
+
+----
+
+And you may have noticed that actions are usually put, not directly into the `Menu/` folders, but into subfolders of this `Actions/` folder. Then we create link:DevFaqDotShadowFiles.html[.shadow files ] that act like symbolic links, pointing to the real link:DevFaqInstanceDataObject.html[.instance file ]. Why all this indirection?
+
+Older versions of the NetBeans UI included the ability to rearrange, and even delete, whole menus or individual menu items, and future ones may again.
+(Many applications built on NetBeans will not want to expose such customizability, but some do.)
+The current UI does include a key binding editor;
+the `Actions/` folder can be used from this editor to list available actions, even those which are not currently bound to any keystroke.
+
+Additionally, for actions which are `javax.swing.Action` but not `SystemAction`,
+creating the action instance in only a single place
+ensures that it acts as a singleton.
+(While the action class likely has no declared instance fields,
+it does have some state,
+notably information about keyboard accelerators which should be displayed in menu presenters.)
+
+<hr/>
+
+Applies to: NetBeans 6.7 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqActionsFolder[http://wiki.netbeans.org/DevFaqActionsFolder] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:09:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddActionToMembersOrHierarchyView.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddActionToMembersOrHierarchyView.asciidoc
new file mode 100644
index 0000000..a4e1fb5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddActionToMembersOrHierarchyView.asciidoc
@@ -0,0 +1,152 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddActionToMembersOrHierarchyView
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an action to the context menu of the members or hierarchy view?
+
+Since 7.3 ([1], [2]) it is possible to extend the context menu of the newly redesigned members and hierarchy view.
+
+Plugin your action at the following extension points
+
+[source,java]
+----
+
+Navigator/Actions/Members/text/x-java
+Navigator/Actions/Hierarchy/text/x-java
+----
+
+Then you get the "TreePathHandle" from the Node's lookup.
+
+==== A more or less complete example:
+
+[source,java]
+----
+
+package de.markiewb.netbeans.sample.extendMembersAndHierarchyView;
+
+import java.util.ArrayList;
+import java.util.List;
+import static javax.swing.Action.NAME;
+import javax.swing.JMenuItem;
+import javax.swing.JOptionPane;
+import org.netbeans.api.java.source.TreePathHandle;
+import org.openide.awt.*;
+import org.openide.nodes.Node;
+import org.openide.util.HelpCtx;
+import org.openide.util.NbBundle;
+import org.openide.util.actions.CookieAction;
+import org.openide.util.actions.Presenter;
+
+@ActionID(category = "Edit",
+ id = "de.markiewb.netbeans.sample.extendMembersAndHierarchyView.SampleAction")
+@ActionRegistration(
+ displayName = "SampleAction")
+@ActionReferences({
+ @ActionReference(path = "Navigator/Actions/Members/text/x-java", position = 1150),
+ @ActionReference(path = "Navigator/Actions/Hierarchy/text/x-java", position = 1150),
+ @ActionReference(path = "Menu/File", position = 0)
+})
+/**
+ * Shows the usage of the extensionpoints of the context menu in the members and
+ * hierarchy views. This is new to NetBeans 7.3. See
+ * http://netbeans.org/bugzilla/show_bug.cgi?id=220057 and
+ * http://netbeans.org/bugzilla/show_bug.cgi?id=224499.
+ *
+ * @author markiewb@netbeans.org
+ */
+public final class SampleAction extends CookieAction implements Presenter.Popup {
+ public SampleAction() {
+ putValue(NAME, "Hello TreePathHandle(s)");
+ }
+
+ @Override
+ public String getName() {
+ return "Hello TreePathHandle(s)";
+ }
+
+ @Override
+ public JMenuItem getPopupPresenter() {
+ return new JMenuItem(this);
+ }
+
+ @Override
+ public HelpCtx getHelpCtx() {
+ return null;
+ }
+
+ @Override
+ protected boolean enable(Node[] activatedNodes) {
+ //.. use tph from lookup in node
+ for (Node node : activatedNodes) {
+ if (null != node.getLookup().lookup(TreePathHandle.class)) {
+ return true;
+ };
+ }
+ return false;
+ }
+
+ @Override
+ protected int mode() {
+ return CookieAction.MODE_ALL;
+ }
+
+ @Override
+ protected Class[] cookieClasses() {
+ return new Class[]{Node.class};
+ }
+
+ @Override
+ protected void performAction(Node[] nodes) {
+
+ List<TreePathHandle> treePathHandles = new ArrayList<TreePathHandle>();
+ for (Node node : nodes) {
+ treePathHandles.add(node.getLookup().lookup(TreePathHandle.class));
+ }
+
+ //show all treePathHandles
+ JOptionPane.showMessageDialog(null, "Hello\n" + treePathHandles);
+ }
+}
+----
+
+See
+
+[1] link:http://netbeans.org/bugzilla/show_bug.cgi?id=220057[http://netbeans.org/bugzilla/show_bug.cgi?id=220057]
+
+[2] link:http://netbeans.org/bugzilla/show_bug.cgi?id=224499[http://netbeans.org/bugzilla/show_bug.cgi?id=224499]
+
+[3] link:https://github.com/markiewb/nb-api-samples/tree/master/ExtendMembersAndHierarchyView[https://github.com/markiewb/nb-api-samples/tree/master/ExtendMembersAndHierarchyView]
+
+[4] link:http://benkiew.wordpress.com/2013/01/06/netbeans-ide-7-3-how-to-extend-the-context-menu-of-the-members-and-hierarchy-view/[http://benkiew.wordpress.com/2013/01/06/netbeans-ide-7-3-how-to-extend-the-context-menu-of-the-members-and-hierarchy-view/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddActionToMembersOrHierarchyView[http://wiki.netbeans.org/DevFaqAddActionToMembersOrHierarchyView] ,
+that was last modified by NetBeans user Markiewb
+on 2013-01-06T22:53:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddDefaultActionShortcuts.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddDefaultActionShortcuts.asciidoc
new file mode 100644
index 0000000..a140290
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddDefaultActionShortcuts.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddDefaultActionShortcuts
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+You just need to include the defaults module _org.netbeans.modules.defaults_ that defines the key bindings for the system actions.
+
+For Maven, add the following dependency to your app:
+
+[source,xml]
+----
+
+ <dependency>
+ <groupId>org.netbeans.modules</groupId>
+ <artifactId>org-netbeans-modules-defaults</artifactId>
+ <version>${netbeans.version}</version>
+ </dependency>
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddDefaultActionShortcuts[http://wiki.netbeans.org/DevFaqAddDefaultActionShortcuts] ,
+that was last modified by NetBeans user Jmborer
+on 2013-09-13T07:52:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddDoingEvilThingsToForeignNodes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddDoingEvilThingsToForeignNodes.asciidoc
new file mode 100644
index 0000000..b66cf66
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddDoingEvilThingsToForeignNodes.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddDoingEvilThingsToForeignNodes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have a reference to an existing Node from some other module. Can I add cookies/properties/actions/children?
+
+No.
+
+Occasionally people want to do something like this, because they want to enhance, for example, the behavior or nodes for Java files or other nodes created by some other modules. However, this is a recipe for disaster - nobody writing a Node subclass does so expecting that random modules will change its internal structures without warning. It is possible to write code that does this sort of thing that looks like it works, but it is sheer luck and it will probably not work for long.
+
+==== *_DO NOT DO THAT UNDER ANY CIRCUMSTANCES_*
+
+(there, did I say that strongly enough?).
+
+Many modules are designed for extensibility - in fact, Nodes for Java files in the IDE do allow you to add children, actions, etc. They offer an API for doing this sort of thing (for example, adding Actions to `Loaders/text/x-java/Actions` declaratively); see the beans module for an example of adding sub-nodes to Java classes.
+
+If you want to modify the children/properties/actions/etc. of a Node you did not create, look for an API that lets you do that in a supported way.
+
+If one does not exist, link:http://www.netbeans.org/issues/enter_bug.cgi[file an enhancement request] against the module that actually creates these nodes, asking for an appropriate API for doing what you want (and be clear about exactly what you want or why). If you really want to expedite it, write a patch that creates such an API (look at how other modules do this sort of thing and aim to follow a similar pattern) - it's hard to say no to working code.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddDoingEvilThingsToForeignNodes[http://wiki.netbeans.org/DevFaqAddDoingEvilThingsToForeignNodes] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:36:02Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddFileTemplateToNewFileContentMenu.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddFileTemplateToNewFileContentMenu.asciidoc
new file mode 100644
index 0000000..9c4a3c0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddFileTemplateToNewFileContentMenu.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddFileTemplateToNewFileContentMenu
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I define the available File types when the user right-clicks the project folder and chooses "New"?
+
+See documentation of "Privileged and Recommended Templates" at
+link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/templates/support/package-summary.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/templates/support/package-summary.html]
+
+Example:
+`
+
+[source,java]
+----
+
+import org.netbeans.spi.project.ProjectServiceProvider;
+import org.netbeans.spi.project.ui.PrivilegedTemplates;
+
+@ProjectServiceProvider(projectType = "org-netbeans-modules-cnd-makeproject", service = PrivilegedTemplates.class)
+public class NescPrivilegedTemplates implements PrivilegedTemplates {
+
+ private static final String[] PRIVILEGED_NAMES = new String[]{
+ "Templates/Nesc/EmptyTemplate.nc",
+ "Templates/Nesc/SimpleTemplate.nc",
+ };
+
+ @Override
+ public String[] getPrivilegedTemplates() {
+ return PRIVILEGED_NAMES;
+ }
+
+}
+----
+
+`
+Taken from Geertjan @ dev@platform.netbeans.org
+
+Further examples:
+
+* link:https://blogs.oracle.com/geertjan/entry/privileged_and_recommended_templates[https://blogs.oracle.com/geertjan/entry/privileged_and_recommended_templates]
+* link:https://blogs.oracle.com/geertjan/entry/nescide_an_ide_for_the[https://blogs.oracle.com/geertjan/entry/nescide_an_ide_for_the]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddFileTemplateToNewFileContentMenu[http://wiki.netbeans.org/DevFaqAddFileTemplateToNewFileContentMenu] ,
+that was last modified by NetBeans user Markiewb
+on 2013-08-10T16:08:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddGlobalContext.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddGlobalContext.asciidoc
new file mode 100644
index 0000000..32e2073
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddGlobalContext.asciidoc
@@ -0,0 +1,583 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddGlobalContext
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I Add Content to the Global Context?
+
+The NetBeans Platform provides the ability to enable and disable Actions based upon what is selected in the current logical window--this is known as the "_global selection_". In this article I show how to extend this selection concept to include objects that are global to the entire application. Using this technique, you'll be able to leverage existing idioms for creating context-sensitive actions and querying the global selection, but the scope of your operations will be expanded from the context of the current window to the context of the entire application. That's a pretty powerful extension point that demonstrates the strength and versatility of the NetBeans Platform APIs.
+
+This FAQ will add a Project instance to the global selection. However, you could add any object, for instance a NavigatorHint, or perhaps you could keep track of the last used "widget".
+
+=== Use Cases
+
+Consider the following use cases. Each one interacts with the global selection in some way. Each one would benefit by giving the currently selected project an application-wide scope.
+
+==== Use Case #1
+
+You want to create a context sensitive action that is enabled when a project is selected in the Projects window, and that remains enabled when the focus changes to another window. For example:
+
+[source,java]
+----
+
+@ActionID(...)
+@ActionRegistration(...)
+@ActionReference(...)
+public final class CloseProjectAction implements ActionListener
+{
+ private final Project project;
+
+ public CloseProjectAction(Project context)
+ {
+ this.project = context;
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent e)
+ {
+ OpenProjects.getDefault().close(new Project[] { project });
+ }
+}
+
+----
+
+==== Use Case #2
+
+You want an Action to interact with a capability found in the current project. Your Action is in a loosely coupled module that knows nothing about projects other than the NetBeans Project API and your capability's API. For example:
+
+[source,java]
+----
+
+@ActionID(...)
+@ActionRegistration(...)
+@ActionReference(...)
+public final class SomeAction implements ActionListener
+{
+ @Override
+ public void actionPerformed(ActionEvent event)
+ {
+ Project project = Utilities.actionsGlobalContext().lookup(Project.class);
+ if (project != null)
+ {
+ SomeCapability capability = project.getLookup().lookup(SomeCapability.class);
+ if (capability != null)
+ {
+ ...
+ }
+ ...
+ }
+ }
+}
+
+----
+
+==== Use Case #3
+
+You want to update the main window title based on an attribute in the current project, for instance, the name. You want to use a simple LookupListener that listens for the selected projects in the global selection. For example:
+
+[source,java]
+----
+
+/**
+ * This class provides the application's window title with the selected
+ * project's name.
+ */
+public class MainWindowTitleManager
+{
+ private static Lookup.Result<Project> lookupResults;
+ private static LookupListener lookupListener;
+
+ /**
+ * Creates a LookupListener on the Project.class that
+ * handles changes in the project selection.
+ */
+ public static void activate()
+ {
+ if (lookupResults == null)
+ {
+ // Monitor the existance of Projects in the global context lookup
+ lookupResults = Utilities.actionsGlobalContext().lookupResult(Project.class);
+ // Create the listener on the lookupResults
+ lookupListener = new LookupListener()
+ {
+ // Update window title when the Project changes
+ @Override
+ public void resultChanged(LookupEvent ignored)
+ {
+ String projectName;
+ Collection<? extends Project> projects = lookupResults.allInstances();
+ if (projects.isEmpty())
+ {
+ projectName = "<No Project>";
+ }
+ else if (projects.size() == 1)
+ {
+ Project project = projects.iterator().next();
+ projectName = ProjectUtils.getInformation(project).getDisplayName();
+ }
+ else
+ {
+ projectName = "Multiple Projects";
+ }
+ demonstrateUpdateWindowTitle(projectName);
+ }
+ };
+ // Activate the listener
+ lookupResults.addLookupListener(lookupListener);
+ lookupListener.resultChanged(null);
+ }
+ }
+
+ static void demonstrateUpdateWindowTitle(final String projectName)
+ {
+ // We have to do this on the AWT thread, so we use the invokeWhenUIReady
+ // method which can be called from any thread.
+ {
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable()
+ {
+ @Override
+ public void run()
+ {
+ Frame mainWindow = WindowManager.getDefault().getMainWindow();
+ mainWindow.setTitle(projectName);
+ }
+ });
+ }
+ }
+}
+
+----
+
+All of these examples work fine when a project is selected in the Projects window, but not when the focus is switched to another window, nor when a child node of a project is selected. What we want is for the selected project to be universally available throughout the scope of the entire application. What better way than to simply expand the scope of the Lookup contents provided by Utilities.actionsGlobalContext(). We can do this by creating a ProxyLookup that merges the default "global selection" with our own content that we control.
+
+=== Basic Implementation
+
+The first step is to create a service provider that implements the ContextGlobalProvider interface. Our service provider will supersede the default NetBeans implementation: GlobalActionContextImpl. When Utilities.actionsGlobalContext() is called, our class will return a ProxyLookup that includes the default implementation for the logical window-scope context, plus our own application-wide content. What you place in the application content is up to you, but some examples that I've used are Projects and NavigatorHints.
+
+We'll start by creating a GlobalActionContextProxy class. Note the class comment about the Window System API dependency. Without it, we won't have access to the GlobalActionContextImpl class. To change the dependency, right-click your class' module and select: *Properties > Libraries > Module Dependencies > Window System API > Edit? > Implementation Version*.
+
+[source,java]
+----
+
+/**
+ * This class proxies the original ContextGlobalProvider. It provides the ability
+ * to add and remove objects from the application-wide global selection.
+ *
+ * To use this class you must edit the Windows System API module dependency:
+ * change the dependency to an implementation version so that the
+ * org.netbeans.modules.openide.windows package is on the classpath.
+ */
+@ServiceProvider(service = ContextGlobalProvider.class,
+ supersedes = "org.netbeans.modules.openide.windows.GlobalActionContextImpl")
+public class GlobalActionContextProxy implements ContextGlobalProvider
+{
+ /** The native NetBeans global context Lookup provider */
+ private final GlobalActionContextImpl globalContextProvider;
+ /** The primary lookup managed by the platform */
+ private Lookup globalContextLookup;
+ /** The project lookup managed by this class */
+ private Lookup projectLookup;
+ /** The actual Lookup returned by this class */
+ private Lookup proxyLookup;
+ /** The additional content for our proxy lookup */
+ private final InstanceContent content;
+
+ public GlobalActionContextProxy()
+ {
+ this.content = new InstanceContent();
+
+ // Create the default GlobalContextProvider
+ this.globalContextProvider = new GlobalActionContextImpl();
+ this.globalContextLookup = this.globalContextProvider.createGlobalContext();
+ }
+
+ /**
+ * Returns a ProxyLookup that adds the application-wide content to the original lookup
+ * returned by Utilities.actionsGlobalContext().
+ *
+ * @return a ProxyLookup that includes the default global context plus our own content
+ */
+ @Override
+ public Lookup createGlobalContext()
+ {
+ if (this.proxyLookup == null)
+ {
+ // Merge the two lookups that make up the proxy
+ this.projectLookup = new AbstractLookup(content);
+ this.proxyLookup = new ProxyLookup(this.globalContextLookup, this.projectLookup);
+ }
+ return this.proxyLookup;
+ }
+
+ /**
+ * Adds an Object to the application scope global selection.
+ */
+ public void add(Object obj)
+ {
+ this.content.add(obj);
+ }
+
+ /**
+ * Removes an Object from the application scope global selection.
+ */
+ public void remove(Object obj)
+ {
+ this.content.remove(obj);
+ }
+}
+
+----
+
+=== Complete Implementation
+
+Here's a complete GlobalActionContextProxy that satisfies the three use cases described above. This implementation ensures that the currently selected Project remains in the global selection regardless of the current TopComponent. This is accomplished with the following:
+
+* A PropertyChangeListener is attached to the TopComponent.Registry to track the Project node selection in the Projects window. It stores the last selected Project in the lastProject static member. Here's the magic: when the lastProject reference is not found in the default global selection, it is placed in the InstanceContent that is returned in our ProxyLookup. Wha-la!
+* A Lookup.Result is obtained from the default global selection to track the existence of Projects in the global selection. A LookupListener is attached to the result that handles changes to the project selection that occur outside of the Projects window, for instance, when projects are closed.
+[source,java]
+----
+
+package com.emxsys.projectassistant;
+
+import java.beans.PropertyChangeEvent;
+import java.beans.PropertyChangeListener;
+import java.util.Collection;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import org.netbeans.api.project.FileOwnerQuery;
+import org.netbeans.api.project.Project;
+import org.netbeans.api.project.ProjectUtils;
+import org.netbeans.api.project.ui.OpenProjects;
+import org.netbeans.modules.openide.windows.GlobalActionContextImpl;
+import org.openide.explorer.ExplorerManager;
+import org.openide.loaders.DataObject;
+import org.openide.nodes.Node;
+import org.openide.util.ContextGlobalProvider;
+import org.openide.util.Lookup;
+import org.openide.util.Lookup.Result;
+import org.openide.util.Lookup.Template;
+import org.openide.util.LookupEvent;
+import org.openide.util.LookupListener;
+import org.openide.util.lookup.AbstractLookup;
+import org.openide.util.lookup.InstanceContent;
+import org.openide.util.lookup.ProxyLookup;
+import org.openide.util.lookup.ServiceProvider;
+import org.openide.windows.TopComponent;
+import org.openide.windows.WindowManager;
+
+
+/**
+ * This class proxies the original ContextGlobalProvider and ensures the current project remains in
+ * the GlobalContext regardless of the TopComponent selection. The class also ensures that when a
+ * child node is selected within the in Projects tab, the parent Project will be in the lookup.
+ *
+ * To use this class you must edit the Windows System API module dependency: change the dependency
+ * to an implementation version so that the org.netbeans.modules.openide.windows package is on the
+ * classpath.
+ *
+ * @see ContextGlobalProvider
+ * @see GlobalActionContextImpl
+ * @author Bruce Schubert
+ */
+@ServiceProvider(service = ContextGlobalProvider.class,
+ supersedes = "org.netbeans.modules.openide.windows.GlobalActionContextImpl")
+public class GlobalActionContextProxy implements ContextGlobalProvider
+{
+
+ /** The native NetBeans global context Lookup provider */
+ private final GlobalActionContextImpl globalContextProvider;
+ /** Additional content for our proxy lookup */
+ private final InstanceContent content;
+ /** The primary lookup managed by the platform */
+ private Lookup globalContextLookup;
+ /** The project lookup managed by resultChanged */
+ private Lookup projectLookup;
+ /** The actual proxyLookup returned by this class */
+ private Lookup proxyLookup;
+ /** A lookup result that we listen to for Projects */
+ private Result<Project> resultProjects;
+ /** Listener for changes resultProjects */
+ private final LookupListener resultListener;
+ /** Listener for changes on the TopComponent registry */
+ private final PropertyChangeListener registryListener;
+ /** The last project selected */
+ private Project lastProject;
+ /** Critical section lock */
+ private final Object lock = new Object();
+ private static final Logger logger = Logger.getLogger(GlobalActionContextProxy.class.getName());
+ public static final String PROJECT_LOGICAL_TAB_ID = "projectTabLogical_tc";
+ public static final String PROJECT_FILE_TAB_ID = "projectTab_tc";
+
+ public GlobalActionContextProxy()
+ {
+ this.content = new InstanceContent();
+
+ // The default GlobalContextProvider
+ this.globalContextProvider = new GlobalActionContextImpl();
+ this.globalContextLookup = this.globalContextProvider.createGlobalContext();
+
+ // Monitor the activation of the Projects Tab TopComponent
+ this.registryListener = new RegistryPropertyChangeListener();
+ TopComponent.getRegistry().addPropertyChangeListener(this.registryListener);
+
+ // Monitor the existance of a Project in the principle lookup
+ this.resultProjects = globalContextLookup.lookupResult(Project.class);
+ this.resultListener = new LookupListenerImpl();
+ this.resultProjects.addLookupListener(this.resultListener);
+
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable()
+ {
+ @Override
+ public void run()
+ {
+ // Hack to force the current Project selection when the application starts up
+ TopComponent tc = WindowManager.getDefault().findTopComponent(PROJECT_LOGICAL_TAB_ID);
+ if (tc != null)
+ {
+ tc.requestActive();
+ }
+ }
+ });
+ }
+
+ /**
+ * Returns a ProxyLookup that adds the current Project instance to the global selection
+ * returned by Utilities.actionsGlobalContext().
+ *
+ * @return a ProxyLookup that includes the original global context lookup.
+ */
+ @Override
+ public Lookup createGlobalContext()
+ {
+ if (proxyLookup == null)
+ {
+ logger.config("Creating a proxy for Utilities.actionsGlobalContext()");
+ // Create the two lookups that will make up the proxy
+ projectLookup = new AbstractLookup(content);
+ proxyLookup = new ProxyLookup(globalContextLookup, projectLookup);
+ }
+ return proxyLookup;
+ }
+
+ /**
+ * This class populates the proxy lookup with the currently selected project
+ * found in the Projects tab.
+ */
+ private class RegistryPropertyChangeListener implements PropertyChangeListener
+ {
+ private TopComponent projectsTab = null;
+
+ @Override
+ public void propertyChange(PropertyChangeEvent event)
+ {
+ if (event.getPropertyName().equals(TopComponent.Registry.PROP_ACTIVATED_NODES)
+ || event.getPropertyName().equals(TopComponent.Registry.PROP_ACTIVATED))
+ {
+ // Get a reference to the Projects window
+ if (projectsTab == null)
+ {
+ projectsTab = WindowManager.getDefault().findTopComponent(PROJECT_LOGICAL_TAB_ID);
+ if (projectsTab == null)
+ {
+ logger.severe("propertyChange: cannot find the Projects logical window ("
+ + PROJECT_LOGICAL_TAB_ID + ")");
+ return;
+ }
+ }
+ // Look for the current project in the Projects window when activated and handle
+ // special case at startup when lastProject hasn't been initialized.
+ Node[] nodes = null;
+ TopComponent activated = TopComponent.getRegistry().getActivated();
+ if (activated != null && activated.equals(projectsTab))
+ {
+ logger.finer("propertyChange: processing activated nodes");
+ nodes = projectsTab.getActivatedNodes();
+ }
+ else if (lastProject == null)
+ {
+ logger.finer("propertyChange: processing selected nodes");
+ ExplorerManager em = ((ExplorerManager.Provider) projectsTab).getExplorerManager();
+ nodes = em.getSelectedNodes();
+ }
+ // Find and use the first project that owns a node
+ if (nodes != null)
+ {
+ for (Node node : nodes)
+ {
+ Project project = findProjectThatOwnsNode(node);
+ if (project != null)
+ {
+ synchronized (lock)
+ {
+ // Remember this project for when the Project Tab goes out of focus
+ lastProject = project;
+
+ // Add this project to the proxy if it's not in the global lookup
+ if (!resultProjects.allInstances().contains(lastProject))
+ {
+ logger.finer("propertyChange: Found project ["
+ + ProjectUtils.getInformation(lastProject).getDisplayName()
+ + "] that owns current node.");
+
+ updateProjectLookup(lastProject);
+ }
+ }
+ break;
+ }
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * This class listens for changes in the Project results, and ensures a Project remains in the
+ * Utilities.actionsGlobalContext() if a project is open.
+ */
+ private class LookupListenerImpl implements LookupListener
+ {
+ @Override
+ public void resultChanged(LookupEvent event)
+ {
+ logger.finer("resultChanged: Entered...");
+ synchronized (lock)
+ {
+ // First, handle projects in the principle lookup
+ if (resultProjects.allInstances().size() > 0)
+ {
+ // Clear the proxy, and remember this project.
+ // Note: not handling multiple selection of projects.
+ clearProjectLookup();
+ lastProject = resultProjects.allInstances().iterator().next();
+
+ logger.finer("resultChanged: Found project ["
+ + ProjectUtils.getInformation(lastProject).getDisplayName()
+ + "] in the normal lookup.");
+ }
+ else if (OpenProjects.getDefault().getOpenProjects().length==0)
+ {
+ clearProjectLookup();
+ lastProject = null;
+ }
+ else
+ {
+ if (lastProject == null)
+ {
+ // Find the project that owns the current Node
+ Node currrentNode = globalContextLookup.lookup(Node.class);
+ Project project = findProjectThatOwnsNode(currrentNode);
+ if (project != null)
+ {
+ lastProject = project;
+ logger.finer("resultChanged: Found project ["
+ + ProjectUtils.getInformation(lastProject).getDisplayName()
+ + "] that owns current node.");
+ }
+ }
+ // Add the last used project to our internal lookup
+ if (lastProject != null)
+ {
+ updateProjectLookup(lastProject);
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * Unconditionally clears the project lookup.
+ */
+ private void clearProjectLookup()
+ {
+ Collection<? extends Project> projects = projectLookup.lookupAll(Project.class);
+ for (Project project : projects)
+ {
+ content.remove(project);
+ }
+ }
+
+ /**
+ * Replaces the project lookup content.
+ * @param project to place in the project lookup.
+ */
+ private void updateProjectLookup(Project project)
+ {
+ if (project == null)
+ {
+ throw new IllegalArgumentException("project cannot be null.");
+ }
+ // Add the project if an instance of it is not already in the lookup
+ Template<Project> template = new Template<Project>(Project.class, null, project);
+ if (projectLookup.lookupItem(template) == null)
+ {
+ clearProjectLookup();
+ content.add(project);
+ logger.fine("updateProjectLookup: added ["
+ + ProjectUtils.getInformation(lastProject).getDisplayName()
+ + "] to the proxy lookup.");
+ }
+ }
+
+ /**
+ * Recursively searches the node hierarchy for the project that owns a node.
+ *
+ * @param node a node to test for a Project in its or its ancestor's lookup.
+ * @return the Project that owns the node, or null if not found
+ */
+ private static Project findProjectThatOwnsNode(Node node)
+ {
+ if (node != null)
+ {
+ Project project = node.getLookup().lookup(Project.class);
+ if (project == null)
+ {
+ DataObject dataObject = node.getLookup().lookup(DataObject.class);
+ if (dataObject != null)
+ {
+ project = FileOwnerQuery.getOwner(dataObject.getPrimaryFile());
+ }
+ }
+ return (project == null) ? findProjectThatOwnsNode(node.getParentNode()) : project;
+ }
+ else
+ {
+ return null;
+ }
+ }
+}
+
+----
+
+
+Tested with NetBeans IDE 7.2
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddGlobalContext[http://wiki.netbeans.org/DevFaqAddGlobalContext] ,
+that was last modified by NetBeans user Bdschubert
+on 2012-12-17T17:08:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddIconToContextMenu.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddIconToContextMenu.asciidoc
new file mode 100644
index 0000000..9084e26
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddIconToContextMenu.asciidoc
@@ -0,0 +1,111 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddIconToContextMenu
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do i add an icon to the context menu?
+
+NOTE: This is not recommended for NB RCP (it will break HMI standards on Mac OS X for example), but is still possible.
+
+Steps:
+
+* let your action implement Presenter.Popup and return a JMenuItem instance for the current action (see [1], [2])
+* set the icon via putValue(javax.swing.Action.SMALL_ICON, ...)
+* set the icon via putValue("iconBase", ...) to make it work properly in the toolbar. Otherwise you will get a fixed size icon.
+* By using setEnabled, it makes sure every listener will be notified (JButton, JMenuItem...). Moreover it is safer to call it on the EDT since it is not sure which thread triggered the event in the first place.
+[source,java]
+----
+
+@ActionID(
+ category = "Build",
+ id = "sample.contextmenu.HelloIconAction")
+@ActionReferences({
+ @ActionReference(path = "Menu/File", position = 0),
+ @ActionReference(path = "Loaders/Languages/Actions", position = 0),
+ @ActionReference(path="Projects/Actions")
+})
+@ActionRegistration(
+ displayName = "#CTL_HelloIconAction")
+
+@Messages("CTL_HelloIconAction=Hello Icon Action")
+public final class HelloIconAction extends AbstractAction implements Presenter.Popup {
+
+ @StaticResource
+ private static final String ICON = "sample/contextmenu/sample.gif";
+ private static final long serialVersionUID = 1L;
+ private final LookupListener lookupListener;
+ private final Lookup.Result<Project> result;
+
+ public HelloIconAction() {
+ putValue(SMALL_ICON, ImageUtilities.loadImageIcon(ICON, false));
+ putValue(NAME, Bundle.CTL_HelloIconAction());
+ putValue("iconBase", ICON);
+ result = Utilities.actionsGlobalContext().lookupResult(Project.class);
+ this.lookupListener = new LookupListener() {
+
+ @Override
+ public void resultChanged(LookupEvent ev) {
+ EventQueue.invokeLater(new Runnable() {
+
+ @Override
+ public void run() {
+ setEnabled(!result.allInstances().isEmpty());
+ }
+ });
+ }
+ };
+ result.addLookupListener(WeakListeners.create(LookupListener.class, this.lookupListener, result));
+ this.lookupListener.resultChanged(null);
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent ev) {
+ for (Project project : result.allInstances()) {
+ JOptionPane.showMessageDialog(null, "Hello colorful project.\n" + project.toString());
+ }
+ }
+
+ @Override
+ public JMenuItem getPopupPresenter() {
+ return new JMenuItem(this);
+ }
+}
+----
+
+[1] link:http://wiki.netbeans.org/DevFaqChangeMenuItemToolbarAppearanceForAction[http://wiki.netbeans.org/DevFaqChangeMenuItemToolbarAppearanceForAction]
+
+
+[2] link:http://forums.netbeans.org/topic40762.html[http://forums.netbeans.org/topic40762.html]
+
+[3] link:http://benkiew.wordpress.com/2012/12/28/netbeans-how-to-create-a-context-aware-action-with-an-icon-for-the-context-menu/[http://benkiew.wordpress.com/2012/12/28/netbeans-how-to-create-a-context-aware-action-with-an-icon-for-the-context-menu/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddIconToContextMenu[http://wiki.netbeans.org/DevFaqAddIconToContextMenu] ,
+that was last modified by NetBeans user Jmborer
+on 2013-10-17T13:27:02Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddMacroableAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddMacroableAction.asciidoc
new file mode 100644
index 0000000..f9fdc3e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddMacroableAction.asciidoc
@@ -0,0 +1,55 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddMacroableAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How do I create an action which can be invoked by a macro?
+
+Use @EditorActionRegistration!
+
+[source,java]
+----
+
+@NbBundle.Messages({ "CTL_MyAction=Let's go", "macro-name=Let's go" })
+@EditorActionRegistration(
+ name = "macro-name",
+ mimeType = "text/x-java",
+ menuPath = "Source", menuPosition = 0, menuText = "#CTL_MyAction")
+public class MyAction extends org.netbeans.editor.BaseAction {
+ //...
+}
+
+----
+
+Then your action can be invoked by a macro (and even recorded by the macro recorder)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddMacroableAction[http://wiki.netbeans.org/DevFaqAddMacroableAction] ,
+that was last modified by NetBeans user Markiewb
+on 2016-09-12T19:38:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddShortCutForAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddShortCutForAction.asciidoc
new file mode 100644
index 0000000..cd527c6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddShortCutForAction.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddShortCutForAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to set the shortcut of an action outside of your own module?
+
+Register a shortcut at the "Shortcuts" folder in the layer.xml.
+
+[source,xml]
+----
+
+ <folder name="Shortcuts">
+ <file name="C-8.shadow">
+ <!--org.netbeans.modules.db.explorer.action.ExecuteCommandAction-->
+ <attr name="originalFile" stringvalue="Actions/Database/org-netbeans-modules-db-explorer-action-ExecuteCommandAction.instance"/>
+ </file>
+ </folder>
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddShortCutForAction[http://wiki.netbeans.org/DevFaqAddShortCutForAction] ,
+that was last modified by NetBeans user Markiewb
+on 2016-08-06T14:53:22Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddTimestampToLogs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddTimestampToLogs.asciidoc
new file mode 100644
index 0000000..9ca39ca
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddTimestampToLogs.asciidoc
@@ -0,0 +1,160 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddTimestampToLogs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How Do I Add a Timestamp to the Logs?
+
+This FAQ entry demonstrates how to prepend a timestamp to your log file entries. For example:
+
+[source,java]
+----
+
+05:42:51.210 CONFIG [com.emxsys.wmt.core.project.GlobalActionContextProxy]: Creating a proxy ....
+05:42:51.295 WARNING [org.openide.filesystems.Ordering]: Not all children in ....
+05:42:52.151 INFO [org.netbeans.core.startup.NbEvents]: Turning on modules: ....
+----
+
+=== Caveats
+
+The NetBeans Platform includes its own logging mechanism. If you customize the logging through the use of the _java.util.logging.config.file_ or _java.util.logging.config.class_ property settings, then the native NetBeans logging mechanism is completely disabled, and either the default Java logging or your custom logging class is used instead.
+
+=== Solution
+
+This solution shows how to customize the output from the native NetBeans log formatter (_NbFormatter_) by creating a new custom formatter that by prepends a timestamp to the log messages. Note, using _NbFormatter_ requires a private package reference to the _org-netbeans-core-startup_ module. This FAQ will also show how to establish the private package access.
+
+==== Step 1. Establish Project Dependencies
+
+Include the a dependency on *org-netbeans-core-startup* in the project that will implement the custom formatter. In Maven, add following entry to the project POM:
+
+[source,xml]
+----
+
+<dependency>
+ <!--Private Package References: see maven plugin dependencies ...-->
+ <artifactId>org-netbeans-core-startup</artifactId>
+ <groupId>org.netbeans.modules</groupId>
+ <version>${netbeans.version}</version>
+</dependency>
+
+----
+
+==== Step 2. Create the Custom Log Formatter
+
+Here's an example of a custom _Formatter_. It uses the NetBeans _NbFormatter_ instance to obtain a formatted message from the _LogRecord_. NbFormatter is a final class that exposes itself via a public static _FORMATTER_ property. This solution simply prepends a timestamp, extracted from the LogRecord, to the formatted log message.
+
+[source,java]
+----
+
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.util.logging.Formatter;
+import java.util.logging.LogRecord;
+import org.netbeans.core.startup.logging.NbFormatter; // Private Package Referenced: See POM notes.
+
+public class LogFormatter extends Formatter {
+
+ @Override
+ public String format(LogRecord record) {
+ String logMsg = NbFormatter.FORMATTER.format(record);
+ StringBuilder sb = new StringBuilder();
+
+ // Prepend a timestamp
+ Instant instant = Instant.ofEpochMilli(record.getMillis());
+ ZonedDateTime timestamp = ZonedDateTime.ofInstant(instant, ZoneId.systemDefault());
+ sb.append(timestamp.toLocalTime.toString());
+ sb.append(' ');
+ sb.append(logMsg);
+
+ return sb.toString();
+ }
+}
+
+----
+
+==== Step 3. Override the Default Formatters
+
+In a module _Installer_ class, include the following code block in the restored method to replace the default formatters with the custom formatter:
+
+[source,java]
+----
+
+public class Installer extends ModuleInstall {
+
+ @Override
+ public void restored() {
+
+ // Override the default formatters with the custom formatter
+ LogFormatter formatter = new LogFormatter(); // Custom formatter
+ Logger logger = Logger.getLogger (""); // Root logger
+ Handler[] handlers = logger.getHandlers();
+ for (Handler handler : handlers) {
+ handler.setFormatter(formatter);
+ }
+ }
+}
+
+----
+
+==== Step 4. Configure Access to Private Package
+
+In the project's POM, edit the *nbm-maven-plugin* configuration to allow private package access to *org.netbeans.modules:org-netbeans-core-startup* via an *impl* module dependency, for example:
+
+[source,xml]
+----
+
+<plugin>
+ <artifactId>nbm-maven-plugin</artifactId>
+ <groupId>org.codehaus.mojo</groupId>
+ <extensions>true</extensions>
+ <configuration>
+ <moduleDependencies>
+ <dependency>
+ <!--Private Package Reference-->
+ <id>org.netbeans.modules:org-netbeans-core-startup</id>
+ <type>impl</type>
+ </dependency>
+ </moduleDependencies>
+ </configuration>
+</plugin>
+
+----
+
+=== Final Notes
+
+To leverage the NetBeans logging, you must disable any _java.util.logging.config.file_ or _java.util.logging.config.class_ property settings. Check your application's .conf file, and, in the application's POM, check the _additionalArguments_ entry.
+
+<hr/>
+
+This example was tested with NetBeans 8.0 and JDK 8.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddTimestampToLogs[http://wiki.netbeans.org/DevFaqAddTimestampToLogs] ,
+that was last modified by NetBeans user Bdschubert
+on 2014-06-21T13:31:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAddingRemovingChildrenDynamically.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAddingRemovingChildrenDynamically.asciidoc
new file mode 100644
index 0000000..3125761
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAddingRemovingChildrenDynamically.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAddingRemovingChildrenDynamically
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add or remove children of a node on the fly?
+
+Yes. Have your node subclass link:http://www.netbeans.org/download/dev/javadoc/org-openide-nodes/org/openide/nodes/AbstractNode.html[AbstractNode]
+or whatever else you like.
+
+*NB 6 > m9 Specific*:
+Implement `ChildFactory`. To create the `Children` object for your Node, pass it to `Children.create()`. When the child list needs updating, call `refresh()` on your `ChildFactory`. Its `createKeys` method will be called again and you can update the set of key objects as needed; Nodes for objects that remain in the list of keys will simply continue to exist; additions and removals will be handled.
+
+*NB 5 And Earlier*:
+Have your `Children` object subclass link:http://www.netbeans.org/download/dev/javadoc/org-openide-nodes/org/openide/nodes/Children.Keys.html[Children.Keys].
+As needed, call `setKeys()` on the `Children.Keys` object.
+Just by passing a larger or smaller (or reordered) list of keys, you will be adding or removing (or reordering) children.
+
+Do not _ever_ try to add/remove children from a node you
+did not create (unless it has an API that explicitly gives you permission to do that); occasionally
+people try to add child nodes to nodes for things like Java files. If it works at all it's by accident.
+
+---
+
+Applies to: NetBeans 4.0, 4.1, 5.0
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAddingRemovingChildrenDynamically[http://wiki.netbeans.org/DevFaqAddingRemovingChildrenDynamically] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:36:07Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAnnotationDevelopDebug.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAnnotationDevelopDebug.asciidoc
new file mode 100644
index 0000000..9d8f6e3
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAnnotationDevelopDebug.asciidoc
@@ -0,0 +1,129 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAnnotationDevelopDebug
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I develop and debug annotations for NetBeans platform apps?
+
+The NetBeans platform has API support for creating XML layer entries from annotations. The popular book "NetBeans Platform for Beginners" has several examples of writing your own annotations. Familiarity with developing annotations and annotation processing is a prerequisite. Though not specifically about NetBeans platform annotations, link:https://netbeans.org/kb/docs/java/annotations.html[Annotation Processors Support in the NetBeans IDE] may also be useful for those new to working with annotions.
+
+The relevant NetBeans platform APIs are described at
+link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/annotations/package-summary.html[Package org.openide.filesystems.annotations]. Note that link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/annotations/LayerBuilder.File.html[Class LayerBuilder.File] has the methods for adding specific attributes to a layer file. Near the end of the package description there is mention of _AnnotationProcessorTestUtils_ this is found in the NetBeans sources at _openide.util.lookup/test/unit/src/org/openide/util/test/AnnotationProcessorTestUtils.java_.
+
+Much of the following is found in messages of the thread link:https://forums.netbeans.org/topic63404.html[Debugging Platform annotations], from the platform mailing list.
+
+== Debugging Custom Annotations
+
+=== Printf is your friend
+
+Tim Boudreau says: I've written quite a few annotation processors, and System.out.println() is your friend. Trying to actually step through this stuff in a debugger is pretty useless, but I've never hit something I couldn't solve with plain old console logging.
+
+=== If you really want to use a debugger
+
+There is a mailing list thread link:http://forums.netbeans.org/topic53688.html[Debugging an annotation processor] from a few years ago which has a messy/complicated process suggesting ANT_OPS and "Attach Debugger" outlined by Jaroslav Tulach .
+
+== Hints and techniques for developing annotations
+
+Things that generally bite you when writing an annotation processor:
+
+* Handling unexpected types - i.e. someone writes an annotation and a parameter that's supposed to be an int is in source code as a string - best you can do is catch these and bail out, but if you don't, you'll see an exception dialog pop up in NetBeans when your processor hits code like that
+* Dealing with things that explode on contact - i.e. annotation parameters of type Class will throw an exception if you try to read their value via the Annotation instances javac gives you (the Class objects referenced are not necessarily on the classpath, or even valid) - you have to instead find the right AnnotationMirror and get the value as a string - example here, see validatorsForParam() link:https://github.com/timboudreau/numble/blob/master/src/main/java/com/mastfrog/parameters/processor/Processor.java[https://github.com/timboudreau/numble/blob/master/src/main/java/com/mastfrog/parameters/processor/Processor.java]
+* Opening or trying to write a file more than once (annotation processing happens in multiple rounds - until the last round you should just collect data) - but LayerGeneratingProcessor should solve this for you if you're using it - but if not, have a look at the source code for it
+
+Anything you do regarding analyzing or using classes when processing annotations you want to do using javac's API - you *do not ever* want to load a user-defined class into an annotation processor. Imagine what
+
+[source,java]
+----
+
+static {
+ for (;;) { EventQueue.invokeLater(new Runnable(){ throw new Error(); })}
+}
+----
+
+would do if you actually loaded something like that during a compilation.
+
+== Examples
+
+Checking for a subtype, can't use _instanceof_ since should *not* load user classes.
+
+[source,java]
+----
+
+public void isSubtypeOf(Element e, String qualifiedClassName) {
+ Types types = processingEnv.getTypeUtils();
+ Elements elements = processingEnv.getElementUtils();
+ TypeElement pageType = elements.getTypeElement(qualifiedClassName);
+ if (pageType == null) { //not on the classpath javac can see
+ return false;
+ }
+ return types.isSubtype(e.asType(), pageType.asType());
+}
+----
+
+Getting the elements of an enum, with lots of checking
+
+[source,java]
+----
+
+private List<String> getEnumConstants(String enumQalifiedClassName) {
+ if(enumQalifiedClassName.isEmpty())
+ return Collections.emptyList();
+ Element e = processingEnv.getElementUtils()
+ .getTypeElement(enumQalifiedClassName);
+ if(e == null) {
+ processingEnv.getMessager().printMessage(
+ Diagnostic.Kind.ERROR, "enumQalifiedClassName '" + enumQalifiedClassName
+ + "' does not exist");
+ return null;
+ }
+ if(e.getKind() != ElementKind.ENUM) {
+ processingEnv.getMessager().printMessage(
+ Diagnostic.Kind.ERROR, "enumQalifiedClassName '" + enumQalifiedClassName
+ + "' is not an Enum");
+ return null;
+ }
+----
+[source,java]
+----
+
+ Types types = processingEnv.getTypeUtils();
+ List<? extends Element> elems = e.getEnclosedElements();
+ List<String> enumConstantsNames = new ArrayList<String>(elems.size());
+ for(Element e01 : elems) {
+ if(e01.getKind() == ElementKind.ENUM_CONSTANT)
+ enumConstantsNames.add(e01.getSimpleName().toString());
+ }
+ return enumConstantsNames;
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAnnotationDevelopDebug[http://wiki.netbeans.org/DevFaqAnnotationDevelopDebug] ,
+that was last modified by NetBeans user Err
+on 2015-06-07T22:28:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAnnotationList.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAnnotationList.asciidoc
new file mode 100644
index 0000000..9e4bb10
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAnnotationList.asciidoc
@@ -0,0 +1,101 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAnnotationList
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== NetBeans Annotation Cheat Sheet
+
+==== Actions
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/ActionID.html[@ActionID]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/ActionReference.html[@ActionReference]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/ActionReferences.html[@ActionReferences]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/ActionRegistration.html[@ActionRegistration]
+
+==== Editor
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.Registration.html[@DataObject.Registration] (new in 7.2)
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-lib2/org/netbeans/api/editor/EditorActionRegistration.html[@EditorActionRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-lib2/org/netbeans/api/editor/EditorActionRegistrations.html[@EditorActionRegistrations]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-mimelookup/org/netbeans/spi/editor/mimelookup/MimeLocation.html[@MimeLocation]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-mimelookup/org/netbeans/api/editor/mimelookup/MimeRegistration.html[@MimeRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-mimelookup/org/netbeans/api/editor/mimelookup/MimeRegistrations.html[@MimeRegistrations]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/MIMEResolver.ExtensionRegistration.html[@MIMEResolver.ExtensionRegistration] (new in 7.2)
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/MIMEResolver.NamespaceRegistration.html[@MIMEResolver.NamespaceRegistration] (new in 7.2)
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/MIMEResolver.Registration.html[@MIMEResolver.Registration] (new in 7.2)
+
+==== Lookup
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html[@ServiceProvider]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProviders.html[@ServiceProviders]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectapi/org/netbeans/spi/project/LookupMerger.Registration.html[@LookupMerger.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectapi/org/netbeans/spi/project/LookupProvider.Registration.html[@LookupProvider.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectapi/org/netbeans/spi/project/LookupProvider.Registration.ProjectType.html[@LookupProvider.Registration.ProjectType]
+
+==== Navigator
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-spi-navigator/org/netbeans/spi/navigator/NavigatorPanel.Registration.html[@NavigatorPanel.Registration] (new in 7.2)
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-spi-navigator/org/netbeans/spi/navigator/NavigatorPanel.Registrations.html[@NavigatorPanel.Registrations] (new in 7.2)
+
+==== Nodes
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/support/NodeFactory.Registration.html[@NodeFactory.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-core-ide/org/netbeans/api/core/ide/ServicesTabNodeRegistration.html[@ServicesTabNodeRegistration]
+
+==== Options Window
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.ContainerRegistration.html[@OptionsPanelController.ContainerRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.SubRegistration.html[@OptionsPanelController.SubRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.TopLevelRegistration.html[@OptionsPanelController.TopLevelRegistration]
+
+==== Project System
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-project-ant/org/netbeans/spi/project/support/ant/AntBasedProjectRegistration.html[@AntBasedProjectRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/support/ProjectCustomizer.CompositeCategoryProvider.Registration.html[@ProjectCustomizer.CompositeCategoryProvider.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectapi/org/netbeans/spi/project/ProjectServiceProvider.html[@ProjectServiceProvider]
+
+==== Window System
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.OpenActionRegistration.html[@TopComponent.OpenActionRegistration]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.Registration.html[@TopComponent.Registration]
+
+==== Miscellaneous
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-settings/org/netbeans/api/settings/ConvertAsJavaBean.html[@ConvertAsJavaBean]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-settings/org/netbeans/api/settings/ConvertAsProperties.html[@ConvertAsProperties]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbBundle.Messages.html[@NbBundle.Messages]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-versioning/org/netbeans/modules/versioning/spi/VersioningSystem.Registration.html[@VersioningSystem.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-core-multiview/org/netbeans/core/spi/multiview/MultiViewElement.Registration.html[@MultiViewElement.Registration]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-sendopts/org/netbeans/spi/sendopts/Arg.html[@Arg] (new in 7.2)
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-api-annotations-common/org/netbeans/api/annotations/common/StaticResource.html[@StaticResource] (new in 7.2)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAnnotationList[http://wiki.netbeans.org/DevFaqAnnotationList] ,
+that was last modified by NetBeans user Geertjan
+on 2012-02-21T07:24:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqApiSpi.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqApiSpi.asciidoc
new file mode 100644
index 0000000..ec39bdb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqApiSpi.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqApiSpi
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== What is an SPI? How is it different from an API?
+
+link:http://en.wikipedia.org/wiki/Api[API] is a general term - an acronym for _Application Programming Interface_ - it means something (in Java, usually some Java classes) a piece of software exposes, which allows other software to communicate with it.
+
+SPI stands for _Service Provider Interface_. It is a subset of all things that can be API specific to situations where a library is providing classes which are *called by* the application (or API library), and which typically change the things the application is able to do.
+
+The classic example is link:http://java.sun.com/products/javamail/[JavaMail]. Its API has two sides:
+
+* The _API side_ — which you call if you are writing a mail client or want to read a mailbox
+* The _SPI side_ if you are providing a wire-protocol handler to allow JavaMail to talk to a new kind of server, such as a news or IMAP server
+
+Users of the API rarely need to see or talk to the SPI classes, and vice-versa.
+
+In NetBeans, when you see the term SPI, it is usually talking about classes that a module can inject at runtime which allow NetBeans to do new things. For example, there is a general SPI for implementing version control systems. Different modules provide implementations of that SPI for CVS, Subversion, Mercurial and other revision control systems. However, the code that deals with files (the API side) does not need to care if there is a version control system, or what it is.
+
+link:http://weblogs.java.net/blog/2008/08/11/capability-pattern-future-proof-your-apis[More on API and SPI]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqApiSpi[http://wiki.netbeans.org/DevFaqApiSpi] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-11T20:10:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqApisBasics.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqApisBasics.asciidoc
new file mode 100644
index 0000000..5063590
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqApisBasics.asciidoc
@@ -0,0 +1,68 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqApisBasics
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are the basic things I should know about NetBeans' architecture to get started creating NetBeans Platform applications?
+
+The most important thing you need when creating applications on top of the NetBeans Platform (a.k.a. NetBeans RCP) is to know what you are trying to do clearly, so you can find what you need to get started quickly. Here are some basic NetBeans factoids which will either answer some questions or whet your appetite for more information:
+
+* A module is a JAR file with some special manifest entries. The NetBeans IDE (5.0 and up) has lots of support for building modules.
+* Modules usually affect the system by putting entries in an link:DevFaqModulesLayerFile.html[XML file] inside their JAR, which the system reads.
+* You can link:DevFaqActionAddMenuBar.html[add] to, remove from, change or completely remove menus from the main window, toolbars and other things from a module
+* To show your own tabs in the main window, you will want to subclass link:DevFaqWindowsTopComponent.html[TopComponent]
+* The windowing system provides facilities for link:DevFaqTrackingExplorerSelections.html[tracking selection], and actions can be made sensitive to selection. Selection typically centers around use of link:DevFaqWhatIsANode.html[Node]s; it is also possible to have link:DevFaqTrackGlobalSelection.html[context sensitive actions without Nodes].
+* It is possible to build tree and other views of objects very quickly using link:DevFaqWhatIsANode.html[Node]s in conjunction with link:DevFaqExplorerViews.html[Explorer Views]
+* Many pieces of NetBeans UI are really views of some folder in the link:DevFaqSystemFilesystem.html[configuration filesystem] which modules install things into
+* The link:DevFaqSystemFilesystem.html[configuration filesystem] is read-write, and changes can be saved to the link:DevFaqUserDir.html[user's settings directory]
+* Applications built on NetBeans do not have to be IDE-like - there is plenty of support for editing files available in the Editor module and friends, but you do not even have to include those modules in your application if you do not use them
+
+A lot of things in NetBeans are based around _file recognition_ and using files to provide Java objects. Even if your application has nothing to do with editing files, this may still be very useful to you, since the same mechanism that recognizes/displays a user's files on disk also recognizes/displays configuration data (which may not even be files in the traditional sense at all), and such "files" can actually be factories for whatever kind of object you want (and that way you get persistence of those files for free).
+
+For example, the link:http://platform.netbeans.org/tutorials/nbm-feedreader.html[FeedReader tutorial] simply serializes POJO Feed objects into the link:DevFaqSystemFilesystem.html[configuration filesystem ], and its whole UI consists of aiming a standard tree component at a folder full of those objects, and providing a few actions to let the user create more of them. When the application shuts down, it does not need to any special code for persisting them, it is all automatic.
+
+For more information about how that works, see link:DevFaqFileRecognition.html[the section on file recognition].
+
+One of the most basic and important things to know about is link:DevFaqModulesGeneral.html[how modules register objects] - this is mainly done through a configuration file inside the module's jar file (if you are using NetBeans 5.0 or greater's module building support, you can usually avoid hand-editing this file). Most things a module does to influence the environment are link:DevFaqModulesDeclarativeVsProgrammatic.html[declarative] rather than programmatic - in other words, you put some text in an XML file, or an entry in a jar manifest, or a file in some specific place in the module jar, and your functionality will be discovered when the system starts up - as opposed to writing java code.
+
+Two of the most common needs are opening custom link:DevFaqWindowsTopComponent.html[Swing components] in the UI, and link:DevFaqActionAddMenuBar.html[installing actions in the main menu ].
+
+Other basic topics that are worth reading to get the lay of the land are:
+
+* link:DevFaqLookup.html[Lookup]
+* link:DevFaqModulesStartupActions.html[How to run some code on startup]
+* link:DevFaqFileSystem.html[Overview of filesystems]
+* link:DevFaqWindowsGeneral.html[The windowing system]
+
+There are link:DevFaqTutorialsIndex.html[various tutorials], and the canonical reference to NetBeans APIs is the link:http://bits.netbeans.org/dev/javadoc/index.html[API javadoc].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqApisBasics[http://wiki.netbeans.org/DevFaqApisBasics] ,
+that was last modified by NetBeans user Geertjan
+on 2010-06-14T09:01:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAppClientOnNbPlatformTut.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAppClientOnNbPlatformTut.asciidoc
new file mode 100644
index 0000000..b1129d6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAppClientOnNbPlatformTut.asciidoc
@@ -0,0 +1,383 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAppClientOnNbPlatformTut
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Java EE Application Client on top of the NetBeans Platform Tutorial
+
+=== Draft
+
+This is document currently has draft status
+
+This tutorial will show you how easy is to create an application client on top of the NetBeans Platform. It will be demonstrated on the example of Database Reader.
+
+=== Table of Contents
+
+* link:DevFaqAppClientOnNbPlatformTut#Requirements.html[Requirements]
+* link:DevFaqAppClientOnNbPlatformTut#InstallationAndConfiguration.html[Installation And Configuration]
+* link:DevFaqAppClientOnNbPlatformTut#ProjectsCreation.html[Projects Creation]
+* link:DevFaqAppClientOnNbPlatformTut#EnterpriseApplicationDevelopment.html[Enterprise Application Development]
+* link:DevFaqAppClientOnNbPlatformTut#BuildScriptModifying.html[Build Script Modifying]
+* link:DevFaqAppClientOnNbPlatformTut#GeneratingEntityClassesFromDatabase.html[Generating Entity Classes From Database]
+* link:DevFaqAppClientOnNbPlatformTut#CreateSessionBean.html[Create Session Bean (stateless) with remote interface to communicate with persistence unit]
+* link:DevFaqAppClientOnNbPlatformTut#ModifyApplicationClient.html[Modify the dbreader-ear-app-client Application Client module]
+* link:DevFaqAppClientOnNbPlatformTut#NetBeansModulesDevelopment.html[NetBeans Modules Development]
+* link:DevFaqAppClientOnNbPlatformTut#SetUpSuite.html[Set Up dbreader NetBeans Module Suite]
+* link:DevFaqAppClientOnNbPlatformTut#SetUpModule.html[Set Up customers NetBeans Module]
+* link:DevFaqAppClientOnNbPlatformTut#CreateWindowComponent.html[Create Window Component]
+* link:DevFaqAppClientOnNbPlatformTut#WriteCustomersTopComponentLogic.html[Write Customers Top Component Logic]
+* link:DevFaqAppClientOnNbPlatformTut#RunApplication.html[Run Application]
+* link:DevFaqAppClientOnNbPlatformTut#DebugApplication.html[Debug Application]
+
+
+
+-
+
+=== Requirements
+
+* link:http://java.sun.com/javase/downloads/index_jdk5.jsp[Java(TM) SE Development Kit 5.0]
+* link:http://www.netbeans.org/[NetBeans IDE 5.5.1] or later
+* NetBeans Platform 5.5.1 or later
+* link:https://glassfish.dev.java.net/public/downloadsindex.html[GlassFish v2] or later
+
+=== Installation And Configuration
+
+Install all of the required products (installation guides are available on the product's websites). When it'll be done we have to set up a few things. First of all please start NetBeans IDE 5.5.1 and register GlassFish v2. Right click on the Servers node in the Runtime tab and select Add server (choose Sun Java Application Server).
+
+image:addserver_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now we need to register NetBeans Platform into IDE. It's in fact almost same as to add a new server. In menu Tools -> NetBeans Platform Manager click on a Add Platform button and pass through the wizard (as a new platform select downloaded NetBeans Platform 5.5.1).
+
+image:addplatform_DevFaqAppClientOnNbPlatformTut.png[]
+
+=== Projects Creation
+
+It's time to create all projects. We need NetBeans Module Suite project, NetBeans Module (added into your NetBeans Module Suite) project and Enterprise Application project with Application Client and EJB module included. Let's do it. First of all we create NetBeans Module Suite project. Call it dbreader. As used platform choose the new one what you registered before.
+
+image:createsuite1_DevFaqAppClientOnNbPlatformTut.png[]
+
+image:createsuite2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Then create NetBeans Module Project. Call it customers. And check that you want to add it into your dbreader suite. All other options leave as default.
+
+image:createmodule_DevFaqAppClientOnNbPlatformTut.png[]
+
+Actually we have had NetBeans Modules created and now we have to create Java EE part. So let's create an Enterprise Application with Application Client and EJB module. Call it dbreader-ear. Include Application Client and EJB module. Exclude Web module. Also select Java EE 5 version and choose Sun Java Application Server as development server.
+
+image:createear1_DevFaqAppClientOnNbPlatformTut.png[]
+
+image:createear2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Great ! You have successfully created all required projects. Now you should see something like this in Projects tab.
+
+image:projects_DevFaqAppClientOnNbPlatformTut.png[]
+
+=== Enterprise Application Development
+
+==== Build Script Modifying (5.5.x)
+
+We need to modify dbreader-ear build.xml script because the dbreader suite jnlp distro has to be packed into dbreader ear. Due to add these lines into dbreader-ear build.xml (instructions for 6.x are in the next part).
+
+[source,xml]
+----
+
+ <property name="dbreader.home" value="../"/>
+
+ <target name="build-dbreader-jnlp">
+ <java classname="org.apache.tools.ant.Main" dir="${dbreader.home}" failonerror="true" fork="true">
+ <jvmarg value="-Dant.home=${ant.home}"/>
+ <arg value="build-jnlp"/>
+ <classpath path="${java.class.path}"/>
+ </java>
+ </target>
+
+ <target name="pre-dist" depends="build-dbreader-jnlp">
+ <!-- dbreader.home must point to DatabaseReader Application home directory -->
+
+ <mkdir dir="${build.dir}/lib"/>
+ <copy todir="${build.dir}/lib">
+ <fileset dir="${dbreader.home}/build/jnlp/app" includes="*.jar" />
+ <fileset dir="${dbreader.home}/build/jnlp/branding" includes="*.jar" />
+ <fileset dir="${dbreader.home}/build/jnlp/netbeans" includes="*.jar" />
+ </copy>
+ </target>
+----
+
+You are able to access build.xml file in Files view.
+
+image:editearbuild1_DevFaqAppClientOnNbPlatformTut.png[]
+
+After editing you should see something like this.
+
+image:editearbuild2_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Build Script Modifying (6.x)
+
+[source,xml]
+----
+
+ <property name="dbreader.home" value="../"/>
+
+ <target name="build-dbreader-jnlp">
+ <java classname="org.apache.tools.ant.Main" dir="${dbreader.home}" failonerror="true" fork="true">
+ <jvmarg value="-Dant.home=${ant.home}"/>
+ <arg value="build-jnlp"/>
+ <classpath path="${java.class.path}"/>
+ </java>
+ </target>
+
+ <target name="pre-dist" depends="build-dbreader-jnlp">
+ <!-- dbreader.home must point to DatabaseReader Application home directory -->
+
+ <mkdir dir="${build.dir}/lib"/>
+ <copy todir="${build.dir}/lib">
+ <flattenmapper/>
+ <fileset dir="${dbreader.home}/build/jnlp/app" includes="**/*.jar" />
+ <fileset dir="${dbreader.home}/build/jnlp/branding" includes="**/*.jar" />
+ <fileset dir="${dbreader.home}/build/jnlp/netbeans" includes="**/*.jar" />
+ </copy>
+ </target>
+----
+
+If you're not using Mac then also don't forget to exclude "Apple Application Menu" module (module suite project properties -> libraries -> PlatformX). Also make sure you're including only modules from platformX cluster.
+
+==== Generating Entity Classes From Database
+
+We have dbreader-ear project infrastructure prepared. Now we have to generate entity classes from sample database. Right click on dbreader-ear-ejb project in Project tab and select New -> Entity Classes From Database. In wizard chose as datasource jdbc/sample datasource and select CUSTOMER table.
+
+image:generateentity1_DevFaqAppClientOnNbPlatformTut.png[]
+
+On the next wizard panel type package for entity classes. Type db. Then Click on create persistence unit. Persistence unit dialog will appear. Click on Create. Now finish the wizard by clicking on the Finish button.
+
+image:generateentity2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now we have generated entity classes from jdbc/sample database. Under dbreader-ear-ejb project you can see generated classes.
+
+image:generateentity3_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Create Session Bean
+
+We need to create stateless session bean with remote interface to communicate with persistence unit. Create one and call it DataBean.
+
+image:createsession1_DevFaqAppClientOnNbPlatformTut.png[]
+
+When you have session bean created add business method called getData. You are able to do it by right clicking on the editor pane (in DataBean.java file opened) and select EJB Methods -> Add Business Method. Pass through the wizard and create getData method which returns <pre>java.util.List</pre>.
+
+image:createsession2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now use entity manager. Once again do a right click on the editor pane and select Persistence -> Use Entity Manager. Entity manager code is generated. Now implement getData method.
+
+[source,java]
+----
+
+ public List getData() {
+ //TODO implement getData
+ return em.createQuery("SELECT c FROM Customer c").getResultList();
+ }
+----
+
+After that you should see in editor (in DataBean.java file) something like this.
+
+image:createsession3_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Modify Application Client
+
+We prepared EJB module and now we have to implement functionality into dbreader-ear-app-client Application Client module. Open Main.java file in dbreader-ear-app-client project.
+
+image:modifyappclient1_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now call your session bean DataBean. Right click on editor pane and select Enterprise Resources -> Call Enterprise Bean. In the dialog select your DataBean and click OK.
+
+image:modifyappclient2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now we need to implement main method and create getCustomers method. Before that add <dbreader_project_home>/build/jnlp/netbeans/boot.jar (or <dbreader_project_home>/build/jnlp/netbeans/org-netbeans-bootstrap/boot.jar in case of NetBeans 6.1) file on classpath. Do it by right clicking on dbreader-ear-app-client project and select Properties. There select Libraries and then click on Add JAR/Folder and in open file dialog select boot.jar file. Don't forget to uncheck the checkbox. We do not want to package this file with dbreader-ear-app-client module. Actually you have to run build-jnlp target on dbreader suite. Before that please perform step link:DevFaqAppClientOnNbPlatformTut#SetUpSuite.html[Set Up Suite]. Then you can right click on dbreader project and select Build JNLP Application.
+
+image:modifyappclient3_DevFaqAppClientOnNbPlatformTut.png[]
+
+Implement main method by this code.
+
+[source,java]
+----
+
+ public static void main(String[] args) {
+ try {
+ String userDir = System.getProperty("user.home") + File.separator + ".dbreader";
+ org.netbeans.Main.main(new String[] {"--branding", "dbreader", "--userdir", userDir});
+ } catch (Exception ex) {
+ ex.printStackTrace();
+ }
+ }
+----
+
+Now create getCustomers static method.
+
+[source,java]
+----
+
+ public static List getCustomers() {
+ return dataBean.getData();
+ }
+----
+
+After doing this you should see something like this in editor pane.
+
+image:modifyappclient4_DevFaqAppClientOnNbPlatformTut.png[]
+
+Great ! We have finished development of the dbreader-ear Enterprise Application. Let's go to develop NetBeans Modules.
+
+=== NetBeans Modules Development
+
+==== Set Up Suite
+
+Now we set up the dbreader NetBeans module suite. We have to set it as standalone application and also we are able to change splash screen. Right click on dbreader project and select Properties. There select Application and then click on the Create Standalone Application.
+
+image:setupsuite1_DevFaqAppClientOnNbPlatformTut.png[]
+
+Also you are able to set up your own splash screen. Do it by same way and under the Application node in project Properties click on Splash Screen.
+
+image:setupsuite2_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Set Up Module
+
+Now we set up the customers NetBeans Module. We have to add dbreader-ear-ejb.jar, dbreader-ear-app-client.jar and javaee.jar on compile classpath. First of all set sources level of the module to 1.5. Right click on customers project and on the first panel select 1.5 for sources level.
+
+image:setupmodule1_DevFaqAppClientOnNbPlatformTut.png[]
+
+Open project.properties file from project tab.
+
+image:setupmodule2_DevFaqAppClientOnNbPlatformTut.png[]
+
+Add this code into project.properties file. Of course use your own path to dbreader and glassfish.
+
+[source,java]
+----
+
+cp.extra=\
+/home/marigan/temp/dbreader/dbreader-ear/dbreader-ear-ejb/dist/dbreader-ear-ejb.jar:\
+/home/marigan/temp/dbreader/dbreader-ear/dbreader-ear-app-client/dist/dbreader-ear-app-client.jar:\
+/home/marigan/apps/glassfish/lib/javaee.jar
+----
+
+After that you should see something like this in editor pane.
+
+image:setupmodule3_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Create Window Component
+
+Now we create a new window component which will serve as viewer for database data. Right click on customers project and select New -> Window Component. On the first wizard panel choose editor as Window Position and select Open on Application Start.
+
+image:createwindow1_DevFaqAppClientOnNbPlatformTut.png[]
+
+On the second panel specify component Class Name Prefix (use Customers) and finish the wizard.
+
+image:createwindow2_DevFaqAppClientOnNbPlatformTut.png[]
+
+After that you should see this in Project tab.
+
+image:createwindow3_DevFaqAppClientOnNbPlatformTut.png[]
+
+==== Write Customers Top Component Logic
+
+We have to write application logic for customers top component. Open CustomersTopComponent.java file in design mode and drag and drop a jTable component from palette into it.
+
+image:writelogic1_DevFaqAppClientOnNbPlatformTut.png[]
+
+Now switch into source view and modify constructor and add initData method.
+
+[source,java]
+----
+
+ private CustomersTopComponent() {
+ initComponents();
+ setName(NbBundle.getMessage(CustomersTopComponent.class, "CTL_CustomersTopComponent"));
+ setToolTipText(NbBundle.getMessage(CustomersTopComponent.class, "HINT_CustomersTopComponent"));
+// setIcon(Utilities.loadImage(ICON_PATH, true));
+
+ initData();
+ }
+
+ private void initData() {
+
+ List<Customer> data = Main.getCustomers();
+
+ Object[][] rows = new Object[data.size()][3];
+ int i = 0;
+
+ for (Customer c : data) {
+ rows[i][0] = c.getName();
+ rows[i][1] = c.getEmail();
+ rows[i++][2] = c.getPhone();
+ }
+
+ Object[] colums = {"Name", "E-mail", "Phone"};
+
+ jTable1.setModel(new DefaultTableModel(rows, colums));
+
+ }
+----
+
+After that you should see something like this.
+
+image:writelogic2_DevFaqAppClientOnNbPlatformTut.png[]
+
+=== Run Application
+
+Great job !! Everything is done. Now you can run your application. Right click on dbreader-ear project and select Run Project. Wait a minute do build and glassfish to start. Enjoy your application :o)
+
+image:runapp_DevFaqAppClientOnNbPlatformTut.png[]
+
+=== Debug Application
+
+There of course comes a time when you need to debug your application. Debugging the server side is relatively easy: start Glassfish in Debug mode and simply "Attach" to it ('Attach Debugger...' from the 'Run' menu).
+
+Debugging the client side is a little harder. On NetBeans 6.1, simply right-clicking on the EAR project and select "Debug" doesn't seem to work. It fails with error messages saying that your classes from your other modules are not found on the classpath. Manually referring to them isn't sufficient either, because once you've done that the Ant debug script will complain about not finding classes belonging to the Platform modules you depend on.
+
+The simple solution is to add the following 2 Ant targets to your build.xml :
+
+[source,xml]
+----
+
+ <target name="Debug platform (Attach-debug)" description="Debug the platform, need to attach the debugger once the JVM is started"
+ depends="-debug-init-jvm,run"/>
+
+ <target name="-debug-init-jvm">
+ <property name="j2ee.appclient.jvmoptions.param" value="-agentlib:jdwp=transport=dt_socket,server=y,address=9009"/>
+ </target>
+----
+
+To run the "Debug platform (Attach-debug) target, right-click on the 'build.xml' file in the "Files" (can't see it from the "Project") view and select it from the "Run target" menu item. Once the JVM is started (the console stops scrolling but the program is still running), attach to the JVM just like when debugging the server.
+
+The idea is to call the already-existing "run" target, but specify arguments to be passed to the JVM when its launched. The above arguments will launch the JVM in debug mode, asking it to wait for a connection (default behavior) and the address will be 9009. You could even specify a different port number if you want to run Glassfish in debug mode at the same time (note that the debugger can only attach to one JVM at a time, so you have to detach from the client and then attach to the server).
+
+For more details about the JPDA debugging arguments, see link:http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html[here].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAppClientOnNbPlatformTut[http://wiki.netbeans.org/DevFaqAppClientOnNbPlatformTut] ,
+that was last modified by NetBeans user Newacct
+on 2010-04-17T00:46:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAppLifecycleHooks.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAppLifecycleHooks.asciidoc
new file mode 100644
index 0000000..4dfda82
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAppLifecycleHooks.asciidoc
@@ -0,0 +1,107 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAppLifecycleHooks
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== What are some of the hooks in the application's lifecycle I can plug into?
+
+One major difference between developing a Platform application and a monolithic Java application is that there is no `main` method. This sometimes leaves developers wondering where they can insert their own code. This FAQ entry describes some places where this is possible.
+
+Although a bit drastic for most cases, you can
+replace the main class used to start NetBeans
+(link:DevFaqPlatformAppAuthStrategies.html[DevFaqPlatformAppAuthStrategies])
+with your own class and then delegate back to NetBeans' normal main class.
+This offers you a hook early in the startup sequence without having to modify the launchers or shell scripts.
+
+Any module may provide a link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html[ModuleInstall] implementation. The `validate` method will be called before your module is even loaded, so it is the first module-level hook available in the startup sequence. Note that many services and classes offered by the platform are unlikely to be initialized at this point.
+
+A short time afterwards, the `restored` method will be called on each `ModuleInstall` class.
+More services and classes will be initialized at this point than with the `validate` method, but the GUI will probably not yet be realized.
+You can post some code to be executed when the UI is fully loaded like this:
+
+[source,java]
+----
+
+@Override public void restored() {
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable() {
+ public void run() {
+ // any code here will be run with the UI is available
+ SomeTopComponent.findInstance().open();
+ }
+ });
+}
+----
+
+The `ModuleInstall` class offers two methods which let you plug into the exit sequence.
+The `closing` method is called first and requires that you return a boolean value.
+If `true`, then your module agrees to be closed,
+but if `false`, then you will prevent the exit sequence from continuing.
+The `close` method is called after all `ModuleInstall` classes return `true` from the `closing` method
+and is the final hook in which modules can participate in the application's lifecycle.
+
+Note that providing a `ModuleInstall` class will increase total startup time a little,
+even if you have taken care to execute any long-running tasks from its methods in a background thread.
+It is always preferable to register objects declaratively,
+and/or run procedural code when it is first needed rather than eagerly.
+
+Another major class in platform development is the link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html[TopComponent] class.
+It offers several methods which allow you to hook into its lifecycle.
+
+Here are some events you can hook into for when a `TopComponent` is opened:
+
+* `JComponent.addNotify`
+* `TopComponent.componentOpened`
+* `TopComponent.componentShowing`
+* `TopComponent.componentActivated`
+
+When you set focus on a `TopComponent`, the `componentActivated` method is called.
+Likewise, the `componentDeactivated` method is called when focus is moved away from that `TopComponent`.
+
+Here are some events you can hook into for when a `TopComponent` is closed:
+
+* `TopComponent.canClose`
+* `JComponent.removeNotify`
+* `TopComponent.componentHidden`
+* `TopComponent.componentDeactivated`
+* `TopComponent.componentClosed`
+
+(The exact sequence in which the opening/closing hooks are invoked is not documented or guaranteed to remain constant.)
+
+Note that you can return `false` from `TopComponent.canClose` to prevent the `TopComponent` from being closed at all.
+
+Applies to: NetBeans 6.5 and later
+
+==== Further reading
+
+You can get more details along with code examples link:http://wiki.netbeans.org/BookNBPlatformCookbookCH01#Module_Installer[here].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAppLifecycleHooks[http://wiki.netbeans.org/DevFaqAppLifecycleHooks] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2012-07-31T13:15:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateAPIJavadoc.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateAPIJavadoc.asciidoc
new file mode 100644
index 0000000..ce72448
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateAPIJavadoc.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAutoUpdateAPIJavadoc
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I find Javadoc of Autoupdate API with hints to use it?
+
+Since NetBeans 6.0 there is a public *API* to use *Autoupdate Services*. Autoupdate API provides several services to applications built on NetBeans Platform: it allows users to download and install available updates of installed plugins, search and install new plugins from subscribed Update Centers, browsing and manipulating plugins already installed. To use these services NetBeans Platform supplies a GUI (_Plugin Manager_ in _Tools->Plugins_ menu item) to easy call these services. AutoUpdate API also cares about registration of Update Centers.
+
+* Where to find Javadoc? link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/overview-summary.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/overview-summary.html]
+* Which version of NetBeans should I use? This API was firstly introduced in NetBeans 6.0 Platform where the API was still in development. In NetBeans 6.1 Platform it was made official API, it means further changes should be backward compatible. Use link:http://platform.netbeans.org/platform-get.html[NetBeans Platform of the latest version] for the best performance.
+
+==== Related articles
+
+* link:DevFaqWhatIsNbm.html[What is an NBM?]
+* link:FaqPluginManagerCustomization.html[How to customize Plugin Manager?]
+* link:DevFaqNbmPostInstall.html[How to specify post-install code in NBM?]
+* link:FaqDevComponentWithCustomInstaller.html[How to install components using its custom installers?]
+
+==== Other resources
+
+* link:https://blogs.oracle.com/rechtacek/[Rechtacek's Blog]
+* link:https://blogs.oracle.com/geertjan/[Geertjan's Blog]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAutoUpdateAPIJavadoc[http://wiki.netbeans.org/DevFaqAutoUpdateAPIJavadoc] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T19:59:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateBranding.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateBranding.asciidoc
new file mode 100644
index 0000000..283580b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateBranding.asciidoc
@@ -0,0 +1,83 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAutoUpdateBranding
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I update the splash screen, title bar and other branding items via AutoUpdate?
+
+It's easy to distribute new and/or updated modules via AutoUpdate, but you might also like to update branding items like the splash screen and version number in the application's title bar to reflect the changes.
+
+To do this, create a new module in your suite. Edit its build.xml and AFTER the line
+
+[source,xml]
+----
+
+<import file="nbproject/build-impl.xml"/>
+----
+
+insert
+
+[source,xml]
+----
+
+<property file="${suite.dir}/nbproject/project.properties"/>
+<target name="netbeans-extra" depends="init">
+ <branding cluster="${cluster}" overrides="${suite.dir}/branding" token="${app.name}"/>
+</target>
+----
+
+Next, add the following to the modules' nbproject/project.properties file. You may also need to update the list of files in extra.module.files to include only those JARs which your suite actually brands.
+
+[source,java]
+----
+
+nbm.needs.restart=true
+nbm.is.global=true
+nbm.target.cluster=${app.name}
+extra.module.files=\
+ core/locale/core_${app.name}.jar,\
+ modules/ext/locale/updater_${app.name}.jar,\
+ modules/locale/org-netbeans-core-windows_${app.name}.jar,\
+ modules/locale/org-netbeans-core_${app.name}.jar,\
+ modules/locale/org-netbeans-modules-autoupdate-ui_${app.name}.jar,\
+ modules/locale/org-netbeans-modules-favorites_${app.name}.jar,\
+ modules/locale/org-netbeans-modules-javahelp_${app.name}.jar,\
+ modules/locale/org-netbeans-modules-projectui_${app.name}.jar
+----
+
+Finally, run the "nbms" Ant target on your suite and deploy the updates to your AutoUpdate center.
+
+Note that you link:http://www.netbeans.org/issues/show_bug.cgi?id=122815[may encounter problems doing this in NetBeans 6.0].
+
+Thanks to Matteo Di Giovinazzo for sharing how to do this on the dev@openide list.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAutoUpdateBranding[http://wiki.netbeans.org/DevFaqAutoUpdateBranding] ,
+that was last modified by NetBeans user Bruehlicke
+on 2012-02-24T03:15:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateCheckEveryStartup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateCheckEveryStartup.asciidoc
new file mode 100644
index 0000000..01d6c90
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAutoUpdateCheckEveryStartup.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAutoUpdateCheckEveryStartup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to force to check for updates at every startup?
+
+[source,java]
+----
+
+NbPreferences.root().node("/org/netbeans/modules/autoupdate").putLong("lastCheckTime", System.currentTimeMillis() - 1000000000);
+----
+
+See also "The Definitive Guide to the NetBeans Platform 7" book, chapter 25.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAutoUpdateCheckEveryStartup[http://wiki.netbeans.org/DevFaqAutoUpdateCheckEveryStartup] ,
+that was last modified by NetBeans user Markiewb
+on 2016-02-07T14:27:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqAutomaticPlatformDownload.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqAutomaticPlatformDownload.asciidoc
new file mode 100644
index 0000000..ae01134
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqAutomaticPlatformDownload.asciidoc
@@ -0,0 +1,299 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqAutomaticPlatformDownload
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I have my application compiled in a specific version of the platform ?
+
+Now the platform can be downloaded on demand! Just update your platform.properties files as follows:
+
+[source,java]
+----
+
+# NOTE: You must remove the nbplatform.default line which might already exist in this file.
+# Also note that editing the properties of your suite via the suite customizer (dialog)
+# can add that line back in, so you'll need to watch for this and delete it again in this case.
+nbplatform.active=custom
+nbplatform=7.2
+
+# Where the suite is located; you don't need to change this. It exists
+# to allow us to use relative paths for the other values
+suite.dir=${basedir}
+
+# Classpath-like list of absolute or relative paths to individual clusters
+# against which you want your suite to build; Note that you can use
+# "bare", i.e. not numbered cluster names, which simplifies later transitions
+# to newer version of the platform. E.g: ${nbplatform.active.dir}/nb
+cluster.path=\
+ ${nbplatform.active.dir}/extra:\
+ ${nbplatform.active.dir}/ide:\
+ ${nbplatform.active.dir}/nb:\
+ ${nbplatform.active.dir}/platform:\
+ ${nbplatform.active.dir}/sappy
+# Path to the build harness you want to use. This is typically in the
+# harness subdirectory of your platform, but you could point to a directory
+# containing customized build scripts if you want to.
+harness.dir=${nbplatform.custom.netbeans.dest.dir}/harness
+
+nbplatform.custom.netbeans.dest.dir=${suite.dir}/netbeans_platform_${nbplatform}
+bootstrap.url=http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/artifact/nbbuild/netbeans/harness/tasks.jar
+autoupdate.catalog.url=http://updates.netbeans.org/netbeans/updates/${nbplatform}/uc/final/distribution/catalog.xml.gz
+----
+
+All the magic is done by the new platform.xml file that has been recently added. In cases where you need to get updates from other URL's I made the following changes to the platform.xml file:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="platform" default="download" basedir="..">
+ <import file="../preparation.xml"/>
+
+ <fileset dir="${nbplatform.custom.netbeans.dest.dir}" id="platform.path"/>
+ <mkdir dir="${nbplatform.custom.netbeans.dest.dir}"/>
+ <pathconvert refid="platform.path"
+ property="platform.notempty"
+ setonempty="false"/>
+
+ <condition property="download.enabled">
+ <and>
+ <isset property="bootstrap.url"/>
+ <isset property="autoupdate.catalog.url"/>
+ <not>
+ <isset property="platform.notempty"/>
+ </not>
+ </and>
+ </condition>
+
+ <condition property="download.harness.required">
+ <and>
+ <not>
+ <available file="${harness.dir}/suite.xml"/>
+ </not>
+ <isset property="download.enabled"/>
+ </and>
+ </condition>
+
+ <target name="download-harness" if="download.harness.required">
+ <mkdir dir="${harness.dir}"/>
+ <autoupdate installdir="${nbplatform.active.dir}" updatecenter="${autoupdate.catalog.url}">
+ <modules includes="org[.]netbeans[.]modules[.]apisupport[.]harness" clusters="harness"/>
+ </autoupdate>
+ </target>
+
+ <target name="download" depends="-init-netbeans, -init-hudson" if="download.enabled">
+ <pathconvert pathsep="|" property="download.clusters">
+ <mapper type="flatten"/>
+ <path path="${cluster.path}"/>
+ </pathconvert>
+ <property name="disabled.modules" value=""/>
+ <pathconvert property="module.includes" pathsep="">
+ <mapper type="glob" from="${basedir}${file.separator}*" to="(?!\Q*\E)"/>
+ <path>
+ <filelist files="${disabled.modules}" dir="."/>
+ </path>
+ </pathconvert>
+ <property file="nbproject/platform.properties" prefix="urls."/>
+ <propertyselector property="urls" match="urls.autoupdate.catalog\.(.*)" select="\1"/>
+
+ <property file="nbproject/platform.properties"/>
+ <echo message="Downloading clusters ${download.clusters}"/>
+ <property name="tasks.jar" location="${java.io.tmpdir}/tasks.jar"/>
+ <get src="${bootstrap.url}" dest="${tasks.jar}" usetimestamp="true" verbose="true"/>
+ <taskdef name="autoupdate" classname="org.netbeans.nbbuild.AutoUpdate" classpath="${tasks.jar}"/>
+ <antcall target="download-harness"/>
+ <for list="${urls}" param="url">
+ <sequential>
+ <echo message="Attempting to download plug-ins from ${autoupdate.catalog.@{url}}" />
+ <download-platform url="${autoupdate.catalog.@{url}}"/>
+ </sequential>
+ </for>
+ <echo>Installing plug-ins from ../netbeans</echo>
+ <mkdir dir="${nbplatform.active.dir}/extra"/>
+ <autoupdate todir="${nbplatform.active.dir}/extra">
+ <nbms dir="../netbeans">
+ <include name="*.nbm"/>
+ </nbms>
+ <modules includes=".+"/>
+ </autoupdate>
+ </target>
+
+ <macrodef name="download-platform">
+ <attribute name="url"/>
+ <sequential>
+ <autoupdate installdir="${nbplatform.active.dir}" updatecenter="@{url}">
+ <modules includes="${module.includes}.*" clusters="${download.clusters}"/>
+ <modules includes="org[.]netbeans[.]modules[.]apisupport[.]harness" clusters="harness"/>
+ </autoupdate>
+ </sequential>
+ </macrodef>
+</project>
+----
+
+Here's the imported preparation.xml:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="MSM-Preparation" basedir=".">
+ <description>Prepares the environment to build the module suite MSM.</description>
+ <!--Don't modify this file unless you know what you are doing-->
+ <property name="ant-contrib-filename" value="ant-contrib-1.0b3.jar"/>
+ <property file="nbproject/project.properties"/>
+ <property file="nbproject/platform.properties"/>
+ <property name="platform.dir" value="../netbeans/"/>
+ <property name="lib.dir" value="${suite.dir}/../Simple Libs/tools"/>
+
+ <scriptdef name="substring" language="javascript">
+ <attribute name="text" />
+ <attribute name="start" />
+ <attribute name="end" />
+ <attribute name="property" />
+ <![CDATA[
+ var text = attributes.get("text");
+ var start = attributes.get("start");
+ var end = attributes.get("end") || text.length;
+ project.setProperty(attributes.get("property"), text.substring(start, end));
+ ]]>
+ </scriptdef>
+
+ <target name="-check-env" depends="-getAntContribJar">
+ <condition property="isNetbeans">
+ <not>
+ <isset property="Hudson"/>
+ </not>
+ </condition>
+ <property name="xmltasks-loc" value="${lib.dir}/xmltask.jar"/>
+ <available file="${xmltasks-loc}" property="xmltasks.present"/>
+ <fail unless="xmltasks.present" message="The xmltasks jar doesn't exist at: ${xmltasks-loc}, can't build. Check your settings!" />
+ <taskdef name="xmltask"
+ classname="com.oopsconsultancy.xmltask.ant.XmlTask">
+ <classpath>
+ <pathelement location="${xmltasks-loc}"/>
+ </classpath>
+ </taskdef>
+ </target>
+
+ <target name="-getAntContribJar">
+ <fileset id="ant-contrib-jar" dir="${lib.dir}">
+ <include name="ant-contrib-*.jar" />
+ </fileset>
+ <pathconvert property="ant-contrib-jar" refid="ant-contrib-jar" pathsep="," />
+ <basename property="ant-contrib-filename" file="${ant-contrib-jar}"/>
+ </target>
+
+ <target name="-init-netbeans" depends="-check-env" if="isNetbeans">
+ <echo>Configuring ant-contrib for Netbeans use...</echo>
+ <property name="ant-contrib-loc" value="${lib.dir}/${ant-contrib-filename}"/>
+ <available file="${ant-contrib-loc}" property="ant-contrib.present"/>
+ <fail unless="ant-contrib.present" message="The ant-contrib jar doesn't exist at: ${ant-contrib-loc}, can't build. Check your settings!" />
+ <!--We are in not Hudson-->
+ <taskdef resource="net/sf/antcontrib/antcontrib.properties">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ </target>
+
+ <target name="-init-hudson" depends="-check-env" unless="isNetbeans">
+ <echo>Configuring ant-contrib for Hudson use...</echo>
+ <!--Import Hudson environment variables-->
+ <property environment="env"/>
+ <property name="ant-contrib-loc" value="${env.ANT_HOME}/lib/${ant-contrib-filename}"/>
+ <available file="${ant-contrib-loc}" property="ant-contrib.present"/>
+ <fail unless="ant-contrib.present" message="The ant-contrib jar doesn't exist at: ${ant-contrib-loc}, can't build. Check your settings!" />
+ <!--Define it. For some reason the approach in -init-netbeans doesn't work in Hudson.-->
+ <taskdef name="for" classname="net.sf.antcontrib.logic.ForTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="propertyregex" classname="net.sf.antcontrib.property.RegexTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="if" classname="net.sf.antcontrib.logic.IfTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="math" classname="net.sf.antcontrib.math.MathTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="var" classname="net.sf.antcontrib.property.Variable">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="foreach" classname="net.sf.antcontrib.logic.ForEach">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ </target>
+
+ <target name="module-fix-dependencies">
+ <ant antfile= "${suite.dir}/versions.xml" target="fix"/>
+ </target>
+
+ <!-- iterate finds all build files, excluding this one and invokes the named target -->
+ <macrodef name="iterate">
+ <attribute name="target"/>
+ <sequential>
+ <subant target="@{target}">
+ <fileset dir="."
+ includes="**/*/build.xml"
+ excludes="build.xml"/>
+ </subant>
+ </sequential>
+ </macrodef>
+</project>
+----
+
+After this you can add alternate update centers and it'll look for nbms on those sites as well. Just add the additional URLS in the platform.properties as follows:
+
+[source,java]
+----
+
+autoupdate.catalog.url1=url1
+autoupdate.catalog.url2=url2
+.
+.
+.
+autoupdate.catalog.urlx=urlx
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqAutomaticPlatformDownload[http://wiki.netbeans.org/DevFaqAutomaticPlatformDownload] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:37:38Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqBackgroundThread.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqBackgroundThread.asciidoc
new file mode 100644
index 0000000..2a6205f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqBackgroundThread.asciidoc
@@ -0,0 +1,57 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqBackgroundThread
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a background thread and why do I need one?
+
+As with most user interface (UI) toolkits, Swing is _single threaded_. That means there is one and only one thread that should create or alter the state of UI components, and that is the AWT Event Dispatch Thread (also known as the EDT or the "event thread"). It processes things like key and mouse events and calls components to respond to them.
+
+This also means that code that responds to a key or mouse event, or some call triggered by one, should run very quickly, because the user can be typing or clicking, but the entire application is _blocked_ from responding to more events until your code exits. So sometimes you will want to move expensive or slow work onto a link:DevFaqThreading.html[background thread].
+
+A background thread is any thread that is not the event thread.
+
+If you are running on some background thread, but need to modify some Swing component, a simple way to do this is <pre>
+
+[source,xml]
+----
+
+ EventQueue.invokeLater(new Runnable() {
+ public void run() {
+ //this code can work with Swing
+ }
+ });</pre>
+----
+
+Note that the caveat about Swing includes creating components - it is probably not safe to even construct Swing components on a background thread, because of synchronization on `Component.getTreeLock()`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqBackgroundThread[http://wiki.netbeans.org/DevFaqBackgroundThread] ,
+that was last modified by NetBeans user Braiam
+on 2010-03-03T21:56:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqBecomingProficient.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqBecomingProficient.asciidoc
new file mode 100644
index 0000000..3c4b795
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqBecomingProficient.asciidoc
@@ -0,0 +1,118 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqBecomingProficient
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Becoming a Proficient NetBeans Module Developer
+
+The NetBeans Platform has a learning curve. The goal of this FAQ is to get you over the basic humps quickly. Being proficient does not necessarily mean knowing everything there is to know. It means being able to find what you need to know quickly when you need it. Here are some pointers.
+
+=== Javadoc
+
+The reference documentation for all of NetBeans APIs can be found on the web here:
+link:http://bits.netbeans.org/dev/javadoc/index.html[http://bits.netbeans.org/dev/javadoc/index.html].
+
+If you want a local copy of it, you can either download it from the update center, or build it from your source checkout
+
+[source,java]
+----
+
+cd $NB_SRC_ROOT
+ant build-javadoc
+----
+
+=== Using the Javadoc
+
+Notice the list of APIs in the upper left in the javadoc. These restrict the list of classes to a single API. /Also notice the link that says _javadoc_ next to each API name. It's important! This links to the overview page for each API. That page contains a list of changes, an architecture description, and other very useful stuff!/
+
+=== NetBeans Tutorials
+
+There are a link:http://netbeans.org/kb/trails/platform.html[huge number of tutorials]. Do at least some of them - step by step.
+
+=== FAQs
+
+There is a huge link:NetBeansDeveloperFAQ.html[Frequently Asked Questions for Module Developers] list. It is worth bookmarking.
+
+=== Getting the Source Code
+
+Some people claim that they should never need to look at source code - documentation should suffice. That's just silly. The NetBeans codebase is a treasure-trove of examples of how to do things.
+
+Since the end of January 2008 the NetBeans sources are stored in Mercurial repository at link:http://hg.netbeans.org[hg.netbeans.org].
+
+You can see useful documentation about Mercurial and also about its specifics for NetBeans repository in link:HgMigrationDocs.html[HgMigrationDocs] wiki topic. If you are already familiar with Mercurial you cat go directly to link:HgHowTos.html[HgHowTos] topic.
+
+You will end up with a large number of directories representing top-level NetBeans projects. Most of them will be openable as projects in NetBeans.
+
+Here's how to link:HgHowTos#Doing_your_first_build.html[build it].
+
+The build of NetBeans will be created in `nbbuild/netbeans`.
+
+=== How To Find Useful APIs
+
+See the link:DefFaqMapApisToTasks.html[tasks to APIs faq] for a list of common tasks and what APIs you will want to use to accomplish those tasks.
+
+=== Get the NetBeans Platform Examples
+
+There are a large number of samples. Many of these correspond to the tutorials.
+
+Two full blown NetBeans Platform applications are provided as samples in NetBeans IDE. Look in the Samples category in the New Project dialog and you will find the FeedReader sample and the Paint sample, for both of which there are tutorials describing how to create them from scratch.
+
+You can find several other samples in the module `platform` in `main/misc` repository at hg.netbeans.org. They are in the `platform/samples/` subdirectory. The `platform/samples/` folder can be link:http://hg.netbeans.org/main/misc/file/tip/platform/samples/[browsed online here].
+
+=== Build Platform from Sources
+
+First get platform sources from link:http://www.netbeans.info/downloads/dev.php[download page] or use Hg client as described in link:HgHowTos.html[HgHowTos].
+
+To build platform run
+
+[source,java]
+----
+
+cd $NB_SRC_ROOT
+ant build-platform
+----
+
+=== Mining the NetBeans Source Code for Examples
+
+For most things you will need to do, there is some module that does something similar already. For example, say that you want to show a window that shows the contents of some random directories on disk or some registry of objects your module creates. The `core/favorites` module provides the Favorites window which does exactly this. A bit of intuition and a willingness to open a couple of projects is all it takes to find examples of many things. Often a good place to start is simply to open the source for a class you think you want to use and run Find Usages on it.
+
+=== Use the Mailing Lists
+
+If you have questions, the best place to go is the link:mailto:dev@platform.netbeans.org[developer mailing list]. Click link:mailto:sympa@platform.netbeans.org?subject=subscribe%20dev[this link] to subscribe.
+
+You can also browse the link:http://netbeans.org/projects/platform/lists/dev/archive[archives online], but actually joining the mailing list is the best way to get (and give) help.
+
+Note: dev@platform.netbeans.org was formerly dev@openide.netbeans.org - older archives can be found on link:http://www.nabble.com/Netbeans---Open-API-f2609.html[Nabble] and via a newsreader by going to `news://news.gmane.org`.
+
+Ask questions, and when you can answer them, do that too. There is a very healthy and helpful community there.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqBecomingProficient[http://wiki.netbeans.org/DevFaqBecomingProficient] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-13T23:38:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCallEjbFromNbm.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCallEjbFromNbm.asciidoc
new file mode 100644
index 0000000..df2b1f6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCallEjbFromNbm.asciidoc
@@ -0,0 +1,123 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCallEjbFromNbm
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to call EJB from NetBeans module
+
+This How-To is based on link:https://glassfish.dev.java.net/javaee5/ejb/EJB_FAQ.html[GlassFish EJB Faq]
+
+=== How to call EJB from Java EE Application Client built on top of NetBeans Platform
+
+*Important:* Application Client must be created as it is described in link:DevFaqAppClientOnNbPlatformTut.html[Java EE Application Client on top of the NetBeans Platform Tutorial] otherwise this will not work
+
+* create lookup method in some class in your module
+* add entry to `application-client.xml` in application client module
+
+==== Example
+
+* for following lookup method in some class from your module:
+[source,java]
+----
+
+protected mypkg.MySessionBeanRemote lookupMySessionBean() {
+ try {
+ javax.naming.Context c = new javax.naming.InitialContext();
+ return (mypkg.MySessionBeanRemote) c.lookup("java:comp/env/ejb/MySessionBean");
+ } catch(javax.naming.NamingException ne) {
+ java.util.logging.Logger.getLogger(getClass().getName()).log(java.util.logging.Level.SEVERE,"exception caught" ,ne);
+ throw new RuntimeException(ne);
+ }
+}
+----
+
+* there must be following entry in `application-client.xml`:
+[source,xml]
+----
+
+<ejb-ref>
+ <ejb-ref-name>ejb/MySessionBean</ejb-ref-name>
+ <ejb-ref-type>Session</ejb-ref-type>
+ <remote>mypkg.MySessionBeanRemote</remote>
+</ejb-ref>
+----
+
+=== How to call EJB from standalone module/NB platform based application
+
+==== Call EJB on GlassFish
+
+* ensure that $GLASSFISH_HOME/lib/appserv-rt.jar, $GLASSFISH_HOME/lib/appserv-ext.jar, $GLASSFISH_HOME/lib/appserv-deployment-client.jar, $GLASSFISH_HOME/lib/javaee.jar, $GLASSFISH_HOME/lib/jmxremote_optional.jar are on NB platform based *application's classpath* (startup classpath is not enough)
+* ensure that the same applies to jar with EJB interfaces and its helper classes
+* when using jars from GlassFish v1 or v1u1 - disable assertions (due to link:http://forums.java.net/jive/thread.jspa?forumID=56&threadID=16138&messageID=122831[bug] in GlassFish which should be fixed in GlassFish v2)
+* add org.omg.CORBA.ORBInitialHost and org.omg.CORBA.ORBInitialPort JVM options to application's startup JVM options
+* use lookup
+
+==== Example
+
+* add:
+[source,java]
+----
+
+run.args.extra=-J-da -J-Dorg.omg.CORBA.ORBInitialHost=localhost -J-Dorg.omg.CORBA.ORBInitialPort=3700 \
+ -cp:a $GLASSFISH_HOME/lib/appserv-rt.jar:$GLASSFISH_HOME/lib/appserv-ext.jar:\
+ $GLASSFISH_HOME/lib/appserv-deployment-client.jar:$GLASSFISH_HOME/lib/javaee.jar:\
+ $GLASSFISH_HOME/lib/jmxremote_optional.jar:someejb.jar
+----
+
+to module suite project.properties
+
+* add javaee.jar and jar with ejb interfaces to compile time dependencies for your module
+* create lookup method for your bean in some class in your module:
+[source,java]
+----
+
+// for EJB 3.0 bean
+protected mypkg.MyBeanRemote lookupMyBeanRemote30 throws NamingException {
+ javax.naming.Context ic = new javax.naming.InitialContext();
+ return (mypkg.MyBeanRemote) ic.lookup("mypkg.MyBeanRemote");
+}
+
+// for EJB 2.1 and/or earlier
+protected mypkg.MyBeanRemote lookupMyBeanRemote21 throws NamingException {
+ javax.naming.Context ic = new javax.naming.InitialContext();
+ Object remote = c.lookup("java:comp/env/ejb/MyBean");
+ mypkg.MyBeanRemoteHome rv = (mypkg.MyBeanRemoteHome) PortableRemoteObject.narrow(remote, mypkg.MyBeanRemoteHome.class);
+ return rv.create();
+}
+----
+
+
+Applies to: NetBeans 5.5, 6.0, 6.1
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCallEjbFromNbm[http://wiki.netbeans.org/DevFaqCallEjbFromNbm] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:37:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqChangeLookAndFeel.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqChangeLookAndFeel.asciidoc
new file mode 100644
index 0000000..fb11389
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqChangeLookAndFeel.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqChangeLookAndFeel
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I set the Swing look and feel on startup?
+
+Generally, you can change the look and feel either by passing command line arguments, e.g.<pre>
+netbeans --laf javax.swing.plaf.metal.MetalLookAndFeel
+</pre>
+or do so programmatically on startup in a module's `link:DevFaqModulesGeneral.html[ModuleInstall]` class (generally if you're installing a custom look and feel, you probably want to have a separate module to do that; link:http://substance-netbeans.dev.java.net[some look and feels] provide NetBeans modules to make it easy to use them.
+
+If you want to test running with a different look and feel during development of your application, and you know it will be on the application's classpath, see the example in link:DevFaqPassCommandLineArgumentsAtDevTime.html[DevFaqPassCommandLineArgumentsAtDevTime] for how to include `--laf` in the runtime arguments to your module suite.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqChangeLookAndFeel[http://wiki.netbeans.org/DevFaqChangeLookAndFeel] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T19:56:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqChangeMenuItemToolbarAppearanceForAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqChangeMenuItemToolbarAppearanceForAction.asciidoc
new file mode 100644
index 0000000..1917599
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqChangeMenuItemToolbarAppearanceForAction.asciidoc
@@ -0,0 +1,63 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqChangeMenuItemToolbarAppearanceForAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I change the appearance of the menu items and toolbar buttons for my action?
+
+The main menus and toolbars of a NetBeans Platform application are configured based on the contents of folders in the system filesystem. There are many benefits of this approach, such as improved performance since the platform can create all the menus and toolbars without having to actually instantiate the actions with which they are associated.
+
+Because the platform builds the menus and toolbars for you, it might seem like you have little control over how those items appear. In practice, you have a great deal of control over the appearance for any action you create. Typically, actions in a NetBeans platform application which will be shown in the main menu or toolbar extend from `CallableSystemAction`, perhaps indirectly through its `CookieAction` subclass.
+
+In the code you've written for one of these actions, you can override `getMenuPresenter` to change the appearance of the menu item associated with your action and/or override `getToolbarPresenter` to change the appearance of the toolbar component associated with your action.
+
+For example, if you wanted to make the menu item for your action have a blue background and yellow text, you could do something like this:
+
+[source,java]
+----
+
+@Override
+public JMenuItem getMenuPresenter() {
+ JMenuItem item = super.getMenuPresenter();
+ item.setOpaque(true);
+ item.setBackground(Color.BLUE);
+ item.setForeground(Color.YELLOW);
+ return item;
+}
+
+----
+
+Note that if you are changing the menu item to support a tooltip, the object returned by `getMenuPresenter` needs a property change listener on the action's `SHORT_DESCRIPTION` so that its tooltip value is updated correctly upon change.
+
+*Note about using alternate components in the main menu:* If you want your action to work properly on Mac OS, you probably don't want to return anything other than a `JMenu` or `JMenuItem` from `getMenuPresenter()` if you implement link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.Menu.html[Presenter.Menu]. In general, Swing allows you to treat menu popups as generic Swing containers you can put what you like into. This is not true at all of the Mac OS screen menu bar - it expects normal menu items, and will not handle unusual contents for menus.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqChangeMenuItemToolbarAppearanceForAction[http://wiki.netbeans.org/DevFaqChangeMenuItemToolbarAppearanceForAction] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:39:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqChangeNodeAppearance.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqChangeNodeAppearance.asciidoc
new file mode 100644
index 0000000..7d040b0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqChangeNodeAppearance.asciidoc
@@ -0,0 +1,68 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqChangeNodeAppearance
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I change my node's appearance?
+
+It's pretty simple to change the font color, style or weight for your node's label. Simply override `getHtmlDisplayName` and provide some HTML in your return value. (An example can be found in link:http://platform.netbeans.org/tutorials/60/nbm-nodesapi2.html[this] tutorial.) Here is another example:
+
+[source,java]
+----
+
+public class MovieNode extends AbstractNode {
+
+ private Movie movie;
+
+ public MovieNode(Movie key) {
+ super(Children.LEAF, Lookups.fixed(new Object[]{key}));
+ this.movie = key;
+ setName(key.getTitle());
+ setDisplayName(key.getTitle());
+ getHandle();
+ setIconBaseWithExtension("org/nb/marilyn/pics/marilyn.gif");
+ }
+
+ @Override
+ public String getHtmlDisplayName() {
+ return "*" + this.getDisplayName() + "*";
+ }
+
+}
+
+----
+
+The javadoc for the HtmlRenderer class link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/HtmlRenderer.html[explains what subset of HTML is supported]. You can also change the icon's node by overriding various methods such as `getIcon(int type)` or `{getOpenedIcon()`}.
+
+It's also possible, but far more difficult, to control other aspects of the node's appearance; for example, drawing a box around the node or changing its background color. To do this you must create or modify the explorer view in which the node is rendered. link:http://openide.netbeans.org/servlets/ReadMsg?list=dev&msgNo=31412[Fabrizio Giudici posted code that illustrates this] on the `dev@openide` list.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqChangeNodeAppearance[http://wiki.netbeans.org/DevFaqChangeNodeAppearance] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:19:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqChangeRestartSplash.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqChangeRestartSplash.asciidoc
new file mode 100644
index 0000000..cbbb3c8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqChangeRestartSplash.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqChangeRestartSplash
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How Can I Change the NetBeans Splash Screen Shown When A User Installs a Module Requiring Restart?
+
+The splash screen is here:
+
+[source,java]
+----
+
+autoupdate.services/libsrc/org/netbeans/updater/resources/updatersplash.gif
+----
+
+You can brand this in your application; see: link:BrandingUpdaterSplash.html[BrandingUpdaterSplash]
+
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqChangeRestartSplash[http://wiki.netbeans.org/DevFaqChangeRestartSplash] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:06:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCheckableActionPreferenceOption.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCheckableActionPreferenceOption.asciidoc
new file mode 100644
index 0000000..c7873f2
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCheckableActionPreferenceOption.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCheckableActionPreferenceOption
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How do I make a checkable action that represents a preference option?
+
+See
+link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/Actions.html[org-openide-awt/org.openide.awt.Actions.checkbox(...)]
+
+Here an example for a checkable action which represents the state of the "ignoreCase" property within the property file "org/netbeans/modules/diff.properties"
+`
+
+[source,xml]
+----
+
+ <folder name="Actions">
+ <folder name="Diff">
+ <file name="toggle-ignore-case-diff-option.instance">
+ <attr bundlevalue="org.netbeans.modules.diff.Bundle#CTL_IgnoreCaseOptionAction" name="displayName"/>
+ <attr name="Name" stringvalue="toggle-ignore-case-diff-option"/>
+ <attr name="preferencesNode" stringvalue="/org/netbeans/modules/diff" />
+ <attr name="preferencesKey" stringvalue="ignoreCase"/>
+ <attr name="instanceCreate" methodvalue="org.openide.awt.Actions.checkbox"/>
+ </file>
+ </folder>
+ </folder>
+----
+
+`
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCheckableActionPreferenceOption[http://wiki.netbeans.org/DevFaqCheckableActionPreferenceOption] ,
+that was last modified by NetBeans user Markiewb
+on 2013-05-03T21:46:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqClassLoaders.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqClassLoaders.asciidoc
new file mode 100644
index 0000000..5987e01
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqClassLoaders.asciidoc
@@ -0,0 +1,115 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqClassLoaders
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What class loaders are created by the module system?
+
+==== Overview
+
+This FAQ item should be a companion to the main link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/classpath.html[classpath documentation]. Please refer to the original document for additional details.
+
+==== Class loaders in the NetBeans platform
+
+There are basically three main class loader types used in the platform.
+Most code is loaded by module class loaders.
+In special cases the "system" class loader can be used,
+when you need access to resources from unknown modules.
+Resources directly on the classpath from the launch script (mainly `platform*/lib/*.jar`)
+are loaded by the application loader.
+(There are also bootstrap and extension loaders in the JRE,
+and the platform has a special loader for a couple of JARs in `platform*/core/*.jar`.)
+
+Most of the class loaders in the NetBeans platform are multi-parented class loaders.
+This means that the class loader can have zero or more parents.
+`org.netbeans.ProxyClassLoader` implements the search across multiple parents.
+
+==== Module class loader
+
+Every module loaded by the module system has its own class loader.
+This loader loads resources primarily from the module's JAR.
+The application loader is an implicit parent of each module loader.
+
+The module loader is able to load from additional JARs (besides delegating to various parents):
+
+* extensions - anything listed in the manifest attribute `Class-Path` of the module JAR
+* locale extensions - JARs placed in a subdirectory `locale` relative to the original module JAR position, named by appending a locale suffix to the original name
+* patches - JARs placed in a subdirectory `patches/code-name-base` relative to the original JAR position (can override module classes)
+
+The implementation class is `link:http://hg.netbeans.org/main/file/tip/o.n.bootstrap/src/org/netbeans/StandardModule.java[org.netbeans.StandardModule$OneModuleClassLoader]`.
+
+==== System class loader
+
+The "system" loader loads no resources on its own,
+but has as its parents all enabled module's class loaders.
+It is accessible via `Lookup.getDefault().lookup(ClassLoader.class)`
+or by using the fact that it is the context loader on all threads by default: `Thread.currentThread().getContextClassLoader()`
+
+==== Application class loader
+
+This class loader is set up by the launch script (or by `javaws` if running in JNLP mode).
+It can load classes from `lib/*.jar` in specified clusters.
+It is generally discouraged to use this loader for your own classes,
+but it is sometimes needed e.g. for Look & Feel classes
+(which must be loaded very early during the startup sequence).
+
+==== Example
+
+Take a very simple module `a`:
+
+[source,java]
+----
+
+Manifest-Version: 1.0
+OpenIDE-Module: org.netbeans.modules.a
+----
+
+and module `b` depending on `a`:
+
+[source,java]
+----
+
+Manifest-Version: 1.0
+OpenIDE-Module: org.netbeans.modules.b
+OpenIDE-Module-Module-Dependencies: org.netbeans.modules.a
+Class-Path: ext/library-b-1.1.jar
+----
+
+Classes in `org-netbeans-modules-a.jar` will be loaded in `a`'s module class loader.
+Classes in both `org-netbeans-modules-b.jar` and `library-b-1.1.jar`
+will be loaded in `b`'s module loader,
+and can refer to classes in `org-netbeans-modules-a.jar`.
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqClassLoaders[http://wiki.netbeans.org/DevFaqClassLoaders] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T13:43:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCreateExplorerPanel.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCreateExplorerPanel.asciidoc
new file mode 100644
index 0000000..5881e74
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCreateExplorerPanel.asciidoc
@@ -0,0 +1,86 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCreateExplorerPanel
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I create a TopComponent to show an explorer view?
+
+link:DevFaqExplorerViews.html[Explorer views ] are generic Swing components, not subclasses of link:DevFaqWindowsTopComponent.html[TopComponent ], the Swing panel class that is used for top level components (tabs) in the main window. So an explorer view component is added to a TopComponent, using the TopComponent as a Swing container for the view.
+
+A little bit of plumbing is needed to wire up an explorer view to the global link:DevFaqWhatIsANode.html[Node ] selection so that link:DevFaqTrackGlobalSelection.html[code that is sensitive to selection ] such as link:DevFaqTrackingExplorerSelections.html[context sensitive actions ]. Basically you want the TopComponent to expose the selection in your link:DevFaqExplorerViews.html[Explorer View ] so that when your view has focus, the global selection that affects everything will be whatever the user selects in your view.
+
+In olden times, there was a convenient class called ExplorerPanel (now in `org.openide.compat` ) which would do this for you; due to a tragedy of being in the wrong package, it is now deprecated, but the required plumbing is not hard:
+
+[source,java]
+----
+
+public class MyView extends TopComponent implements ExplorerManager.Provider {
+ private final ExplorerManager manager = new ExplorerManager();
+ private final JComponent view = new BeanTreeView();
+ public MyView() {
+ setLayout (new BorderLayout());
+ add(view, BorderLayout.CENTER);
+ manager.setRootContext(someNode);
+
+ // Probably boilerplate (depends on what you are doing):
+ ActionMap map = getActionMap();
+ map.put(DefaultEditorKit.copyAction, ExplorerUtils.actionCopy(manager));
+ map.put(DefaultEditorKit.cutAction, ExplorerUtils.actionCut(manager));
+ map.put(DefaultEditorKit.pasteAction, ExplorerUtils.actionPaste(manager));
+ // This one is sometimes changed to say "false":
+ map.put("delete", ExplorerUtils.actionDelete(manager, true));
+ // Boilerplate:
+ associateLookup(ExplorerUtils.createLookup(manager, map));
+ }
+ // This is optional:
+ public boolean requestFocusInWindow() {
+ super.requestFocusInWindow();
+ // You will need to pick a view to focus:
+ return view.requestFocusInWindow();
+ }
+ // The rest is boilerplate.
+ public ExplorerManager getExplorerManager() {
+ return manager;
+ }
+ protected void componentActivated() {
+ ExplorerUtils.activateActions(manager, true);
+ }
+ protected void componentDeactivated() {
+ ExplorerUtils.activateActions(manager, false);
+ }
+}
+
+----
+
+The primary difference between the above code and ExplorerPanel is that ExplorerPanel automagically persisted paths from the selected nodes to the root, so that it could be deserialized on restart with the same selection it had before shutdown (assuming that selection still existed - this was never terribly robust).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCreateExplorerPanel[http://wiki.netbeans.org/DevFaqCreateExplorerPanel] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T18:46:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomDebugger.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomDebugger.asciidoc
new file mode 100644
index 0000000..2116367
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomDebugger.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomDebugger
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How can I create a custom Debugger for my language?
+
+Problem: I have a debugger built for my custom programming language. How do I integrate it into the NetBeans Platform?
+
+Solution: Here is a tutorial on integrating a custom Debugger: link:http://netbeans.dzone.com/how-reuse-netbeans-debugger[http://netbeans.dzone.com/how-reuse-netbeans-debugger]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomDebugger[http://wiki.netbeans.org/DevFaqCustomDebugger] ,
+that was last modified by NetBeans user Stefika
+on 2010-10-01T19:56:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomFontSize.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomFontSize.asciidoc
new file mode 100644
index 0000000..db70637
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomFontSize.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomFontSize
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have a custom component. How can I make it respond to --fontsize like the rest of NetBeans?
+
+[source,java]
+----
+
+Integer fontSize = (Integer) UIManager.get("customFontSize");
+if (fontSize != null) {
+ //--fontsize was passed - adjust your fonts accordingly
+}
+----
+
+You can also just set your font with UIManager.getFont("controlFont") which
+will be set according to --fontsize, but sometimes you do need the actual
+value for using fixed width fonts or computing fixed cell height for an
+unusual font or similar.
+
+The code in core.swing.plaf processes the --fontsize argument and sets the
+UIManager key/value pair if it was passed on startup.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomFontSize[http://wiki.netbeans.org/DevFaqCustomFontSize] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-25T16:22:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomIOProvider.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomIOProvider.asciidoc
new file mode 100644
index 0000000..3c9f281
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomIOProvider.asciidoc
@@ -0,0 +1,87 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomIOProvider
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I implement a custom IOProvider?
+
+_Note: You will only do this if you are writing a replacement for the NetBeans output window, which is a fairly unusual activity._
+
+You need to extend `IOProvider` and override/implement following methods:
+
+[source,java]
+----
+
+import javax.swing.Action;
+import org.openide.windows.IOContainer;
+import org.openide.windows.IOProvider;
+import org.openide.windows.InputOutput;
+import org.openide.windows.OutputWriter;
+
+// registration, you can change default instance returned by IOProvider.getDefault() by adjusting position
+@org.openide.util.lookup.ServiceProvider(service=org.openide.windows.IOProvider.class, position=200)
+public final class MyIOProvider extends IOProvider {
+
+ // unique name of your provider
+ private static final String NAME = "My IO provider"; // NOI18N
+
+ public OutputWriter getStdOut() {
+ // implement
+ }
+
+ public InputOutput getIO(String name, boolean newIO) {
+ // implement
+ }
+
+ @Override
+ public InputOutput getIO(String name, Action[] toolbarActions) {
+ // override
+ }
+
+ @Override
+ public InputOutput getIO(String name, Action[] additionalActions, IOContainer ioContainer) {
+ // override
+ }
+
+ @Override
+ public String getName() {
+ return NAME;
+ }
+}
+----
+
+Add "OpenIDE-Module-Provides: org.openide.windows.IOProvider" to your module manifest (manifest.mf file) to inform that your module provides IOProvider service.
+Then instance of your provider could be obtained by `IOProvider.get("My IO provider")`
+<hr/>
+Applies to: NetBeans 6.7 or higher
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomIOProvider[http://wiki.netbeans.org/DevFaqCustomIOProvider] ,
+that was last modified by NetBeans user Jhavlin
+on 2011-12-12T13:12:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomUpdateCenter.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomUpdateCenter.asciidoc
new file mode 100644
index 0000000..5947a4d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomUpdateCenter.asciidoc
@@ -0,0 +1,80 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomUpdateCenter
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I use AutoUpdate to deploy updates and new modules for my application?
+
+An AutoUpdate server (also called an AutoUpdate Center or AUC) it not as complicated as it sounds. It's just a server which contains a set of modules and an XML file that describes them all (the autoupdate XML descriptor).
+
+There are four main steps in setting up your AUC, all of which are quite simple:
+
+==== 1. Deciding where you will host it.
+
+This is typically just a Web server (Tomcat, Apache, etc.) which has a directory that's writable by you. You will need to know how to map that directory to the URL which will be used to request the files you add there; for example, you might put a file `com-example-foo.nbm` in the `/var/www/html/mysite` directory and that will map to `link:http://www.example.com/mysite/com-example-foo.nbm[http://www.example.com/mysite/com-example-foo.nbm]`.
+
+==== 2. Creating your NBM files and autoupdate XML descriptor.
+
+Just right-click on your suite and choose "Create NBMs", or if you prefer the command line, type `ant nbms` from a command prompt in the root directory of your suite. This will create an NBM file for every module in your suite and will also generate the autoupdate XML descriptor which describes each module.
+
+==== 3. Uploading your NBM files and autoupdate XML descriptor to the server.
+
+You can do this manually at first, but later you might wish to automate this using Ant's support for FTP or scp, or simply copy files via shares or NFS mounts. Which method you choose will largely be dictated by what your Web server's operating system supports.
+
+==== 4. Making sure your application knows about it.
+
+*a) Using wizards*:
+There is a wizard for this in recent versions of the NetBeans IDE. Right-click on one of the modules in your suite (or add a new one, if you prefer) and choose New -> Other. Select "Module development" in the dialog, choose "Update Center" and then click the Next button. Specify the URL of the update center descriptor (i.e. the URL of the file you uploaded in step 3) and a display name of your choice, and then click Finish.
+
+*b) Using layer.xml*:
+
+[source,xml]
+----
+
+<folder name="Services">
+ <folder name="AutoupdateType">
+ <file name="my_update_center.instance">
+ <attr name="displayName" stringvalue="My Update Center" />
+ <attr name="enabled" boolvalue="true" />
+ <attr name="instanceCreate" methodvalue="org.netbeans.modules.autoupdate.updateprovider.AutoupdateCatalogFactory.createUpdateProvider" />
+ <attr name="instanceOf" stringvalue="org.netbeans.spi.autoupdate.UpdateProvider" />
+ <attr name="url" urlvalue="http://my_site.com/updates.xml" />
+ </file>
+ </folder>
+</folder>
+----
+
+(taken from mailinglist)
+
+*Note:* Whenever you need to deploy an update, be sure you have incremented the module's specification version number and then repeat steps 2 and 3 above. Users should be able to easily install the updates you've published. There is more link:DevFaqImplementationDependency.html[explanation of module versioning and dependencies] elsewhere in this FAQ.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomUpdateCenter[http://wiki.netbeans.org/DevFaqCustomUpdateCenter] ,
+that was last modified by NetBeans user Markiewb
+on 2012-12-05T20:07:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomWindowMode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomWindowMode.asciidoc
new file mode 100644
index 0000000..8589be4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomWindowMode.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomWindowMode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to create a custom window mode?
+
+From time to time the available options are not enough. The available options are displayed below:
+
+image:Netbeans_Window_Modes.jpg[]
+
+Here's the link:http://www.yworks.com/en/products_yed_about.html[yEd] file for the above image in case this is incorrect or needs to be modified:
+
+image:Netbeans_Window_Modes.graphml[]
+
+If you want a custom "mode" or location for a top component follow this blog from Geertjan's Blog: link:https://blogs.oracle.com/geertjan/entry/creating_a_new_mode_in[Creating A New Mode In Your Application]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomWindowMode[http://wiki.netbeans.org/DevFaqCustomWindowMode] ,
+that was last modified by NetBeans user Maehem
+on 2012-06-02T00:37:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomizeBuild.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomizeBuild.asciidoc
new file mode 100644
index 0000000..db3cd75
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomizeBuild.asciidoc
@@ -0,0 +1,60 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomizeBuild
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How can I customize the build process?
+
+Problem: Customization of the build process is not documented properly
+
+Solution:
+
+* Add the custom tasks in the suite's build.xml file
+* Add a task overriding the -init task like this:
+[source,xml]
+----
+
+<target name="-init" depends="suite.-init,custom-task1,...">
+ <!--Perform your actions here-->
+</target>
+----
+
+
+
+The key part is calling the suite.-init task as it initializes a lot of stuff used by the rest of the process. Depending on which things you need to initialize, this target may not work and you may need to pick another one; look at what `common.xml` in the harness is initializing when.
+
+--
+Applies to: NetBeans IDE 6.8 and 6.9
+Platforms: All
+See also link:DevFaqSignNbm.html[DevFaqSignNbm] for an example using this.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomizeBuild[http://wiki.netbeans.org/DevFaqCustomizeBuild] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:25:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomizeWindowSystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomizeWindowSystem.asciidoc
new file mode 100644
index 0000000..693b1ab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomizeWindowSystem.asciidoc
@@ -0,0 +1,131 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomizeWindowSystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+When developing an application based on NetBeans platform there's sometimes need to tweak the Window System for your target users. Here's a couple of tips how to use various switches and options.
+
+==== Use own JFrame instance as the main window
+
+It is possible to use any JFrame instance as the main window. Simply create the instance when your module is being loaded (link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html#restored()[ModuleInstall.restored()]) and set its name to _NbMainWindow_. When the window system loads it will pick this instance and initialize it with menu bar, status bar, toolbars, inner desktop hierarchy etc.
+
+==== Mixing document and non-document windows
+
+As of NetBeans 7.1 it is possible to mix document and non-document windows. It means it is possible for example to drag Projects window and drop it next to Java source editor. It is also possible to drag any editor window and dock it next to Project or Output windows.
+If you want to turn this feature off and revert to NetBeans 7.0 behavior use _Mix.Editors.And.Views.Enabled_ branding property in _org/netbeans/core/windows/Bundle.properties_ bundle.
+
+==== Paint custom background
+
+Boolean property _NbMainWindow.showCustomBackground_ set to true in link:http://docs.oracle.com/javase/6/docs/api/javax/swing/UIManager.html#getBoolean(java.lang.Object)[UIManager] will make most of main window components transparent. So anything painted to main window root pane will be showing through its toolbars, menu bar, status bar and window borders. Use this property together with custom JFrame instance (see above) to paint custom images on main window background.
+
+==== Turn some features on/off on TopComponent level
+
+When creating a new TopComponent using NetBeans New File wizard you are presented a couple of option to modify window behavior. If you need to customize the behavior of an existing TopComponent or behavior of a TopComponent you don't have sources to just use any of client properties listed below. For example:
+
+[source,java]
+----
+
+WindowManager.getDefault().findTopComponent("output").putClientProperty("netbeans.winsys.tc.closing_disabled", Boolean.TRUE);
+//nobody can close Output window now!
+----
+
+* _netbeans.winsys.tc.closing_disabled_ - user cannot close the window - there is no close button and Close actions in the main menu is disabled. Closing the window by calling link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html#close()[TopComponent.close()] naturally still works.
+
+* _netbeans.winsys.tc.sliding_disabled_ - user cannot minimize the window.
+
+* _netbeans.winsys.tc.undocking_disabled_ - user cannot float the window.
+
+* _netbeans.winsys.tc.dragging_disabled_ - user cannot drag and drop the window to a different location.
+
+* _netbeans.winsys.tc.maximization_disabled_ - user cannot maximize window.
+
+* _netbeans.winsys.tc.keep_preferred_size_when_slided_in_ - by default minimized windows take the whole main window height or width when being shown from minimize bar. Setting this client property to true will force the window system to use TopComponent's preferred size when it is being slided in from the minimize bar.
+
+* _netbeans.winsys.tc.draganddrop_copy_disabled_ - by default it is possible to link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/CloneableTopComponent.html#clone()[clone] a link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/CloneableTopComponent.html[CloneableTopComponent] by dragging its header while holding down CTRL key. To disable such cloning set this client property to true.
+
+==== Turn some features on/off on window system level
+
+If you want to customize features of all windows you can use the following branding properties. (See for example link:DevFaqRenamingMenuItem.html[here] how NetBeans branding works.)
+
+* _TopComponent.DragAndDrop.Enabled_ - it is not possible to drag and drop any window when set to false.
+
+* _TopComponent.Undocking.Enabled_ - it is not possible to float any window when set to false.
+
+* _TopComponent.Sliding.Enabled_ - it is not possible to minimize any window when set to false.
+
+* _TopComponent.Resizing.Enabled_ - it is not possible to resize any window using the splitter bars when set to false.
+
+* _View.TopComponent.Closing.Enabled_ - it is not possible to close any non-document window when set to false.
+
+* _Editor.TopComponent.Closing.Enabled_ - it is not possible to close any document window when set to false.
+
+* _TopComponent.Maximization.Enabled_ - it is not possible to maximize any window when set to false.
+
+* _Splitter.Respect.MinimumSize.Enabled_ - it is not possible to make any window smaller than its minimum size by dragging its splitter bars when set to true.
+
+* _WinSys.Open.New.Editors.Docked_ - by default new document windows open next to the last active document window. If the last active document is floating then a new document will open tabbed next to that floating document. When this property is set to true then new documents will always open in the main window even if the last active document was floating.
+
+* _WinSys.DragAndDrop.Sliding.Enabled_ - it is not possible to drag any window and drop it to a minimize bar to minimize it when set to false.
+
+NetBeans version 7.1 introduced a concept of *tab groups*. All windows in the same docking spot form a tab group. For example Projects, Files and Services windows in the top-left corner of the main window belong into the same tab group. User can close/minimize/float the whole tab group with a single mouse gesture or keyboard shortcut. The following branding properties define which tab group actions are (not) enabled.
+
+* _Mode.Closing.Enabled_ - set to false to disable tab group closing.
+
+* _Mode.Sliding.Enabled_ - set false to disable tab group minimization.
+
+* _Mode.View.Undocking.Enabled_ - set to false to disable floating of non-document tab group.
+
+* _Mode.Editor.Undocking.Enabled_ - set to false to disable floating of document tab group.
+
+* _Mode.View.DragAndDrop.Enabled_ - set to false to disable drag and drop of non-document tab group.
+
+* _Mode.Editor.DragAndDrop.Enabled_ - set to false to disable drag and drop of document tab group.
+
+* _TopComponent.Auto.Slide.In.Minimized.Mode.Enabled_ - when set to true then windows that belong to a minimized tab group will open as minimized. When set to false then windows that belong to a minimized tab group will open as docked (unminimized).
+
+==== Customize non-document tabs layout
+
+As of NetBeans 7.1 non-document windows in the same docking spot are organized into a tab group (see also above).
+
+image:71_and_newer.png[title="Tabs in NetBeans 7.1 and newer"]
+
+If you want to revert the tab layout back to the old behavior in NetBeans 7.0 then you must set system property _winsys.stretching_view_tabs_ to true. Window tabs will then stretch to fill the whole width of the docking spot:
+
+image:70_and_older.png[title="Tabs in NetBeans 7.0 and older"]
+
+Please note that tab group actions (close group, float group, move group etc) will still be present in the main menu and in window's context menu. Use the branding propeties above to remove those actions.
+
+== External Link
+
+Up to date list of all Window System related properties and brading options should be available at link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/architecture-summary.html[architecture summary] page.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomizeWindowSystem[http://wiki.netbeans.org/DevFaqCustomizeWindowSystem] ,
+that was last modified by NetBeans user Jtulach
+on 2012-01-10T11:22:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCustomizingUnexpectedExceptionDialog.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCustomizingUnexpectedExceptionDialog.asciidoc
new file mode 100644
index 0000000..f5eca90
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCustomizingUnexpectedExceptionDialog.asciidoc
@@ -0,0 +1,173 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCustomizingUnexpectedExceptionDialog
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I customize the Unexpected Exception dialog ?
+
+Problem: How do I add new functionality to the Unexpected Exception dialog?
+
+Solution: First, one needs to create a new class as follows.
+
+The first part of this class is that it must extend `Handler`:
+
+[source,java]
+----
+
+public class NewFunctionExceptionHandler extends Handler {
+
+
+ @Override
+ public void publish(LogRecord record) {
+ if (record.getThrown() != null) {
+ // This is an uncaught exception being thrown.
+ }
+ }
+
+ @Override
+ public void flush() {
+ }
+
+ @Override
+ public void close() throws SecurityException {
+ }
+}
+----
+
+In order to properly process the exceptions, one must do a check for the exception in the `publish()` method; `LogRecord`s created due to exceptions being thrown will always have `Throwable`s present.
+
+This class also must implement `Callable<JButton>`. The button we want displayed in the Uncaught Exception dialog needs to be returned in the call() method:
+
+[source,java]
+----
+
+public class NewFunctionExceptionHandler extends Handler implements Callable<JButton> {
+
+
+ @Override
+ public void publish(LogRecord record) {
+ if (record.getThrown() != null) {
+ // This is an uncaught exception being thrown.
+ }
+ }
+
+ @Override
+ public void flush() {
+ }
+
+ @Override
+ public void close() throws SecurityException {
+ }
+
+ // Return the button we want to be displayed in the Uncaught Exception Dialog.
+ @Override
+ public JButton call() throws Exception {
+ ...
+ }
+}
+----
+
+The JButton's action listener needs to be passed the LogRecord that passed via the `publish()` method. Then, within said action listener for the button, the developer can do what is needed with that record (e.g. Open a Top Component to email a bug report or do anything else).
+
+The final result will look similar to:
+
+[source,java]
+----
+
+public class NewFunctionExceptionHandler extends Handler implements Callable<JButton> {
+
+ private JButton newFunctionButton;
+ private NewFunctionActionListener newFunctionActionListener = new NewFunctionActionListener();
+
+ @Override
+ public void publish(LogRecord record) {
+ if (record.getThrown() != null) {
+ newFunctionActionListener.setLogRecord(record);
+ }
+ }
+
+ @Override
+ public void flush() {
+ }
+
+ @Override
+ public void close() throws SecurityException {
+ }
+
+ // Return the button we want to be displayed in the Uncaught Exception Dialog.
+ @Override
+ public JButton call() throws Exception {
+ if (newFunctionButton == null) {
+ newFunctionButton = new JButton("Review and Submit Issue");
+ newFunctionButton.addActionListener(newFunctionActionListener);
+ }
+
+ return reviewIssueButton;
+ }
+
+ private class NewFunctionActionListener implements ActionListener {
+
+ private LogRecord logRecord;
+
+ public NewFunctionActionListener() {
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ // Close our Uncaught Exception Dialog first.
+ SwingUtilities.windowForComponent(reviewIssueButton).setVisible(false);
+ }
+
+ public void setLogRecord(LogRecord logRecord) {
+ this.logRecord = logRecord;
+ }
+ }
+}
+----
+
+To register this exception handler, one only needs to add the new `Handler` to a `java.util.Logger` named with the empty string:
+
+[source,java]
+----
+
+ Logger.getLogger("").addHandler(new NewFunctionExceptionHandler());
+----
+
+Any `Handler` attached to the "" Logger that also `implements Callable<JButton>` will have its button displayed in the Uncaught Exception Dialog.
+
+This could be done in a module's `Installer` class.
+
+Applies to: NetBeans IDE 6.0 and newer
+
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCustomizingUnexpectedExceptionDialog[http://wiki.netbeans.org/DevFaqCustomizingUnexpectedExceptionDialog] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:39:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqCutCopyPaste.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqCutCopyPaste.asciidoc
new file mode 100644
index 0000000..4efaef6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqCutCopyPaste.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqCutCopyPaste
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I handle cut, copy and paste?
+
+The subject of properly handling cut, copy and paste is underdocumented in modern material on the NetBeans Platform and I am not aware of any clear and concise examples that show how to handle all aspects of these common actions. Anyone who can improve these shortcomings would be doing a great service for the NetBeans Platform developer community.
+
+The link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/doc-files/api.html#edit[Nodes API documentation] provides some guidance, while chapter 14 of _NetBeans: The Definitive Guide_ link:http://www.netbeans.org/download/books/definitive-guide/html/apis-c_betterexplorer.html#N400551[goes into greater detail]. Although some parts of _NetBeans: The Definitive Guide_ are now outdated, the portions related to the Nodes API are likely still relevant.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqCutCopyPaste[http://wiki.netbeans.org/DevFaqCutCopyPaste] ,
+that was last modified by NetBeans user Jglick
+on 2010-05-04T13:46:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataLoader.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataLoader.asciidoc
new file mode 100644
index 0000000..a49c984
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataLoader.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataLoader
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a DataLoader?
+
+As of NetBeans 6.8, it is usually not necessary to implement DataLoader directly - today it is usually an implementation detail of writing file support, and you can simply write a link:DevFaqDataObject.html[DataObject] subclass and register it as follows:
+
+[source,java]
+----
+
+ <folder name="Loaders">
+ <folder name="text">
+ <folder name="x-foo">
+ <folder name="Factories">
+ <file name="FooDataLoader.instance">
+ <attr name="dataObjectClass" stringvalue="com.foo.modules.foofile.FooDataObject"/>
+ <attr name="instanceCreate" methodvalue="org.openide.loaders.DataLoaderPool.factory"/>
+ <attr name="mimeType" stringvalue="text/x-foo"/>
+ </file>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+
+----
+
+This registers the DataObject subclass `com.modules.foofile.FooDataObject` against the MIME type `text/x-foo`.
+
+==== DataLoader Details
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataLoader.html[DataLoaders] are factories for DataObjects. A DataLoader is typically associated with one or more link:http://en.wikipedia.org/wiki/MIME[MIME types] (such as `text/x-java`), and is allowed to be the system-wide factory for DataObjects for individual files of that MIME type.
+
+MIME type is typically determined by the file extension, though it can depend on content for things like XML files. link:DevFaqFileRecognition.html[(more about how NetBeans recognizes files)].
+
+DataLoaders are factories for link:DevFaqDataObject.html[DataObjects]. Typically there is a 1:1 mapping between file-type:DataLoader-subclass and a 1:1 mapping from file:DataObject. When a file is first encountered, and something calls [link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.html#find(org.openide.filesystems.FileObject[http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.html#find(org.openide.filesystems.FileObject]) `DataObject.find(theFileObject)`], the correct DataLoader is found and used to asked to create DataObject for that file.
+
+Modules that provide the ability the system to open (or otherwise use) files of a particular type will register DataLoaders for those types. So typically for each file type (as defined by MIME type, which in practice usually means file name extension, or XML subtype) there is a matching DataObject
+subclass.
+
+Note that DataLoaders do not _have_ to be tied to MIME types — you can still write a DataLoader subclass, registered the old-fashioned way via the JAR manifest, which gets the first chance in the system to claim *any* file in the system. However this is rarely wise or useful to do.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataLoader[http://wiki.netbeans.org/DevFaqDataLoader] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:48:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataObject.asciidoc
new file mode 100644
index 0000000..57fea01
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataObject.asciidoc
@@ -0,0 +1,67 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a DataObject?
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/index.html?org/openide/loaders/DataObject.html[DataObjects] wrap link:DevFaqFileObject.html[FileObjects]. (If you do not want to visualize files on disk in an explorer view or create a text editor [with syntax coloring, etc] for files, then you will never need to touch DataObjects.) A FileObject is just a container
+for data; it happens to have a MIME type, but like `java.io.File`, it doesn't know or care what kind
+of file it represents, or what data it contains. DataObject is part of the link:http://www.netbeans.org/download/dev/javadoc/org-openide-loaders/overview-summary.html[Loaders API] - a good overview of this API can be found link:http://www.netbeans.org/download/dev/javadoc/org-openide-loaders/overview-summary.html[here].
+
+A DataObject represents one or more (typically only one) FileObjects. A DataObject knows what kind of a file it represents. It may represent the parsed contents of a file such as a `.java` file. Or,
+as in the case of link:DevFaqInstanceDataObject.html[InstanceDataObject], the file _name_ may have semantic meaning. For example, a file with the name `org-netbeans-modules-speech-SpeakAction.instance` literally is an instruction to "Load the class `org.netbeans.modules.speech.SpeakAction`, and create an instance of it using its default (no argument) constructor" (this technique is commonly used in the link:DevFaqSystemFilesystem.html[system filesystem] to register Java objects installed by modules - more about that link:DevFaqFolderOfInstances.html[here]).
+
+DataObjects are produced by link:DevFaqDataLoader.html[DataLoaders], which modules register for specific file types. For each file type, there is (usually) one DataLoader. For each file of that type, there is one DataObject.
+
+DataObjects are seldom referred to by Java subclass. If you are casting a DataObject to its implementation class, you are probably doing something wrong. This is a general rule for which there can be exceptions, but is especially true if you're doing the cast from code in a different module than the one in which the DataObject was defined. Instead, the usage pattern is to _ask_ a DataObject for instances of interfaces that are the things your code will actually interact with, by calling `DataObject.getLookup().lookup(SomeType.class)` (link:DevFaqLookup.html[more about Lookup]).
+
+As a simple example, the NetBeans APIs define an interface `org.netbeans.api.actions.Openable`. It has
+one method, `open()`. That method will open the file in the editor.
+
+What exactly will happen when `open()` is called is entirely up to the module that implements the DataObject and Openable. The rest of the system does not need to know any of the implementation details - it just needs to know if the DataObject has an Openable. If it does, then the Open action on its context menu can be enabled, and that action will call
+`theDataObject.getLookup().lookup(Openable.class).open()`.
+
+As suggested above, a DataObject may actually represent more than one file - so when you expand a folder
+in the UI, there may actually be fewer DataObjects in that folder than there are files. This is why, in the
+NetBeans IDE, a Swing form is represented by a `.java` file and a corresponding `.form`
+file, but the `.form` file is not visible in the UI. `.properties` files have also used
+this mechanism to present multiple resource bundles in diverse languages as a single node in the files tree.
+
+However, this ability to represent multiple files with a single DataObject is strongly discouraged for new code and will probably eventually be deprecated - it has serious negative implications for scalability.
+
+=== Related tutorials
+
+* link:http://platform.netbeans.org/tutorials/60/nbm-copyfqn.html[NetBeans Java Language Infrastructure Tutorial]
+* link:http://platform.netbeans.org/tutorials/nbm-filetype.html[File Type Integration Tutorial]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataObject[http://wiki.netbeans.org/DevFaqDataObject] ,
+that was last modified by NetBeans user Geertjan
+on 2012-01-16T22:44:07Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataObjectFileObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataObjectFileObject.asciidoc
new file mode 100644
index 0000000..0b0d88f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataObjectFileObject.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataObjectFileObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I get a DataObject for a FileObject?
+
+[source,java]
+----
+
+DataObject.find (theFileObject)
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataObjectFileObject[http://wiki.netbeans.org/DevFaqDataObjectFileObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:38:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataObjectInItsCookieSet.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataObjectInItsCookieSet.asciidoc
new file mode 100644
index 0000000..2c5d015
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataObjectInItsCookieSet.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataObjectInItsCookieSet
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== The next button is never enabled when I create my DataObject from a template. Help!
+
+Most likely your `DataObject` does not put itself into its own `CookieSet`/`Lookup`. If you call `setCookieSet()`, or override `getLookup()` or `getCookie()`, this can happen. There are a few parts of NetBeans which will expect `Node`s to be present in their own `Lookup`s and `DataObject`s to be present in theirs. It is always best to make sure they are there. For a `DataObject`, the code for this is usually as simple as:
+
+[source,java]
+----
+
+getCookieSet().add(this);
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataObjectInItsCookieSet[http://wiki.netbeans.org/DevFaqDataObjectInItsCookieSet] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:38:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataObjectNode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataObjectNode.asciidoc
new file mode 100644
index 0000000..ed4c4d3
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataObjectNode.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataObjectNode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I get a DataObject for a Node?
+
+[source,java]
+----
+
+DataObject dob = (DataObject) theNode.getLookup().lookup (DataObject.class);
+if (dob != null) {
+ //do something
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataObjectNode[http://wiki.netbeans.org/DevFaqDataObjectNode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:38:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDataSystemsAddPopupToAllFolders.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDataSystemsAddPopupToAllFolders.asciidoc
new file mode 100644
index 0000000..6d090bf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDataSystemsAddPopupToAllFolders.asciidoc
@@ -0,0 +1,58 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDataSystemsAddPopupToAllFolders
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add an item to for every folder in the system?
+
+There is a folder in the link:DevFaqSystemFilesystem.html[System Filesystem ] called Loaders. It is where various things are registered that apply to specific link:DevFaqDataObject.html[DataObject ] types. For example, there is a folder `Loaders/text/x-java` that contains things that pertain to Java files (notice that the path is a MIME type). It has an `Actions` subfolder where you can add actions to the popup menu for Java files.
+
+You may not think of a folder as being a file type, but to NetBeans it is. There is a subfolder `Loaders/folder/any/Actions` which contains actions that should appear in the popup menu for folders. Just add your action in your link:DevFaqModulesLayerFile.html[layer file ] to that folder, i.e.
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="Loaders">
+ <folder name="folder">
+ <folder name="any">
+ <folder name="Actions">
+ <file name="com-foo-module-MyAction.instance"/>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+</filesystem>
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDataSystemsAddPopupToAllFolders[http://wiki.netbeans.org/DevFaqDataSystemsAddPopupToAllFolders] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:52:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDependOnCore.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDependOnCore.asciidoc
new file mode 100644
index 0000000..c925b57
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDependOnCore.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDependOnCore
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== There is a class under org.netbeans.core that does what I need. Can I call/use/depend on it?
+
+No. Not if you want your module to work in the future. Copy the code instead. If it is a thing that seems generally useful, link:http://www.netbeans.org/issues/enter_bug.cgi[file an enhancement request] requesting an API for the thing you need to do (and make sure there isn't already a supported way to do it).
+
+Anything under `org.netbeans.core` is non-public, not an API, and subject to change without notice. An API is a contract - an agreement about compatibility. There is no such contract for this namespace, under any circumstances. The class or method you are using may not even exist in the future. Depend on it at your peril.
+
+A perfect example of why not to do this is JProfiler's plugin for NetBeans - it broke very badly across releases because it needlessly depended on the _implementation_ of `DialogDisplayer` rather than on the API class - so when that class moved, it could no longer link, so the module didn't work.
+
+If you really must use some non-API classes to do what you need to do, use an implementation dependency (link:DevFaqImplementationDependency.html[DevFaqImplementationDependency]) - your module probably won't load in any version except the one it was built against, but at least your users won't get nasty surprises. And ideally, notify the maintainer of the thing you're depending on - they can give you a heads-up if they think they're about to make a change that will break your module.
+
+<hr/>
+
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDependOnCore[http://wiki.netbeans.org/DevFaqDependOnCore] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:12:01Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDialogControlOKButton.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDialogControlOKButton.asciidoc
new file mode 100644
index 0000000..2eb4dbf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDialogControlOKButton.asciidoc
@@ -0,0 +1,123 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDialogControlOKButton
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I control when the OK button is enabled?
+
+The link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/index.html?overview-summary.html[NetBeans Dialogs API] makes it easy to create consistent dialogs that behave as users would expect. But since you don't directly create the OK button, it may not be obvious how you can enable it or disable it.
+
+You can enable the OK button by calling <pre>setValid(true)</pre> and disable it by calling <pre>setValid(false)</pre>
+
+When using DialogDescriptors some additional steps need to be taken. Its OK button cannot be enabled/diabled after it has been displyed via a DialogDisplyer. The following is a sample code :
+
+[source,java]
+----
+
+1. Create a new Action in one of your modules using the wizard in the
+NetBeans IDE
+
+2. Replace the code generated inside that ActionListener with this code below:
+
+ public void actionPerformed(ActionEvent e) {
+ MyForm form = new MyForm();
+
+ DialogDescriptor desc = new DialogDescriptor(form,
+
+ "Hello", true, DialogDescriptor.OK_CANCEL_OPTION,
+ DialogDescriptor.OK_OPTION, null);
+
+ desc.setValid(false);
+
+ form.setDialogDescriptor(desc);
+
+ DialogDisplayer.getDefault().notify(desc); // displays the dialog
+ }
+
+
+ static class MyForm extends JPanel implements DocumentListener {
+
+ private JTextField field;
+ private DialogDescriptor desc;
+
+ MyForm() {
+ super(new BorderLayout());
+ field = new JTextField();
+ add(new JLabel("Type Something Here"), BorderLayout.NORTH);
+ add(field, BorderLayout.SOUTH);
+ }
+
+ void setDialogDescriptor(DialogDescriptor desc) {
+ this.desc = desc;
+ field.getDocument().addDocumentListener(this);
+ }
+
+ private void doEnablement() {
+ if (field.getText().isEmpty()) {
+ desc.setValid(false);
+ } else {
+ desc.setValid(true);
+ }
+ }
+
+ @Override
+ public void insertUpdate(DocumentEvent e) {
+ doEnablement();
+ }
+
+ @Override
+ public void removeUpdate(DocumentEvent e) {
+ doEnablement();
+ }
+
+ @Override
+ public void changedUpdate(DocumentEvent e) {
+ doEnablement();
+ }
+ }
+
+3. Run your application and invoke the new action you added
+----
+
+Here the OK button in the dialog is initially disabled, but becomes enabled when some characters are typed. Removing all characters will disable it again.
+
+One noteworthy point is that the following alternative fails to enable the OK button and hence the given solution is the appropriate one.
+
+[source,java]
+----
+
+desc.setValid(false);
+DialogDisplayer.getDefault().notify(desc);
+desc.setValid(true); //OK button doesnot get enabled
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDialogControlOKButton[http://wiki.netbeans.org/DevFaqDialogControlOKButton] ,
+that was last modified by NetBeans user Darrshan
+on 2010-06-15T05:06:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDialogsApiIntro.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDialogsApiIntro.asciidoc
new file mode 100644
index 0000000..b7a9f72
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDialogsApiIntro.asciidoc
@@ -0,0 +1,109 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDialogsApiIntro
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the Dialogs API and How Do I Use It?
+
+The link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/[Dialogs API] provides support for dialogs and wizards.
+
+Whenever you'd use JDialog or JOptionPane in Swing, using the Dialogs API provides some alternatives. These are easier to use as they automatically take care of centering and other display details, but also allow you to later plug in a different implementation of how they're actually "displayed." Instead of showing them on screen, for example, you could link:http://wiki.netbeans.org/DevFaqLookupHowToOverride[override the default] `DialogDisplayer` class to specify your own that logged them to a printer or read them aloud using speech synthesis.
+
+I'll illustrate three of the most common use cases. The first is when you want to simply show a dialog box with some text:
+image:OkDialog.png[]
+
+[source,java]
+----
+
+String msg = "There is something you should know...";
+NotifyDescriptor nd = new NotifyDescriptor.Message(msg, NotifyDescriptor.INFORMATION_MESSAGE);
+DialogDisplayer.getDefault().notify(nd);
+----
+
+For a question to users, you'll use a similar mechanism.
+
+image:YesNoDialog.png[]
+
+The `msg` argument is optional here:
+
+[source,java]
+----
+
+String msg = "Something is going to happen. Do you want to continue?";
+NotifyDescriptor nd = new NotifyDescriptor.Confirmation(msg, NotifyDescriptor.YES_NO_OPTION);
+Object result = DialogDisplayer.getDefault().notify(nd);
+if (NotifyDescriptor.OK_OPTION == result) {
+ // do it
+} else {
+ // don't do it
+}
+----
+
+And to request simple user input:
+
+image:InputDialog.png[]
+
+[source,java]
+----
+
+String txt = "Name: ";
+String title = "State your name";
+
+NotifyDescriptor.InputLine input = new NotifyDescriptor.InputLine(txt, title);
+input.setInputText("John Doe"); // specify a default name
+Object result = DialogDisplayer.getDefault().notify(input);
+if (result != NotifyDescriptor.OK_OPTION) {
+ return;
+}
+
+String userInput = input.getInputText();
+----
+
+And finally, the DialogDescriptor subclass, handles complex cases (there are many variants here; see link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/org/openide/DialogDescriptor.html[Dialog Descriptor's Javadoc] for details):
+
+image:CustomPanelDialog.png[]
+
+[source,java]
+----
+
+JPanel form = new MyComplexForm();
+String msg = "Something bad happened...";
+DialogDescriptor dd = new DialogDescriptor(form, msg);
+Object result = DialogDisplayer.getDefault().notify(dd);
+if (result != NotifyDescriptor.OK_OPTION) {
+ return;
+}
+
+// you can now examine the form's state...
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDialogsApiIntro[http://wiki.netbeans.org/DevFaqDialogsApiIntro] ,
+that was last modified by NetBeans user Maehem
+on 2012-11-10T06:16:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDisableAutoupdate.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDisableAutoupdate.asciidoc
new file mode 100644
index 0000000..d803f7a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDisableAutoupdate.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDisableAutoupdate
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I disable Auto Update (for example, while running tests)?
+
+The IDE often checks for updates on startup.
+This behavior may not be desired in some cases;
+for example, when running tests on the GUI,
+because they can slow the application down or potentially change its behavior
+from what you expected.
+In order to prevent the Auto Update check,
+run the application with the `netbeans.full.hack` system property set to `true`.
+For example, use `-J-Dnetbeans.full.hack=true` on the command line.
+
+Setting this property has some other side-effects; see: link:DevFaqNetBeansFullHack.html[DevFaqNetBeansFullHack]
+
+Functional tests using `NbModuleSuite` get this property set automatically.
+So do unit tests using `NbTestCase` (though they would rarely need it anyway).
+
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDisableAutoupdate[http://wiki.netbeans.org/DevFaqDisableAutoupdate] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:06:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDotSettingsFiles.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDotSettingsFiles.asciidoc
new file mode 100644
index 0000000..4a09de6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDotSettingsFiles.asciidoc
@@ -0,0 +1,65 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDotSettingsFiles
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are .settings files?
+
+`.settings` files are similar to [[DevFaqInstanceDataObject| `.instance` files]],
+with the difference that they are XML format, and can contain serialized data rather than just default instances.
+
+Since the introduction of [link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbPreferences.html[http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbPreferences.html] `NbPreferences`] to replace [link:http://bits.netbeans.org/dev/javadoc/org-openide-options/org/openide/options/SystemOption.html[http://bits.netbeans.org/dev/javadoc/org-openide-options/org/openide/options/SystemOption.html] `SystemOption`],
+very little new code uses these files, and they should be considered semi-deprecated. They are difficult and error-prone to use, and have a fair amount of overhead. The Window System still requires them to be used to persist the state of opened windows/tabs (caret position, what file is opened, or other state that should be restored when reopening a [link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html[http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html] `TopComponent`] after a restart) across application runs.
+
+A `.settings` file can encode the entire parent class and interface hierarchy of the object it represents, so that a query about _whether an object of a given type is present_ (such as using `link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#forPath(java.lang.String)[Lookups.forPath]("path/to/folder").allItems()`) can be answered without actually creating an instance of the object.
+
+Settings files are also useful if you are declaring some objects in a layer file (see link:DevFaqModulesLayerFile.html[DevFaqModulesLayerFile]) _and intend to write them back out to disk after they have been modified in-memory_ (note this involves writing ugly and inefficient hexadecimal-encoded serialized data into XML files - if the object is a singleton, using `link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbPreferences.html[NbPreferences]` will be both more efficient and more readable).
+
+==== Example
+
+[source,xml]
+----
+
+<?xml version="1.0"?>
+<!DOCTYPE settings PUBLIC "-//NetBeans//DTD Session settings 1.0//EN"
+ "link:http://www.netbeans.org/dtds/sessionsettings-1_0.dtd[http://www.netbeans.org/dtds/sessionsettings-1_0.dtd]">
+<settings version="1.0">
+ <module name="org.netbeans.core.io.ui/1" spec="1.6"/>
+ <instanceof class="org.openide.windows.TopComponent"/>
+ <instanceof class="org.netbeans.core.io.ui.IOWindow$IOWindowImpl"/>
+ <serialdata class="org.netbeans.core.io.ui.IOWindow$IOWindowImpl">
+ ACED0005737200296F72672E6F70656E6964652E7...
+ </serialdata>
+</settings>
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDotSettingsFiles[http://wiki.netbeans.org/DevFaqDotSettingsFiles] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T21:40:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDotShadowFiles.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDotShadowFiles.asciidoc
new file mode 100644
index 0000000..61a9c18
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDotShadowFiles.asciidoc
@@ -0,0 +1,81 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDotShadowFiles
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are `*.shadow` files?
+
+`*.shadow` files are mainly used in the link:DevFaqSystemFilesystem.html[system filesystem]
+for configuration data.
+They are the functional equivalent of Unix symbolic links -
+a `*.shadow` file is a pointer to another file whose
+behavior in every respect except its path and file name is the same as the original.
+
+`*.shadow` files are commonly used where only a single instance of an object is needed,
+but it must be registered in multiple folders.
+For example, a general `Action` is declared in the `Actions/` folder of the
+system filesystem.
+But the action also needs to appear in menus and toolbars, possibly other places.
+So, rather than create multiple instances of an action, one [[DevFaqInstanceDataObject|`*.instance` file]]
+is created in the link:DevFaqModulesLayerFile.html[module's layer file], in the `Actions/` folder.
+Then `*.shadow` files are created in all of the other places the `*.instance` file would be needed,
+pointing to the original file.
+
+Declaring a .shadow file in the system filesystem looks like this:
+
+[source,xml]
+----
+
+<folder name="A">
+ <file name="com-foo-mymodule-MyClass.instance"/>
+</folder>
+<folder name="B">
+ <file name="Shadow1.shadow">
+ <attr name="originalFile" stringvalue="A/com-foo-mymodule- MyClass.instance"/>
+ </file>
+</folder>
+<folder name="C">
+ <file name="anotherShadow.shadow">
+ <attr name="originalFile" stringvalue="A/com-foo-mymodule-MyClass.instance"/>
+ </file>
+</folder>
+----
+
+Shadow files can also point to real files on disk.
+For example, the Favorites tab in the NetBeans IDE
+uses shadow files to link to real directories on disk.
+
+===== Creating Shadow Files Programmatically
+
+If you need to create `.shadow` files programmatically, use [link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataShadow.html#create(org.openide.loaders.DataFolder,%20java.lang.String,%20org.openide.loaders.DataObject[http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataShadow.html#create(org.openide.loaders.DataFolder,%20java.lang.String,%20org.openide.loaders.DataObject]) `DataShadow.create()`] — do not write `FileObject`s and try to set attributes on them. In an XML layer, a `DataShadow`'s original file is pointed to by a file attribute. On disk, that is accomplished via the _file's content_ instead. To reliably create `DataShadow`s, let the infrastructure do it for you - do not make assumptions about how the original file is pointed to.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDotShadowFiles[http://wiki.netbeans.org/DevFaqDotShadowFiles] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T21:42:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbar.asciidoc
new file mode 100644
index 0000000..d4a1fc8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbar.asciidoc
@@ -0,0 +1,214 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDropdownMenuAddToolbar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add a drop-down menu to a toolbar button?
+
+To add a drop-down menu to a component in a toolbar, you can either extend `CallableSystemAction` and override
+`public Component getToolbarPresenter()`,
+or implement `javax.swing.Action` or any subclass thereof, and implement `link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.Toolbar.html[Presenter.Toolbar]`
+which defines that method.
+
+You might want to create a `JToggleButton`, and when the button is pressed, show a `JPopupMenu`. (Also try `org.openide.awt.DropDownButtonFactory`.)
+
+Example:
+
+[source,java]
+----
+
+public class PickDrawingLineAction extends CallableSystemAction {
+ private static JToggleButton toggleButton;
+ private static ButtonGroup buttonGroup;
+ private static JPopupMenu popup;
+ private MyMenuItemListener menuItemListener;
+
+ List handledCharts;
+
+ public void performAction() {
+ java.awt.EventQueue.invokeLater(new Runnable() {
+ public void run() {
+ toggleButton.setSelected(true);
+ }
+ });
+
+ }
+
+ public String getName() {
+ return "Pick Drawing Line";
+ }
+
+ public HelpCtx getHelpCtx() {
+ return HelpCtx.DEFAULT_HELP;
+ }
+
+ protected boolean asynchronous() {
+ return false;
+ }
+
+ public Component getToolbarPresenter() {
+ Image iconImage = Utilities.loadImage(
+ "org/blogtrader/platform/core/netbeans/resources/drawingLine.png");
+ ImageIcon icon = new ImageIcon(iconImage);
+
+ toggleButton = new JToggleButton();
+
+ toggleButton.setIcon(icon);
+ toggleButton.setToolTipText("Pick Drawing Line");
+
+ popup = new JPopupMenu();
+ menuItemListener = new MyMenuItemListener();
+
+ handledCharts = PersistenceManager.getDefalut()
+ .getAllAvailableHandledChart();
+
+ buttonGroup = new ButtonGroup();
+
+ for (AbstractHandledChart handledChart : handledCharts) {
+ JRadioButtonMenuItem item =
+ new JRadioButtonMenuItem(handledChart.toString());
+ item.addActionListener(menuItemListener);
+ buttonGroup.add(item);
+ popup.add(item);
+ }
+
+ toggleButton.addItemListener(new ItemListener() {
+ public void itemStateChanged(ItemEvent e) {
+ int state = e.getStateChange();
+ if (state == ItemEvent.SELECTED) {
+ /** show popup menu on toggleButton at position: (0, height) */
+ popup.show(toggleButton, 0, toggleButton.getHeight());
+ }
+ }
+ });
+
+ popup.addPopupMenuListener(new PopupMenuListener() {
+ public void popupMenuCanceled(PopupMenuEvent e) {
+ toggleButton.setSelected(false);
+ }
+ public void popupMenuWillBecomeInvisible(PopupMenuEvent e) {
+ toggleButton.setSelected(false);
+ }
+ public void popupMenuWillBecomeVisible(PopupMenuEvent e) {
+ }
+ });
+
+ return toggleButton;
+ }
+
+ private class MyMenuItemListener implements ActionListener {
+ public void actionPerformed(ActionEvent ev) {
+ JMenuItem item = (JMenuItem)ev.getSource();
+ String selectedStr = item.getText();
+
+ AnalysisChartTopComponent analysisTc =
+ AnalysisChartTopComponent.getSelected();
+
+ if (analysisTc == null) {
+ return;
+ }
+
+ AbstractChartViewContainer viewContainer =
+ analysisTc.getSelectedViewContainer();
+ AbstractChartView masterView = viewContainer.getMasterView();
+ if (!(masterView instanceof WithDrawingPart)) {
+ return;
+ }
+
+ DrawingPart drawingPart =
+ ((WithDrawingPart)masterView).getCurrentDrawing();
+
+ if (drawingPart == null) {
+ JOptionPane.showMessageDialog(
+ WindowManager.getDefault().getMainWindow(),
+ "Please add a layer firstly to pick line type",
+ "Pick line type",
+ JOptionPane.OK_OPTION,
+ null);
+ return;
+ }
+
+ AbstractHandledChart selectedHandledChart = null;
+
+ for (AbstractHandledChart handledChart : handledCharts) {
+ if (handledChart.toString().equalsIgnoreCase(selectedStr)) {
+ selectedHandledChart = handledChart;
+ break;
+ }
+ }
+
+ if (selectedHandledChart == null) {
+ return;
+ }
+
+ AbstractHandledChart handledChart =
+ selectedHandledChart.createNewInstance();
+ handledChart.setPart(drawingPart);
+ drawingPart.setHandledChart(handledChart);
+
+ Series masterSeries = viewContainer.getMasterSeries();
+ DrawingDescriptor description =
+ viewContainer.getDescriptors().findDrawingDescriptor(
+ drawingPart.getLayerName(),
+ masterSeries.getUnit(),
+ masterSeries.getNUnits());
+
+ if (description != null) {
+ Node stockNode = analysisTc.getActivatedNodes()[0];
+ Node node =
+ stockNode.getChildren()
+ .findChild(DescriptorGroupNode.DRAWINGS)
+ .getChildren().findChild(description.getDisplayName());
+
+ if (node != null) {
+ ViewAction action =
+ (ViewAction)node.getLookup().lookup(ViewAction.class);
+ assert action != null :
+ "view action of this layer's node is null!";
+ action.view();
+ }
+ } else {
+ /** best effort, should not happen */
+ viewContainer.setCursorCrossVisible(false);
+ drawingPart.setActived(true);
+
+ SwitchHideShowDrawingLineAction.updateToolbar(viewContainer);
+ }
+
+ }
+ }
+
+}
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDropdownMenuAddToolbar[http://wiki.netbeans.org/DevFaqDropdownMenuAddToolbar] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:33:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbarEnabled.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbarEnabled.asciidoc
new file mode 100644
index 0000000..266abda
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDropdownMenuAddToolbarEnabled.asciidoc
@@ -0,0 +1,173 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDropdownMenuAddToolbarEnabled
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add a dropdown menu to toolbar that is selectively enabled/disabled?
+
+Create an Action as described in link:DevFaqDropdownMenuAddToolbar.html[the general FAQ for to add a dropdown menu to a toolbar].
+
+In this case, your action also needs to implement link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/ContextAwareAction.html[ContextAwareAction]. A ContextAwareAction is a factory for other Action instances which are tied to a specific Lookup (so that, if selection changes after the popup menu for a Node is shown, the Action does not operate on the wrong object). You can start with a subclass of javax.swing.AbstractAction, and you will need two constructors:
+
+[source,java]
+----
+
+private final Lookup lookup;
+public MyAction() {
+ this (Utilities.actionsGlobalContext());
+}
+
+private MyAction(Lookup lookup) {
+ this.lookup = lookup;
+ Icon icon = ImageUtilities.image2Icon(
+ ImageUtilities.loadImage("com/foo/icon.gif"));
+ putValue(SMALL_ICON, icon);
+ //set the initial enabled state
+ setEnabled(false);
+}
+----
+
+You will also need to implement the one method of ContextAwareAction:
+
+[source,java]
+----
+
+public Action createContextAwareInstance(Lookup actionContext) {
+ return new MyAction(actionContext);
+}
+
+----
+
+To enable and disable the action, we will need to listen on the lookup for the presence or absence of some object type. If it is there, the action will be enabled; if it is not, it will be disabled.
+
+Since we do not want to start listening on the global selection context until something actually cares whether the action is enabled or not, so we will override add/removePropertyChangeListener() to notice that and listen or not.
+
+First, we must modify our class signature to implement LookupListener:
+
+[source,java]
+----
+
+public class MyAction extends AbstractAction implements ContextAwareAction, LookupListener, Presenter.Toolbar {
+...
+----
+
+Now we will handle listening on the Lookup.Result. We want to stop listening to it when there are no PropertyChangeListeners left, so that our action can be garbage collected if not in use:
+
+[source,java]
+----
+
+private LookupResult<? extends DataObject> res;
+
+@Override
+public synchronized void addPropertyChangeListener(PropertyChangeListener l) {
+ boolean startListening = getPropertyChangeListeners().length == 0;
+ super.addPropertyChangeListener(l);
+ if (startListening) {
+ res = lookup.lookupResult(MyType.class);
+ res.addLookupListener(this);
+ }
+}
+
+@Override
+public synchronized void removePropertyChangeListener(PropertyChangeListener l) {
+ super.removePropertyChangeListener(l);
+ if (getPropertyChangeListeners().length == 0) {
+ res.removeLookupListener(this);
+ res = null;
+ }
+}
+
+----
+
+Now comes the actual implementation of LookupListener:
+
+[source,java]
+----
+
+public void resultChanged(LookupEvent ev) {
+ setEnabled(!res.allItems().isEmpty());
+}
+
+----
+
+A bit of bookkeeping is required in getToolbarPresenter() - at least until link:https://netbeans.org/bugzilla/show_bug.cgi?id=179814[issue 179814] is fixed, we will need to manually enable/disable the actions for our menu items:
+
+[source,java]
+----
+
+ private final Set<Action> popupMenuActions = new WeakSet<Action>();
+ @Override
+ public Component getToolbarPresenter() {
+ JPopupMenu menu = new JPopupMenu();
+ Action actionOne = new DemoMenuAction("One");
+ Action actionTwo = new DemoMenuAction("Two");
+ menu.add(new JMenuItem(actionOne));
+ menu.add(new JMenuItem(actionTwo));
+ popupMenuActions.add(actionOne);
+ popupMenuActions.add(actionTwo);
+ //add action listeners to the menu items to do what you want
+ Icon icon = (Icon) getValue(SMALL_ICON);
+ JButton result = DropDownButtonFactory.createDropDownButton(icon, menu);
+ result.setAction(this);
+ return result;
+ }
+
+ @Override
+ public void setEnabled(boolean enabled) {
+ super.setEnabled(enabled);
+ for (Action a : popupMenuActions) {
+ if (a != null) { //WeakSet iterator can return null
+ a.setEnabled(enabled);
+ }
+ }
+ }
+
+ private class DemoMenuAction extends AbstractAction {
+ DemoMenuAction(String name) {
+ putValue(NAME, name);
+ setEnabled (MyAction.this.isEnabled());
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ DataObject ob = res.allInstances().iterator().next();
+ DialogDisplayer.getDefault().notify(new NotifyDescriptor.Message(
+ ob.getName()));
+ }
+ }
+----
+
+If we want the drop-down button to do something when it is clicked on the right side (not in the popup area with the down-arrow), we can implement actionPerformed(ActionEvent) to do whatever that is.
+
+For an older detailed example of manually creating a context-aware drop-down toolbar button (without DropDownButtonFactory, circa NetBeans 6.0), see link:http://article.gmane.org/gmane.comp.java.netbeans.modules.openide.devel/35436[see this post], posted in link:http://thread.gmane.org/gmane.comp.java.netbeans.modules.openide.devel/35424[on the old dev@openide NetBeans mailing lists].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDropdownMenuAddToolbarEnabled[http://wiki.netbeans.org/DevFaqDropdownMenuAddToolbarEnabled] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:35:21Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqDynamicSystemFilesystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqDynamicSystemFilesystem.asciidoc
new file mode 100644
index 0000000..38be365
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqDynamicSystemFilesystem.asciidoc
@@ -0,0 +1,89 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqDynamicSystemFilesystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Can I dynamically change the contents of the System Filesystem at runtime?
+
+Yes. This technique is commonly used in platform applications which require the user to log in, to keep menu contents/toolbar actions/keyboard shortcuts/window definitions hidden until the user is authenticated.
+
+There are two ways to do it. The most obvious way is to programmatically write files to disk at runtime (call `FileUtil.getConfigRoot().createFolder()`, etc.). This technique is appropriate if you are creating files which should be preserved across restarts (for example, adding folders to the Favorites window). _It is completely inappropriate in the case of authentication, or any other case where you do not want the added files to be present after restart. You cannot depend on the application always being shut down normally and having a chance to clean such files up - since they are actually written to disk._
+
+=== Using Dynamically Added Layers
+
+The alternative is quite simple: Write a subclass of `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/MultiFileSystem.html[MultiFileSystem]`. Put it in the link:DevFaqLookupDefault.html[default lookup].
+
+At runtime, when you want to add contents to the system filesystem, simply add additional filesystems to your `MultiFileSystem`. To remove the contents, simply remove those filesystems.
+
+A convenient way to do this is to use XMLFileSystem - this is a filesystem created with exactly the same syntax as normal module XML layer files (see link:DevFaqModulesLayerFile.html[DevFaqModulesLayerFile]). The following code loads an XML filesystem, which is in an XML file in the same package as the class, called `dynamicContent.xml`:
+
+[source,java]
+----
+
+@ServiceProvider(service=FileSystem.class)
+public class DynamicLayerContent extends MultiFileSystem {
+ private static DynamicLayerContent INSTANCE;
+ public DynamicLayerContent() {
+ // will be created on startup, exactly once
+ INSTANCE = this;
+ setPropagateMasks(true); // permit *_hidden masks to be used
+ }
+ static boolean hasContent() {
+ return INSTANCE.getDelegates().length &gt; 0;
+ }
+ static void enable() {
+ if (!hasContent()) {
+ try {
+ INSTANCE.setDelegates(new XMLFileSystem(
+ DynamicLayerContent.class.getResource(
+ "dynamicContent.xml")));
+ } catch (SAXException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ }
+ }
+ static void disable() {
+ INSTANCE.setDelegates();
+ }
+}
+----
+
+In NetBeans 7.2 and later, the above code can be simplified by using `Repository.LayerProvider`. See its Javadoc for a usage example.
+
+If finer grained control of what is added is needed at runtime, there are two possibilities, using this general approach:
+
+* If the new layer contents are fixed and known, but perhaps correspond to user roles which may be overlaid together, split up the functionality for each role into a separate XML file (hint: define an enum of roles, where each role can point to an XML file URL, use `link:http://java.sun.com/j2se/1.5.0/docs/api/java/util/EnumSet.html#of%28E,%20E...%29[EnumSet.of()]` and process that to decide what to enable)
+* Write contents programmatically, but write folders/files to an in-memory filesystem created using `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#createMemoryFileSystem()[FileUtil.createMemoryFileSystem()]` so the contents disappear on VM exit
+
+link:https://bitbucket.org/jglick/dynamicmenudemo/[https://bitbucket.org/jglick/dynamicmenudemo/] tries to automate this kind of task.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqDynamicSystemFilesystem[http://wiki.netbeans.org/DevFaqDynamicSystemFilesystem] ,
+that was last modified by NetBeans user Jglick
+on 2012-04-10T00:02:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorCodeCompletionAnyJEditorPane.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorCodeCompletionAnyJEditorPane.asciidoc
new file mode 100644
index 0000000..ed30394
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorCodeCompletionAnyJEditorPane.asciidoc
@@ -0,0 +1,106 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorCodeCompletionAnyJEditorPane
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How to add code completion to any JEditorPane
+
+You can add the built-in Java code completion from the Netbeans 6 Java editor to any arbitrary JEditorPane. See the code below for how this can be achieved. Note that Netbeans Java editor functionality is derived from an underlying FileObject, so we are essentially creating a dummy Java FileObject and tying our JEditorPane document in with the appropriate hooks.
+
+
+
+The end result of this code is that we create a Java context for our JEditorPane. This context initializes code completion with a default class path, and that grants us access to the standard Java APIs (i.e. the code completion box can include classes such as java.lang.String, java.util.List, etc.). However, this context has no visibility into any additional jars nor Java projects. In order to expand this default Java context, you will need to create your own class path provider (see the link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-api-java/org/netbeans/spi/java/classpath/package-summary.html["Java Support APIs"] module).
+
+
+
+First, let's take a look at some of the classes we'll be using:
+
+* import java.io.File;
+* import javax.swing.JEditorPane;
+* import javax.swing.text.Document;
+* import javax.swing.text.EditorKit;
+* import org.netbeans.spi.java.classpath.ClassPathProvider; <span style='color:orange;'> from the "Java Support APIs" module</span>
+* import org.openide.filesystems.FileObject; <span style='color:orange;'> from the "File System API" module</span>
+* import org.openide.filesystems.FileUtil; <span style='color:orange;'> from the "File System API" module</span>
+* import org.openide.loaders.DataObject; <span style='color:orange;'> from the "Datasystems API" module</span>
+* import org.openide.text.CloneableEditorSupport; <span style='color:orange;'> from the "Text API" module</span>
+* import org.openide.util.Lookup; <span style='color:orange;'> from the "Utilities API" module</span>
+* import org.netbeans.api.java.source.ui.DialogBinding; <span style='color:orange;'> from the "Java Source UI" module</span>
+
+
+
+Now we're ready to take a look at the actual code:
+
+[source,java]
+----
+
+
+ JEditorPane editorPane = new JEditorPane();
+
+ // This will find the Java editor kit and associate it with
+ // our editor pane. But that does not give us code completion
+ // just yet because we have no Java context (i.e. no class path, etc.).
+ // However, this does give us syntax coloring.
+ EditorKit kit = CloneableEditorSupport.getEditorKit("text/x-java");
+ editorPane.setEditorKit(kit);
+
+ // You can specify any ".java" file.
+ // If the file does not exist, it will be created.
+ // The contents of the file does not matter.
+ // The extension must be ".java", however.
+ String newSourcePath = "tmp.java";
+
+ File tmpFile = new File(newSourcePath);
+ FileObject fob = FileUtil.createData(tmpFile);
+
+ DataObject dob = DataObject.find(fob);
+ editorPane.getDocument().putProperty(
+ Document.StreamDescriptionProperty,
+ dob);
+
+ // This sets up a default class path for us so that
+ // we can find all the JDK classes via code completion.
+ DialogBinding.bindComponentToFile(fob, 0, 0, editorPane);
+
+ // Last but not least, we need to fill the editor pane with
+ // some initial dummy code - as it seems somehow required to
+ // kick-start code completion.
+ // A simple dummy package declaration will do.
+ editorPane.setText("package dummy;");
+
+----
+
+Applies to: Netbeans 6.0, 6.1 and 6.5. Since 6.7 `DialogBinding` class was moved to `org.netbeans.api.editor` package in `Editor Library 2` module.
+
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorCodeCompletionAnyJEditorPane[http://wiki.netbeans.org/DevFaqEditorCodeCompletionAnyJEditorPane] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:25:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorGetCurrentDocument.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorGetCurrentDocument.asciidoc
new file mode 100644
index 0000000..26e9975
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorGetCurrentDocument.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorGetCurrentDocument
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I find the currently open document in the selected editor?
+
+[source,java]
+----
+
+JTextComponent ed = org.netbeans.api.editor.EditorRegistry.lastFocusedComponent();
+Document doc = ed.getDocument();
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorGetCurrentDocument[http://wiki.netbeans.org/DevFaqEditorGetCurrentDocument] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:40:29Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorHowIsMimeLookupComposed.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorHowIsMimeLookupComposed.asciidoc
new file mode 100644
index 0000000..d43ca35
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorHowIsMimeLookupComposed.asciidoc
@@ -0,0 +1,112 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorHowIsMimeLookupComposed
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How is MimeLookup composed?
+
+In order to get link:DevFaqEditorWhatIsMimeLookup.html[MimeLookup] you have to supply
+link:DevFaqEditorWhatIsMimePath.html[MimePath]. With the default `MimeLookup`
+implementation provided by Netbeans the contents of `MimeLookup` is defined by
+a hierarchical structure of folders on the system FileSystem. The structure
+starts in the `Editors` folder and then follows all the components of the `MimePath` you
+have supplied.
+
+For example if you ask for `MimeLookup` for the following `MimePath` of
+`text/x-java` you will get `Lookup` with contents from the following
+folders:
+
+[source,java]
+----
+
+ Editors/text/x-java
+ Editors
+----
+
+As you can see `MimeLookup` for `text/x-java` contains not only editor
+features registered for the `text/x-java` mime type itself, but it also
+inherits general features registered for an empty `MimePath` (i.e. in the
+root of the hierarchy).
+
+The inheritence algorithm used for composing `MimeLookup` for a given
+`MimePath` supports more than just simple inheritance from the root. It also
+supports compound mime types such as `text/x-ant+xml` and embedded mime types
+such as `text/x-jsp/text/x-java`.
+
+==== Compound mime types
+
+Let's have a look at the `MimeLookup` composition for a compound mime type
+`text/x-ant+xml`. The resulting `Lookup` will contain things registered in
+the following folders:
+
+[source,java]
+----
+
+ Editors/text/x-ant+xml
+ Editors/text/xml
+ Editors
+----
+
+That's the reason why editor features provided by XML modules for general
+XML files work also for specialized, but XML-based, files.
+
+==== Embedded mime types
+
+The inheritance hierarchy becomes even more complicated when dealing with embedded mime
+types. Let's use a java scriplet inside a JSP page as an example of language embedding.
+The `MimePath` for the scriplet is `text/x-jsp/text/x-java` and its `MimeLookup` will
+contain features registered in the following folders:
+
+[source,java]
+----
+
+ Editors/text/x-jsp/text/x-java
+ Editors/text/x-java
+ Editors
+----
+
+The algorithm for computing the inheritance tree for a particular `MimePath`
+combines all the above cases together and works always the same way no matter what
+feature you are going to look for in the resulting `MimeLookup`.
+
+---
+
+Applies to: NetBeans 6.x and with some exceptions also to 5.x
+
+Platforms: All
+
+See also:
+link:DevFaqEditorWhatIsMimeLookup.html[What is MimeLookup?],
+link:DevFaqEditorWhatIsMimePath.html[What is MimePath?],
+link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-modules-editor-mimelookup/index.html[MimeLookup API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorHowIsMimeLookupComposed[http://wiki.netbeans.org/DevFaqEditorHowIsMimeLookupComposed] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:05:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddCodeTemplates.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddCodeTemplates.asciidoc
new file mode 100644
index 0000000..bad9042
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddCodeTemplates.asciidoc
@@ -0,0 +1,68 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorHowToAddCodeTemplates
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to add code templates?
+
+1. Create your template file
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE codetemplates PUBLIC "-//NetBeans//DTD Editor Code Templates settings 1.0//EN" "http://www.netbeans.org/dtds/EditorCodeTemplates-1_0.dtd">
+<codetemplates>
+ <codetemplate abbreviation="hello" xml:space="preserve">
+ `<![CDATA[Hello ${world}]]>`
+ <description><![CDATA[Bla bla bla]]></description>
+ </codetemplate>
+</codetemplates>
+----
+
+2. Register it for the mimetype in the layer.xml
+
+[source,xml]
+----
+
+ <folder name="Editors">
+ <folder name="text">
+ <folder name="x-java">
+ <folder name="CodeTemplates">
+ <file name="my-templates.xml" url="my-templates.xml"/>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorHowToAddCodeTemplates[http://wiki.netbeans.org/DevFaqEditorHowToAddCodeTemplates] ,
+that was last modified by NetBeans user Markiewb
+on 2016-05-26T21:47:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddDiffView.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddDiffView.asciidoc
new file mode 100644
index 0000000..38d405c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToAddDiffView.asciidoc
@@ -0,0 +1,243 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorHowToAddDiffView
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to use the diff view in my own application/plugin
+
+== Show non-editable diff for files
+
+[source,java]
+----
+
+@ActionID(category = "Tools", id = "org.my.diff.DiffViewerAction")
+@ActionRegistration(asynchronous = true, displayName = "#CTL_DiffViewerAction")
+@ActionReference(path = "Menu/Tools", position = 0)
+@Messages("CTL_DiffViewerAction=Open Diff Viewer")
+public final class DiffViewerAction implements ActionListener {
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ StreamSource local = StreamSource.createSource("name1", "title1", "text/html", new File("C:/tutorials/nbm-google.html"));
+ StreamSource remote = StreamSource.createSource("name2","title2", "text/html", new File("C:/tutorials/72/nbm-google.html"));
+ diff(local, remote);
+ }
+
+ public void diff(final StreamSource local, final StreamSource remote) {
+ SwingUtilities.invokeLater(new Runnable() {
+ @Override
+ public void run() {
+ try {
+ DiffView view = Diff.getDefault().createDiff(local, remote);
+ TopComponent tc = new TopComponent();
+ tc.setDisplayName("Diff Viewer");
+ tc.setLayout(new BorderLayout());
+ tc.add(view.getComponent(), BorderLayout.CENTER);
+ tc.open();
+ tc.requestActive();
+ } catch (IOException ex) {
+ }
+ }
+ });
+ }
+
+}
+----
+
+or
+
+[source,java]
+----
+
+ String contentType = fo.getMIMEType();
+ DiffView view = Diff.getDefault().createDiff(
+ StreamSource.createSource("Before", "Before", contentType, new StringReader(beforeText)),
+ StreamSource.createSource("After", "After", contentType, new StringReader(afterText))
+ );
+ Component diffViewComponent = view.getComponent();
+
+----
+
+See
+
+* link:https://blogs.oracle.com/geertjan/entry/getting_started_with_diff_viewer[https://blogs.oracle.com/geertjan/entry/getting_started_with_diff_viewer]
+* link:https://blogs.oracle.com/geertjan/entry/netbeans_diff_api[https://blogs.oracle.com/geertjan/entry/netbeans_diff_api]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-diff/index.html?overview-summary.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-diff/index.html?overview-summary.html]
+
+== Show editable diff for nodes with FileObject in node's lookup
+
+* link:https://blogs.oracle.com/geertjan/entry/how_to_create_an_editable[https://blogs.oracle.com/geertjan/entry/how_to_create_an_editable]
+
+== Show editable diff for a FileObject and an arbitrary base source
+
+You have to an editable StreamSource for your FileObject to create a editable diff viewer.
+
+The following sample app will compare the given FileObject (from the Lookup) with its base. The base - in this very simplified example ? is a String read from a file.
+
+[source,java]
+----
+
+package de.markiewb.netbeans.sample.editablediff;
+
+//...
+
+@ActionID(category = "Edit", id = "de.markiewb.netbeans.sample.editablediff.EditableDiffAction")
+@ActionRegistration(displayName = "#CTL_DiffAction")
+@ActionReferences({
+ @ActionReference(path = "Editors/Popup")})
+@Messages("CTL_DiffAction=Editable diff...")
+public final class EditableDiffAction implements ActionListener {
+
+ private final FileObject file;
+
+ public EditableDiffAction(FileObject context) {
+ this.file = context;
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent ev) {
+ final String baseText = getOriginalText(file);
+ final StreamSource base = StreamSource.createSource("name1", "base", file.getMIMEType(), new StringReader(baseText));
+ final StreamSource modified = EditableStreamSource.createEditableSource("name2", "modified", file.getMIMEType(), file);
+
+ openDiffWindow(file, modified, base, "Diff of " + file.getNameExt() + " to original");
+ }
+
+ public void openDiffWindow(final FileObject localFile, final StreamSource local, final StreamSource remote, final String title) {
+ SwingUtilities.invokeLater(new Runnable() {
+ @Override
+ public void run() {
+ try {
+ final TopComponent tc = new TopComponent();
+ tc.setDisplayName(title);
+ tc.setLayout(new BorderLayout());
+ makeDiffWindowSaveable(tc, localFile);
+ tc.add(DiffController.createEnhanced(remote, local).getJComponent(), BorderLayout.CENTER);
+ tc.open();
+ tc.requestActive();
+ } catch (IOException ex) {
+ }
+ }
+ });
+ }
+
+ /**
+ * Put the node of dataObject of the fileObject into "globallookup". This
+ * allows saving via CTRL-S shortkey from within the editable diff TC. See
+ * http://netbeans.org/bugzilla/show_bug.cgi?id=223703
+ *
+ * @param tc
+ * @param fileObject
+ */
+ private void makeDiffWindowSaveable(TopComponent tc, FileObject fileObject) {
+ if (tc != null) {
+ Node node;
+ try {
+ node = DataObject.find(fileObject).getNodeDelegate();
+ } catch (DataObjectNotFoundException e) {
+ node = new AbstractNode(Children.LEAF, Lookups.singleton(fileObject));
+ }
+ tc.setActivatedNodes(new Node[]{node});
+ }
+ }
+
+ public String getOriginalText(FileObject file) {
+ // TODO this is only a mockup
+ // TODO get original text from other sources like SCM, DB, template files..
+ try {
+ return file.asText("UTF-8").replace("public ", "public final ");
+ } catch (IOException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ return "";
+ }
+
+ public static class EditableStreamSource extends StreamSource {
+
+ private String name, title, mimeType;
+ private FileObject fileObject;
+
+ private EditableStreamSource(String name, String title, String mimeType, FileObject fileObject) {
+ this.name = name;
+ this.title = title;
+ this.mimeType = mimeType;
+ this.fileObject = fileObject;
+ }
+
+ public static StreamSource createEditableSource(String name, String title, String mimeType, FileObject fileObject) {
+ return new EditableStreamSource(name, title, mimeType, fileObject);
+ }
+
+ @Override
+ public String getName() {
+ return this.name;
+ }
+
+ @Override
+ public String getTitle() {
+ return this.title;
+ }
+
+ @Override
+ public Lookup getLookup() {
+ return Lookups.fixed(fileObject);
+ }
+
+ @Override
+ public boolean isEditable() {
+ return fileObject.canWrite();
+ }
+
+ @Override
+ public String getMIMEType() {
+ return mimeType;
+ }
+
+ @Override
+ public Reader createReader() throws IOException {
+ return new FileReader(FileUtil.toFile(fileObject));
+ }
+
+ @Override
+ public Writer createWriter(Difference[] conflicts) throws IOException {
+ return null;
+ }
+ }
+}
+
+----
+
+PS: There is a small trick to enable the ?save?-action (Menubar File->Save / CTRL-S) for your new editable diff, which won?t get enabled after changing content in the right editor pane of the diff viewer by default. You have to associate your node to the TopComponent ? see makeDiffWindowSaveable(). Thanks to Ondrej Vrabec for the solution ? see link:http://netbeans.org/bugzilla/show_bug.cgi?id=223703[http://netbeans.org/bugzilla/show_bug.cgi?id=223703].
+
+Copied from link:http://benkiew.wordpress.com/2013/01/24/netbeans-rcp-editable-diff-viewer-using-custom-base-source/[http://benkiew.wordpress.com/2013/01/24/netbeans-rcp-editable-diff-viewer-using-custom-base-source/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorHowToAddDiffView[http://wiki.netbeans.org/DevFaqEditorHowToAddDiffView] ,
+that was last modified by NetBeans user Markiewb
+on 2013-01-24T23:28:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent.asciidoc
new file mode 100644
index 0000000..cacd4c2
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent.asciidoc
@@ -0,0 +1,66 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to get mime type from `Document` or `JTextComponent`?
+
+WARNING: The API described here is not official! Check the javadoc for its
+stability level.
+
+[source,java]
+----
+
+ // Suppose you have javax.swing.text.Document
+ String mimeType = NbEditorUtilities.getMimeType(document);
+
+ // Suppose you have javax.swing.text.JTextComponent
+ String mimeType = NbEditorUtilities.getMimeType(component);
+----
+
+The method accepting `JTextComponent` is generally more practical, because
+`JTextComponent` or its subclasses is what you usually have to start with.
+Internally the method calls the `Document` version of itself on the document
+loaded in the component and returns its mime type (if it has any assigned). If
+the document does not have mime type information attached (and non-Netbeans documents
+generally don't) the method will use the component's `EditorKit` to get it.
+
+---
+
+Applies to: NetBeans 6.x, the algorithm in `NbEditorUtilities.getMimeType(JTextComponent)`
+works fine in 5.0 and 5.5, but the method is not public.
+
+Platforms: All
+
+See also: link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-modules-editor/index.html[Editor Module API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent[http://wiki.netbeans.org/DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:07:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorHowToReuseEditorHighlighting.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToReuseEditorHighlighting.asciidoc
new file mode 100644
index 0000000..0b4ef56
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorHowToReuseEditorHighlighting.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorHowToReuseEditorHighlighting
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+I you don't want to open or edit your data in a new editor TopComponent, but you still want to have nice syntax coloring in your own editor, you can get the EditorKit for the mime type and reuse it in your own JEditorPane.
+
+For example, if you want to nicely display some XML in your own JEditorPane then first make sure all the required modules are loaded then:
+
+[source,java]
+----
+
+String mime = "text/xml";
+EditorKit ek = CloneableEditorSupport.getEditorKit(mime);
+editorPane.setEditorKit(ek);
+editorPane.setContentType(mime);
+editorPane.setText(xml);
+----
+
+And you will get nice syntax coloring. However you won't get line numbers and other editing facilities since they are not provided by the EditorKit.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorHowToReuseEditorHighlighting[http://wiki.netbeans.org/DevFaqEditorHowToReuseEditorHighlighting] ,
+that was last modified by NetBeans user Jmborer
+on 2013-09-27T09:13:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorJEPForMimeType.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorJEPForMimeType.asciidoc
new file mode 100644
index 0000000..b8e332f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorJEPForMimeType.asciidoc
@@ -0,0 +1,57 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorJEPForMimeType
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I create JEditorPane for a specific document type?
+
+You need to find the right `EditorKit` first and then set it on your `JEditorPane`. Here is an example showing how to do that for a java file.
+
+[source,java]
+----
+
+EditorKit kit = CloneableEditorSupport.getEditorKit("text/x-java");
+
+JEditorPane jep = new JEditorPane();
+jep.setEditorKit(kit);
+----
+
+---
+
+Applies to: NetBeans 6.x
+
+Platforms: All
+
+See also:
+link:http://www.netbeans.org/download/dev/javadoc/org-openide-text/org/openide/text/CloneableEditorSupport.html#getEditorKit(java.lang.String)[CloneableEditorSupport.getEditorKit()]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorJEPForMimeType[http://wiki.netbeans.org/DevFaqEditorJEPForMimeType] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:06:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorTopComponent.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorTopComponent.asciidoc
new file mode 100644
index 0000000..d6933e8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorTopComponent.asciidoc
@@ -0,0 +1,275 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorTopComponent
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== I want to create a TopComponent class to use as an editor, not a singleton
+
+This entry is about creating non-text-editor (e.g. graphical) editors for files or other objects. If you want a text editor, NetBeans has a lot of built-in support for text editors and you will probably want to use `link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/text/DataEditorSupport.html#create(org.openide.loaders.DataObject,%20org.openide.loaders.MultiDataObject.Entry,%20org.openide.nodes.CookieSet)[DataEditorSupport.create()]` and its relatives (hint: *New > File Type* will get you basic text editor support which you can build on).
+
+If you want to create some other kind of editor, you will probably want to start by creating a link:DevFaqNonSingletonTopComponents.html[non-singleton TopComponent] - a logical window, or tab, that can be opened in the editor area and can show your file or object in some way.
+
+Our editor component will be fairly simple. It will have two constructors, one which takes a `link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.html[DataObject]` (the file) and one which has no arguments:
+
+[source,java]
+----
+
+ public MyEditor() {
+ }
+
+ MyEditor(FooDataObject ob) throws IOException {
+ init(ob);
+ }
+----
+
+and it will have an initialization method. In our case, since this is a simple example, we will use a `JTextArea`. Our `DataObject` subclass will have a method `setContent(String)` which is passed the updated text if the user types into the text area. The `DataObject` will take care of marking the file modified and saving it when the user invokes the Save action. So we will just pass the text the user changed to the `DataObject` and update the tab name of the editor to show if the file is modified in-memory or not:
+
+[source,java]
+----
+
+ void init(final FooDataObject file) throws IOException {
+ associateLookup(file.getLookup());
+ setDisplayName(file.getName());
+ setLayout(new BorderLayout());
+ add(new JLabel(getDisplayName()), BorderLayout.NORTH);
+ //If you expect large files, load the file in a background thread
+ //and set the field's text under its Document's lock
+ final JTextField field = new JTextField(file.getPrimaryFile().asText());
+ add(field, BorderLayout.CENTER);
+ field.getDocument().addDocumentListener(new DocumentListener() {
+
+ @Override
+ public void insertUpdate(DocumentEvent e) {
+ changedUpdate(e);
+ }
+
+ @Override
+ public void removeUpdate(DocumentEvent e) {
+ changedUpdate(e);
+ }
+
+ @Override
+ public void changedUpdate(DocumentEvent e) {
+ FooDataObject foo = getLookup().lookup(FooDataObject.class);
+ foo.setContent(field.getText());
+ }
+ });
+ file.addPropertyChangeListener(new PropertyChangeListener() {
+ @Override
+ public void propertyChange(PropertyChangeEvent evt) {
+ if (DataObject.PROP_MODIFIED.equals(evt.getPropertyName())) {
+ //fire a dummy event
+ setDisplayName(Boolean.TRUE.equals(evt.getNewValue()) ? file.getName() + "*" : file.getName());
+ }
+ }
+ });
+ }
+----
+
+As of NetBeans 6.8, modified files are usually shown with a *boldface* tab name, so for consistency we should too:
+
+[source,java]
+----
+
+ @Override
+ public String getHtmlDisplayName() {
+ DataObject dob = getLookup().lookup(DataObject.class);
+ if (dob != null && dob.isModified()) {
+ return "<html>*" + dob.getName();
+ }
+ return super.getHtmlDisplayName();
+ }
+----
+
+The persistence code (described link:DevFaqNonSingletonTopComponents.html[here]) will save the file's path on disk, and on restart, reinitialize the editor (if the file still exists).
+
+The code to do this is actually quite simple - it can be boiled down to loading:
+
+[source,java]
+----
+
+init (DataObject.find(FileUtil.toFileObject(FileUtil.normalizeFile(new File(properties.getProperty("path"))));
+----
+
+and saving
+
+[source,java]
+----
+
+ properties.setProperty (FileUtil.toFile(dataObject.getPrimaryFile()).getAbsolutePath());
+----
+
+That is, all we are doing is saving a path on shutdown, and on restart looking that file up, transforming it into a NetBeans link:DevFaqFileObject.html[FileObject], and initializing with the link:DevFaqDataObject.html[DataObject] for that. It just happens that we have to handle a few corner cases involving missing files and checked exceptions:
+
+* The file never really existed on disk (editing a template)
+* The file was deleted
+* The file cannot be read for some reason
+
+So our persistence code looks like this:
+
+[source,java]
+----
+
+ private static final String KEY_FILE_PATH = "path";
+ void readProperties(java.util.Properties p) {
+ String path = p.getProperty(KEY_FILE_PATH);
+ try {
+ File f = new File(path);
+ if (f.exists()) {
+ FileObject fileObject = FileUtil.toFileObject(FileUtil.normalizeFile(f));
+ DataObject dob = DataObject.find(fileObject);
+ //A DataObject always has itself in its Lookup, so do this to cast
+ FooDataObject fooDob = dob.getLookup().lookup(FooDataObject.class);
+ if (fooDob == null) {
+ throw new IOException("Wrong file type");
+ }
+ init(fooDob);
+ //Ensure Open does not create another editor by telling the DataObject about this editor
+ fooDob.editorInitialized(this);
+ } else {
+ throw new IOException(path + " does not exist");
+ }
+ } catch (IOException ex) {
+ //Could not load the file for some reason
+ throw new IllegalStateException(ex);
+ }
+ }
+----
+[source,java]
+----
+
+ void writeProperties(java.util.Properties p) {
+ FooDataObject dob = getLookup().lookup(FooDataObject.class);
+ if (dob != null) {
+ File file = FileUtil.toFile(dob.getPrimaryFile());
+ if (file != null) { //could be a virtual template file not really on disk
+ String path = file.getAbsolutePath();
+ p.setProperty(KEY_FILE_PATH, path);
+ }
+ }
+ }
+----
+
+==== Implementing A Very Simple DataObject For Our Very Simple Editor
+
+The skeleton of our DataObject class is generated from the *New > File Type* template - this includes registering our DataObject subclass and associating it with a file extension. What we need to do is
+
+* Modify it so that *Open* on it will open our editor TopComponent, not a normal text editor
+* We will implement our own subclass of `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/cookies/OpenCookie.html[OpenCookie]`, which can create and open an instance of our editor, and remember and reuse that editor on subsequent invocations
+* Modify it so that we can pass the text the user typed to it, and it will mark itself modified and become savable (causing *File > Save* and *File > Save All* to become enabled)
+* We will implement the setContent(String) method to
+* Make a `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/cookies/SaveCookie.html[SaveCookie]` available, which is what the various built-in Save actions operate on
+* Call `DataObject.setModified()`—this guarantees that the user will be given a chance to save the file if they shut down the application before saving.
+[source,java]
+----
+
+public class FooDataObject extends MultiDataObject {
+ private String content;
+ private final Saver saver = new Saver();
+ public FooDataObject(FileObject pf, MultiFileLoader loader) throws DataObjectExistsException, IOException {
+ super(pf, loader);
+ CookieSet cookies = getCookieSet();
+ cookies.add(new Opener());
+ }
+
+ @Override
+ public Lookup getLookup() {
+ return getCookieSet().getLookup();
+ }
+
+ synchronized void setContent(String text) {
+ this.content = text;
+ if (text != null) {
+ setModified(true);
+ getCookieSet().add(saver);
+ } else {
+ setModified(false);
+ getCookieSet().remove(saver);
+ }
+ }
+
+ void editorInitialized(MyEditor ed) {
+ Opener op = getLookup().lookup(Opener.class);
+ op.editor = ed;
+ }
+
+ private class Opener implements OpenCookie {
+ private MyEditor editor;
+ @Override
+ public void open() {
+ if (editor == null) {
+ try {
+ editor = new MyEditor(FooDataObject.this);
+ } catch (IOException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ }
+ editor.open();
+ editor.requestActive();
+ }
+ }
+
+ private class Saver implements SaveCookie {
+ @Override
+ public void save() throws IOException {
+ String txt;
+ synchronized (FooDataObject.this) {
+ //synchronize access to the content field
+ txt = content;
+ setContent(null);
+ }
+ FileObject fo = getPrimaryFile();
+ OutputStream out = new BufferedOutputStream(fo.getOutputStream());
+ PrintWriter writer = new PrintWriter(out);
+ try {
+ writer.print(txt);
+ } finally {
+ writer.close();
+ out.close();
+ }
+ }
+ }
+}
+----
+
+==== Caveats For Production Use
+
+A few things may be worth considering if you want to use code like this in a production environment:
+
+* File loading should usually happen on a background thread - put up some sort of progress bar _inside_ the editor component, and replace its contents on the event thread after the load is completed - use RequestProcessor and EventQueue.invokeLater().
+* If it is expected that there will be a lot of FooDataObjects, Opener should instead keep a WeakReference to the editor component so that closed editors can be garbage collected. The following other changes would need to be made:
+* MyEditor should implement PropertyChangeListener directly
+* Use WeakListeners.propertyChange (this, file) rather than directly adding the editor as a listener to the DataObject
+* As of 6.9, the `Openable` interface is preferred to `OpenCookie`; a similar `Savable` interface is probably on the horizon to replace `SaveCookie`
+* The DataObject's lookup could alternately be implemented link:DevFaqNodesCustomLookup.html[using ProxyLookup and AbstractLookup] and this will probably be the preferred way in the future
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorTopComponent[http://wiki.netbeans.org/DevFaqEditorTopComponent] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-03-13T07:34:06Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimeLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimeLookup.asciidoc
new file mode 100644
index 0000000..01ddaa8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimeLookup.asciidoc
@@ -0,0 +1,91 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorWhatIsMimeLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is MimeLookup?
+
+The `MimeLookup` is a mechanism for extending editor functionality provided by
+NetBeans modules.
+
+Most of the editor functionality in NetBeans is organized by mime types of
+documents that are edited. There are special modules that provide support for
+editing Java, XML, JSP, C++ and many other file types. All of these modules need
+to provide more or less the same features such as syntax coloring, code
+completion, code folding, popup menu, etc. However, the implementation of
+these features is different for particular file types.
+
+The editor insfrastructure provides many SPI interfaces that can be implemented by modules providing specific implementations of editor features, and the `MimeLookup` is the way that these implementations can be plugged in to the system.
+
+As its name suggests, `MimeLookup` is a mime-type specific `Lookup`. This means that modules can register instances in the Lookup dedicated to the mime type of
+files that they support. For example, there are different Lookups for
+`text/x-java` and `text/xml` mime types, and both contain FoldManager
+implementations specific for Java and XML languages respectively.
+
+The `MimeLookup` implementation is split in two parts. The first part is pretty
+much independent of most of the other NetBeans libraries and provides a simple
+API and SPI for accessing contents of `MimeLookup`. The second part is a
+NetBeans specific implementation of the `MimeLookup`'s registry based on the
+modules' XML layers. This registry is in fact a hierarchical structure of folders under the `Editors/` folder on the system filesystem.
+
+---
+
+==== Examples
+
+[source,xml]
+----
+
+# How to get the Lookup for Java files?
+MimePath mimePath = MimePath.parse("text/x-java");
+Lookup lookup = MimeLookup.getLookup(mimePath);
+
+# How to register instances (e.g. EditorKit) in the Lookup for Java files?
+<folder name="Editors>
+ <folder name="text">
+ <folder name="x-java">
+ <file name="org-netbeans-modules-java-JavaEditorKitImpl.instance"/>
+ </folder>
+ </folder>
+</folder>
+----
+
+---
+
+Applies to: NetBeans 5.x, 6.x
+
+Platforms: All
+
+See also:
+link:DevFaqLookup.html[What is Lookup?],
+link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-modules-editor-mimelookup/index.html[MimeLookup API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorWhatIsMimeLookup[http://wiki.netbeans.org/DevFaqEditorWhatIsMimeLookup] ,
+that was last modified by NetBeans user Dbell
+on 2010-09-30T10:33:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimePath.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimePath.asciidoc
new file mode 100644
index 0000000..bb421bb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEditorWhatIsMimePath.asciidoc
@@ -0,0 +1,84 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEditorWhatIsMimePath
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is MimePath?
+
+Basically, `MimePath` is an ordered list of mime types.
+
+The reason why we
+have come up with the concept of `MimePath` is that we need to support embedded
+languages. In the simple world where code is written only in one language
+and stored in files dedicated for that language it is enough to know the
+mime type of a file in order to know its language and to load appropriate
+editor features. The world, however, is not simple anymore and the reality
+requires us to deal with situations when one file contains a mixture of
+several different languages. An example is a web applications development
+when people write JSP files that contain snippets of code in JSP, HTML, an expression
+language, Java, JavaScript and possibly some other languages. The whole JSP file
+can be broken up into sections containing code in different languages and
+user expects to get features like coloring and code completion that are
+appropriate for the mime type of each section. This is called language embedding.
+
+In order to be able to describe the exact 'type' of each embedded block of
+text Netbeans use an ordered list of mime types that describe languages along the way from the top level language (i.e. the mime type of the file itself) to the embedded block.
+So, for example a java scriplet in a JSP file can be identified
+by the list of two mime types `text/x-jsp, text/x-java`. The list
+can be encoded in one `String` using the forward slash character as
+a separator and that's what `MimePath` is. In our example the
+`MimePath` of java scriplet in a JSP file is `text/x-jsp/text/x-java`.
+
+The embedding can go indefinitely deep and you can have `MimePath` like
+`text/x-jsp/text/html/text/el` for an expression language used in an
+HTML attribute inside a JSP file - `<a href="${myLink}">...</a>`.
+
+Since `MimePath` is required when you want
+link:DevFaqEditorWhatIsMimeLookup.html[MimeLookup] and since `MimeLookup` is the
+way for pluging-in language specific editor features it is possible to
+provide features tailored specifically for any type of language embedding.
+If you want to know more about the contents of `MimeLookup` generally and
+for compound and embedded mime types, read more in [[DevFaqEditorHowIsMimeLookupComposed| How is MimeLookup
+composed?]].
+
+---
+
+Applies to: NetBeans 5.x, 6.x
+
+Platforms: All
+
+See also:
+link:DevFaqEditorWhatIsMimeLookup.html[What is MimeLookup?],
+link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-editor-mimelookup/org/netbeans/api/editor/mimelookup/MimePath.html[MimePath Javadoc],
+link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-modules-editor-mimelookup/index.html[MimeLookup API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEditorWhatIsMimePath[http://wiki.netbeans.org/DevFaqEditorWhatIsMimePath] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:03:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqEpl3rdPartySources.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqEpl3rdPartySources.asciidoc
new file mode 100644
index 0000000..ba2d1ec
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqEpl3rdPartySources.asciidoc
@@ -0,0 +1,161 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqEpl3rdPartySources
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Where to download sources of EPL third-party components?
+
+The following third-party components licensed under EPL license have the sources available for download from netbeans.org:
+
+|===
+|3rd party component |binaries in installed product |download of sources
+
+|... name with version number |... a path inside NB installation folder |... link to a zip file stored at hg.nb.org/binaries
+
+|JUnit 4.12 |platform/modules/ext/junit-4.12.jar |link:http://hg.netbeans.org/binaries/A6C32B40BF3D76ECA54E3C601E5D1470C86FCDFA-junit-4.12-sources.jar[sources]
+
+|EclipseLink 2.5.1 |java/modules/ext/eclipselink/* |link:http://hg.netbeans.org/binaries/9E77FD7D09168AA2F01E1E0C9D2FA2498F313973-eclipselink-src-2.5.1.v20130918-f2b9fc5.zip[sources]
+
+|org.eclipse.osgi 3.9.1 |platform/modules/ext/org.eclipse.osgi_3.9.1.v20140110-1610.jar |link:http://hg.netbeans.org/binaries/3435D72408ED96338439116A54B922ED02668713-org.eclipse.osgi.source_3.9.1.v20140110-1610.jar[sources]
+
+|org.eclipse.core.contenttype 3.4.100 |ide/modules/org-eclipse-core-contenttype.jar |link:http://hg.netbeans.org/binaries/93C09088CAC6BD49C43600781A0EBAB0F8C4DFA7-org.eclipse.core.contenttype.source_3.4.100.v20100505-1235.jar[sources]
+
+|org.eclipse.core.jobs 3.5.101 |ide/modules/org-eclipse-core-jobs.jar |link:http://hg.netbeans.org/binaries/2D072755F6B3DC2124173B6F713D69A08AB58255-org.eclipse.core.jobs.source_3.5.101.v20120113-1953.jar[sources]
+
+|org.eclipse.core.net 1.2.100 |ide/modules/org-eclipse-core-net.jar |link:http://hg.netbeans.org/binaries/CC45F3EB67A3B548B8CAA607C9BB6D1438475A90-org.eclipse.core.net.source_1.2.100.I20100511-0800.jar[sources]
+
+|org.eclipse.core.runtime 3.7.0 |ide/modules/org-eclipse-core-runtime.jar |link:http://hg.netbeans.org/binaries/61A1483E98B6A32E902603ADE0F18EC092A81583-org.eclipse.core.runtime.source_3.7.0.v20110110.jar[sources]
+
+|org.eclipse.core.runtime.compatibility.auth 3.2.200 |ide/modules/org-eclipse-core-runtime-compatibility-auth.jar |link:http://hg.netbeans.org/binaries/B0474E02C843BCD7B8370AC8E51175646E3A52EA-org.eclipse.core.runtime.compatibility.auth.source_3.2.200.v20100517.jar[sources]
+
+|org.eclipse.equinox.app 1.3.100 |ide/modules/org-eclipse-equinox-app.jar |link:http://hg.netbeans.org/binaries/5817967141D926F27FDF9C3EAD97AE106FFCD79E-org.eclipse.equinox.app.source_1.3.100.v20110321.jar[sources]
+
+|org.eclipse.equinox.common 3.6.0 |ide/modules/org-eclipse-equinox-common.jar |link:http://hg.netbeans.org/binaries/92CAA7B4757BF8FBDA0DC690A1EE9060A9A92B06-org.eclipse.equinox.common.source_3.6.0.v20100503.jar[sources]
+
+|org.eclipse.equinox.preferences 3.4.2 |ide/modules/org-eclipse-equinox-preferences.jar |link:http://hg.netbeans.org/binaries/D878A46A74B4A5FCD1F1D5390490D10DE3A6C8E8-org.eclipse.equinox.preferences.source_3.4.2.v20120111-2020.jar[sources]
+
+|org.eclipse.equinox.registry 3.5.200 |ide/modules/org-eclipse-equinox-registry.jar |link:http://hg.netbeans.org/binaries/1DF39F018A41E7AA987263CFFC54385688C36A73-org.eclipse.equinox.registry.source_3.5.200.v20120522-1841.jar[sources]
+
+|org.eclipse.equinox.security 1.1.1 |ide/modules/org-eclipse-equinox-security.jar |link:http://hg.netbeans.org/binaries/E31B15155B913C6333AFD5DDEDD66AF36306D5CD-org.eclipse.equinox.security.source_1.1.1.R37x_v20110822-1018.jar[sources]
+
+|org.eclipse.mylyn.bugzilla.core 3.17.0 |ide/modules/org-eclipse-mylyn-bugzilla-core.jar |link:http://hg.netbeans.org/binaries/93FE3698ADEA710869E3D5149A96A419C91D55C1-org.eclipse.mylyn.bugzilla.core.source_3.17.0.v20150828-2026.jar[sources]
+
+|org.eclipse.mylyn.commons.core 3.17.0 |ide/modules/org-eclipse-mylyn-commons-core.jar |link:http://hg.netbeans.org/binaries/0D3EED2AD82E0FAB15B07BFBEF97D24B94165EEE-org.eclipse.mylyn.commons.core.source_3.17.0.v20150625-2042.jar[sources]
+
+|org.eclipse.mylyn.commons.net 3.17.0 |ide/modules/org-eclipse-mylyn-commons-net.jar |link:http://hg.netbeans.org/binaries/9953E6E43332C77FB8AF8631A1EDE416013880AE-org.eclipse.mylyn.commons.net.source_3.17.0.v20150706-2057.jar[sources]
+
+|org.eclipse.mylyn.commons.repositories.core 1.9.0 |ide/modules/org-eclipse-mylyn-commons-repositories-core.jar |link:http://hg.netbeans.org/binaries/D6CA71AC17E4DA7B9007757E225CDDEE95D9A426-org.eclipse.mylyn.commons.repositories.core.source_1.9.0.v20150625-2042.jar[sources]
+
+|org.eclipse.mylyn.commons.soap 3.10.0 |ide/modules/org-eclipse-mylyn-commons-soap.jar |link:http://hg.netbeans.org/binaries/1CC710EAE8D591B11AC7D55758BE2CE3A0E240AA-org.eclipse.mylyn.commons.soap.source_3.10.0.20130704-2116.jar[sources]
+
+|org.eclipse.mylyn.commons.xmlrpc 3.17.0 |ide/modules/org-eclipse-mylyn-commons-xmlrpc.jar |link:http://hg.netbeans.org/binaries/755DBAA81511A7811E8AC1CDA9F4D966E5531753-org.eclipse.mylyn.commons.xmlrpc.source_3.17.0.v20150625-2042.jar[sources]
+
+|org.eclipse.mylyn.tasks.core 3.17.0 |ide/modules/org-eclipse-mylyn-tasks-core.jar |link:http://hg.netbeans.org/binaries/842E31A6108D31769D153054C1A19B23D2E6D2C8-org.eclipse.mylyn.tasks.core.source_3.17.0.v20150828-2026.jar[sources]
+
+|org.eclipse.mylyn.wikitext.core 2.6.0 |ide/modules/org-eclipse-mylyn-wikitext-core.jar |link:https://hg.netbeans.org/binaries/3EA36D04CDA2BF99517601FE50E1AB602549C54C-org.eclipse.mylyn.wikitext.core.source_2.6.0-patched.zip[sources]
+
+|org.eclipse.mylyn.wikitext.confluence.core 2.6.0 |ide/modules/org-eclipse-mylyn-wikitext-confluence-core.jar |link:https://hg.netbeans.org/binaries/582C6DDFB13DDB83C1725DFF1D25F803F2D633F1-org.eclipse.mylyn.wikitext.confluence.core.source_2.6.0.v20150901-2143.jar[sources]
+
+|org.eclipse.mylyn.wikitext.markup.core 2.6.0 |ide/modules/org-eclipse-mylyn-wikitext-markup-core.jar |link:https://hg.netbeans.org/binaries/B29C686F75CB89A0B6E7A0B923A7E16C4F063969-org.eclipse.mylyn.wikitext.markdown.core.source_2.6.0.v20150901-2143.jar[sources]
+
+|org.eclipse.mylyn.wikitext.textile.core 2.6.0 |ide/modules/org-eclipse-mylyn-wikitext-textile-core.jar |link:https://hg.netbeans.org/binaries/8F0AA8645CBD54943C87E9AAB236C6BA4F038FA8-org.eclipse.mylyn.wikitext.textile.core.source_2.6.0.v20150901-2143.jar[sources]
+
+|JIRA eclipse connector 3.0.4 |com-atlassian-connector-eclipse-commons-core.jar
+com-atlassian-connector-eclipse-jira-core.jar |link:http://hg.netbeans.org/binaries/9C00174B5B496DE1C79EDAA0B0C226CB38085DE6-com.atlassian.connector.eclipse.commons.core-3.0.4.zip[c.a.c.e.commons.core-sources] link:http://hg.netbeans.org/binaries/ADB3C1F66A094A6BC0B8DA8DC90244F2FE607D36-com.atlassian.connector.eclipse.jira.core-3.0.4.zip[c.a.c.e.jira.core-sources]
+|===
+
+=== Older components used in previous releases
+
+|===
+|3rd party component |binaries in installed product |download of sources
+
+|EclipseLink 2.3 |java/modules/ext/eclipselink/* |link:http://hg.netbeans.org/binaries/FBE4CFBA58F293C90D197FEF3FA44C547E7976C7-eclipselink-src-2.3.0.v20110604-r9504.zip[sources]
+
+|org.eclipse.osgi 3.8.0 |platform/modules/ext/org.eclipse.osgi_3.8.0.v20120529-1548.jar |link:http://hg.netbeans.org/binaries/E150624772453437D207F01896B30C8BDBA7BF37-org.eclipse.osgi.source_3.8.0.v20120529-1548.jar[sources]
+
+|org.eclipse.osgi 3.7.1 |platform/modules/ext/org.eclipse.osgi_3.7.1.R37x_v20110808-1106.jar |link:http://hg.netbeans.org/binaries/BEA925ABD6733CC5BB7ACE90C87D3DB612BD9BCA-org.eclipse.osgi.source_3.7.1.R37x_v20110808-1106.jar[sources]
+
+|org.eclipse.osgi 3.6.0 |platform/modules/ext/org.eclipse.osgi.source_3.6.0.v20100517.jar |link:http://hg.netbeans.org/binaries/B6631615DB4268B245FC8DD4D428D47DEBCC40AB-org.eclipse.osgi.source_3.6.0.v20100517.jar[sources]
+
+|org.eclipse.core.jobs 3.5.1 |ide/modules/org-eclipse-core-jobs.jar |link:http://hg.netbeans.org/binaries/0EA24B3BAE3A1F1334D81A923FB7C49CE739C2BC-org.eclipse.core.jobs.source_3.5.1.R36x_v20100824.jar[sources]
+
+|org.eclipse.core.runtime 3.6.0 |ide/modules/org-eclipse-core-runtime.jar |link:http://hg.netbeans.org/binaries/B61890F95463589FEE96F2E66EEF0F19BD85CA8F-org.eclipse.core.runtime.source_3.6.0.v20100505.jar[sources]
+
+|org.eclipse.equinox.app 1.3.1 |ide/modules/org-eclipse-equinox-app.jar |link:http://hg.netbeans.org/binaries/2C725136C1E832C631A4939CB2E8092B49A617F0-org.eclipse.equinox.app.source_1.3.1.R36x_v20100803.jar[sources]
+
+|org.eclipse.equinox.preferences 3.3.0 |ide/modules/org-eclipse-equinox-preferences.jar |link:http://hg.netbeans.org/binaries/4DA94D06D538A5187289DA9350BE4E86A5BA3ECE-org.eclipse.equinox.preferences.source_3.3.0.v20100503.jar[sources]
+
+|org.eclipse.equinox.registry 3.5.0 |ide/modules/org-eclipse-equinox-registry.jar |link:http://hg.netbeans.org/binaries/B2FA46A9FD5CEB8A34CBF86BE0A70604A99F4788-org.eclipse.equinox.registry.source_3.5.0.v20100503.jar[sources]
+
+|org.eclipse.equinox.security 1.0.200 |ide/modules/org-eclipse-equinox-security.jar |link:http://hg.netbeans.org/binaries/CFAC5DE06A2480A8C43D175B303938B26DD3D319-org.eclipse.equinox.security.source_1.0.200.v20100503.jar[sources]
+
+|org.eclipse.mylyn.bugzilla.core 3.9.0 |ide/modules/org-eclipse-mylyn-bugzilla-core.jar |link:http://hg.netbeans.org/binaries/4954B7C9FB474039C87E320457C66C4FFBDCE4B4-org.eclipse.mylyn.bugzilla.core.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.commons.core 3.9.0 |ide/modules/org-eclipse-mylyn-commons-core.jar |link:http://hg.netbeans.org/binaries/1791646115720C345433C02EB1057DAF32660768-org.eclipse.mylyn.commons.core.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.commons.net 3.9.0 |ide/modules/org-eclipse-mylyn-commons-net.jar |link:http://hg.netbeans.org/binaries/C4FE682262EF539EE7C36A3758E8A90DEA99632E-org.eclipse.mylyn.commons.net.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.commons.repositories.core 1.1.0 |ide/modules/org-eclipse-mylyn-commons-repositories-core.jar |link:http://hg.netbeans.org/binaries/89D29EDD13C137FD209A5F3F6B8CEEEA98651D82-org.eclipse.mylyn.commons.repositories.core.source_1.1.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.commons.soap 3.9.0 |ide/modules/org-eclipse-mylyn-commons-soap.jar |link:http://hg.netbeans.org/binaries/C9F11514C77B339A7455981834EBB1752220D7D0-org.eclipse.mylyn.commons.soap.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.commons.xmlrpc 3.9.0 |ide/modules/org-eclipse-mylyn-commons-xmlrpc.jar |link:http://hg.netbeans.org/binaries/EB7CB896086B8751B430616A976DDFBFD75B98A8-org.eclipse.mylyn.commons.xmlrpc.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.tasks.core 3.9.0 |ide/modules/org-eclipse-mylyn-tasks-core.jar |link:http://hg.netbeans.org/binaries/8DCC3741CD0071CF418EBB92CC67EB4FEC695031-org.eclipse.mylyn.tasks.core.source_3.9.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.wikitext.core 1.8.0 |ide/modules/org-eclipse-mylyn-wikitext-core.jar |link:https://hg.netbeans.org/binaries/78CEC75DD7834838A0C214E4409FC0C0EE355659-org.eclipse.mylyn.wikitext.core.source_1.8.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.wikitext.confluence.core 1.8.0 |ide/modules/org-eclipse-mylyn-wikitext-confluence-core.jar |link:https://hg.netbeans.org/binaries/EC9F3D9A69CF2493EC074BF6950C242003A2DA66-org.eclipse.mylyn.wikitext.confluence.core.source_1.8.0.v20130612-0100.jar[sources]
+
+|org.eclipse.mylyn.wikitext.textile.core 1.8.0 |ide/modules/org-eclipse-mylyn-wikitext-textile-core.jar |link:https://hg.netbeans.org/binaries/82EFA9F844A1392D95F66D3DF7999FAFFD2C4E76-org.eclipse.mylyn.wikitext.textile.core.source_1.8.0.v20130612-0100.jar[sources]
+
+|JIRA eclipse connector 3.0.4 |com-atlassian-connector-eclipse-commons-core.jar
+com-atlassian-connector-eclipse-jira-core.jar |link:http://hg.netbeans.org/binaries/9C00174B5B496DE1C79EDAA0B0C226CB38085DE6-com.atlassian.connector.eclipse.commons.core-3.0.4.zip[c.a.c.e.commons.core-sources] link:http://hg.netbeans.org/binaries/ADB3C1F66A094A6BC0B8DA8DC90244F2FE607D36-com.atlassian.connector.eclipse.jira.core-3.0.4.zip[c.a.c.e.jira.core-sources]
+
+|org.eclipse.mylyn.bugzilla.core 3.6.0 |ide/modules/org-eclipse-mylyn-bugzilla-core.jar |link:http://hg.netbeans.org/binaries/755000391E40ADE9F4EB40A954E92FEEFC067138-org.eclipse.mylyn.bugzilla.core.source_3.6.0.v20110608-1400.jar[sources]
+
+|org.eclipse.mylyn.commons.core 3.6.0 |ide/modules/org-eclipse-mylyn-commons-core.jar |link:http://hg.netbeans.org/binaries/20900A1BB8FA36C61C75D777BDF8A207F65ACFE3-org.eclipse.mylyn.commons.core.source_3.6.0.v20110608-1400.jar[sources]
+
+|org.eclipse.mylyn.commons.net 3.6.0 |ide/modules/org-eclipse-mylyn-commons-net.jar |link:http://hg.netbeans.org/binaries/4F6590200F311C1B3C1D188FB7468570D2ABC20C-org.eclipse.mylyn.commons.net.source_3.6.0.v20110608-1400.jar[sources]
+
+|org.eclipse.mylyn.commons.xmlrpc 3.6.0 |ide/modules/org-eclipse-mylyn-commons-xmlrpc.jar |link:http://hg.netbeans.org/binaries/C34376CC794BD5101EBFD34914DF1E28AB1FDC76-org.eclipse.mylyn.commons.xmlrpc.source_3.6.0.v20110608-1400.jar[sources]
+
+|org.eclipse.mylyn.tasks.core 3.6.0 |ide/modules/org-eclipse-mylyn-tasks-core.jar |link:http://hg.netbeans.org/binaries/E45B89E54E9D135BBB014686C83B1F1045D6DE98-org.eclipse.mylyn.tasks.core.source_3.6.0.v20110608-1400.jar[sources]
+
+|org.eclipse.mylyn.wikitext.core 1.7.1 |ide/modules/org-eclipse-mylyn-wikitext-core.jar |link:http://hg.netbeans.org/binaries/3D4A2DD30C355E9D8FAE55AEAB2D91EE55AF0079-org.eclipse.mylyn.wikitext.core.source_1.7.1.v20120725-0100.jar[sources]
+
+|org.eclipse.mylyn.wikitext.confluence.core 1.7.1 |ide/modules/org-eclipse-mylyn-wikitext-confluence-core.jar |link:http://hg.netbeans.org/binaries/EAECDE39298C08D8C704DA9723D8F7DFDF0AC1E2-org.eclipse.mylyn.wikitext.confluence.core.source_1.7.1.v20120725-0100.jar[sources]
+
+|org.eclipse.mylyn.wikitext.textile.core 1.7.1 |ide/modules/org-eclipse-mylyn-wikitext-textile-core.jar |link:http://hg.netbeans.org/binaries/44F35A62CAD11C0DC6B6DEA6C798AFCD43B500B3-org.eclipse.mylyn.wikitext.textile.core.source_1.7.1.v20120725-0100.jar[sources]
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqEpl3rdPartySources[http://wiki.netbeans.org/DevFaqEpl3rdPartySources] ,
+that was last modified by NetBeans user Tstupka
+on 2016-03-31T09:43:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExecutableIcon.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExecutableIcon.asciidoc
new file mode 100644
index 0000000..43b53bf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExecutableIcon.asciidoc
@@ -0,0 +1,123 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExecutableIcon
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I change the executable's icon?
+
+In short, the current NetBeans IDE (6.7) only provides limited support for changing application icons. Alternate solutions are described below, but NetBeans itself does not include any way to change the icon of the Windows launcher executable called `<your branding name>.exe`, nor does it provide a way to specify an `.icns` file for Mac OS X. There is already an enhancement request for Windows icon support: link:http://www.netbeans.org/nonav/issues/show_bug.cgi?id=64612[issue #64612].
+
+==== 'Application Icon' Images
+
+NetBeans only provides GUI support for choosing a 48x48 GIF or PNG image, within the Project Properties dialog on the Build screen. Using this screen produces two files within your project's `branding/core/core.jar/org/netbeans/core/startup` folder: `frame.gif` and `frame48.gif`. However, these files are crudely resized from the selected image. For this reason, and because a 32x32 icon is not generated, it is best to create the image files for the three icon sizes yourself using another editor, and then simply place them into the startup folder mentioned above.
+
+Similar to toolbar icons, these files always use the `.gif` extension, regardless of their actual format. The `frame.gif` file is used for the smallest icon size of 16x16, which shows up in three places: the taskbar (Windows/Linux), in the upper-left corner of the application's title bar (Windows/Linux), and in the upper-left corner of most dialog windows (Windows/Linux). Another file called `frame32.gif` (which is not generated by the NetBeans Project Properties dialog) provides a 32x32 icon that shows up in the Alt-Tab menu on Windows. Lastly, the `frame48.gif` file provides a 48x48 icon that shows up in the Alt-Tab menu on Linux.
+
+==== Windows Icons
+
+This refers to the icon of the Windows launcher executable as seen in Windows Explorer or when you make a shortcut to it on your Windows desktop. The Windows executable is found within `<your project>\build\launcher\bin\` and is an identical copy of `<NetBeans install location>\harness\launchers\app.exe` that has simply been renamed to the branding name that you have specified within the Project Properties dialog on the Build screen (which is actually saved as the `app.name` property in `project.properties`). Although the NetBeans IDE can't change this icon, you can use a third-party utility program to replace the exe's icon with an `.ico` of your own.
+
+If you want a simple commandline program to call as part of your Windows build process, the free `ReplaceVistaIcon.exe` from link:http://www.rw-designer.com/compile-vista-icon[ RealWorld Graphics] works well, and can be invoked as simply as:
+
+[source,java]
+----
+
+ReplaceVistaIcon.exe build\launcher\bin\<your branding name>.exe YourIconFile.ico
+----
+
+To do this automatically when building, simply place a copy of `ReplaceVistaIcon.exe` and `<your branding name>.ico` into your project's root directory (where `build.xml` is), and add the following to your suite's Build Script (`build.xml`) after the import line:
+
+[source,xml]
+----
+
+ <condition property="isWindows">
+ <os family="windows" />
+ </condition>
+
+ <target name="build-launchers" depends="suite.build-launchers">
+ <!-- Replace the icon for the Windows launcher exe. -->
+ <antcall target="replaceWindowsLauncherIcon"/>
+ </target>
+
+ <!-- Windows-only target that replaces the icon for the launcher exe with our own icon. -->
+ <target name="replaceWindowsLauncherIcon" if="isWindows" description="Replace the icon for the Windows launcher exe">
+ <echo message="Replacing icon of Windows launcher executable."/>
+ <exec executable="ReplaceVistaIcon.exe" resolveexecutable="true">
+ <arg line="build/launcher/bin/${app.name}.exe ${app.name}.ico"/>
+ </exec>
+ </target>
+----
+
+If you would prefer to simply do it manually and need a GUI resource editor, try the free programs:
+
+* link:http://www.angusj.com/resourcehacker[http://www.angusj.com/resourcehacker]
+* link:http://www.wilsonc.demon.co.uk/d10resourceeditor.htm[http://www.wilsonc.demon.co.uk/d10resourceeditor.htm]
+
+If you need an editor for creating/converting both Windows `.ico` files and Mac `.icns` files, try the excellent, program link:http://icofx.ro/[IcoFX] (no longer free).
+
+==== Mac Icons
+
+The "Build Mac OS X Application" command in NetBeans uses a default icon from `<NetBeans install location>/harness/etc/applicationIcon.icns`.
+You can change this icon after a Mac build by simply replacing the file `<your project>/dist/<your branding name>.app/Contents/Resources/<your branding name>.icns` with your own `.icns` file of the same name.
+
+In order to replace it automatically when building, name your `.icns` file as `<your branding name>.icns` and place a copy into your project's root directory (where `build.xml` is), and add the following to your suite's Build Script (`build.xml`) after the import line:
+
+[source,xml]
+----
+
+ <!-- Override to change Mac application icon. -->
+ <target name="build-mac" depends="suite.build-mac" description="Build Mac OS X Application">
+ <property name="nbdist-contents.dir" value="${dist.dir}/${app.name}.app/Contents"/>
+ <property name="nbdist-resources.dir" value="${nbdist-contents.dir}/Resources"/>
+
+ <!-- Replace the icns file. -->
+ <delete file="${nbdist-resources.dir}/${app.name}.icns"/>
+ <copy tofile="${nbdist-resources.dir}/${app.name}.icns" file="${app.name}.icns" />
+ </target>
+----
+
+This is a simplified version of Tonny Kohar's (of link:http://www.kiyut.com[http://www.kiyut.com]) build script posted on: link:http://forums.netbeans.org/ptopic10504.html[http://forums.netbeans.org/ptopic10504.html]
+
+Since Netbeans 6.9 (link:http://netbeans.org/bugzilla/show_bug.cgi?id=182230+&x=23&y=2[Issue #182230]) is possible to specify the Mac dock icon just by setting the property `app.icon.icns in` your `build.xml`
+
+[source,xml]
+----
+
+ <import file="nbproject/build-impl.xml"/>
+ <property name="app.icon.icns" value="${basedir}/myappicon.icns"/>
+----
+
+==== Related links
+
+* link:https://blogs.oracle.com/geertjan/entry/icons_for_netbeans_platform_applications[https://blogs.oracle.com/geertjan/entry/icons_for_netbeans_platform_applications]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExecutableIcon[http://wiki.netbeans.org/DevFaqExecutableIcon] ,
+that was last modified by NetBeans user Jmborer
+on 2015-04-28T11:14:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExpandAndSelectSpecificNode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExpandAndSelectSpecificNode.asciidoc
new file mode 100644
index 0000000..013143d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExpandAndSelectSpecificNode.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExpandAndSelectSpecificNode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I make a particular node visible in the Explorer, and maybe select it?
+
+In general you cannot. See link:http://www.netbeans.org/nonav/issues/show_bug.cgi?id=7551[issue #7551.]
+
+If you created the Explorer view (e.g. you created a `BeanTreeView` or similar and put it in a Swing panel of some sort) then you can use `[link:http://www.netbeans.org/download/dev/javadoc/org-openide-explorer/org/openide/explorer/ExplorerManager.html#setSelectedNodes(org.openide.nodes.Node[http://www.netbeans.org/download/dev/javadoc/org-openide-explorer/org/openide/explorer/ExplorerManager.html#setSelectedNodes(org.openide.nodes.Node][ ExplorerManager.setSelectedNodes])]` and more rarely `link:http://www.netbeans.org/download/dev/javadoc/org-openide-explorer/org/openide/explorer/view/TreeView.html#expandNode(org.openide.nodes.Node)[TreeView.expandNode]` to display a given node in your tree (The node _must_ be a descendant of the current root node. You cannot construct a new "similar" `Node` and hope to select it).
+
+If you did not create the Explorer view then there is no reliable way to find it. However you might try scanning`link:http://www.netbeans.org/download/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.Registry.html#getOpened()[TopComponent.Registry.getOpened()]` for instances of `ExplorerManager.Provider` and looking for appropriate nodes that way. Such tricks must be done with care - the fact that you can find the component to do this does not imply that the author of the component intends that it be there forever, remain of the same type, continue implementing `ExplorerManager.Provider` or anything else. Check nulls, check casts, be prepared for it not to work on future versions.
+
+In the particular case of making a new file wizard, you can and should ask for the file(s) you create to be selected when the wizard finishes, simply by returning them from `link:http://www.netbeans.org/download/dev/javadoc/org-openide-dialogs/org/openide/WizardDescriptor.InstantiatingIterator.html#instantiate()[WizardDescriptor.InstantiatingIterator.instantiate()]`
+
+---
+
+Applies to: NetBeans 5.0, 5.5, 6.x
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExpandAndSelectSpecificNode[http://wiki.netbeans.org/DevFaqExpandAndSelectSpecificNode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:41:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExplorer.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExplorer.asciidoc
new file mode 100644
index 0000000..c6378c7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExplorer.asciidoc
@@ -0,0 +1,40 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExplorer
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is "explorer"?
+
+There is thing that is explorer; the name is historical - very old versions of NetBeans had a window named "Explorer" that contained a tree of files and other components. Colloquially, the term is still used to refer to the area in the left side of the main window where the Files and Projects tabs live in the IDE - but NetBeans has long since stopped having names for or frames around tabbed containers.
+There is an API in NetBeans which contains Swing components that can render link:DevFaqWhatIsANode.html[Nodes ], which is called the Explorer API.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExplorer[http://wiki.netbeans.org/DevFaqExplorer] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:41:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExplorerConnectNode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExplorerConnectNode.asciidoc
new file mode 100644
index 0000000..27fbeb1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExplorerConnectNode.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExplorerConnectNode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I show a Node to my Explorer View?
+
+Once you have a component to show link:DevFaqWhatIsANode.html[Nodes ], you will need to set the _root node_ whose children it will display (some views show the root node, some don't, in some cases you can set whether it does or not).
+
+Presumably you have an link:DevFaqExplorerManager.html[ExplorerManager ] set up for your view - just get that and call `setRootContext (someNode)` and the view will display it.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExplorerConnectNode[http://wiki.netbeans.org/DevFaqExplorerConnectNode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:41:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExplorerManager.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExplorerManager.asciidoc
new file mode 100644
index 0000000..6d683d3
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExplorerManager.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExplorerManager
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is an ExplorerManager?
+
+You do not directly set the Node that is displayed by an link:DevFaqExplorerViews.html[Explorer view ] component (Swing components that display link:DevFaqWhatIsANode.html[Nodes ]) by calling a method on that component. Rather, you set that kind of information by finding the _manager_ for that component - it's what is in charge of what node is displayed, selected, etc.
+
+The manager may be explicitly set on an Explorer view, but usually this is not necessary. When you add a view component (such as a link:Http://www.netbeans.org/download/dev/javadoc/orgOpenideOxplorer/org/openide/explorer/view/BeanTreeView.html.html[BeanTreeView ]) to a Swing container, it will search backward through its parent, it's parent's parent, and so forth, looking for a component that implements link:Http://www.netbeans.org/download/dev/javadoc/orgOpenideOxplorer/org/openide/explorer/ExplorerManager.Provider.html.html[ExplorerManager.Provider ] (an interface with one method - `getExplorerManager()`). That ExplorerManager is what will determine what is displayed.
+
+While this may seem like an unnecessary layer of indirection, it is actually quite powerful: It makes it possible to very simply create master-detail views ala Windows Explorer: Just add two views to a JPanel subclass that implements link:Http://www.netbeans.org/download/dev/javadoc/orgOpenideOxplorer/org/openide/explorer/ExplorerManager.Provider.html.html[ExplorerManager.Provider ]. It is very easy to set it up so changing the selection in one causes the other one to show the children of the selected object - just the way selecting a folder in Windows Explorer does.
+
+See also the link:Http://www.netbeans.org/download/dev/javadoc/orgOpenideOxplorer/org/openide/explorer/ExplorerManager.html.html[ExplorerManager javadoc ]. The link:DevFaqCreateExplorerPanel.html[FAQ about showing explorer views in the main window ] includes sample usage of ExplorerManager.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExplorerManager[http://wiki.netbeans.org/DevFaqExplorerManager] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:41:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExplorerViews.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExplorerViews.asciidoc
new file mode 100644
index 0000000..fdc4a56
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExplorerViews.asciidoc
@@ -0,0 +1,63 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExplorerViews
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is an Explorer view?
+
+An explorer view is a GUI component which can display a link:DevFaqWhatIsANode.html[Node ] and (optionally) its child nodes. While Nodes are, by definition, a tree structure, explorer views are much more than just JTrees. Here is a list of the components available:
+
+* BeanTreeView - the classic tree view, as seen in the Projects and Files tabs in the IDE
+* ListView - a JList based node view component - you can see it in the right hand list in
+* ChoiceView - a ComboBox based explorer view - older versions of the NetBeans IDE used this to display a list of methods in the editor toolbar
+* ContextTreeView - like a BeanTreeView, but sets its manager's explorered context. The "master" part of a master-detail component that uses two views.
+* MenuView - a JMenu view of a Node and its children
+* TableView - an Explorer view displaying nodes in a table.
+* TreeTableView - a TreeTable view of a Node and its children, in which the left column of the table is a tree of nodes, and the other columns display/edit a specified set of properties of those nodes
+* OutlineView - replacement for TreeTableView
+* IconView - a view similar to that of the left pane in Windows Explorer - a table of equidistant icons. Not currently used anywhere in the IDE's UI.
+* PropertySheetView - doesn't show Nodes per-se at all, but rather, shows a property sheet for editing a Node's properties
+
+With the exception of PropertySheetView, all of these classes live in the package `org.openide.explorer.view` (sources in openide/explorer in link:DevFaqAccessSourcesUsingCvs.html[NetBeans' CVS]).
+
+An explorer view's content is controlled by its link:DevFaqExplorerManager.html[ExplorerManager] - you don't set the root node directly on the view component, you use its manager. This is so that more than one view can share a single manager, to do master-detail views (for example, the first page of the New Project wizard is one such view - the right hand panel displays children of the left hand panel's selection).
+
+There are a number of advantages to using Nodes and Explorer Views
+
+* it is possible to create a rich UI with very little UI code
+* they integrate well with standard menu/toolbar actions that are sensitive to selection
+* they contain convenient and well tested features (start randomly typing in a tree or list view - a little popup will appear and search for a matching node)
+* there is a lot of logic built into NetBeans for creating Nodes simply and easily, for example, from link:http://www.netbeans.org/download/dev/javadoc/org-openide-nodes/org/openide/nodes/BeanNode.html[any POJO JavaBean] and persisting the things they represent, so you can do a lot with very little code by using Nodes and Explorer Views
+
+A common usage is to get a Node for some folder on disk or in the link:DevFaqSystemFilesystem.html[configuration filesystem], optionally create a `FilterNode` to filter out some child nodes of it or its children, and display that.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExplorerViews[http://wiki.netbeans.org/DevFaqExplorerViews] ,
+that was last modified by NetBeans user LiborJelinek
+on 2011-08-09T16:07:51Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExplorerViewsInMantisse.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExplorerViewsInMantisse.asciidoc
new file mode 100644
index 0000000..1473c6a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExplorerViewsInMantisse.asciidoc
@@ -0,0 +1,113 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExplorerViewsInMantisse
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I design explorer views in Mantisse GUI editor?
+
+There is an open RFE [1] to include explorer views in the GUI designer palettes by default, but until it is implemented, you can follow the following procedure. (digested from the mailing list)
+
+=== Add explorer views to palette manually
+
+As suggested in several articles [2]/[3], adding the .jar
+file to the palette exposes the containers. Here the exact procedure to add the containers to the palette
+
+1. Right click in the Matisse palette
+2. "Add from JAR..."
+3. Navigate to the org-openide-explorer.jar file, click "Next". On my system this is C:\Program\ Files\NetBeans\8.0.1\platform\modules\org-openide-explorer.jar
+4. Select available components, "Next"
+5. Select the destination palette category in which to add the explorer containers, "Finish"
+
+After all that, the containers are all listed in the palette.
+
+=== More explanations
+
+(originally by Eirik Bakke)
+
+I use explorer views in matisse all the time. You can add them to the
+matisse palette (via Palette Manager) or add any arbitrary class,
+including your own, using the "Beans->Add Bean" icon in the palette. If
+you make your own JComponents, they have to conform to the JavaBean
+conventions, i.e. have a public no-arg constructor.
+
+For explorer views to work correctly, there must be an
+ExplorerManager.Provider in the component hierarchy. I use a simple custom
+JPanel for this purpose, see
+link:https://gist.github.com/anonymous/402e6d9956a77feaac60[https://gist.github.com/anonymous/402e6d9956a77feaac60] (feel free to use).
+This "ExplorerManagerProviderPanel" can also be added to the hierarchy
+using Matisse.
+
+[source,java]
+----
+
+import javax.swing.ActionMap;
+import javax.swing.JPanel;
+import javax.swing.text.DefaultEditorKit;
+import org.openide.explorer.ExplorerManager;
+import org.openide.explorer.ExplorerUtils;
+import org.openide.util.Lookup;
+
+public class ExplorerManagerProviderPanel extends JPanel
+ implements ExplorerManager.Provider, Lookup.Provider
+{
+ private final ExplorerManager explorerManager = new ExplorerManager();
+ private final Lookup lookup;
+
+ public ExplorerManagerProviderPanel() {
+ ActionMap map = this.getActionMap();
+ map.put(DefaultEditorKit.copyAction, ExplorerUtils.actionCopy(explorerManager));
+ map.put(DefaultEditorKit.cutAction, ExplorerUtils.actionCut(explorerManager));
+ map.put(DefaultEditorKit.pasteAction, ExplorerUtils.actionPaste(explorerManager));
+ map.put("delete", ExplorerUtils.actionDelete(explorerManager, true));
+ lookup = ExplorerUtils.createLookup(explorerManager, map);
+ }
+
+ @Override
+ public final ExplorerManager getExplorerManager() {
+ return explorerManager;
+ }
+ @Override
+ public final Lookup getLookup() {
+ return lookup;
+ }
+}
+----
+
+=== Resources
+
+[1] link:https://netbeans.org/bugzilla/show_bug.cgi?id=20851[https://netbeans.org/bugzilla/show_bug.cgi?id=20851]
+
+[2] link:https://netbeans.org/projects/platform/lists/dev/archive/2008-01/message/370[https://netbeans.org/projects/platform/lists/dev/archive/2008-01/message/370]
+
+[3] link:http://netbeansrcp.wordpress.com/2009/04/01/adding-explorer-components-into-the-netbeans-palette/[http://netbeansrcp.wordpress.com/2009/04/01/adding-explorer-components-into-the-netbeans-palette/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExplorerViewsInMantisse[http://wiki.netbeans.org/DevFaqExplorerViewsInMantisse] ,
+that was last modified by NetBeans user Markiewb
+on 2014-11-23T11:36:09Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExportImport.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExportImport.asciidoc
new file mode 100644
index 0000000..5ed4c32
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExportImport.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExportImport
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to register options for export/import to module's layer?
+
+The idea is to register patterns for export/import into module's layer.
+
+See the official API documentation at link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/overview-summary.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/overview-summary.html]
+
+For historical interests the design document can be found at link:http://wiki.netbeans.org/ExportImportOptions#section-ExportImportOptions-ImplementationDetails[Export/Import Options in NetBeans - Proposal].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExportImport[http://wiki.netbeans.org/DevFaqExportImport] ,
+that was last modified by NetBeans user Markiewb
+on 2016-02-23T19:24:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsSearch.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsSearch.asciidoc
new file mode 100644
index 0000000..9a949e5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsSearch.asciidoc
@@ -0,0 +1,84 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExtendOptionsSearch
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How can configure my options panel to be found by global quicksearch or options search?
+
+== Quicksearch
+
+Use the `keywords` attribute of the `@OptionsPanelController.SubRegistration`/`@OptionsPanelController.TopLevelRegistration`
+
+For example
+`
+
+[source,java]
+----
+
+@OptionsPanelController.SubRegistration(
+ id = "XXX",
+ location = "Java",
+ displayName = "#AdvancedOption_DisplayName_MYPLUGIN",
+ keywords = "#AdvancedOption_Keywords_MYPLUGIN",
+ keywordsCategory = "Java/MYPLUGIN")
+@org.openide.util.NbBundle.Messages({"AdvancedOption_DisplayName_MYPLUGIN=MYPLUGIN", "AdvancedOption_Keywords_MYPLUGIN=keyword1,keyword2"})
+public final class MYPLUGINOptionsPanelController extends OptionsPanelController
+----
+
+`
+
+== Options search
+
+Use the `keywords` attribute of the `@OptionsPanelController.Keywords`. Place the annotation at the OptionPanel and *NOT* at the OptionsPanelController.
+
+For example
+`
+
+[source,java]
+----
+
+@org.netbeans.spi.options.OptionsPanelController.Keywords(location="Java", tabTitle="XXX", keywords={"configures format","highlighting","much more"})
+public class MYPLUGINOPTIONSPanel extends javax.swing.JPanel
+
+----
+
+`
+
+== Further resources
+
+[1] link:http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.SubRegistration.html[http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.SubRegistration.html]
+
+[2] link:http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.TopLevelRegistration.html[http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.TopLevelRegistration.html]
+
+[3] link:http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.Keywords.html[http://bits.netbeans.org/8.0/javadoc/org-netbeans-modules-options-api/org/netbeans/spi/options/OptionsPanelController.Keywords.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExtendOptionsSearch[http://wiki.netbeans.org/DevFaqExtendOptionsSearch] ,
+that was last modified by NetBeans user Markiewb
+on 2015-03-04T10:19:38Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsWindow.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsWindow.asciidoc
new file mode 100644
index 0000000..4be3e9c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExtendOptionsWindow.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExtendOptionsWindow
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add new panels to the Options window?
+
+Use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/overview-summary.html[Options Dialog and SPI] as explained in the link:http://platform.netbeans.org/tutorials/nbm-options.html[NetBeans Options Window Module Tutorial].
+
+There are wizards for creating primary and secondary options panels. Use `New File.../Module Development/Options Panel` and follow the wizard.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExtendOptionsWindow[http://wiki.netbeans.org/DevFaqExtendOptionsWindow] ,
+that was last modified by NetBeans user Markiewb
+on 2015-03-04T10:01:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExternalExecution.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExternalExecution.asciidoc
new file mode 100644
index 0000000..27fd1c6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExternalExecution.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExternalExecution
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to run/execute an external program?
+
+Use the "External Execution Support API".
+
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-extexecution/overview-summary.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-extexecution/overview-summary.html]
+* link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-extexecution/org/netbeans/api/extexecution/ExecutionService.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-extexecution/org/netbeans/api/extexecution/ExecutionService.html]
+* link:https://blogs.oracle.com/phejl/entry/external_execution_support_1_2[https://blogs.oracle.com/phejl/entry/external_execution_support_1_2]
+* link:https://blogs.oracle.com/phejl/entry/external_execution_support_2_2[https://blogs.oracle.com/phejl/entry/external_execution_support_2_2]
+
+Please not that some of the API mentioned in the links above got deprecated in NB 8.1. Please use `extexecution.base` instead.
+For more details see link:https://netbeans.org/bugzilla/show_bug.cgi?id=244308[https://netbeans.org/bugzilla/show_bug.cgi?id=244308]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExternalExecution[http://wiki.netbeans.org/DevFaqExternalExecution] ,
+that was last modified by NetBeans user Markiewb
+on 2016-08-21T11:34:42Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqExternalLibraries.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqExternalLibraries.asciidoc
new file mode 100644
index 0000000..06e702b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqExternalLibraries.asciidoc
@@ -0,0 +1,417 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqExternalLibraries
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+1. link:#How_to_store_external_libraries_in_the_NetBeans_Hg_repository[How to store external libraries in the NetBeans Hg repository]
+1. link:#License_file_format[License file format]
+2. link:#Template-based_licenses[Template-based licenses]
+3. link:#NBM_build.2C_managing_correct_license_for_NBMs[NBM build, managing correct license for NBMs]
+4. link:#Normalized_names[Normalized names]
+5. link:#NetBeans_Samples[NetBeans Samples]
+6. link:#Common_mistakes[Common mistakes]
+7. link:#Implementation_work[Implementation work]
+1. link:#Static_verification_of_Hg[Static verification of Hg]
+2. link:#Things_done_in_IDE_build[Things done in IDE build]
+3. link:#Things_done_in_NBM_build[Things done in NBM build]
+4. link:#Golden_files[Golden files]
+8. link:#Apache_Migration_Information[Apache Migration Information]
+
+== How to store external libraries in the NetBeans Hg repository
+
+In the spirit of building on the shoulders of giants,
+NetBeans takes advantage of external libraries which are not developed on netbeans.org.
+Those libraries are either open-source software,
+or binary-only software but with liberal licenses.
+A few examples: Apache Tomcat; JUnit; JavaHelp (runtime);
+javac compiler; JSR-88 interface classes.
+
+For convenience, these libraries are stored
+in the same Hg repository as the source code under CDDL/GPL.
+They are placed in well-known places in the source tree.
+The license text is associated with the binary file
+to make it clear which terms and conditions the users/developers must agree to
+besides being compliant with the CDDL/GPL itself.
+Only source code covered by the CDDL/GPL (or BSD, in the case of samples)
+can be hosted in the `link:http://hg.netbeans.org/main/[http://hg.netbeans.org/main/]` repository.
+As the NetBeans Hg tree is growing, we need to initiate stricter rules
+and check that all external binary files have a correct associated license.
+There are also several recommendations
+on avoiding unnecessary additions of binary files into Hg.
+
+The build system will automatically check if all binary files under `<nbmodule>/external`
+are stored correctly with appropriate license and all required information.
+`<nbmodule>` means NetBeans project module, e.g. `external` is on same level as `nbproject`.
+*Failing to do so will result in a broken build!*
+
+Questions:
+
+* I need to store some binaries in my own VCS repository. Should I follow same rules as well? No, you do not have to. You can store your binaries under release/modules/ext/, more details are described in `harness/README`
+* My binary is not a library and I need to store it somewhere else. It has been also created under CDDL. Then you should update `nbbuild/antsrc/org/netbeans/nbbuild/extlibs/ignored-binaries`
+* How can I check all is all right? Run `ant verify-libs-and-licenses`
+
+Here are the rules NetBeans committers must follow when placing external libraries into NetBeans Hg:
+
+* Legal due diligence must be observed before using a new external library, to make sure that the library license is suitable for use in NetBeans.
+* All external binaries should be stored under a subdirectory named `<nbmodule>/external`, and nowhere else. (For the `contrib` repository, the path will be `contrib/<nbmodule>/external`.)
+* External binaries are versioned in Hg. link:ExternalBinaries.html[ExternalBinaries] describes how the actual binary content is stored outside Hg, while the Hg repository actually tracks the SHA-1 hash of the binary. `ant download-selected-extbins` suffices to download all external binaries in a fresh checkout.
+* Each external binary should have a corresponding license file stored in the same directory as the binary itself. You will upload the binary itself through the Web form, but will add the license file directly to Mercurial (e.g. `hg add external/somelib-x.y.z-license.txt`).
+* The name of the binary must follow the convention `somelib-x.y.z.jar` or `somelib-x.y.z.zip` where `x.y.z` is the version number. The corresponding license file must be named `somelib-x.y.z-license.txt`.
+* All license files should be in UTF-8 encoding with appropriate line and paragraph breaks. The license file must end with a newline. Lines should not exceed 80 characters.
+* The license file should follow a specific format. Details below.
+
+==== License file format
+
+License files should be in the following format:
+
+[source,java]
+----
+
+Name: SomeLib
+Version: 1.2.3
+Description: Library for management of some blah blah blah.
+License: Apache_V20 [SeeNoteRegardingNormalizedNames]
+OSR: 1234 [OSRNumber,ReferToLFIPreviously;SunInternalLegal]
+Origin: http://www.xyz.org [WhereFile(s)WereDownloadedFrom]
+Files: xyz.jar, xyz-doc.zip, xyz-src.zip [Optional;SeeBelowForExplanation]
+Source: URL to source [MandatoryForLGPL,OtherwiseOptional]
+Comment: needed until NB runs on JDK 6+ [Optional:WhyIsThisLibraryHere]
+
+Use of SomeLib version 1.2.3 is governed by the terms of the license below:
+
+[TEXTOFTHELICENSE]
+----
+
+As hinted at above, the OSR field refers to a Sun-internal system. Those contributing patches from outside of Sun can leave this field blank. Also note that a single license file may cover multiple JAR files from the same project. For example, if your patch depends on a third-party library distributed under the same license as two JARs, you will only need one license file and can account for both of these JARs in its Files header.
+
+If the `Files` header is not present, then a license `name-x.y.z-license.txt` must
+correspond to a binary `name-x.y.z.jar` or `name-x.y.z.zip`.
+If present, it should list the names of all binaries to which it corresponds.
+
+The header fields are read during the build process and removed.
+Therefore this information will not appear in the final build or NBMs.
+
+==== Template-based licenses
+
+If there is template-based license (like BSD one link:http://www.opensource.org/licenses/bsd-license.php[http://www.opensource.org/licenses/bsd-license.php]),
+e.g. the license file has several ad hoc places to be updated accordingly.
+The template itself should have the license file stored under `nbbuild/licenses`
+with well-defined tags <pre>*TAGNAME*</pre>; these tags will be replaced during the build.
+Template-based licenses stored along with the binary in Hg
+must have be in original form as they came with binary:
+
+Example BSD License, as it is stored in `nbbuild/licenses`:
+
+[source,java]
+----
+
+Copyright (c) '''YEAR''', '''OWNER'''
+
+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 '''ORGANIZATION''' 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.
+----
+
+Example BSD License, as it is stored in Hg along with binary:
+
+[source,java]
+----
+
+Copyright (c) 2007, NetBeans
+
+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 NetBeans 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.
+----
+
+==== NBM build, managing correct license for NBMs
+
+Required licenses should be listed in `project.properties`.
+(There still must be a license along with the binary in Hg.)
+The new entry will be called `extra.license.files`,
+where the license files will be relative to project basedir,
+e.g.
+
+[source,java]
+----
+
+extra.license.files=external/x-1.0-license.txt,external/y-2.0-license.txt
+----
+
+This will create an NBM with two extra licenses besides the usual CDDL.
+This also maintains compatibility with the current build system.
+
+As a convenient shortcut for the common case that you simply want to
+copy some files to the target cluster
+(but cannot use the `release` directory since third-party binaries are involved),
+you may use the newly introduced `release.*` Ant properties
+which should be specified in `project.properties`.
+Each key names a file in the source project;
+the value is a path in the target cluster.
+Any such pair will automatically:
+
+* Copy the source file to the cluster. (No need to override the `release` Ant target.)
+* Cause the target file to be included in the NBM file list. (No need to add to `extra.module.files`.)
+* In the case of `release.external/*` properties, cause the associated binary to be included in the NBM license. (No need to override the `nbm` Ant target or add to `extra.license.files`.)
+
+Example (from the `form` module):
+
+[source,java]
+----
+
+release.external/beansbinding-0.6.1.jar=modules/ext/beansbinding-0.6.1.jar
+release.external/beansbinding-0.6.1-doc.zip=docs/beansbinding-0.6.1-doc.zip
+----
+
+(Note: if you wish for the binary to be in the classpath of the module as a library,
+you will still need a `<class-path-extension>` in your `project.xml`.)
+You can also use a ZIP entry on the left side and it will be extracted from the ZIP
+to your cluster:
+
+[source,java]
+----
+
+release.external/stuff-1.0.zip!/stuff.jar=modules/ext/stuff-1.0.jar
+----
+
+==== Normalized names
+
+There will be a license repository under `nbbuild/licenses`
+where all licenses in use should be available.
+Each license type will be given a unique name: `Apache_V11`, `Apache_V20`, etc.
+This name must be referred to in the `License` field.
+This allows us to count licenses and file names and build a 3rd-party `README`
+as well as NBMs.
+Make sure that the license for a new binary is correctly included under `nbbuild/licenses`.
+If there is no existing license of the same type, it must be reviewed prior to committing.
+
+==== NetBeans Samples
+
+If a sample is created for NetBeans itself,
+it can be packaged into ZIP file and should not be in the `external/` folder.
+To ensure tests correctly skip over it,
+the owner must add an entry for the binary into `nbbuild/antsrc/org/netbeans/nbbuild/extlibs/ignored-binaries`
+and include a brief explanatory comment.
+
+Alternately, it may be preferable to keep the sample files unpacked directly in Hg,
+and create the ZIP during the module's build process
+(either directly into the cluster, or into `build/classes` for inclusion inside the module).
+This not only prevents tests from warning about it,
+but can make it easier to update minor parts of a sample
+and may make version control operations more pleasant.
+
+The sample itself must be covered by the BSD license;
+the license must be included in every file (excepting binaries such as icons).
+
+[source,java]
+----
+
+Copyright (c) <YEAR>, Sun Microsystems, 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 Sun Microsystems, 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.
+----
+
+If sample is not created solely for NetBeans,
+e.g. bundled in a third-party product and covered by a separate license,
+it must follow the same rules as for any other binary library.
+
+-
+
+=== Common mistakes
+
+A binary file has no associated license. (E.g. `xyz.jar` is missing `xyz-license.txt`.)
+
+A binary file has an associated license, but does not maintain the naming convention,
+or has typos. (E.g. `xyz.jar` with `xy-license.txt`.)
+
+Licenses are not pure text. (E.g. they contain HTML.)
+
+A binary file is duplicated in several places.
+Before adding a new library,
+please make sure that library is not already available in the Hg tree.
+If it is, check if the version there is suitable for you;
+if so, communicate with the owner regarding possible upgrades and/or available packages
+if they are not available.
+You might need to move the library to a parent cluster as well.
+If you do depend on such a third cluster,
+make sure your module is marked as eager, otherwise it will get disabled.
+
+The names of the binary and its license file will change when the binary is
+upgraded to a newer version. Update `project.properties`
+(or, less commonly, `build.xml`) to reflect this change.
+
+Before moving from my own repository to NetBeans Hg, I used `release/modules/ext/` for storing my binary libraries. They need to be moved into `external/` unless the library itself is covered by CDDL, build script, licenses etc., must be updated accordingly!
+
+How do I know if some other modules is relying on the source location of my external binaries?
+Answer: it's not hard to find out. For example, if you want to know who uses
+`httpserver/external`, try this (Unix / Bash syntax):
+
+[source,java]
+----
+
+cd nb-main
+for f in */{build.xml,nbproject/*.{properties,xml`; \
+ do fgrep -H httpserver/external $f; done
+----
+
+=== Implementation work
+
+Interesting files from build:
+
+1. link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/build/generated/external-libraries.txt[Current license summary]
+2. link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/build/verifylibsandlicenses.xml[VerifyLibsAndLicenses test]
+3. link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/testReport/org.netbeans.nbbuild.extlibs/CreateLicenseSummary/[CreateLicenseSummary test]
+4. link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/testReport/org.netbeans.nbbuild/DeleteUnreferencedClusterFiles/[Unreferenced or overreferenced files]
+
+==== Static verification of Hg
+
+Part of regular build.
+Only pays attention to Hg-controlled files in the checkout,
+so can run on a built source tree without becoming confused.
+Writes results in JUnit format for easy browsing from Hudson.
+
+* Look for `*.jar` not in `*/external/` dirs (with some exceptions).
+* Every license file has at least mandatory headers.
+* Every license file has lines at most 80 characters long, etc.
+* For LGPL, must have `Source` header.
+* Check that every external `*.jar` or `*.zip` has a matching license. (Or it can be mentioned in `Files` header of some license.)
+* Every binary has a version number in name.
+* No binary occurs more than once, under any name (so check by CRC-32 or SHA-1 etc.). (Look inside ZIP files for nested JARs.)
+* Every license file's `License` field refers to something in `nbbuild/licenses`.
+* The file in `nbbuild/licenses` exactly matches the body of the license file. Whitespace-only changes are permitted, e.g. rewrapping lines to make them fit. For licenses with templates (e.g. BSD License) any tokens between two underscores can match whatever character sequence.
+
+==== Things done in IDE build
+
+Generate a third-party JAR & license summary.
+Find every binary in the IDE build which is either
+present directly in some `*/external` dir
+or present inside a ZIP in some `*/external` dir.
+For every such binary, retrieve the license from `nbbuild/licenses`.
+Make a single document listing all of the binaries and licenses.
+
+Verify that no such binary is present in more than one place.
+
+Saved as `THIRDPARTYLICENSE-generated.txt` in development builds.
+
+==== Things done in NBM build
+
+`nbbuild/templates/projectized.xml` (netbeans.org modules only)
+will look up `extra.license.files` and use them in `Info.xml`.
+
+`release.*` properties honored (see above).
+
+==== Golden files
+
+`nbbuild/build/generated/external-libraries.txt` is generated
+directly from `external` dirs.
+
+Does not yet take account `extra.license.files` correctly.
+Also may not be a complete list of libraries.
+
+<hr/>
+
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqExternalLibraries[http://wiki.netbeans.org/DevFaqExternalLibraries] ,
+that was last modified by NetBeans user Jglick
+on 2012-03-14T23:34:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileAttributes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileAttributes.asciidoc
new file mode 100644
index 0000000..50eeca0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileAttributes.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileAttributes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are File Attributes?
+
+link:DevFaqFileObject.html[FileObjects] have _attributes_. These are ad-hoc key-value
+pairs which can be associated with a file and persist across shutdown and restart.
+
+Attributes are routinely used in the link:DevFaqModulesLayerFile.html[module XML files] which define the initial contents of the link:DevFaqSystemFilesystem.html[system filesystem]. They are used to providing additional configuration data for files, such as declaring sorting order or the path to an icon file.
+
+Attributes are perfectly safe to use freely in `layer.xml` files.
+
+In pre-4.0 NetBeans, they were relatively commonly used for user files on disk. They still may be used for user files, but this is now discouraged - the infrastructure has been changed to store all attributes in the link:DevFaqUserDir.html[userdir] rather than sprinking `.nbattrs` files in directories all over the user's disk. Since they are now stored in a central location, the more attributes there are, the longer it takes to find attributes for any given file. Using attributes for user files _on disk_ has negative performance implications.
+
+See `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileObject.html#getAttribute(java.lang.String)[FileObject.getAttribute]` and
+`link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileObject.html#setAttribute(java.lang.String,%20java.lang.Object)[FileObject.setAttribute]`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileAttributes[http://wiki.netbeans.org/DevFaqFileAttributes] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-19T01:50:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileBug.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileBug.asciidoc
new file mode 100644
index 0000000..cf63055
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileBug.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileBug
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Filing a bug report
+
+If you think you have found a bug in the NetBeans Platform or IDE which affects your module development, please file it so it can be fixed. Generally exceptions coming from platform code are bugs in NetBeans (unless it is e.g. an `IllegalArgumentException` thrown after your code called a method with invalid arguments). Other things can of course be bugs if NetBeans is not behaving according to its documentation, or if something just looks wrong.
+
+1. Reread all relevant documentation to see if you have missed anything important.
+2. If you are unsure whether the behavior is really incorrect, you can ask on `dev@platform.netbeans.org`. Do not be too shy to file a bug, though; it is just as easy to close an invalid bug report as it is to reply to the mailing list.
+3. If at all possible, figure out how to reproduce your bug. From scratch: the assignee of the bug report cannot see your computer and has no idea what you are working on or why. Try to make a _minimal_, self-contained test case that anyone could run to see the bug in action. Often a suite project is a good test case - attach a ZIP of sources, including nested module projects. If you know how to write a unit test for the buggy module, that is ideal, but this can require some deeper knowledge of NetBeans internals. Sometimes a bug occurs that just cannot be easily reproduced - it is still fine to file a bug, but include as much diagnostic information as you can and do not be surprised if it does not get fixed.
+4. Read: link:IssueReportingGuidelines.html[Issue Reporting Guidelines]
+5. For general background you may also want to read: link:http://www.catb.org/esr/faqs/smart-questions.html[How To Ask Questions The Smart Way]
+6. File a bug report and include at least
+1. Some background on what you are trying to accomplish and why.
+2. Some kind of test case to demonstrate the bug.
+3. Instructions for running the test case.
+4. What you would expect to see happen.
+5. What you actually see happen.
+7. Be patient as the bug is assigned and evaluated, and provide additional information if requested. If all goes well it should be fixed for a future NetBeans release. The evaluator may also be able to offer some workarounds for use in current releases.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileBug[http://wiki.netbeans.org/DevFaqFileBug] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2011-12-27T16:23:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileChoosers.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileChoosers.asciidoc
new file mode 100644
index 0000000..4109944
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileChoosers.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileChoosers
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I need to show a file chooser when my action runs. Can I remember the most recently used directories?
+
+As of NetBeans 6.7, `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileChooserBuilder.html[org.openide.filesystems.FileChooserBuilder]` makes this easy.
+Pass a `Class` or unique `String` key to the constructor of a `FileChooserBuilder`.
+The next time the same key is passed, the new file chooser will automatically be rooted on the directory selected the last time.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileChoosers[http://wiki.netbeans.org/DevFaqFileChoosers] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:42:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileContextMenuAddition.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileContextMenuAddition.asciidoc
new file mode 100644
index 0000000..3f67f00
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileContextMenuAddition.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileContextMenuAddition
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add a menu item to the context menu of every Java source file?
+
+Yes. In NetBeans 5.0 and later there is a wizard available for NetBeans modules which does this for you. Just run *New File | Module Development | Action*, as an action type choose *Conditionally Enabled*. Choose "*Data Object*" in Cookie Class(es) combobox. On the next step select "*File Type Context Menu Item*" and choose `text/x-java` in the *File Type Context Menu Item* combobox, finish the wizard and you are done. For more information you may press the *Help* button available at the bottom of each step of the wizard.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileContextMenuAddition[http://wiki.netbeans.org/DevFaqFileContextMenuAddition] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:53:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileEditorContextMenuAddition.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileEditorContextMenuAddition.asciidoc
new file mode 100644
index 0000000..135c355
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileEditorContextMenuAddition.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileEditorContextMenuAddition
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add a menu item to the context menu of the Java source editor?
+
+Yes. In NetBeans 5.0 and later there is a wizard available for NetBeans modules which does this for you. Just run *New File | NetBeans Module Development | Action*, as an action type choose *Conditionally Enabled*. On the next step choose `text/x-java` in the *Editor Context Menu Item* combobox, finish the wizard and you are done. For more information you may press the *Help* button available at the bottom of each step of the wizard.
+
+In NetBeans 4.1 you just need to insert an action (e.g. `*.instance` ) into the folder `Editors/text/x-java/Popup/` in your module's XML layer.
+
+---
+
+Applies to: all versions of NetBeans
+
+Related: link:DevFaqFileContextMenuAddition.html[DevFaqFileContextMenuAddition]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileEditorContextMenuAddition[http://wiki.netbeans.org/DevFaqFileEditorContextMenuAddition] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T13:36:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileFileObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileFileObject.asciidoc
new file mode 100644
index 0000000..c0f513b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileFileObject.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileFileObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get a java.io.File for a FileObject?
+
+[source,java]
+----
+
+FileUtil.toFile(FileObject fo)
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileFileObject[http://wiki.netbeans.org/DevFaqFileFileObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:42:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileObject.asciidoc
new file mode 100644
index 0000000..7a43a0a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileObject.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a FileObject?
+
+FileObjects are _virtual files_ which live inside a link:DevFaqFileSystem.html[FileSystem ]. They
+may represent a file on disk - or anything else walks and talks like a file, or can be made to - such as a file
+on a remote FTP server, a file entry in a JAR file, an entry in an XML file, etc.
+
+FileObjects differ from `java.io.File` in certain ways:
+
+* You don't generally ever have a FileObject representing a file that doesn't really exist (if you think a FileObject may have been deleted, check `isValid()`)
+* You can listen for changes on FileObjects
+* `FileObjects` can have key-value pairs of ad-hoc link:DevFaqFileAttributes.html[attributes ] associated with them
+
+They are part of the link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/api.html[Filesystems API];
+the javadoc for FileObject can be found link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileObject.html[here].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileObject[http://wiki.netbeans.org/DevFaqFileObject] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-19T01:44:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileObjectDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileObjectDataObject.asciidoc
new file mode 100644
index 0000000..1788ee0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileObjectDataObject.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileObjectDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I get a FileObject for a DataObject?
+
+[source,java]
+----
+
+theDataObject.getPrimaryFile()
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileObjectDataObject[http://wiki.netbeans.org/DevFaqFileObjectDataObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:43:01Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileObjectFile.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileObjectFile.asciidoc
new file mode 100644
index 0000000..35b865a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileObjectFile.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileObjectFile
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I get a FileObject for a File?
+
+[source,java]
+----
+
+FileUtil.toFileObject (FileUtil.normalizeFile(theFile));
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileObjectFile[http://wiki.netbeans.org/DevFaqFileObjectFile] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-12T20:35:46Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileObjectInMemory.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileObjectInMemory.asciidoc
new file mode 100644
index 0000000..3a281c6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileObjectInMemory.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileObjectInMemory
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I create a FileObject in memory?
+
+Sometimes it's desirable to work with a file (or call code that expects to operate on files), but you don't want to commit it permanently to disk. It's easy to do this in NetBeans by using the in-memory filesystem. The first two lines in the following code will create a new text file and the next three will open it in an editor. You can easily change this to handle other types of files provided that their DataObject's also have an OpenCookie.
+
+[source,java]
+----
+
+ FileSystem fs = FileUtil.createMemoryFileSystem();
+ FileObject fob = fs.getRoot().createData(name, "txt");
+
+ DataObject data = DataObject.find(fob);
+ OpenCookie cookie = (OpenCookie)data.getCookie(OpenCookie.class);
+ cookie.open();
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileObjectInMemory[http://wiki.netbeans.org/DevFaqFileObjectInMemory] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:59:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileOpenAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileOpenAction.asciidoc
new file mode 100644
index 0000000..88e5169
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileOpenAction.asciidoc
@@ -0,0 +1,42 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileOpenAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get the Open File item on the File menu into my platform application?
+
+The Open File menu item is a part of the *User Utilities* module, in the `ide` cluster.
+This module can be added to your project using the *Libraries* page of the module property sheet. It must be also added to the suite (your suite > Project properties, Libraries > ide > User Utilities)
+
+The *User Utilities* module also adds the *Find in Files* feature and support for PDF files (they are recognized and can be opened by double-clicking on them).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileOpenAction[http://wiki.netbeans.org/DevFaqFileOpenAction] ,
+that was last modified by NetBeans user Jirka x1
+on 2010-12-14T07:11:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileRecognition.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileRecognition.asciidoc
new file mode 100644
index 0000000..f8305d8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileRecognition.asciidoc
@@ -0,0 +1,76 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileRecognition
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How does NetBeans recognize files?
+
+A lot of applications show some UI that displays folders of files; also a lot of NetBeans UI is created by showing virtual files in the link:http://wiki.netbeans.org/DevFaqSystemFilesystem[configuration filesystem]. When a folder is expanded in the UI, files of known types have their own icons, menu items, actions, properties, child nodes and behavior.
+
+The way NetBeans detects files is this:
+
+* The "files" being shown are [link:http://wiki.netbeans.org/DevFaqFileObject[http://wiki.netbeans.org/DevFaqFileObject] `FileObject`]s - wrappers around `java.io.File`, or in the case of configuration files, typically wrappers around data stored in a _virtual filesystem_, such as inside XML files in modules.
+* What you're actually seeing is `link:http://wiki.netbeans.org/DevFaqWhatIsANode[Node]`s, which are the things that provide actions, localized names, etc. to files or other things.
+
+* Between `Node`s and `FileObject`s are `link:http://wiki.netbeans.org/DevFaqDataObject[DataObject]s`. A DataObject is like a FileObject, except that it knows what _kind of file_ is being shown. There are different subclasses of DataObject for files with different file extensions, XML files with different DTDs, etc.
+
+* The various DataObject subclasses are provided by modules which implement support for particular file types (for example, the Image module makes it possible to recognize and open `.gif` and `.png` files), provides the icon for them, etc.
+
+* The "type" of a file is a link:http://en.wikipedia.org/wiki/MIME[MIME type], just as email attachments use - for example, a `.java` file has the MIME type `text/x-java` and a `.gif` file has the MIME type `image/gif`.
+
+* A module which wants to implement support for a file type registers a `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/MIMEResolver.html[MIMEResolver]` that is given a chance to claim a file the first time the system sees it (typically you do not write your own MIMEResolver, you just declaratively register a MIME type against a file extension or XML DTD).
+
+* That module (or some other one) also provides a `link:http://wiki.netbeans.org/DevFaqDataLoader[DataLoader]` — a factory for custom link:http://wiki.netbeans.org/DevFaqDataObject[DataObject]s that are specific to this file type. The DataObject in turn provides the Node (icon, etc.) that you see in the user interface.
+
+So, to recap — when you expand a folder, and the system goes about showing a tree of nodes representing files, what happens is:
+
+1. The child FileObjects of the folder are listed
+2. Each child FileObject is checked by extension (and DTD in the case of XML files) against registered MIME types / MIMEResolvers.
+3. Once the MIME type is known, the DataLoader for that MIME type is found
+4. The DataLoader is asked for a DataObject for the child FileObject
+5. The DataObject is asked for its _Node delegate_
+6. That Node's icon and display name are shown in the UI
+
+The results of these operations are cached as long as they are in use. For any file on disk, there is at most 1 FileObject. For any FileObject there is at most one DataObject (one DataObject may represent 2 files, but that is another story). Each DataObject has exactly one Node which presents that DataObject to the user.
+
+In other words:
+
+* FileObjects represent "dumb" files on disk or elsewhere - a path, input and output streams, but no concept of what the file represents beyond folder versus data.
+* MIMEResolvers know how to tell what MIME type a file is. They have an order in which they are asked to claim a file.
+* DataLoaders are registered against various MIME types. When a DataObject for a file is needed, the DataLoader for that MIME type is asked to make one. What it will make is a DataObject subclass that understands something about the file, its data, etc. For example, a DataObject for a `.properties` file might provide a way to get a `java.util.Properties` object representing the file's contents.
+* DataObjects are like FileObjects, except they _understand_ what the file is, or its contents, and may provide ways to programmatically manipulate the file, such as opening a text or graphical editor.
+* DataObjects have Nodes.
+* Nodes add human-friendly attributes such as localized names, popup menu items, properties, tooltips, etc. to the more programmer-friendly Nodes.
+
+_Note: As of NetBeans 6.9, it is often not necessary to subclass DataLoader - a generic DataLoader can be created by the system, which knows the DataObject subclass to create. Simply use _'New File > Module Development > File Type'_ to generate such code._
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileRecognition[http://wiki.netbeans.org/DevFaqFileRecognition] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-25T16:08:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileSystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileSystem.asciidoc
new file mode 100644
index 0000000..8429c2f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileSystem.asciidoc
@@ -0,0 +1,59 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileSystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a FileSystem?
+
+If you use a Unix-based operating system, this concept will be familiar; if not, it may require some explanation.
+
+NetBeans uses link:DevFaqFileObject.html[virtual files] to refer to the users files on disk, and to refer to its own configuration files. If you used the NetBeans IDE 3.6 or earlier, you may remember that the way you constructed your classpath used to be by "mounting" filesystems - folders on your disk.
+
+Filesystems are gone from the UI, but are alive and well under the hood in NetBeans.
+
+A `FileSystem` is a hierarchical tree of folders and files. A filesystem has a "root folder", which may contain files and other folders. "Files" (link:DevFaqFileObject.html[FileObjects ]) in a Filesystem may be actual files on disk, or entries in JAR file, or entries in an XML file, or anything else that walks and talks like a file that someone has implemented the Filesystem interface for.
+
+In the NetBeans Platform there are implementations of `FileSystem` for
+
+* plain disk files and folders
+* ZIP/JAR files
+* XML files in a predefined format ("layers")
+* a block of memory with no backing store
+* proxies for merging other filesystems with optional behavior overrides
+
+Filesystems are used both to represent user files on disk, and also to represent configuration data internal to NetBeans - the link:DevFaqSystemFilesystem.html[System Filesystem ]. This is one of the reason that it takes only minimal code to create a GUI view of the system filesystem - the same file recognition code that recognizes user files, gives them actions, icons and display names is what recognizes internal configuration data.
+
+Especially in the case of the System Filesystem, it can be useful to think of a Filesystem as a "namespace" in which objects (which may contain data or represent Java objects) live - for the System Filesystem, the fact that the entries in it are referred to as files is incidental.
+
+As of NetBeans 4.0 you will rarely work directly with the `FileSystem` class. `FileUtil.toFileObject` is the normal way of getting a file object from a disk file. `FileUtil.getArchiveRoot` is the normal way of getting file objects from a JAR or ZIP file. In NetBeans 4.x `FileSystem` implementations are also used for version control integration but the 5.0 CVS support no longer uses this system.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileSystem[http://wiki.netbeans.org/DevFaqFileSystem] ,
+that was last modified by NetBeans user Jskrivanek
+on 2009-12-03T10:34:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFileVsFileObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFileVsFileObject.asciidoc
new file mode 100644
index 0000000..ab7503d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFileVsFileObject.asciidoc
@@ -0,0 +1,59 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFileVsFileObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Files vs. file objects
+
+What exactly is the difference between a filename on disk and a
+`FileObject`? How do I convert them?
+
+Raw files on disk are generally represented in Java using `java.io.File`. These correspond directly to what the operating system thinks of as a file.
+
+Under the Filesystems API, raw files are not usually manipulated
+directly. Rather, you should usually be using `FileObject`.
+Besides the fact that most other APIs that
+work with files expect `FileObject`, these have a
+number of advantages:
+
+* The filesystem they come from need not correspond to physical files on disk, but could be JAR file entries, or potentially database entries, FTP downloads, etc.
+
+* The rest of the IDE can interact with them in an object-oriented fashion, including locking and change notification.
+
+However a `FileObject` must always really exist on disk (or whatever backing storage is used), unlike `File`.
+
+In case translation from one to the other is necessary:
+
+* To look for a `FileObject` representing a `File`, use `FileUtil.toFileObject(File)`.
+* To look for a `File` from a `FileObject`, you may use `FileUtil.toFile(FileObject)`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFileVsFileObject[http://wiki.netbeans.org/DevFaqFileVsFileObject] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T05:41:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFilesFromNodes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFilesFromNodes.asciidoc
new file mode 100644
index 0000000..ea5323e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFilesFromNodes.asciidoc
@@ -0,0 +1,81 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFilesFromNodes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get at the file that a particular node represents?
+
+In general, it shall be enough to request a link:FileObject.html[FileObject] via link:Lookup.html[Lookup]:
+
+[source,java]
+----
+
+Node n = ...;
+FileObject fo = n.getLookup().lookup(FileObject.class);
+if (fo != null) {
+ File f = FileUtil.toFile (fo);
+ if (f != null) { //if it is null, it is a virtual file -
+ //its filesystem does not represent disk-based storage
+ //do something
+ }
+}
+
+----
+
+If this does not work for some (strange) reason. You may fallback to old good way and get the `DataObject` the node represents, and drill down to a file from there
+
+[source,java]
+----
+
+Node n = ...;
+DataObject dob = n.getLookup().lookup(DataObject.class);
+if (dob == null) {
+ // definitely not a file node
+} else {
+ // could also get all files in the data object, if desired:
+ FileObject fo = dob.getPrimaryFile();
+ // and if you really need java.io.File
+ File f = FileUtil.toFile (fo);
+ if (f != null) { //if it is null, it is a virtual file -
+ //its filesystem does not represent disk-based storage
+ //do something
+ }
+}
+
+----
+
+In the other direction you can use `DataObject.find` and then `DataObject.getNodeDelegate`
+to get a node representing a file object.
+
+Also see link:DevFaqFileVsFileObject.html[DevFaqFileVsFileObject] if you need `java.io.File` for some reason.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFilesFromNodes[http://wiki.netbeans.org/DevFaqFilesFromNodes] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T18:53:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFilesystemSee.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFilesystemSee.asciidoc
new file mode 100644
index 0000000..8c61b96
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFilesystemSee.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFilesystemSee
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I see the system filesystem (`FileUtil.getConfigRoot()`)?
+
+The layer file browser in NetBeans project support shows the default file system.
+
+Open a NetBeans module project in the Projects window. Navigate to *Important Files* > *XML Layer* > *<this layer in context>*. You can examine the IDE's default file system by browsing the *<this layer in context>* node.
+
+While browsing the filesystem remember that each node has a "Name" property (use the Properties Window to see the properties of each node). You must use the "Name" to refer to the node in the filesystem.
+
+For instance, in default (English) locale the menu bar appears as the node *Menu Bar* in the filesystem viewer, but its nonlocalizable code name is *Menu*. So to refer to the menu bar
+in your `layer.xml` file you have to use the name of the node, like this:
+
+[source,java]
+----
+
+<folder name="Menu">
+----
+
+instead of
+
+[source,java]
+----
+
+<folder name="Menu Bar">
+----
+
+-
+
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFilesystemSee[http://wiki.netbeans.org/DevFaqFilesystemSee] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T13:53:09Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFindCaretPositionInEditor.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFindCaretPositionInEditor.asciidoc
new file mode 100644
index 0000000..a8a0b9a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFindCaretPositionInEditor.asciidoc
@@ -0,0 +1,94 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFindCaretPositionInEditor
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I get the position of the caret in the currently selected editor window?
+
+You need to first get the selected node (which if the Editor is selected, should correspond to the file being edited); get the most recent editor pane open on it; and then access the caret:
+
+[source,java]
+----
+
+Node[] n = TopComponent.getRegistry().getActivatedNodes();
+if (n.length == 1) {
+ EditorCookie ec = (EditorCookie) n[0].getCookie(EditorCookie.class);
+ if (ec != null) {
+ JEditorPane[] panes = ec.getOpenedPanes();
+ if (panes.length > 0) {
+ int cursor = panes[0].getCaret().getDot();
+ String selection = panes[0].getSelectedText();
+ // USE selection
+ }
+ }
+}
+----
+
+Or
+
+[source,java]
+----
+
+org.netbeans.api.editor.EditorRegistry.lastFocusedComponent().getCaretPosition()
+----
+
+=== How can I get the linenumber/column of the currently selected editor?
+
+[source,java]
+----
+
+ JTextComponent editor = org.netbeans.api.editor.EditorRegistry.lastFocusedComponent();
+
+ //using StyledDocument
+ {
+ StyledDocument sdocument = (StyledDocument) editor.getDocument();
+
+ int line = NbDocument.findLineNumber(sdocument, editor.getCaretPosition());
+ int column = NbDocument.findLineColumn(sdocument, editor.getCaretPosition());
+ }
+ //using BaseDocument
+ {
+ try {
+ BaseDocument bdocument = Utilities.getDocument(editor);
+ int line = Utilities.getLineOffset(bdocument, editor.getCaretPosition());
+ } catch (BadLocationException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ }
+
+----
+
+---
+
+Applies to: NetBeans 4.0 and newer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFindCaretPositionInEditor[http://wiki.netbeans.org/DevFaqFindCaretPositionInEditor] ,
+that was last modified by NetBeans user Markiewb
+on 2016-03-05T13:25:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFindInstance.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFindInstance.asciidoc
new file mode 100644
index 0000000..80df008
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFindInstance.asciidoc
@@ -0,0 +1,62 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFindInstance
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have a .instance file. How do I get an actual object instance?
+
+Using `InstanceCookie` (note that if you have an entire folder of `.instance` files, there's a link:DevFaqFolderOfInstances.html[more efficient way ] to get all of them):
+
+[source,java]
+----
+
+DataObject dob = DataObject.find (theDotInstanceFileObject);
+InstanceCookie ck = dob.getLookup().lookup(InstanceCookie.class);
+MyObject obj = (MyObject) ck.instanceCreate();
+
+----
+
+(you can and should call `ck.instanceClass()` to ensure the type cast is correct ahead of time)
+
+==== Alternative:
+
+[source,java]
+----
+
+T obj=FileUtil.getConfigObject("Actions/Window/org-foo-B.instance", T.class)
+
+//for example:
+Action action=FileUtil.getConfigObject("Actions/Window/org-netbeans-core-windows-actions-ResetWindowsAction.instance", Action.class)
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFindInstance[http://wiki.netbeans.org/DevFaqFindInstance] ,
+that was last modified by NetBeans user Markiewb
+on 2013-03-31T16:20:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFindLocationInSourcesFromUi.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFindLocationInSourcesFromUi.asciidoc
new file mode 100644
index 0000000..cc6ba8c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFindLocationInSourcesFromUi.asciidoc
@@ -0,0 +1,60 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFindLocationInSourcesFromUi
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== Looking at the UI how do I find a module that implements a menu item?
+
+Looking at text in IDE such as a menu item, window title, node display name, etc. you may want to change it. But first you need to find where in the code this string is produced. It is very easy to find if you add the following switch into your `.../etc/netbeans.conf`:
+
+[source,java]
+----
+
+-J-Dorg.openide.util.NbBundle.DEBUG=true
+----
+
+If you use this switch all strings loaded from `Bundle.properties` files using `org.openide.util.NbBundle` will have two numbers appended to them. The first number identifies the bundle file. Look for this number in the IDE log to find the location of the properties file that provides this string.
+
+Another handy trick: in a built source tree, run
+
+[source,java]
+----
+
+ant index-layer-paths
+----
+
+to see which module (by code name) contributes each layer file (or folder),
+including menu items and so on.
+You can also just look at the trunk version of this file
+link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastStableBuild/artifact/nbbuild/build/generated/layers.txt[here].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFindLocationInSourcesFromUi[http://wiki.netbeans.org/DevFaqFindLocationInSourcesFromUi] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:44:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFindSfs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFindSfs.asciidoc
new file mode 100644
index 0000000..2fde081
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFindSfs.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFindSfs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get a reference to the system filesystem?
+
+[source,java]
+----
+
+FileUtil.getConfigRoot()
+FileUtil.getConfigFile(path)
+// usually you don't need to use this
+Repository.getDefault().getDefaultFileSystem()
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFindSfs[http://wiki.netbeans.org/DevFaqFindSfs] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:42:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFixDependencies.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFixDependencies.asciidoc
new file mode 100644
index 0000000..933c1ce
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFixDependencies.asciidoc
@@ -0,0 +1,184 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFixDependencies
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+The harness already has a fixdependencies task with only one purpose: replace obsoleted modules with new ones like it happened when Lookup was separated into its own module. In normal applications you might need to manually modify or remove then add the module you changed version for. If the project is really big and complex this can be a nightmare. I went ahead and enhanced the task so it can be more useful.
+
+Basically the current task just replaces obsolete modules with its new version.
+
+To use it add this to your suite's build.xml:
+
+[source,xml]
+----
+
+<target name="fix-dependencies" description="Removes unused compilation dependencies on other modules.">
+ <echo>Fixing dependencies for suite...</echo>
+ <!--Define custom task-->
+ <taskdef resource="org/netbeans/nbbuild/taskdefs.properties">
+ <classpath>
+ <pathelement location="${harness.dir}/tasks.jar"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="stringutil" classname="ise.antelope.tasks.StringUtilTask">
+ <classpath>
+ <pathelement location="${suite.dir}/../tools/AntelopeTasks_3.5.3.jar"/>
+ </classpath>
+ </taskdef>
+ <echo>Create the ant script...</echo>
+ <!--Create the ant script-->
+ <echo file="versions.xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
+<project name="Fix Versions" basedir="." default="fix">
+ <taskdef resource="org/netbeans/nbbuild/taskdefs.properties">
+ <classpath>
+ <pathelement location="${harness.dir}/tasks.jar"/>
+ </classpath>
+ </taskdef>
+ <target name="fix">
+ <property name="build.compiler.deprecation" value="false" />
+ <fixdependencies antfile="../../build.xml"
+ buildtarget="netbeans" cleantarget="clean" failonerror="true" sanitycheck="false">]]>
+ </echo>
+ <!--Now update the versions to fix-->
+ <for list="${modules}" delimiter=":" param="cur" trim="true">
+ <sequential>
+ <!--Read properties-->
+ <property file="@{cur}/manifest.mf" prefix="@{cur}"/><!--Major release and implementation version are here-->
+ <if>
+ <contains string="${@{cur}.OpenIDE-Module}" substring="/"/>
+ <then>
+ <length string="${@{cur}.OpenIDE-Module}" property="@{cur}.length.dist" />
+ <stringutil string="${@{cur}.OpenIDE-Module}"
+ property="@{cur}.OpenIDE-Module.indexOf">
+ <indexof string="/"/>
+ </stringutil>
+ <math result="@{cur}.after" operand1="1" operation="+"
+ operand2="${@{cur}.OpenIDE-Module.indexOf}" datatype="int"/>
+ <substring text="${@{cur}.OpenIDE-Module}"
+ start="${@{cur}.after}"
+ end="${@{cur}.length.dist}"
+ property="@{cur}.release-version" />
+ <substring text="${@{cur}.OpenIDE-Module}" start="0"
+ end="${@{cur}.OpenIDE-Module.indexOf}"
+ property="@{cur}.OpenIDE-Module" />
+ </then>
+ </if>
+ <property file="@{cur}/nbproject/project.properties" prefix="@{cur}."/><!--Spec version is here-->
+ <if>
+ <or>
+ <isset property="@{cur}.release-version"/>
+ <isset property="@{cur}.spec.version.base"/>
+ </or>
+ <then>
+ <echo file="versions.xml" append="true"><![CDATA[
+ <replace codenamebase="]]>${@{cur}.OpenIDE-Module}<![CDATA[" addcompiletime="true">
+ <module codenamebase="]]>${@{cur}.OpenIDE-Module}</echo>
+ <if>
+ <isset property="@{cur}.spec.version.base"/>
+ <then>
+ <echo file="versions.xml" append="true"><![CDATA[" spec="]]>${@{cur}.spec.version.base}<![CDATA["]]></echo>
+ </then>
+ <else>
+ <echo file="versions.xml" append="true"><![CDATA[/>]]>
+ </echo>
+ </else>
+ </if>
+ <if>
+ <isset property="@{cur}.release-version"/>
+ <then>
+ <echo file="versions.xml" append="true"><![CDATA[ release="]]>${@{cur}.release-version}<![CDATA["/>]]>
+ </echo>
+ </then>
+ <else>
+ <echo file="versions.xml" append="true"><![CDATA[/>]]>
+ </echo>
+ </else>
+ </if>
+ <echo file="versions.xml" append="true"><![CDATA[
+ </replace>]]>
+ </echo>
+ </then>
+ </if>
+ </sequential>
+ </for>
+ <echo file="versions.xml" append="true"><![CDATA[
+ <fileset dir="nbproject" >
+ <include name="project.xml" />
+ </fileset>
+ </fixdependencies>
+ </target>
+</project>]]>
+ </echo>
+ <echo>Create the ant script...Done!</echo>
+ <!--Now update modules-->
+ <echo>Fixing module dependencies...</echo>
+ <subant target="module-fix-dependencies">
+ <fileset dir="." includes="**/build.xml" excludes="build.xml"/>
+ </subant>
+ <echo>Fixing module dependencies...Done!</echo>
+ <delete file="versions.xml"/>
+ <!--Run NB fix dependencies in all modules as well-->
+ <echo>Fixing NB dependencies for suite...</echo>
+ <subant target="fix-dependencies" buildpath="${modules}" inheritrefs="false" inheritall="false"/>
+ <echo>Fixing NB dependencies for suite...Done!</echo>
+ <echo>Fixing dependencies for suite...Done!</echo>
+ </target>
+
+ <target name="module-fix-dependencies">
+ <ant antfile= "${suite.dir}/versions.xml" target="fix"/>
+ </target>
+----
+
+And add this to all your module's build.xml:
+
+[source,xml]
+----
+
+<!--Add this to have the module-fix-dependencies target work from within each module-->
+ <import file="${suite.dir}/build.xml"/>
+----
+
+== Explanation
+
+fix-dependencies task will do the following:
+
+* Create an ant file named versions.xml by gathering the current module's version information.
+* versions.xml uses the fixdependencies target (modified) to update all module dependencies.
+* Run the versions.xml file from within each module (using subant)
+* Delete the versions.xml file when done.
+* Call NetBeans fix-dependencies task
+
+Doesn't look like much but it's a lot of work.
+
+*Note:* You need to have defined the if task (from ant-contrib) to use the targets above. Also you'll need antelope library: link:http://antelope.tigris.org/[http://antelope.tigris.org/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFixDependencies[http://wiki.netbeans.org/DevFaqFixDependencies] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-09-02T19:07:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqFolderOfInstances.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqFolderOfInstances.asciidoc
new file mode 100644
index 0000000..88c04e0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqFolderOfInstances.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqFolderOfInstances
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have a folder full of .instance files. How do I get any/all of the object instances?
+
+Often registries of objects are created by placing files with the extension `.instance` into some folder in the link:DevFaqSystemFilesystem.html[system filesystem]. The task, then, is to turn a folder full of files into a collection of objects, and make sure we only get objects of the type we are interested in. In NetBeans 6 it is very simple to do that:
+
+[source,java]
+----
+
+Lookup myObjects = Lookups.forPath ("path/to/folder/in/sysfs");
+Collection <? extends MyType> c = myObjects.lookupAll(MyType.class);
+
+----
+
+(note the separator is always / with NetBeans filesystems).
+
+If you have a single `.instance` file and need to get an object for that, link:DevFaqFindInstance.html[see this FAQ entry].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqFolderOfInstances[http://wiki.netbeans.org/DevFaqFolderOfInstances] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:43:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGeneralPackageNamingConventions.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGeneralPackageNamingConventions.asciidoc
new file mode 100644
index 0000000..2ab47ef
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGeneralPackageNamingConventions.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGeneralPackageNamingConventions
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why are some packages org.netbeans.api.something and others are org.netbeans.something.api?
+
+There is a naming convention for APIs in NetBeans. Generally when a new API is introduced, it will be under development and not stable for a while. During that period, the naming convention for its package is `org.netbeans.modules.something.api`. So, if you rely on an API with a name like that, your code could break. Generally it is the responsibility of the author of that API to refactor all modules in NetBeans source repository when the API graduates to "official" status.
+
+An official API uses the naming convention `org.netbeans.api.something`. APIs named this way should remain backward compatible.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGeneralPackageNamingConventions[http://wiki.netbeans.org/DevFaqGeneralPackageNamingConventions] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2010-06-11T14:40:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGeneralWhatIsNetBeansExe.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhatIsNetBeansExe.asciidoc
new file mode 100644
index 0000000..94ff82b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhatIsNetBeansExe.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGeneralWhatIsNetBeansExe
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is netbeans.exe, who compiles it and why is it there?
+
+netbeans.exe is the Windows launcher for NetBeans. Basically it assembles the class path string for starting up NetBeans, passes the command line arguments, etc., and launches Java with those arguments.
+
+The main reasons for the exe are:
+
+* Start NetBeans without a console window opening as well as the main window
+* Windows shell quoting is inconsistent across versions of Windows
+* On some versions of Windows, command line length is limited to a shorter length than is sometimes needed for all the command-line arguments that should be passed to java
+* Provide a thing you can double click that has the correct icon
+
+It's nothing terribly exciting, it's just a small C++ app; the sources are in ide/launcher.
+
+Up to NetBeans 6.5 there were actually two executables - nb.exe and netbeans.exe. netbeans.exe will suppress the console window (so you won't see any logging on the command line); nb.exe will show the command line. Under the hood, netbeans.exe invokes nb.exe (so don't rename it).
+
+Starting with NetBeans 6.7 the following changes in the Windows launcher were introduced - link:WinNB67Launcher.html[WinNB67Launcher].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGeneralWhatIsNetBeansExe[http://wiki.netbeans.org/DevFaqGeneralWhatIsNetBeansExe] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:45:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsJavadoc.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsJavadoc.asciidoc
new file mode 100644
index 0000000..a47de1e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsJavadoc.asciidoc
@@ -0,0 +1,59 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGeneralWhereIsJavadoc
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Where can I find Javadoc for the IDE and Platform?
+
+There is no separate set of Javadoc for the NetBeans Platform. However, as the Platform is just a subset of the IDE, the Javadoc for the IDE will apply.
+
+You can link:http://bits.netbeans.org/dev/javadoc/index.html[browse the Javadoc online] (this link always points to the latest development version).
+
+You can also download the Javadoc for a particular NetBeans release:
+
+1. Go to the nightly build download site: link:http://bits.netbeans.org/dev/nightly/[http://bits.netbeans.org/dev/nightly/]
+
+2. Click the link for the build you want.
+
+3. Add "zip/" to the end of the URL in your browser's address bar and hit enter. In other words, the complete URL might look like this: link:http://bits.netbeans.org/dev/nightly/2010-06-11_00-01-15/zip/[http://bits.netbeans.org/dev/nightly/2010-06-11_00-01-15/zip/]
+
+5. There are about a dozen links on that page. The one you want begins with `netbeans-trunk-nightly` and ends with `-javadoc.zip`; click that link to download the Javadoc archive.
+
+Finally, you can go to the update center (*Tools > Plugin Manager*) in the NetBeans IDE and request the *NetBeans API Documentation* module, which bundles Javadoc matching your IDE release. Use *Help > Javadoc References* (*View > Documentation Indices* in NetBeans 5.x) to see the overview pages for API sets currently used by your open projects. The IDE should also automatically display this Javadoc in code completion popups.
+
+<hr/>
+
+Applies to: NetBeans 5.x, 6.x, 7.x
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGeneralWhereIsJavadoc[http://wiki.netbeans.org/DevFaqGeneralWhereIsJavadoc] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2011-12-22T17:26:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsPlatformHowToBuild.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsPlatformHowToBuild.asciidoc
new file mode 100644
index 0000000..cb3bb97
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGeneralWhereIsPlatformHowToBuild.asciidoc
@@ -0,0 +1,389 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGeneralWhereIsPlatformHowToBuild
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Where is the Platform and How Can I Build It?
+
+In versions of NetBeans prior to 6.0, two major products were available for download: the IDE and the platform. The platform is the foundation on which the IDE is built, or looking at it another way, the platform is what's left over when you remove all the IDE features from the IDE. At any rate, the platform provides user interface components, build scripts, declarative configuration and many other features that can save you a lot of time and effort in creating your own application.
+
+Because platform-based applications are themselves platforms that can be extended, the IDE can also be extended just as the platform can. Since you can remove features from a platform as well as add new ones, the availability of the platform and IDE let you choose between starting small and adding on (platform) or starting large and removing things (the IDE). Some feel the latter approach is better and even facing such a choice can be confusing to new users. If you're a new user, you'd do well to heed this advice and just use the IDE as a platform. It works just as well and is a lot less trouble.
+
+But if you're still here, you may be asking where is the platform? Binary distributions of the platform are not being made available from version 6.0 onward (and link:http://www.netbeans.org/issues/show_bug.cgi?id=124372[issue #124372] filed to bring them back was closed without any reasonable explanation). So if you want a platform binary, you'll have to create one yourself.
+
+Building the platform is not difficult, but it's not intuitive either. To start, you will need to download the platform source ZIP file and unpack it to some directory. Open a command prompt to that directory and change to the <pre>nbbuild</pre> subdirectory. From there, issue the following command:
+
+[source,java]
+----
+
+
+ ant -Dcluster.config=platform build-platform
+
+----
+
+If you're using Java 6, you'll need to add an extra property:
+
+[source,java]
+----
+
+
+ ant -Dcluster.config=platform build-platform -Dpermit.jdk6.builds=true
+
+----
+
+But be aware that it is not guaranteed to build under Java 6 due to language changes or compiler bugs. It is unlikely you will encounter such a problem in the platform build, though it has certainly been known to happen in the IDE build. If you find something that won't compile under Java 6 but does compile under Java 5, file a bug report (preferably with a patch) about it so it can be corrected. Meanwhile, you can use Java 5 to compile -- even when Java 6 is first in your path -- by using the `nbjdk.home` system property to point to your Java 5 installation:
+
+[source,java]
+----
+
+ ant -Dcluster.config=platform build-platform -Dnbjdk.home=c:/devtools/jdk/jdk-1.5.0_u15
+----
+
+This will build the platform into the <pre>netbeans</pre> subdirectory (i.e. `{nbbuild/netbeans`}). You can zip or tar up the netbeans directory to create a ZIP distribution.
+
+It's also possible to create platforms based on a different subset of the NetBeans project. Hints for doing this can be found here:
+
+* link:WorkingWithNetBeansSources.html[Working with NetBeans Sources]
+
+==== Why would you want to build your application on a separate platform instead of the IDE as a platform?
+
+Using the IDE is certainly easier, but there are inherent dangers associated with developing against your own IDE as the platform. In particular, another developer on your team may have a different version of the IDE, have different modules/clusters installed or even have simply named the platform something different in the Platform Manager. This can result in a broken build or the introduction of unwanted features. It also makes doing an automated build, such as through Hudson or CruiseControl, far more difficult.
+
+If you want to avoid these problems, you can check the platform you want to build against into source control and then set the `netbeans.dest.dir` and `harness.dir` properties in your suite's `nbproject/platform.properties` file to point to the platform and harness, respectively. Building from a known version checked out from source control avoids these problems and makes it possible to historically reproduce any build. I show example values for these below:
+
+[source,java]
+----
+
+
+# NOTE: You must remove the nbplatform.default line which might already exist in this file.
+# Also note that editing the properties of your suite via the suite customizer (dialog)
+# can add that line back in, so you'll need to watch for this and delete it again in this case.
+
+# where the suite is located; you don't need to change this. It exists
+# to allow us to use relative paths for the other values
+suite.dir=${basedir}
+
+# the path to the NetBeans IDE or platform binary we want to build against
+# (e.g. if building against the IDE, this points to the directory created when
+# you unpack the IDE zip file). this example assumes your platform directory
+# is parallel to the suite directory, but you can change it to suit your needs
+netbeans.dest.dir=${suite.dir}/../platform
+
+# path to the build harness you want to use. This is typically in the
+# harness subdirectory of your platform, but you could point to a directory
+# containing customized build scripts if you want to.
+harness.dir=${netbeans.dest.dir}/harness
+
+----
+
+==== Update for NBM projects generated by NetBeans 6.7 and later
+
+If you have generated your projects in IDE version 6.7 and later, you have to modify the above described method slightly (6.5.1 and earlier projects compile against newer platform/harness without changes). You can distinguish "newer" project by the presence of `cluster.path` property in `nbproject/platform.properties` file or simply by the fact that an attempt to build a suite with above described `platform.properties` results in error:
+
+[source,java]
+----
+
+.../harness/suite.xml:60: When using cluster.path property, remove
+netbeans.dest.dir, enabled.clusters and disabled.clusters properties
+from platform config, they would be ignored.
+----
+
+In such case you have to replace `netbeans.dest.dir`, `enabled.clusters` and `disabled.clusters` properties with new property `cluster.path`, e.g.:
+
+[source,java]
+----
+
+
+# NOTE: You must remove the nbplatform.default line which might already exist in this file.
+# Also note that editing the properties of your suite via the suite customizer (dialog)
+# can add that line back in, so you'll need to watch for this and delete it again in this case.
+
+# where the suite is located; you don't need to change this. It exists
+# to allow us to use relative paths for the other values
+suite.dir=${basedir}
+
+# just a helper property pointing to the same location as netbeans.dest.dir did before;
+# Referenced only in this properties file, has no meaning for NB harness.
+platform.base=${suite.dir}/../platform
+
+# Give a name to the platform at the relative path and define its location
+# using the platform.base property we set above. You can change the value
+# ('myplatform') to something more descriptive (like 'nb68'), but you
+# must then change the name of the second property (e.g. from
+# nbplatform.myplatform.netbeans.dest.dir to nbplatform.nb68.netbeans.dest.dir)
+nbplatform.active=myplatform
+nbplatform.myplatform.netbeans.dest.dir=${platform.base}
+
+# classpath-like list of absolute or relative paths to individual clusters
+# against which you want your suite to build; Note that you can use
+# "bare", i.e. not numbered cluster names, which simplifies later transitions
+# to newer version of the platform. E.g:
+cluster.path=${platform.base}/platform:\
+ ${platform.base}/ide:\
+ ../otherSuite/build/cluster
+
+# path to the build harness you want to use. This is typically in the
+# harness subdirectory of your platform, but you could point to a directory
+# containing customized build scripts if you want to.
+harness.dir=${platform.base}/harness
+
+----
+
+Note that the content of `cluster.path` is not limited to clusters from NB platform, you can add clusters from other suites, standalone modules, etc. This allows to reuse non-platform modules in several RCP apps. link:DevFaqHowToReuseModules.html[More on module reuse here], other details about setting up `cluster.path` can be found in `harness/README`.
+
+==== Update for NBM projects generated by NetBeans 7.0 and later
+
+Now the the platform can get downloaded automatically with some minor tweaks! This is great for usage in Continuous Integration servers like Hudson/Jenkins.
+
+See link:DevFaqAutomaticPlatformDownload.html[here] for more details.
+
+== Some automation anyone?
+
+The above process is basically manual so here are some stuff I developed to automate the process:
+
+=== Update the development environment
+
+The following allows to update the development environment mentioned above that should be part of version control. (i.e. to make it work from Hudson for example)
+
+* Add a xml file in the suite's root (referred as preparation.xml from now on)
+
+Hare are its contents:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="XXX-Preparation" basedir=".">
+ <description>Prepares the environment to build the module suite XXX.</description>
+ <!--Don't modify this file unless you know what you are doing-->
+ <property name="ant-contrib-filename" value="ant-contrib-1.0b3.jar"/>
+ <property file="nbproject/project.properties"/>
+ <property file="nbproject/platform.properties"/>
+
+ <target name="update-platform" depends="init-netbeans">
+ <for list="${cluster.path}" delimiter=":" param="cur" trim="true">
+ <sequential>
+ <add-core-module module="@{cur}"/>
+ </sequential>
+ </for>
+ </target>
+
+ <target name="unzip-compilation-env" depends="init-netbeans, init-hudson">
+ <!--Hudson needs to run this task first as it gets the core modules as zip from version control-->
+ <for list="${cluster.path}" delimiter=":" param="cur" trim="true">
+ <sequential>
+ <expand-module module="@{cur}"/>
+ </sequential>
+ </for>
+ </target>
+
+ <target name="update-env" depends="init-netbeans, init-hudson" description="Update the Netbeans core modules used to compile/run OIT">
+ <!--Make sure that any recently added module using the IDE is also included.
+ Fix it to the proper format.-->
+ <mkdir dir="../netbeans/"/>
+ <propertyregex property="cluster.path"
+ input="${cluster.path}"
+ regexp="nbplatform.active.dir"
+ replace="platform.base"
+ global="true"
+ override="true"/>
+ <replaceregexp file="nbproject/platform.properties"
+ match="nbplatform.active.dir"
+ replace="platform.base"
+ byline="true"
+ flags="g,s"/>
+ <pathconvert pathsep="\;" property="folders_temp">
+ <dirset dir="../netbeans/">
+ <include name="*/**"/>
+ <!--ignore svn and cvs files-->
+ <include name="**/.svn"/>
+ <include name="**/.svn/**"/>
+ <include name="**/CVS"/>
+ <include name="**/CVS/**"/>
+ <!--Exclude the nb-plugins folder-->
+ <exclude name="nb-plugins/**"/>
+ <!--Exclude the root folder-->
+ <exclude name="../netbeans"/>
+ </dirset>
+ </pathconvert>
+ <antcall target="update-platform"/>
+ <antcall target="unzip-compilation-env"/>
+ </target>
+
+ <macrodef name="expand-module">
+ <attribute name="module"/>
+ <sequential>
+ <delete dir="@{module}"/>
+ <unzip src="@{module}.zip" dest="@{module}"/>
+ </sequential>
+ </macrodef>
+
+ <macrodef name="add-core-module">
+ <attribute name="module"/>
+ <sequential>
+ <if>
+ <equals arg1="@{module}" arg2="../netbeans/nb-plugins"/>
+ <then>
+ <echo>Adding custom module @{module}</echo>
+ <available file="@{module}" type="dir" property="customdir.exists"/>
+ <if>
+ <equals arg1="${customdir.exists}" arg2="true"/>
+ <then>
+ <zip destfile="@{module}.zip" basedir="@{module}" update="true"/>
+ </then>
+ </if>
+ </then>
+ <else>
+ <length string="@{module}" property="@{module}.length.module" />
+ <substring text="@{module}" start="12" end="${@{module}.length.module}" property="new.module"/>
+ <echo>Adding netbeans core module ${new.module}</echo>
+ <mkdir dir="../netbeans/${new.module}/"/>
+ <delete file="../netbeans/${new.module}.zip"/>
+ <delete includeemptydirs="true">
+ <fileset dir="../netbeans/${new.module}/" includes="**/.*" defaultexcludes="false"/>
+ </delete>
+ <zip destfile="../netbeans/${new.module}.zip" basedir="${netbeans.home}\..\${new.module}" update="true"/>
+ </else>
+ </if>
+ </sequential>
+ </macrodef>
+
+ <scriptdef name="substring" language="javascript">
+ <attribute name="text" />
+ <attribute name="start" />
+ <attribute name="end" />
+ <attribute name="property" />
+ <![CDATA[
+ var text = attributes.get("text");
+ var start = attributes.get("start");
+ var end = attributes.get("end") || text.length;
+ project.setProperty(attributes.get("property"), text.substring(start, end));
+ ]]>
+ </scriptdef>
+
+ <target name="check-env" depends="getAntContribJar">
+ <condition property="isNetbeans">
+ <not>
+ <isset property="Hudson"/>
+ </not>
+ </condition>
+ </target>
+
+ <target name="getAntContribJar">
+ <fileset id="ant-contrib-jar" dir="${suite.dir}/tools">
+ <include name="ant-contrib-*.jar" />
+ </fileset>
+ <pathconvert property="ant-contrib-jar" refid="ant-contrib-jar" pathsep="," />
+ <basename property="ant-contrib-filename" file="${ant-contrib-jar}"/>
+ </target>
+
+ <target name="init-netbeans" depends="check-env" if="isNetbeans">
+ <echo>Configuring ant-contrib for Netbeans use...</echo>
+ <property name="ant-contrib-loc" value="${suite.dir}/tools/${ant-contrib-filename}"/>
+ <available file="${ant-contrib-loc}" property="ant-contrib.present"/>
+ <fail unless="ant-contrib.present" message="The ant-contrib jar doesn't exist at: ${ant-contrib-loc}, can't build. Check your settings!" />
+ <!--We are in not Hudson-->
+ <taskdef resource="net/sf/antcontrib/antcontrib.properties">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ </target>
+
+ <target name="init-hudson" depends="check-env" unless="isNetbeans">
+ <echo>Configuring ant-contrib for Hudson use...</echo>
+ <!--Import Hudson environment variables-->
+ <property environment="env"/>
+ <property name="ant-contrib-loc" value="${env.ANT_HOME}/lib/${ant-contrib-filename}"/>
+ <available file="${ant-contrib-loc}" property="ant-contrib.present"/>
+ <fail unless="ant-contrib.present" message="The ant-contrib jar doesn't exist at: ${ant-contrib-loc}, can't build. Check your settings!" />
+ <!--Define it. For some reason the approach in init-netbeans doesn't work in Hudson.-->
+ <taskdef name="for" classname="net.sf.antcontrib.logic.ForTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="propertyregex" classname="net.sf.antcontrib.property.RegexTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="if" classname="net.sf.antcontrib.logic.IfTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="math" classname="net.sf.antcontrib.math.MathTask">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ <taskdef name="var" classname="net.sf.antcontrib.property.Variable">
+ <classpath>
+ <pathelement location="${ant-contrib-loc}"/>
+ </classpath>
+ </taskdef>
+ </target>
+</project>
+----
+
+Here's a sumary of the targets and what they do:
+
+* *init-netbeans/init-hudson*: Configures the ant-contrib lib used in other tasks. For some reason Hudson doesn't work with the init-netbeans approach.
+* *getAntContribJar*: Looks in the suite's tools folder for the ant-contrib jar file. This file name is then used by other tasks
+* *check-env*: Basically to decide if we're in Netbeans or in Hudson. While in Hudson just pass the -DHudson=true parameter to the ant job. Having this variable set (not the value) tells this task that we are in Hudson.
+* *update-env*: The task to call. This one updates the cluster.path values in nbproject/platform.properties to set it up as mentioned in this FAQ. Why you might ask? This just takes care of updating any later addition of a module via using Netbeans and converts it to the format discussed in this FAQ. Basically no need to manually modify the nbproject/platform.properties file after the initial change!
+* *update-platform*: This will grab the current's IDE modules defined in cluster.path and zip them in a netbeans folder parallel to the suite's root folder. No need to do it manually!
+* *unzip-compilation-env*: this unzips the zips created in the above task to their proper place.
+
+Keep in mind that after making the changes proposed earlier in this FAQ the project won't work (i.e. build, run, etc) if the environment is not set.
+
+That's the reason of doing all this in another xml file. Attempting any of this from the suite's build file won't work since you are messing with the platform files it is working from.
+
+*Notes:*
+
+* Make sure to have an ant-contrib file in <suite's root>/tools folder for the above to work.
+* Current release of ant-contrib has an error. To fix it unpack the jar and add this entry to the net/sf/antcontrib/antcontrib.properties file in the Logic tasks section:
+[source,java]
+----
+
+for=net.sf.antcontrib.logic.ForTask
+----
+
+
+
+See also:
+
+* link:DevFaqSignNbm.html[Can I sign NBMs I create?] for tasks to sign all your nbm files
+* link:DevFaqCustomizeBuild.html[How can I customize the build process?] To add any custom task you might have to the build process.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGeneralWhereIsPlatformHowToBuild[http://wiki.netbeans.org/DevFaqGeneralWhereIsPlatformHowToBuild] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T19:29:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGetNameOfProjectGroup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGetNameOfProjectGroup.asciidoc
new file mode 100644
index 0000000..0a775ef
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGetNameOfProjectGroup.asciidoc
@@ -0,0 +1,94 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGetNameOfProjectGroup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to get the name of the active project group
+
+== Variant I: "use OpenProjects API" (since NB7.3)
+
+[source,java]
+----
+
+org.netbeans.api.project.ui.OpenProjects.getDefault().getActiveProjectGroup().getName()
+----
+
+This approach uses a public API which is known to be stable for future versions. Since 7.3.
+
+See link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/api/project/ui/OpenProjects.html#getActiveProjectGroup([http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/api/project/ui/OpenProjects.html#getActiveProjectGroup(])
+
+== Variant II: "direct access to properties"-hack
+
+Note: this is rather a hack. It is not guaranteed that this will work for newer NetBeans versions. But this approach is known to work at least with NB 6.9.1 to 7.3.
+
+[source,java]
+----
+
+ /**
+ *
+ * @return name of the current project group or null
+ */
+ public String getActiveProjectGroup() {
+ Preferences groupNode = getPreferences("org/netbeans/modules/projectui/groups");
+ if (null != groupNode) {
+ final String groupId = groupNode.get("active", null);
+ if (null != groupId) {
+ final Preferences groupPref = getPreferences("org/netbeans/modules/projectui/groups/" + groupId);
+ if (null != groupPref) {
+ final String activeProjectGroup = groupPref.get("name", null);
+ return activeProjectGroup;
+ }
+ }
+ }
+ return null;
+ }
+
+ /**
+ * Get the preference for the given node path.
+ *
+ * @param path configuration path like "org/netbeans/modules/projectui"
+ * @return {@link Preferences} or null
+ */
+ private Preferences getPreferences(String path) {
+ try {
+ if (NbPreferences.root().nodeExists(path)) {
+ return NbPreferences.root().node(path);
+ }
+ } catch (BackingStoreException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ return null;
+ }
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGetNameOfProjectGroup[http://wiki.netbeans.org/DevFaqGetNameOfProjectGroup] ,
+that was last modified by NetBeans user Markiewb
+on 2013-01-12T17:40:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGetNameOrIconForProject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGetNameOrIconForProject.asciidoc
new file mode 100644
index 0000000..4be924e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGetNameOrIconForProject.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGetNameOrIconForProject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to get the name or icon of a project?
+
+[source,java]
+----
+
+org.netbeans.api.project.ProjectUtils.getInformation(project).getDisplayName()
+org.netbeans.api.project.ProjectUtils.getInformation(project).getIcon()
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGetNameOrIconForProject[http://wiki.netbeans.org/DevFaqGetNameOrIconForProject] ,
+that was last modified by NetBeans user Markiewb
+on 2013-01-01T16:16:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGetOpenEditorWindows.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGetOpenEditorWindows.asciidoc
new file mode 100644
index 0000000..6e7cf13
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGetOpenEditorWindows.asciidoc
@@ -0,0 +1,123 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGetOpenEditorWindows
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I get a list of open editor windows?
+
+==== To obtain a reference to the currently selected editor
+
+[source,java]
+----
+
+Node[] arr = TopComponent.getRegistry().getCurrentNodes();
+for (int i = 0; i < arr.length; i++) {
+ EditorCookie ec = (EditorCookie) arr[i].getCookie(EditorCookie.class);
+ if (ec != null) {
+ JEditorPane[] panes = ec.getOpenedPanes();
+ if (panes != null) {
+ // USE panes
+ }
+ }
+}
+----
+
+Note that EditorCookie.getOpenPanes() is deprecated (link:https://netbeans.org/bugzilla/show_bug.cgi?id=223383[https://netbeans.org/bugzilla/show_bug.cgi?id=223383]). Use `org.openide.text.NbDocument.findRecentEditorPane(EditorCookie)` instead.
+
+==== To obtain references to all opened editors
+
+[source,java]
+----
+
+Set<TopComponent> comps = TopComponent.getRegistry().getOpened();
+for (TopComponent tc: comps) {
+ Node[] arr = tc.getActivatedNodes();
+ for (int j = 0; j < arr.length; j++) {
+ EditorCookie ec = (EditorCookie) arr[j].getCookie(EditorCookie.class);
+ if (ec != null) {
+ JEditorPane[] panes = ec.getOpenedPanes();
+ if (panes != null) {
+ // USE panes
+ }
+ }
+ }
+}
+----
+
+==== Variants to get the Editor TopComponents
+
+===== Variant A)
+
+[source,java]
+----
+
+ private Collection<TopComponent> getCurrentOpenedEditors() {
+ final ArrayList<TopComponent> result = new ArrayList<TopComponent>();
+ final WindowManager wm = WindowManager.getDefault();
+ for (Mode mode : wm.getModes()) {
+ if (wm.isEditorMode(mode)) {
+ //result.addAll(Arrays.asList(mode.getTopComponents())); OR even faster
+ result.addAll(Arrays.asList(wm.getOpenedTopComponents(mode)));
+ }
+ }
+ return result;
+ }
+
+----
+
+===== Variant B)
+
+[source,java]
+----
+
+ private TopComponent getCurrentEditor() {
+ Set<? extends Mode> modes = WindowManager.getDefault().getModes();
+ for (Mode mode : modes) {
+ if ("editor".equals(mode.getName())) {
+ return mode.getSelectedTopComponent();
+ }
+ }
+ return null;
+ }
+
+ //or
+ private TopComponent getCurrentEditor() {
+ Mode editor = WindowManager.getDefault().findMode("editor");
+ return editor.getSelectedTopComponent();
+ }
+----
+
+<hr/>
+*Reference-* link:http://nbguru.wordpress.com/2008/07/25/tat-editor-windows-reactivated-8/[Editor Windows Reactivated]
+<hr/>
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGetOpenEditorWindows[http://wiki.netbeans.org/DevFaqGetOpenEditorWindows] ,
+that was last modified by NetBeans user Markiewb
+on 2016-10-26T20:35:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGetProjectForFileInEditor.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGetProjectForFileInEditor.asciidoc
new file mode 100644
index 0000000..cbeeba9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGetProjectForFileInEditor.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGetProjectForFileInEditor
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to get the project for the actual file in the editor?
+
+* get the project from the lookup of the active TopComponent AND/OR
+* get the project from the lookup of the active DataObject
+[source,java]
+----
+
+Project p = TopComponent.getRegistry().getActivated().getLookup().lookup(Project.class);
+if (p == null) {
+ DataObject dob = TopComponent.getRegistry().getActivated().getLookup().lookup(DataObject.class);
+ if (dob != null) {
+ FileObject fo = dob.getPrimaryFile();
+ p = FileOwnerQuery.getOwner(fo);
+ ...
+----
+
+----
+Taken from platform-dev mailing list / Tim Boudreau
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGetProjectForFileInEditor[http://wiki.netbeans.org/DevFaqGetProjectForFileInEditor] ,
+that was last modified by NetBeans user Markiewb
+on 2012-12-27T10:47:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGetShortCutForAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGetShortCutForAction.asciidoc
new file mode 100644
index 0000000..dc59d5b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGetShortCutForAction.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGetShortCutForAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to get the shortcut/shortkey of an action at runtime?
+
+For example
+
+[source,java]
+----
+
+Action action = FileUtil.getConfigObject("Actions/Source/org-netbeans-modules-editor-hints-FixAction.instance", Action.class);
+KeyStroke ks = action != null ? (KeyStroke) action.getValue(Action.ACCELERATOR_KEY) : null;
+
+
+// localise a keystroke for display
+org.openide.util.Utilities.keyToString() // or
+org.netbeans.core.options.keymap.api.KeyStrokeUtils.getKeyStrokeAsText() // if a friend of org.netbeans.modules.options.keymap
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGetShortCutForAction[http://wiki.netbeans.org/DevFaqGetShortCutForAction] ,
+that was last modified by NetBeans user Markiewb
+on 2016-03-27T14:05:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGlobalVsEditorKeybindings.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGlobalVsEditorKeybindings.asciidoc
new file mode 100644
index 0000000..5c50e6d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGlobalVsEditorKeybindings.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGlobalVsEditorKeybindings
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are editor-specific keybindings and how are they different from global ones?
+
+The editor has its own mechanism for registering keybindings, which is separate from global keybindings (in essence, they belong to the Swing EditorKit for the editor, but there are some registration mechanisms in the editor for this). So if you want to register a keyboard shortcut only against the editor when editing a certain type of file (as opposed to a keyboard shortcut that is a shortcut for an action on the main menu), you'll be using editor-based keybindings.
+
+If there is a global shortcut bound to a key combination, and also an editor-specific one defined for the type of file being edited, the editor wins if the editor has focus.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGlobalVsEditorKeybindings[http://wiki.netbeans.org/DevFaqGlobalVsEditorKeybindings] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:45:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqGraphicalChoiceView.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqGraphicalChoiceView.asciidoc
new file mode 100644
index 0000000..c133ee9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqGraphicalChoiceView.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqGraphicalChoiceView
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I graphically create a ChoiceView in using the GUI designer?
+
+It is possible to use a ChoiceView graphically during the design of your interface in the Form Editor. As ChoiceView extends JComboBox, you can design the interface with the help of a JComboBox which is the placeholder for your ChoiceView and customize the creation code of the combo to instantiate a ChoiceView instead.
+
+Simply choose "Combo Box" from the "Swing Controls" palette and drop it onto your interface. Then select the combo and select the "Code" tab in the properties window. In the "custom creation code" field type: "new ChoiceView()". Then return to the "Properties" tab an clear the "model" field. This step is absolutely mandatory otherwise it won't work: by default the Form Editor creates a dummy model for you. It is forbidden to set a model on a ChoiceView. If you do anyway you will get errors like:
+
+[source,java]
+----
+
+java.lang.ClassCastException: java.lang.String cannot be cast to org.openide.explorer.view.VisualizerNode
+ at org.openide.explorer.view.NodeRenderer.findVisualizerNode(NodeRenderer.java:232)
+ at org.openide.explorer.view.NodeRenderer.getListCellRendererComponent(NodeRenderer.java:152)
+ at javax.swing.plaf.basic.BasicComboBoxUI.paintCurrentValue(BasicComboBoxUI.java:1202)
+ at com.sun.java.swing.plaf.windows.WindowsComboBoxUI.paintCurrentValue(WindowsComboBoxUI.java:293)
+ at javax.swing.plaf.basic.BasicComboBoxUI.paint(BasicComboBoxUI.java:888)
+ at com.sun.java.swing.plaf.windows.WindowsComboBoxUI.paint(WindowsComboBoxUI.java:199)
+ at javax.swing.plaf.ComponentUI.update(ComponentUI.java:143)
+ at javax.swing.JComponent.paintComponent(JComponent.java:763)
+ at javax.swing.JComponent.paint(JComponent.java:1029)
+ at javax.swing.JComponent.paintChildren(JComponent.java:864)
+ at javax.swing.JComponent.paint(JComponent.java:1038)
+ at javax.swing.JComponent.paintChildren(JComponent.java:864)
+ at javax.swing.JComponent.paint(JComponent.java:1038)
+ ...
+----
+
+Finally switch to the "Source" view and fix the import errors.
+--link:User:Tboudreau.html[Tboudreau] 02:40, 24 January 2010 (UTC)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqGraphicalChoiceView[http://wiki.netbeans.org/DevFaqGraphicalChoiceView] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T02:40:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHelpGuidelines.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHelpGuidelines.asciidoc
new file mode 100644
index 0000000..2a4298b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHelpGuidelines.asciidoc
@@ -0,0 +1,324 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHelpGuidelines
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= Module Helpset Integration FAQs
+
+== How to Create a Help Set in a Module
+
+1. In the IDE, right-click the node of the project to which you want to add the help set and choose New | Other.
+2. In the Module Development category, choose JavaHelp Help Set and complete the wizard.
+
+See also the documentation on link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/org/netbeans/api/javahelp/doc-files/api.html[NetBeans JavaHelp Integration API].
+
+== What Modules are the NetBeans Help Sets In?
+
+Search link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/artifact/nbbuild/build/generated/layers.txt[http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/artifact/nbbuild/build/generated/layers.txt] for Services/JavaHelp/ to find all current help sets.
+
+An easier place to search is the Online Help section of the latest Documentation Table, such as link:NB71DocumentationTable#OnlineHelp_Updates.html[NB71DocumentationTable#OnlineHelp_Updates].
+
+== How do I determine the order in which a help set appears in the help viewer?
+
+The order in which help sets are merged is determined by a position attribute in the help set module's layer file. The higher the number, the lower the position. See the list above for the numbers assigned to the current help sets.
+
+To change the position of a help set:
+
+1. Open the help module's XML layer file, which is in the module's /src directory.
+2. Change the "intvalue" value of the help set's "position" attribute.
+
+== How should I set help IDs?
+
+See this document: link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/org/netbeans/api/javahelp/doc-files/help-guide.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/org/netbeans/api/javahelp/doc-files/help-guide.html]
+
+This document boils down to two ways to set a help ID:
+
+* By creating a new HelpCtx object with <pre>new HelpCtx(ThisHelpCtxInstanceId)</pre>
+* In a property sheet, with a call to <pre>Sheet.Set.setValue("HelpId", "ValueOfThisHelpId")</pre>
+
+The Help id can be any string but the string _must be unique throughout your code._
+If you are creating a HelpCtx object, you can create the help id dynamically using PanelClassName.class or PanelClassName.getClass(). For example,
+
+[source,java]
+----
+
+public class MyBeautifulDialogPanel {
+...
+ public HelpCtx getHelp() {
+ return new HelpCtx(MyBeautifulDialogPanel.class)
+ }
+}
+----
+
+would return the full class name of MyBeautifulDialogPanel as a help id. Be warned that doing this risks you breaking the help mapping if you ever refactor the class.
+
+=== Multiple Forms in a Single Panel Class
+
+Sometimes a single panel class can create multiple forms, using a boolean or an enum. You can dynamically create a separate help id for each of these forms.
+For a boolean, use this code, where BaseHelpId is a unique string and booleanVariable is the variable that determines which form is generated:
+
+[source,java]
+----
+
+public Help Ctx getHelp() {
+ return HelpCtx("BaseHelpId." + booleanVariable);
+}
+----
+
+For an enum, use this code, where BaseHelpId is a unique string and the variable enumVariable has been assigned to the enum:
+
+[source,java]
+----
+
+public Help Ctx getHelp() {
+ switch (enumVariable) {
+ case EnumValue1: return new HelpCtx("BaseHelpId.EnumValue1");
+ case EnumValue2: return new HelpCtx("BaseHelpId.EnumValue2");
+...
+ default:
+ return new HelpCtx("BaseHelpId.default");
+ }
+}
+----
+
+In the mapping file, make sure to add a mapping for every value of the enum plus a mapping to default help in the default case where no enum value is set.
+
+== Mapping Help IDs to Help Files
+
+Every help set has a Map file. Every help ID should have a unique entry in _one and only one_ help set in your code (A program can have many help sets, as is the case with NetBeans IDE). The entry is a mapID element, and is of the form:
+
+[source,java]
+----
+
+&lt;mapID target="UniqueHelpId" url="PathFromMapFileToHelpFileInHelpSet"/&gt;
+----
+
+=== How do I find unmapped help IDs?
+
+You can debug CSH help IDs by running the IDE with:
+
+[source,java]
+----
+
+-J-Dorg.netbeans.modules.javahelp.level=100
+----
+
+The IDE then prints the help ID of each component you press F1 on, or of the Help button in a wizard, in the console/log and tells you if the help ID was not found in the map file.
+
+You can view the output straight from the IDE. Choose View | IDE Log File.
+
+Note: You can add the switch to the NetBeans default switches. Edit INSTALLATION_DIRECTORY/etc/netbeans.conf. If you want to risk editing your .conf file, that is!
+
+== How do I open a helpset programmatically?
+
+Once you have defined a mapID in the map-file
+
+[source,xml]
+----
+
+<map version="2.0">
+ <mapID target="myPluginAboutMapID" url="myplugin-about.html"/>
+</map>
+----
+
+You can open the topic via
+
+[source,java]
+----
+
+new HelpCtx("myPluginAboutMapID").display();
+----
+
+== How do I link to a page in a separate helpset?
+
+The best way is to use the nbdocs URL protocol, where the "host name" field is the code name base of the other module, and the rest is a resource path (such as from the src/ or javahelp/ directories in the source project). For example:
+
+[source,xml]
+----
+
+<a href="nbdocs://org.netbeans.modules.db/org/netbeans/modules/db/docs/connectdb.html">Connecting
+to a Database</a>
+----
+
+When you use this format, the IDE displays an error message if the module is not installed. Otherwise broken inter-helpset links do not do anything in the IDE.
+
+The module name should be the name of the module containing the helpset. The name is listed in the OpenIDE-Module property of the module's JAR file (minus any /number). The list above gives the abbreviated code name bases of the help modules in the left column.
+
+== How do I merge helpsets?
+
+Helpsets are merged automatically by the IDE's master helpset. You don't need to specify mergetypes for the views of your helpset.
+
+== How do I merge into an existing TOC and index category?
+
+In your TOC file, copy the TOC category structure exactly as it exists in the usersguide module TOC file
+(usersguide/javahelp/org/netbeans/modules/usersguide/ide-toc.xml). Then place your listing
+in the desired category.
+
+For example, say you wanted to list a help file under the Java Project Basics -> Building Java Applications category. You would
+enter the following in your TOC file:
+
+[source,xml]
+----
+
+<?xml version='1.0' encoding='ISO-8859-1' ?>
+<!DOCTYPE toc PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp TOC Version 2.0//EN"
+ "link:http://java.sun.com/products/javahelp/toc_2_0.dtd[http://java.sun.com/products/javahelp/toc_2_0.dtd]">
+<toc version="2.0">
+ <tocitem text="Java Project Basics">
+ <tocitem text="Building Java Applications">
+ <tocitem text="My Help File" target="my_target"/>
+ </tocitem>
+ </tocitem>
+</toc>
+----
+
+"My Help File" would get merged in at the end of the topics in the category.
+
+The same technique works for indexing. To merge into the "databases" index category, do the following:
+
+[source,xml]
+----
+
+<indexitem text="databases" >
+ <indexitem text="MyCoolDB, connecting to" target="connectMyCool"/>
+</indexitem>
+----
+
+== Are there guidelines for creating TOC and Index entries?
+
+* If possible, try to merge your helpset into the existing TOC categories and index categories. For example, if you are developing a server plugin merge it into the Servers and Databases > Servers category.
+* In general, put all of your topics into a TOC category. There should never be individual topic entries as first-level entries in the TOC.
+* Don't have your category nodes linked to a topic. If there is a general intro topic for your section, put it as an About page underneath. WRONG:
+[source,xml]
+----
+
+<tocitem text="My Cool Plug-in" target="myCoolPlugin">
+ ...
+</tocitem>
+----
+
+RIGHT:
+
+[source,xml]
+----
+
+<tocitem text="My Cool Plug-in" >
+ <tocitem text="About My Cool Plug-in" target="myCoolPlugin"/>
+ ...
+</tocitem>
+----
+
+== How do I create a glossary item in the help?
+
+Create the glossary page. The page should have an <h6> title in lower case capitalization, for example:
+
+[source,xml]
+----
+
+<h6>standard project</h6>
+<p>A project that uses an IDE-generated Ant script to compile, run, and debug...
+----
+
+*Note* Glossary topics shouldn't be listed in the Table of Contents.
+
+Use the following syntax to link to the glossary page:
+
+[source,xml]
+----
+
+<object classid="java:com.sun.java.help.impl.JHSecondaryViewer">
+ <!-- Enter the link to the glossary page below-->
+ <param name="content" value="../project/csh/glossary_standard.html">
+ <param name="viewerActivator" value="javax.help.LinkLabel">
+ <param name="viewerStyle" value="javax.help.Popup">
+ <param name="viewerSize" value="400,220">
+ <!-- Enter the display text below-->
+ <param name="text" value="standard Java project">
+ <param name="textFontSize" value="small">
+ <param name="textFontFamily" value="SansSerif">
+ <param name="textFontStyle" value="italic">
+ <param name="textFontWeight" value="bold">
+ <param name="textColor" value="blue">
+</object>
+----
+
+== How do I make a link to an external web page open in the IDE's external web browser?
+
+Use the following syntax:
+
+[source,xml]
+----
+
+<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
+ <!-- Enter the URL below -->
+ <param name="content" value="link:http://www.netbeans.org/kb/41/freeform-config.html[http://www.netbeans.org/kb/41/freeform-config.html]">
+ <!-- Enter the display text below. The <html> and <u> make the text look like a link. -->
+ <param name="text" value="<html><u>link:http://www.netbeans.org/kb/41/freeform-config.html[http://www.netbeans.org/kb/41/freeform-config.html]</u></html>">
+ <param name="textFontSize" value="medium">
+ <param name="textColor" value="blue">
+</object>
+----
+
+*Note* When you view the page outside of !NetBeans, this link will not display or will display as a ???
+
+== How do I link to the common CSS for the IDE?
+
+Each helpset should use the ide.css that is included in the usersguide module. Linking to the common
+CSS lets vision-impaired users make changes to the help font and backgroung colors. Use the following link
+in your HTML pages:
+
+[source,java]
+----
+
+<link rel="StyleSheet"
+ href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css"
+ type="text/css">
+----
+
+== How do I check links between help files and between metadata and help files?
+
+There are special Ant targets for this purpose that you can run from inside of the IDE.
+
+To check links in individual help sets (including links in and validity of metadata files):
+
+1. Make sure that you have the nbbuild module checked out. You get this automatically if you have a clone of the repository.
+2. In your help set, right-click the build.xml file for the help set and choose Run Target > check-javahelp. (If you are unsure about which build.xml file applies to the help set, look at the list linked to above to determine the location of the module containing the build.xml file.)
+
+To check inter-helpset links:
+
+1. Clone the entire NetBeans main repository.
+2. Right-click the 'nbbuild' module's build.xml file and choose Run Target > build-nozip. Now the sources are built. Go get coffee. Do not continue with this procedure unless the build succeeds (see Output window for info).
+3. Now, on the build.xml file again, choose Run Target > check-javahelpbin.
+
+*NOTE* - This latter check is based on built modules. If you make or update changes in the files, you have to rebuild the modules before the changes will be recognized by the link check. Running the check-javahelp target for the module that you have updated does the trick (you do not necessarily have to rebuild the whole IDE).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHelpGuidelines[http://wiki.netbeans.org/DevFaqHelpGuidelines] ,
+that was last modified by NetBeans user Markiewb
+on 2016-03-05T16:16:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHideRemoveToolbarMenu.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHideRemoveToolbarMenu.asciidoc
new file mode 100644
index 0000000..0be2bd6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHideRemoveToolbarMenu.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHideRemoveToolbarMenu
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I hide/remove default toolbar buttons and/or menu items?
+
+Create a layer.xml file in a NetBeans module (in the New File wizard, choose Module Development | XML Layer). Once you have created the layer.xml file, expand it in the Important Files node, find the item you want to remove, right-click on it, choose Delete. The _hidden tag for the layer folder or file will be added to your layer.xml file.
+
+Alternatively, if you know the applicable names of folders or files, add the information to the layer.xml file yourself, e.g:
+
+[source,xml]
+----
+
+<folder name="Menu">
+ <folder name="File">
+ <file name="org-netbeans-modules-project-ui-NewFile.shadow_hidden"/>
+ </folder>
+</folder>
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHideRemoveToolbarMenu[http://wiki.netbeans.org/DevFaqHideRemoveToolbarMenu] ,
+that was last modified by NetBeans user Geertjan
+on 2016-01-06T16:58:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHideShowToolbar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHideShowToolbar.asciidoc
new file mode 100644
index 0000000..92637fc
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHideShowToolbar.asciidoc
@@ -0,0 +1,120 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHideShowToolbar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I hide and show toolbars the way the debugger does?
+
+To hide/show a toolbar dynamically in the NetBeans Platform, you should predefine a toolbar configuration first, then activate it.
+
+1. Define toolbar configuration files alongside the module's layer:
+`Standard.xml`:
+
+[source,xml]
+----
+
+<?xml version="1.0"?>
+<!DOCTYPE Configuration PUBLIC "-//NetBeans IDE//DTD toolbar//EN"
+ "http://www.netbeans.org/dtds/toolbar.dtd">
+<Configuration>
+ <Row>
+ <Toolbar name="View" />
+ <Toolbar name="Control" />
+ <Toolbar name="Indicator" />
+ <Toolbar name="Draw" />
+ <Toolbar name="Memory" />
+ </Row>
+ <Row>
+ <Toolbar name="File" position="2" visible="false" />
+ <Toolbar name="Edit" position="2" visible="false" />
+ <Toolbar name="Build" position="2" visible="false" />
+ <Toolbar name="Debug" position="2" visible="false" />
+ <Toolbar name="Versioning" position="2" visible="false" />
+ </Row>
+</Configuration>
+
+----
+
+`Developing.xml`:
+
+[source,xml]
+----
+
+<?xml version="1.0"?>
+<!DOCTYPE Configuration PUBLIC "-//NetBeans IDE//DTD toolbar//EN"
+"http://www.netbeans.org/dtds/toolbar.dtd">
+<Configuration>
+ <Row>
+ <Toolbar name="View" />
+ <Toolbar name="Control" />
+ <Toolbar name="Indicator" />
+ <Toolbar name="Draw" />
+ <Toolbar name="Memory" />
+ </Row>
+ <Row>
+ <Toolbar name="File" position="2" />
+ <Toolbar name="Edit" position="2" />
+ <Toolbar name="Build" position="2" />
+ <Toolbar name="Debug" position="2" visible="false" />
+ <Toolbar name="Versioning" position="2" visible="false" />
+ </Row>
+</Configuration>
+
+----
+
+2. Register the configuration files in `layer.xml`:
+
+[source,xml]
+----
+
+<?xml version="1.0"?>
+<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.0//EN"
+ "http://www.netbeans.org/dtds/filesystem-1_0.dtd">
+<filesystem>
+ <folder name="Toolbars">
+ <file name="Standard.xml" url="Standard.xml"/>
+ <file name="Developing.xml" url="Developing.xml"/>
+ </folder>
+</filesystem>
+
+----
+
+3. At runtime, set the toolbar configuration that you want:
+
+[source,java]
+----
+
+ToolbarPool.getDefault().setConfiguration("Developing");
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHideShowToolbar[http://wiki.netbeans.org/DevFaqHideShowToolbar] ,
+that was last modified by NetBeans user Tjansson
+on 2010-11-04T19:40:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowCreateAnActionObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowCreateAnActionObject.asciidoc
new file mode 100644
index 0000000..31c20e4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowCreateAnActionObject.asciidoc
@@ -0,0 +1,35 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowCreateAnActionObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/[http://wiki.netbeans.org/] ,
+that was last modified by NetBeans user
+on .
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations.asciidoc
new file mode 100644
index 0000000..ae584f9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+How can we reuse and organise existing actions in our menus or pop menus? Usually you need to know the original location of the action you want to use and then refer to it as shadow in your layer.xml file. This requires you to create such as file what you want less and less.
+
+Fortunately there is solution: use annotations such as @ActionReference, @ActionReferences and @ActionID. Their usage is obvious when you create your own actions, but how can they be used to refer to existing actions?
+
+Create an empty class that you will include in your module:
+
+[source,java]
+----
+
+ public class ActionsRefs {
+ }
+----
+
+Next annotate this class with @ActionReference, @ActionReferences:
+
+[source,java]
+----
+
+ @ActionReferences(value = {
+ @ActionReference(id = @ActionID(category = "System",
+ id = "org.openide.actions.FileSystemRefreshAction"),
+ path = "Console/Service/Brokers/Actions/MessageBus",
+ position = 200)})
+ class ActionsRefs {
+ }
+----
+
+This class will be used as action reference configuration and the annotation preprocessor will create the proper entries the the generated layer.xml file. Notice the embeded @ActionID? This refers to the existing Action.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations[http://wiki.netbeans.org/DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations] ,
+that was last modified by NetBeans user Jmborer
+on 2014-01-09T14:05:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowPackageLibraries.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowPackageLibraries.asciidoc
new file mode 100644
index 0000000..5a374ad
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowPackageLibraries.asciidoc
@@ -0,0 +1,75 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowPackageLibraries
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I need to package some third party libraries with my module. How do I do that?
+
+Generally if it's a third party library
+(you didn't write it, you can't or don't want to change it),
+you will want to use a wrapper module (see link:DevFaqWrapperModules.html[DevFaqWrapperModules]).
+An NBM file (a module packaged for delivery over the net)
+can contain more than one JAR,
+so all your libraries can be included in a single file that packages your module.
+
+Note you can multi-select JARs in the New Library Wrapper Module wizard.
+
+Since NetBeans 6.8 you can add, remove and assign sources and Javadoc to wrapped libraries in Project Properties dialog, Libraries / Wrapped JARs tab.
+
+==== Advanced stuff
+
+Before NB 6.8 you _could_ add libraries manually to a standard module;
+or add additional libraries to an existing library wrapper module.
+The relevant data is in the `project.xml` for the module.
+What you would do is add entries similar to this one for each JAR.
+
+[source,xml]
+----
+
+<class-path-extension>
+ <runtime-relative-path>ext/hexedit.jar</runtime-relative-path>
+ <binary-origin>release/modules/ext/hexedit.jar</binary-origin>
+</class-path-extension>
+----
+
+Note if you want these libraries to be usable outside of the module they're declared in,
+then you must add the relevant packages to the list of public packages for that module.
+
+<hr/>
+Applies to: NetBeans 6.8 and later
+
+== See also
+
+* link:PackagingADistributableJavaApp.html[Packaging A Distributable Java App]
+* link:DevFaqHowPackageLibraries_DE.html[German version]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowPackageLibraries[http://wiki.netbeans.org/DevFaqHowPackageLibraries] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-11T20:07:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToChangeSettingsFromAnExternalModules.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToChangeSettingsFromAnExternalModules.asciidoc
new file mode 100644
index 0000000..ba90e61
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToChangeSettingsFromAnExternalModules.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToChangeSettingsFromAnExternalModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do you change the configuration of other modules?
+
+Without adding a dependency to the other module?
+
+Once you found out the property file (from the userdir), where the setting is located, you can set the configuration via code:
+
+For example your setting in located in
+`config/Preferences/org/netbeans/modules/subversion.properties`
+
+a) So you can set it via the NbPreferences-API
+`
+NbPreferences.root().node("org/netbeans/modules/subversion")....
+`
+
+b) Or use the branding approach from link:http://wiki.netbeans.org/DevFaqPropertySheetHideDescription[http://wiki.netbeans.org/DevFaqPropertySheetHideDescription]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToChangeSettingsFromAnExternalModules[http://wiki.netbeans.org/DevFaqHowToChangeSettingsFromAnExternalModules] ,
+that was last modified by NetBeans user Markiewb
+on 2016-07-01T18:57:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToChangeUpdateCenterURL.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToChangeUpdateCenterURL.asciidoc
new file mode 100644
index 0000000..167b178
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToChangeUpdateCenterURL.asciidoc
@@ -0,0 +1,63 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToChangeUpdateCenterURL
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to change the update center URL via code?
+
+Use UpdateUnitProviderFactory [1]!
+`
+
+[source,java]
+----
+
+ List<UpdateUnitProvider> updateUnitProviders = UpdateUnitProviderFactory.getDefault().getUpdateUnitProviders(true);
+ for (int i = 0; i < updateUnitProviders.size(); i++) {
+ UpdateUnitProvider pr = updateUnitProviders.get(i);
+ String name = pr.getDisplayName();
+ if("MyUpdateCenter".equals(name)){
+ pr.setProviderURL(new URL("link:http://example.com/updateCenter[http://example.com/updateCenter]"));
+ pr.refresh(ProgressHandle.createHandle("UpdateCenter refresh"), true);
+ break;
+ }
+ }
+----
+
+`
+or
+
+link:https://github.com/testmycode/tmc-netbeans/blob/master/tmc-plugin/src/fi/helsinki/cs/tmc/actions/TmcModuleInstall.java#L105-L129[https://github.com/testmycode/tmc-netbeans/blob/master/tmc-plugin/src/fi/helsinki/cs/tmc/actions/TmcModuleInstall.java#L105-L129]
+
+[1] link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/api/autoupdate/UpdateUnitProviderFactory.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/api/autoupdate/UpdateUnitProviderFactory.html]
+Taken from platform-dev-mailing list 14.04.2016
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToChangeUpdateCenterURL[http://wiki.netbeans.org/DevFaqHowToChangeUpdateCenterURL] ,
+that was last modified by NetBeans user Markiewb
+on 2016-09-18T14:21:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToDefineTheKeyMapCategoryForAnAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToDefineTheKeyMapCategoryForAnAction.asciidoc
new file mode 100644
index 0000000..74a3fbb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToDefineTheKeyMapCategoryForAnAction.asciidoc
@@ -0,0 +1,159 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToDefineTheKeyMapCategoryForAnAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How do I define and localise the keymap category of an action?
+
+== Keymap category for @ActionID
+
+* The category of the @ActionID-annotation of the action defines the keymap category, which is shown in the keymap options. The category is the name of the "Actions"-subfolder within the layer.xml, which is generated from the annotations. From `@ActionID(category = "MyOwnLabel", id = "com.sample.MyAction")` the following layer.xml content is generated
+[source,xml]
+----
+
+<filesystem>
+ <folder name="Actions">
+ <folder name="MyOwnLabel">
+ <!-- action registration follows -->
+ </folder>
+ </folder>
+</filesystem>
+----
+
+* If you want to localise the category (or include a '/' in its name), then you have to use the attribute "`SystemFileSystem.localizingBundle`" for the folder. Create a layer.xml (via wizard), duplicate the folder structure and add the attribute for localisation. This explicit layer.xml file and the autogenerated layer.xml-file will be merged automatically. The referred bundle key is an absolute path based on the folder structure. For example: `Actions/MyOwnLabel=Shiny new category`
+
+*Example*
+The following action is shown in the localised "Shiny new category" category.
+
+image:keymapshinynewcategory.png[]
+
+[source,java]
+----
+
+package com.sample;
+
+import java.awt.event.ActionEvent;
+import java.awt.event.ActionListener;
+import org.openide.awt.ActionID;
+import org.openide.awt.ActionRegistration;
+import org.openide.util.NbBundle.Messages;
+
+@ActionID(
+ category = "MyOwnLabel",
+ id = "com.sample.MyAction"
+)
+@ActionRegistration(
+ displayName = "#CTL_MyAction"
+)
+@Messages("CTL_MyAction=Execute xyz")
+public final class MyAction implements ActionListener {
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ // TODO implement action body
+ }
+}
+----
+
+Excerpt of layer.xml:
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="Actions">
+ <folder name="MyOwnLabel">
+ <attr name="SystemFileSystem.localizingBundle" stringvalue="com.sample.Bundle"/>
+ </folder>
+ </folder>
+</filesystem>
+----
+
+Bundle:
+
+[source,java]
+----
+
+Actions/MyOwnLabel=Shiny new category
+----
+
+== Keymap category for @EditorActionRegistration
+
+The category of the @EditorActionRegistration-annotation of the action defines the keymap category (since NB 8.2 )
+
+The category is defined the subfolder in "OptionsDialog/Actions".
+
+[source,java]
+----
+
+@EditorActionRegistrations({
+ @EditorActionRegistration(name = "add-caret-up", category = "edit.multicaret")
+})
+public class AddCaretAction extends ... {
+}
+----
+
+Excerpt of layer.xml:
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="OptionsDialog">
+ <folder name="Actions">
+ <folder name="edit.multicaret">
+ <attr name="SystemFileSystem.localizingBundle" stringvalue="org.netbeans.modules.editor.actions.Bundle"/>
+
+ <file name="add-caret-up">
+ <!--org.netbeans.modules.editor.actions.AddCaretAction-->
+ </file>
+ </folder>
+ </folder>
+ </folder>
+</filesystem>
+----
+
+Bundle:
+
+[source,java]
+----
+
+OptionsDialog/Actions/edit.multicaret=Edit (Multicaret)
+----
+
+image:EditorActionRegistrationKeymapCategory.png[]
+
+== Other resources
+
+* link:http://blogs.kiyut.com/tonny/2007/08/04/netbeans-platform-i18n-and-localization/[http://blogs.kiyut.com/tonny/2007/08/04/netbeans-platform-i18n-and-localization/]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToDefineTheKeyMapCategoryForAnAction[http://wiki.netbeans.org/DevFaqHowToDefineTheKeyMapCategoryForAnAction] ,
+that was last modified by NetBeans user Markiewb
+on 2016-07-21T20:58:18Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToFixDependencies.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToFixDependencies.asciidoc
new file mode 100644
index 0000000..ad708c4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToFixDependencies.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToFixDependencies
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== My `project.xml` lists more dependencies than I really need. How can I fix it?
+
+As your code evolves, you may find that it no longer needs dependencies on some modules that it used to require.
+In this case, you can run the `fix-dependencies` Ant target on your module to remove any unnecessary dependencies from your `project.xml`.
+
+As with any automated modification, it's a good idea to ensure that this file is up-to-date in source control before running this task, although in an emergency you can use the IDE's local history feature to revert changes.
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToFixDependencies[http://wiki.netbeans.org/DevFaqHowToFixDependencies] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T15:06:07Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToOpenURL.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToOpenURL.asciidoc
new file mode 100644
index 0000000..03df323
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToOpenURL.asciidoc
@@ -0,0 +1,48 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToOpenURL
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to open a URL in the internal/default HTML browser?
+
+[source,java]
+----
+
+//Use
+HtmlBrowser.URLDisplayer.getDefault().showURL()
+//or
+HtmlBrowser.URLDisplayer.getDefault().showURLExternal()
+----
+
+See link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/HtmlBrowser.URLDisplayer.html#HtmlBrowser.URLDisplayer()[org-openide-awt/org/openide/awt/HtmlBrowser.URLDisplayer.html#HtmlBrowser.URLDisplayer()]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToOpenURL[http://wiki.netbeans.org/DevFaqHowToOpenURL] ,
+that was last modified by NetBeans user Markiewb
+on 2013-05-27T19:47:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToPrint.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToPrint.asciidoc
new file mode 100644
index 0000000..b18b863
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToPrint.asciidoc
@@ -0,0 +1,104 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToPrint
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Help the Print menu item is disabled!
+
+There are several ways to enable printing for a custom data:
+
+If the data is a Swing component which extends JComponent and shown in a TopComponent, the key PRINT_PRINTABLE with value "Boolean.TRUE" in the component must be set as a client property. See example:
+
+[source,java]
+----
+
+ public class MyComponent extends javax.swing.JComponent {
+ public MyComponent() {
+ ...
+ putClientProperty("print.printable", Boolean.TRUE); // NOI18N
+ }
+ ...
+ }
+----
+
+The key PRINT_NAME is used to specify the name of the component which will be printed in the header/footer:
+
+[source,java]
+----
+
+ putClientProperty("print.name", <name>); // NOI18N
+----
+
+If the key is not set at all, the display name of the top component is used by default. The content of the header/footer can be adjusted in the Print Options dialog.
+
+If the size of the custom component for printing differs from visual dimension, specify this with the key PRINT_SIZE:
+
+[source,java]
+----
+
+ putClientProperty("print.size", new Dimension(printWidth, printHeight)); // NOI18N
+----
+
+If the custom data is presented by several components, all of them can be enabled for print preview. The key PRINT_ORDER is used for this purpose, all visible and printable components are ordered and shown in the Print Preview dialog from the left to right:
+
+[source,java]
+----
+
+ putClientProperty("print.order", <order>); // NOI18N
+----
+
+If the custom data is presented by another classes, a PrintProvider should be implemented and put in the lookup of the top component where the custom data lives. How to put the Print action on custom Swing tool bar:
+
+[source,java]
+----
+
+ public class MyComponent extends javax.swing.JComponent {
+ ...
+ JToolBar toolbar = new JToolBar();
+ // print
+ toolbar.addSeparator();
+ toolbar.add(PrintManager.printAction(this));
+ ...
+ }
+----
+
+How does Print action from the main menu decide what to print?
+
+At first, the manager searches for PrintProvider in the lookup of the active top component. If a print provider is found, it is used by the print manager for print preview.
+
+Otherwise, it tries to obtain printable components among the descendants of the active top component. All found printable components are passed into the Print Preview dialog. Note that print method is invoked by the manager for preview and printing the component.
+
+If there are no printable components, printable data are retrieved from the selected nodes of the active top component. The Print manager gets EditorCookie from the DataObject of the Nodes. The StyledDocuments, returned by the editor cookies, contain printing information (text, font, color). This information is shown in the print preview. So, any textual documents (Java/C++/Php/... sources, html, xml, plain text, etc.) are printable by default.
+
+See link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-print/org/netbeans/api/print/PrintManager.html[PrintManager] javadoc for details.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToPrint[http://wiki.netbeans.org/DevFaqHowToPrint] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-14T17:08:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqHowToReuseModules.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqHowToReuseModules.asciidoc
new file mode 100644
index 0000000..3110013
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqHowToReuseModules.asciidoc
@@ -0,0 +1,131 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqHowToReuseModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want to reuse some of my modules in several RCP applications. How to do it?
+
+Assuming you are using version 6.8 or later, this is supported by the module development infrastructure:
+
+1. Open Suite B in the IDE
+2. Right-click on Suite B in the IDE
+3. Click properties
+4. Click libraries on the left of the suite properties dialog
+5. Click 'Add project...' at the bottom of the suite properties dialog
+6. Locate the directory containing the source code for Suite A
+
+You can then select which modules from suite A you want to include in suite B.
+
+Source: link:http://netbeans.org/projects/platform/lists/dev/archive/2010-03/message/652[posting by Tom Wheeler]
+
+=== I want to use modules from update center in my RCP applications. How to do it?
+
+It's possible to use non-netbeans.org modules (yours or 3rd party) directly in your suite and perform this configuration via the GUI. To do this, go to the `Properties` of your suite project, `Libraries` tab:
+
+image:reuse-modules-1_DevFaqHowToReuseModules.png[]
+
+If you have sources of modules you want to reuse, click `Add Project...` button and browse for the suite or standalone module project you want to add.
+
+If you want to use 3rd party binary modules, just unpack them into a cluster folder somewhere on your disk. Preferably put the cluster under your suite's root so that you can use relative paths, which makes setup in a team environment easier. Then click the `Add Cluster...` button and browse for the cluster folder:
+
+image:reuse-modules-2_DevFaqHowToReuseModules.png[]
+
+You can also add sources and/or Javadoc for binary modules, just like for the whole NetBeans Platform.
+
+Once projects and clusters are added to Libraries and checked, they behave just like part of the platform. They will appear in running platform application, will be included in binary distribution, modules from your suite can depend on them, etc.
+
+==== I cannot use 6.7 or newer platform, what to do?
+
+You can actually use older platform as long as you configure it to use newer harness (either via `Tools -> NetBeans Platforms` in IDE or by specifying link:DevFaqNbPlatformAndHarnessMixAndMatch.html[harness.dir]) and you develop in new enough IDE.
+
+If you cannot even use new harness and/or IDE, you have to use _suite chaining_, build your own platform and depend on it. See `harness/README` file for details. See also link:HowToReuseModules.html[HowToReuseModules].
+
+=== I want to use modules installed in my IDE in my RCP applications. How to do it?
+
+First make sure that you have the IDE to install the downloaded plugins into shared directories. To do this go to Tool>Plugins then the Settings tab. Enable the check box at the bottom in the advance section. You might be warned about not having permission to save files into a location. Just make sure to run NetBeans as an administrator.
+
+Now install the plugins you are interested in (using the Update center or manual install). They'll be installed in a different place within the NetBeans platform depending on the classification of the plugin. Verify in the platform, you might have a new cluster named extra.
+
+==== See also
+
+* link:DevFaqGeneralWhereIsPlatformHowToBuild.html[Where is the Platform and how can I build it?] for more details on how to add a custom platform for your application so the project is stand alone.
+
+=== Using an Update Center for a Stand Alone Module
+
+This was suggested as a patch but rejected (link:https://netbeans.org/bugzilla/show_bug.cgi?id=185283[https://netbeans.org/bugzilla/show_bug.cgi?id=185283])
+
+Add the following to the module's build.xml file:
+
+[source,xml]
+----
+
+<target name="create-update-center" depends="harness.taskdefs, nbm">
+ <mkdir dir="${update.dir}"/>
+ <pathfileset id="updater.jar">
+ <path refid="cluster.path.id"/>
+ <filename name="modules/ext/updater.jar"/>
+ </pathfileset>
+ <makeupdatedesc desc="${update.dir}/updates.xml" distbase="."
+automaticgrouping="true" uselicenseurl="${use.license.url.in.catalog}">
+ <fileset dir="./build">
+ <include name="*.nbm"/>
+ <include name="*.jar"/>
+ </fileset>
+ <updaterjar>
+ <resources refid="updater.jar"/>
+ </updaterjar>
+ </makeupdatedesc>
+ <!--Copy the files to the folder-->
+ <copy todir="${update.dir}">
+ <fileset dir="./build">
+ <include name="*.nbm"/>
+ <include name="*.jar"/>
+ </fileset>
+ </copy>
+ </target>
+----
+
+This will create an update center for the stand alone module!
+
+*Note:* Nothing magic about it. Just used the Netbeans task makeupdatedesc. Feel free
+to change the target name and change ./build with something smarter (I couldn't
+find a pre-defined variable for that in the stand alone modules).
+
+=== How to make global updates and updates into a custom target cluster/folder work in a NetBeans Platform application
+
+1. Set `nbm.is.global=true` and/or `nbm.target.cluster="yourtargetcluster"`
+
+2. Create an instance of `org.netbeans.spi.autoupdate.AutoupdateClusterCreator` as a service provider. Unless you have an appropriate `AutoupdateClusterCreator` service in your platform application, these properties have no effect and all updates will always be installed in the user dir! Unfortunately, this is poorly documented.
+
+The easy way to create one such `AutoupdateClusterCreator` was for me to adapt the source file of the default IDE implementation (link:http://hg.netbeans.org/main/file/tip/updatecenters/src/org/netbeans/modules/updatecenters/resources/NetBeansClusterCreator.java[http://hg.netbeans.org/main/file/tip/updatecenters/src/org/netbeans/modules/updatecenters/resources/NetBeansClusterCreator.java] ) to my own needs. Basically, all you have to do is replace one file name: "`netbeans.clusters`" must become "`yourbrandingappname.clusters`". You'll find the respective file in "`install-dir/etc`" of your application.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqHowToReuseModules[http://wiki.netbeans.org/DevFaqHowToReuseModules] ,
+that was last modified by NetBeans user Markiewb
+on 2017-01-04T22:22:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqI18nFileEncodingQueryObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqI18nFileEncodingQueryObject.asciidoc
new file mode 100644
index 0000000..35bc5c5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqI18nFileEncodingQueryObject.asciidoc
@@ -0,0 +1,78 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqI18nFileEncodingQueryObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Project Encoding vs. File Encoding - What are the precedence rules used in NetBeans 6.x?
+
+NetBeans implements the FileEncodingQuery object (FEQ) to determine the language encoding for projects and files. The *FEQ* is an interface for obtaining information about which encoding should be used for reading from/writing to a particular file. It can be best defined as a _layer model_ that adheres to the following precedence rules (level of importance from top to bottom):
+
+* *file FEQ*
+* *project FEQ*
+* *fallback FEQ*
+
+For example:
+
+1. When the client requests the FEQ for the encoding of some object, it first asks the file FEQ. E.g., when the file is XML or HTML, it looks inside the file and returns either the declared encoding attribute, otherwise `null`. If the file FEQ is not `null`, the value is returned to the client, otherwise it continues:
+2. If the file resides within a project that has implemented the FEQ, a request is made for the project FEQ. If the project FEQ is not `null`, the value is returned to the client, otherwise it continues:
+3. If neither the file FEQ nor project FEQ cannot provide any encoding information, the fallback FEQ is used. The fallback FEQ returns the language encoding used by the operating system (i.e. `Charset.defaultCharset()`).
+
+For JSP pages, the JSP parser is responsible for determining the encoding value. For example: if the file itself doesn't contain the encoding declaration, the parser looks in `web.xml`. If there is no declaration there either, it returns ISO-8859-1.
+
+==== What if the project encoding is not set (i.e. for projects that have not implemented the FEQ)?
+
+The fallback FEQ is applied (i.e. the encoding of the system locale). This applies to imported projects and projects created in NetBeans versions 5.x and prior.
+
+*Note*: This does not have any impact on the global project encoding value, which is still used for the creation of new NetBeans 6.x projects, and is by default UTF-8. Nor does this affect the encoding value of previously created NetBeans 6.x projects created during the same session, or opened projects created from previous sessions.
+
+==== What project or file types have/have not implemented FEQ for NetBeans 6.x?
+
+*Project Types*
+
+* Most NetBeans 6.x project types have implemented FEQ (this includes Ruby and Rails projects).
+* The NetBeans Modules project type uses UTF-8 and it is not possible to change the encoding for this project type.
+* UML does not have a project encoding property for NetBeans 6.x, and uses the encoding of the system locale. For UML Java projects that have been reverse-engineered or have had their code generated, the FEQ is applied to query for file encoding. If no information is returned, the encoding of the system locale is used.
+
+*File Types*
+
+* The seeding of encoding for JSP, HTML, and XML files has been completed. For XML it has been completed for most XML-based file types that can be created using the New File wizard, but not for all XML files created by projects for internal data. Other XML files created and used by various projects (e.g. `web.xml`, `sun-config.xml`) still use UTF-8; it has currently not been decided whether these files should use the encoding applied to the value of the project encoding or not.
+* The Visual Web index page currently has the encoding value seeded according to the project encoding value.
+* Properties files have a special encoding defined which translates between escape sequences and real characters. During saving, all non-ASCII characters are translated to the corresponding `\u....` sequences and than the result is saved using encoding ISO-8859-1 (aka Latin 1). During loading, the decoding process is reverse - the file is first decoded using the ISO-8859-1 encoding and then it is parsed such that the `\u....` sequences are recognized and translated back to the corresponding Unicode characters. This special encoding cannot be changed.
+
+Applies to: Netbeans 6.x
+
+Platforms: All
+
+See also:
+link:FaqI18nProjectEncoding.html[How do I set or modify the language encoding for a project?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqI18nFileEncodingQueryObject[http://wiki.netbeans.org/DevFaqI18nFileEncodingQueryObject] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:13:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqIdeWelcome.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqIdeWelcome.asciidoc
new file mode 100644
index 0000000..bc5d7fd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqIdeWelcome.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqIdeWelcome
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I fix problems about 'ide.welcome'?
+
+'ide.welcome' is the map ID of the first help topic shown in the JavaHelp window. It is defined in the 'userguide' module. If you have excluded this module, you need to define this map ID yourself, otherwise you will encounter unexpected/unpleasant behavior:
+
+link:http://www.netbeans.org/issues/show_bug.cgi?id=153793[http://www.netbeans.org/issues/show_bug.cgi?id=153793]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqIdeWelcome[http://wiki.netbeans.org/DevFaqIdeWelcome] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:46:40Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqIdentifyMain.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqIdentifyMain.asciidoc
new file mode 100644
index 0000000..c778751
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqIdentifyMain.asciidoc
@@ -0,0 +1,87 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqIdentifyMain
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I identify the "main project"?
+
+[source,java]
+----
+
+Project mainProject = org.netbeans.api.project.ui.OpenProjects.getDefault().getMainProject();
+----
+
+For this, you need to declare dependencies on Project UI API, Project API and File System API.
+
+As an example usage of the above line of code, here is an action that display a JOptionPane containing the path to the main project, if a project is selected:
+
+[source,java]
+----
+
+public final class ShowMainProjectAction extends CookieAction {
+
+ protected void performAction(Node[] activatedNodes) {
+ String projectPath = OpenProjects.getDefault().getMainProject().getProjectDirectory().getPath();
+ JOptionPane.showMessageDialog(null, projectPath);
+ }
+
+ protected int mode() {
+ return CookieAction.MODE_EXACTLY_ONE;
+ }
+
+ public String getName() {
+ return NbBundle.getMessage(ShowMainProjectAction.class, "CTL_ShowMainProjectAction");
+ }
+
+ protected Class[] cookieClasses() {
+ return new Class[]{Project.class};
+ }
+
+ @Override
+ protected void initialize() {
+ super.initialize();
+ // see org.openide.util.actions.SystemAction.iconResource() Javadoc for more details
+ putValue("noIconInMenu", Boolean.TRUE);
+ }
+
+ public HelpCtx getHelpCtx() {
+ return HelpCtx.DEFAULT_HELP;
+ }
+
+ @Override
+ protected boolean asynchronous() {
+ return false;
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqIdentifyMain[http://wiki.netbeans.org/DevFaqIdentifyMain] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:46:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqImagesForDarkLaf.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqImagesForDarkLaf.asciidoc
new file mode 100644
index 0000000..52dc195
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqImagesForDarkLaf.asciidoc
@@ -0,0 +1,131 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqImagesForDarkLaf
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to provide non-inverted images for dark LookAndFeels like DarkMetal/Darcula?
+
+== In short
+
+* All images will be inverted, when using a DarkLaF with an image filter applied and ImageUtilities is used
+* If you don't like the inverted image/icon, then provide a image using "_dark" in its name. It will be used without any filter applied.
+
+== Details
+
+LaFs like DarkMetal/Darcula "invert" the colors of all the images/icons via an image filter set like `UIManager.put("nb.imageicon.filter", new DarkIconFilter())`
+
+This filter is used when loading images/icons via
+`org.openide.util.ImageUtilities#loadImageIcon` and `org.openide.util.ImageUtilities#loadImage`.
+
+=== You do not like the inverted colors? Provide your own images!
+
+But there are cases, you don't want to get your image inverted.
+
+For example in the following screenshot you do not want the NB logo in the about dialog to be inverted!
+image:YouDontwantyourImageinverted.jpg[]
+
+In this case provide an image with a specific name scheme. Add "`_dark`" to the name. This image is taken as it is and no filter will be applied.
+
+*Scheme:*
+
+* `about.png` -> `about_dark.png`
+* But be aware of brandings! Then it must be `about_dark_BRANDING.png`
+
+=== It still does not work? Migrate from ImageIcon...
+
+Check that your code really loads the images via `org.openide.util.ImageUtilities#loadImageIcon` and `org.openide.util.ImageUtilities#loadImage`!
+
+Dialogs built using the Mantisse GUI Builder often use `new javax.swing.ImageIcon` constructs.
+
+So here some replacements patterns to migrate such dialogs.
+
+[source,xml]
+----
+
+
+// within *.java
+new javax\.swing\.ImageIcon\(getClass\(\)\.getResource\("(.+?)"\)\)
+// with
+org.openide.util.ImageUtilities.loadImageIcon\("$1", false\)
+
+// within *.form
+<Property name="icon" type="javax.swing.Icon" editor="org.netbeans.modules.form.editors2.IconEditor">
+// with
+<Property name="icon" type="javax.swing.Icon" editor="org.netbeans.modules.form.RADConnectionPropertyEditor">
+
+// within *.form
+<Image iconType="3" name="(.*?)"/>
+with
+<Connection code="org.openide.util.ImageUtilities.loadImageIcon\(&amp;quot;$1&amp;quot;, false\)" type="code"/>
+
+----
+
+=== Examples
+
+Without Invert:
+
+image:LafWithoutInvert.png[]
+
+With Invert enabled and *_dark.png for the logo and startpage images:
+
+image:LafWithInvert.png[]
+
+== Related issues
+
+=== Handling Branding
+
+Platform applications using Dark Look And Feels require the following for branding-related image adjustments (as discussed in link:http://forums.netbeans.org/topic66964.html[http://forums.netbeans.org/topic66964.html]):
+
+1. For frame images, the images must be named using the _dark suffix (frame_dark.gif, frame32_dark.gif, and frame48_dark.gif).
+2. For splash images, both a dark and non-dark version are required (splash.gif, splash_dark.gif).
+
+These images are typically found in the branding/core/core.jar/org/netbeans/core/startup folder for the application.
+
+As of Netbeans 8.2, the Branding dialog within the Netbeans IDE is not designed for these dark theme image requirements. Users using a dark theme will want to make image name changes directly within the filesystem to meet these requirements.
+
+=== Handling textareas/textfields
+
+If you have displaying issues with your controls, try to set the `HONOR_DISPLAY_PROPERTIES`-clientproperty.
+
+`
+
+[source,java]
+----
+
+pane.putClientProperty(JEditorPane.HONOR_DISPLAY_PROPERTIES, Boolean.TRUE);
+//and/or
+pane.putClientProperty(JTextPane.HONOR_DISPLAY_PROPERTIES, Boolean.TRUE);
+----
+
+`
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqImagesForDarkLaf[http://wiki.netbeans.org/DevFaqImagesForDarkLaf] ,
+that was last modified by NetBeans user Markiewb
+on 2016-12-19T22:06:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqImplementFilesystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqImplementFilesystem.asciidoc
new file mode 100644
index 0000000..ccad785
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqImplementFilesystem.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqImplementFilesystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I'm having trouble implementing this filesystem....
+
+Be sure that what you really want to be doing is implement link:http://www.netbeans.org/download/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileSystem.html[FileSystem]. Unless you really need to access objects in a database, remote server, or some other such storage as if they were files, you are probably heading in the wrong direction.
+
+If you do need to implement a FileSystem, you should probably start with link:http://www.netbeans.org/download/dev/javadoc/org-openide-filesystems/org/openide/filesystems/AbstractFileSystem.html[AbstractFileSystem] - it handles a lot of knotty locking semantics correctly and will save you a lot of time, effort and bugs.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqImplementFilesystem[http://wiki.netbeans.org/DevFaqImplementFilesystem] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:46:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqImplementationDependency.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqImplementationDependency.asciidoc
new file mode 100644
index 0000000..0d6bd78
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqImplementationDependency.asciidoc
@@ -0,0 +1,227 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqImplementationDependency
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is an implementation dependency and when should I use one?
+
+Normally modules interact with one another using _public packages_: a module can (indeed, must) declare which, if any, of its Java packages are intended to be visible to other modules. When you declare a specification dependency on another module, you only get access to the public packages. This kind of dependency looks like this in the JAR manifest (which is normally constructed from `nbproject/project.xml` in sources):
+
+[source,java]
+----
+
+OpenIDE-Module-Module-Dependencies: some.other.module > 1.5
+----
+
+(requesting version 1.5 or greater of `some.other.module`) or like this:
+
+[source,java]
+----
+
+OpenIDE-Module-Module-Dependencies: some.other.module
+----
+
+(requesting any version; not recommended).
+
+Occasionally you may find that the author of a module neglected to expose certain classes in public packages which you know (from reading the source code) that you need to use and know how to use properly. The classes are public but not in declared public packages. It is _possible_ to access these classes if you really have to. But you need to declare a dependency on that _exact_ version of the other module, since such classes might change incompatibly without notice in a newer copy of that module. Since such a change could break your module, the NB module system requires that you declare the implementation dependency so that it can verify _before_ loading your module that it matches the other module. The general idea is that if module B has an implementation dependency on module A, the system should not be able to load B unless it has the exact same version of A that B was compiled against. To make an implementation dependency in the manifest, use
+
+[source,java]
+----
+
+OpenIDE-Module-Module-Dependencies: some.other.module = 3
+----
+
+where the "3" is what that other module declared as its current implementation version:
+
+[source,java]
+----
+
+OpenIDE-Module-Implementation-Version: 3
+----
+
+In order to add an implementation dependency, first add the dependency to the project (e.g. click on "Add Module Dependency" from the "Libraries" node or by click the "Add Dependency..." button in Project->Properties->Libraries panel). Make sure you've checked the "Show Non-API Modules" checkbox when you're looking for the non-API module, otherwise you're not going to find it. Then, after you've added the module as a dependency, edit the dependency (either Project->Properties->Libraries->Select Dependency->Edit or Project->Right click on dependency Libraries node->Edit) and just select the "Implementation Version" radio box in the Edit dependency dialog. If you don't want to "see" all packages within the module, but only a subset, uncheck the "Include Packages in Classpath" checkbox and select the packages you want to see. This works best if the other module uses a nonnegative integer for the implementation version, and if you also check *Append Implementation Versions Automatically
* in the properties dialog.
+
+Implementation dependencies are to be avoided unless you _really_ need access to all the classes in another module, for the following reason: If your module has an implementation dependency on module A, and module A is upgraded, your module probably must be upgraded as well, or the system will not load it (assuming module A's implementation version has changed with the upgrade - it should have). It is a particularly bad idea to use implementation dependencies if you do not know what the other module's author's intentions are for keeping the classes you use available and compatible. It is always possible to make an enhancement request asking for the other module to make the classes you want to use available publicly. Do not use implementation dependencies just to have access to one or two some convenience or utility classes in another module - copy them instead, and file a bug report asking for an API for doing what you're trying to do.
+
+==== Friend dependencies
+
+_Friend dependencies_ are a little different. A module may have an API which its author is not yet comfortable exposing to just anyone - it might not be fully stabilized yet. In this case, the module with the API can declare some public packages, but also stipulate that only a predefined list of "friend modules" are permitted to use them. The friend modules just declare a regular specification version dependency, but unknown modules are not permitted to use any packages from the API module without an implementation dependency.
+
+(Look at the *Versioning* panel in the API module's project *Properties* dialog.)
+
+_Always prefer friend APIs to implementation dependencies where there is a choice._
+
+==== Implementation dependencies, Auto Update, and <verifyupdatecenter>
+
+Implementation dependencies cause special problems for Auto Update. (Some background information is available in link:http://openide.netbeans.org/versioning-policy.html#3[NetBeans API &amp; Module Versioning Policy / Numbering Scheme for Updates].)
+
+The problem is that when an implementation version of a module published to an update server changes, any modules declaring implementation dependencies on it must also be published, with dependencies on the new version of the base module. Furthermore, the Auto Update client has just one method for deciding whether an NBM on a server is an "update" relative to what you already have installed: if its specification version is larger. So consider the following snapshot of an update center. (The syntax is not what the actual XML file looks like, just an abbreviated version that shows parts relevant to this example.)
+
+[source,java]
+----
+
+[Monday]
+
+OpenIDE-Module: infrastructure
+OpenIDE-Module-Specification-Version: 1.0
+OpenIDE-Module-Implementation-Version: 070120
+
+OpenIDE-Module: guifeature
+OpenIDE-Module-Specification-Version: 1.0
+OpenIDE-Module-Implementation-Version: 070120
+OpenIDE-Module-Module-Dependencies: infrastructure = 070120
+----
+
+These two modules were built at the same time and could be installed together into a NetBeans instance. So far so good.
+
+Now consider what happens when the developer of `guifeature` adds a major new feature and decides to publish a new version, `1.1`. The next day's build produces
+
+[source,java]
+----
+
+[Tuesday]
+
+OpenIDE-Module: infrastructure
+OpenIDE-Module-Specification-Version: 1.0
+OpenIDE-Module-Implementation-Version: 070121
+
+OpenIDE-Module: guifeature
+OpenIDE-Module-Specification-Version: 1.1
+OpenIDE-Module-Implementation-Version: 070121
+OpenIDE-Module-Module-Dependencies: infrastructure = 070121
+----
+
+Again, these two modules could be installed together.
+
+But what if a user connected to the update center on Monday and downloaded both modules, and then connects again on Tuesday looking for updates? `infrastructure` is still listed as `1.0` so Auto Update ignores it (`1.0` is "already installed", after all). `guifeature 1.1` is however a possible update. What if you install this update? The module system will refuse to enable `guifeature` because it requests `infrastructure = 070121`, whereas you have `infrastructure = 070120`. Oops!
+
+The solution (short of not using implementation dependencies at all) is to use the NetBeans build harness to compute a specification version. The developer removes `OpenIDE-Module-Specification-Version` from `manifest.mf` in the source projects for _both_ modules. `manifest.mf` for `infrastructure` instead will get
+
+[source,java]
+----
+
+OpenIDE-Module-Implementation-Version: 1
+----
+
+(only positive integers 1, 2, ... are supported!). And `nbproject/project.properties` for both modules will get the specification version in a new form:
+
+[source,java]
+----
+
+spec.version.base=1.0.0
+----
+
+The IDE's GUI for module projects lets you do all this without editing metadata files manually; just click the option *Append Implementation Versions Automatically* in the *Versioning* panel of the *Properties* dialog.
+
+(The extra `.0` is required for modules in the NetBeans distribution. When sources are branched for a release, `spec.version.base` is incremented to `1.0.1`, `1.0.2`, ... for each release on the branch. "Trunk" (development) changes increment the first or second digits, e.g. `1.1.0`, `1.2.0`, ...)
+
+The effect of using `spec.version.base` is that our AU snapshots now look like this instead:
+
+[source,java]
+----
+
+[Monday]
+
+OpenIDE-Module: infrastructure
+OpenIDE-Module-Specification-Version: 1.0.0.1
+OpenIDE-Module-Build-Version: 070120
+OpenIDE-Module-Implementation-Version: 1
+
+OpenIDE-Module: guifeature
+OpenIDE-Module-Specification-Version: 1.0.0.1
+OpenIDE-Module-Implementation-Version: 070120
+OpenIDE-Module-Module-Dependencies: infrastructure = 1
+
+[Tuesday]
+
+OpenIDE-Module: infrastructure
+OpenIDE-Module-Specification-Version: 1.0.0.1
+OpenIDE-Module-Build-Version: 070121
+OpenIDE-Module-Implementation-Version: 1
+
+OpenIDE-Module: guifeature
+OpenIDE-Module-Specification-Version: 1.1.0.1
+OpenIDE-Module-Implementation-Version: 070121
+OpenIDE-Module-Module-Dependencies: infrastructure = 1
+----
+
+The update to `guifeature` is now safe; it can still use `infrastructure` from Monday. Note the new "build version" tag which is used only for diagnostics, not for dependencies.
+
+If there is actually a change in the signature of anything in `infrastructure` that might affect `guifeature`, then the developer merely needs to increment the implementation version in `infrastructure/manifest.mf`:
+
+[source,java]
+----
+
+[Wednesday]
+
+OpenIDE-Module: infrastructure
+OpenIDE-Module-Specification-Version: 1.0.0.2
+OpenIDE-Module-Build-Version: 070122
+OpenIDE-Module-Implementation-Version: 2
+
+OpenIDE-Module: guifeature
+OpenIDE-Module-Specification-Version: 1.1.0.2
+OpenIDE-Module-Implementation-Version: 070122
+OpenIDE-Module-Module-Dependencies: infrastructure = 2
+----
+
+If the user connects to the update center on Wednesday, the wizard will display both modules as needing to be updated - which is exactly what you want.
+
+How is this system enforced? For one thing, attempts to use inherently unsafe implementation dependencies, or incorrect uses of `spec.version.base`, should produce warnings during the module build process. So look at the output of Ant once in a while and see if the build harness is telling you something.
+
+There is also a continuous builder at link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/[http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/] which (among other things) tries to build NBMs for all modules in the NetBeans standard distribution plus those experimental "alpha" modules normally published on the update center for development builds. If you commit changes to experimental modules this build will be triggered; failures are mailed to `broken_builds@netbeans.org`, which all developers of modules in netbeans.org ought to subscribe to.
+
+This builder uses an Ant task `<verifyupdatecenter>` to detect dependency problems among NBMs. There are two checks:
+
+1. Can the NBMs just built all be enabled together? (_synchronic consistency_)
+2. Suppose I had connected to the update center produced by the previous successful build and installed everything, and now I connected again to this build's update center and asked for all updates. Would any updated modules be broken, due to dependencies on new versions of other modules which were not updated? (_diachronic consistency_)
+
+The second check is what will catch a lot of mistakes in usage of implementation dependencies as described above. Unfortunately it is not feasible to run the second check as part of an offline build process in your own source checkout, as it depends on a build of older sources; so you will need to commit changes and wait for the next build to verify them.
+
+Generally there are two possible solutions to a
+link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/testReport/org.netbeans.nbbuild/VerifyUpdateCenter/[test failure]
+from this stage:
+
+1. Remove the implementation dependencies; switch to friend dependencies or public APIs.
+2. Ensure that all implementation dependencies are against positive integers (not dates), and that `spec.version.base` is used on _both_ sides of the dependency, as described above.
+
+In either case, to fix a test failure
+you will generally also need to increment the specification versions
+of modules on _both_ sides of the dependency.
+
+<hr/>
+
+Applies to: NetBeans 5.x, 6.x
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqImplementationDependency[http://wiki.netbeans.org/DevFaqImplementationDependency] ,
+that was last modified by NetBeans user Jglick
+on 2011-08-03T14:59:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqInitialMainWindowSize.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqInitialMainWindowSize.asciidoc
new file mode 100644
index 0000000..e812c20
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqInitialMainWindowSize.asciidoc
@@ -0,0 +1,84 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqInitialMainWindowSize
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I adjust the initial size/position of the main window?
+
+The default initial size of an application based on NetBeans platform is 90% of the whole screen area and the main window is also centered. These defaults can be redefined quite easily:
+
+* make sure your module has implementation dependency on Core - Windows module, when using NetBeans 6.9 you can use 'weight' attribute instead of implementation dependency.
+* copy file _WindowManager.wswmgr_ from Core - Windows module into the source folder of your own module (you'll find it in folder _core.windows\src\org\netbeans\core\windows\resources\windowmanager_)
+* reference the copied file in your module's XML Layer:
+[source,xml]
+----
+
+ <folder name="Windows2">
+ <file name="WindowManager.wswmgr" url="WindowManager.wswmgr"/>
+ </folder>
+----
+
+* now you can specify either size relative to the size of the whole screen area (the main window will be centered then) which will work on any screen resolution:
+[source,xml]
+----
+
+ <main-window>
+ <joined-properties centered-horizontally="true" centered-vertically="true"
+ relative-width="0.5" relative-height="0.5" />
+ <separated-properties centered-horizontally="true" relative-y="0.1"
+ relative-width="0.8" relative-height="0.08" />
+ </main-window>
+----
+
+The snippet from _windowmanager.wswmgr_ above makes the default main window size to be half of the whole screen area.
+
+* or you can specify exact size and location in pixels:
+[source,xml]
+----
+
+ <main-window>
+ <joined-properties x="0" y="0" width="800" height="600"
+ relative-x="0.0" relative-y="0.0" relative-width="0.0" relative-height="0.0" centered-horizontally="false" centered-vertically="false"
+ maximize-if-width-below="0" maximize-if-height-below="0" frame-state="6"/>
+ <separated-properties x="160" y="116" width="1280" height="93"
+ relative-x="0.0" relative-y="0.0" relative-width="0.0" relative-height="0.0" centered-horizontally="false" centered-vertically="false" frame-state="0" />
+ </main-window>
+----
+
+The snippet from _windowmanager.wswmgr_ above opens the main window in the upper left corner of the screen and makes its size 800x600 pixels.
+
+* you can safely ignore _separated-properties_ part, those properties were used for SDI mode which is no longer supported.
+* keep the rest of _windowmanager.wswmgr_ as it was
+
+*Note:* This way you can also define the default main window state - maximized/minimized/restored, see link:http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Frame.html#setExtendedState(int)[JavaDoc] for possible values.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqInitialMainWindowSize[http://wiki.netbeans.org/DevFaqInitialMainWindowSize] ,
+that was last modified by NetBeans user Simpatico
+on 2010-11-02T01:43:02Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqInput.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqInput.asciidoc
new file mode 100644
index 0000000..42be80b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqInput.asciidoc
@@ -0,0 +1,140 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqInput
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+This is an example on how to get inout from the Output Window. Just change what's done on the read method (listener implementation) to customize the behavior. Things that come to mind: chat client, text based games, etc...
+
+[source,java]
+----
+
+/*
+ * Enable/create the tabs we need for the component
+ */
+package sample.component;
+
+import com.dreamer.outputhandler.InputMonitor;
+import com.dreamer.outputhandler.OutputHandler;
+import org.jivesoftware.smack.util.ReaderListener;
+import org.openide.modules.ModuleInstall;
+import org.openide.windows.WindowManager;
+
+/**
+ * Manages a module's lifecycle. Remember that an installer is optional and
+ * often not needed at all.
+ */
+public class Installer extends ModuleInstall implements ReaderListener {
+
+ private final String normal = "Output";
+
+ @Override
+ public void restored() {
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable() {
+
+ @Override
+ public void run() {
+ OutputHandler.output(normal, "Welcome! Type something below.");
+ //Create a monitor for the tab. This enables input in the tab as well.
+ InputMonitor monitor = OutputHandler.createMonitor(normal);
+ //Add a listener to be notified.
+ monitor.addListener(Installer.this);
+ }
+ });
+ }
+
+ @Override
+ public void read(String read) {
+ OutputHandler.output(normal, "You typed: " + read);
+ }
+}
+----
+
+*Note: *This is feature is available on the link:http://plugins.netbeans.org/plugin/39695/?show=true[Output Handler plugin] version 1.2.
+
+== Example of using input reader in output window
+
+[source,java]
+----
+
+package sample.component;
+
+import java.awt.EventQueue;
+import java.io.BufferedReader;
+import java.io.IOException;
+import org.openide.util.Exceptions;
+import org.openide.util.RequestProcessor;
+import org.openide.windows.IOProvider;
+import org.openide.windows.InputOutput;
+import org.openide.windows.OnShowing;
+
+@OnShowing
+public class OutputWindowReaderExample implements Runnable {
+
+ /**
+ * Open Output Window and ask for some input.
+ */
+ public static void requestAnswerExample() throws IOException {
+ assert !EventQueue.isDispatchThread();
+ InputOutput io = IOProvider.getDefault().getIO("ioName", true);
+ io.select();
+ io.getOut().println("How are you?");
+ BufferedReader br = new BufferedReader(io.getIn());
+ String answer = br.readLine();
+ io.getOut().println("You are " + answer + " today");
+ br.close();
+ io.getOut().close();
+ io.getErr().close();
+ }
+
+ /**
+ * Call requestAnswerExample from a background thread, after initialization
+ * of the user interface.
+ */
+ @Override
+ public void run() {
+ RequestProcessor.getDefault().post(new Runnable() {
+ @Override
+ public void run() {
+ try {
+ requestAnswerExample();
+ } catch (IOException ex) {
+ Exceptions.printStackTrace(ex);
+ }
+ }
+ });
+ }
+}
+----
+
+*Note:* The module that contains this class depends on Window System API (org.openide.windows).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqInput[http://wiki.netbeans.org/DevFaqInput] ,
+that was last modified by NetBeans user Jhavlin
+on 2012-10-17T11:51:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqInstalledFileLocator.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqInstalledFileLocator.asciidoc
new file mode 100644
index 0000000..5cfabf2
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqInstalledFileLocator.asciidoc
@@ -0,0 +1,76 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqInstalledFileLocator
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I bundle some additional files with my module? If so, how can I find those files to use them from my module?
+
+Sometimes you need to bundle some additional files with your module (for example native libraries or native executables).
+
+==== Bundling External File With Your Module
+
+NetBeans provides a simple and straightforward way to bundle whatever files you want into a module project:
+
+* Create a folder in your project root directory called `release/` (note this means the _project root_—the directory containing `src/` and `nbproject/` and `MANIFEST.MF`, _not_ the source root directory of your module project!)
+* Put anything you want bundled with your module in that directory or a subdirectory of `release/`
+* The entire subtree of this folder will be included in your link:DevFaqWhatIsACluster.html[cluster] and bundled into your module's link:DevFaqWhatIsNbm.html[NBM file]
+* Note that if what you are adding is a native library (DLL, .so file, etc.) there is link:DevFaqNativeLibraries.html[a specific place to put this]
+* If the thing you are bundling can change (for example, you are bundling a library you wrote, and you may make changes to that library and recompile it), you may want to override your module's `release-files` to rebuild/re-copy that library (i.e. `<target name="release" depends="compile-lib,projectized-common.release"/>` and then create your own `compile-lib` target that rebuilds the library and copies it somewhere under `release/` in your module project.
+
+The result is:
+
+* the files you are bundling are included in your _module_
+* Note that this does not mean they will be inside your module's JAR file (that would not be useful)
+* They will be bundled _with_ your module's JAR file and will be in a findable location at runtime (see below).
+
+_Note:_ If you are bundling third party software which *has its own installer* there is link:DevFaqUseNativeInstaller.html[a way to run that installer during module installation].
+
+==== Finding External Files At Runtime
+
+Now your module includes the files you need. You still need to get access to them at runtime.
+
+To do that, use `link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/InstalledFileLocator.html[InstalledFileLocator]`. That is a class which can find a file which was installed by a module. You simply give it your module's code-name (the thing you typed when you created the module, which looks like a package name) and a _relative path_ (i.e. not including the `release/` directory):
+
+[source,java]
+----
+
+File emulator = InstalledFileLocator.getDefault().locate(
+ "javacard/bin/jcre.exe",
+ "org.netbeans.modules.javacard.referenceimpl",
+ false);
+----
+
+Always handle the case that the user (or disk crash, whatever) might have deleted it.
+
+If you are wondering why you don't just find the directory NetBeans is installed in and look in that directory, see the link:DevFaqWhatIsACluster#Why_Have_Clusters.3F.html[background information about clusters]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqInstalledFileLocator[http://wiki.netbeans.org/DevFaqInstalledFileLocator] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:11:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqInstanceDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqInstanceDataObject.asciidoc
new file mode 100644
index 0000000..f252e63
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqInstanceDataObject.asciidoc
@@ -0,0 +1,93 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqInstanceDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are `*.instance` files?
+
+`*.instance` files represent an "instance", i.e. arbitrary Java object.
+
+An instance file typically says what class it is an instance of via its class name - for example,
+`com-foo-mymodule-MyObject.instance`.
+A `*.instance` file may create its instance from any Java class
+with a default constructor, or by calling a static method on a class.
+
+In NetBeans infrastructure, `*.instance` files result in `InstanceDataObject`s.
+`InstanceDataObject`s can supply `InstanceCookie`s,
+which in turn instantiate the object.
+So, code to actually get an instance of an object declared in the system filesystem (link:DevFaqSystemFilesystem.html[DevFaqSystemFilesystem]) would look like this (plus error checking):
+
+[source,java]
+----
+
+public static Object getTheObject(String pathInSystemFilesystem) throws Exception {
+ return DataObject.find(FileUtil.getConfigFile(pathInSystemFilesystem)).
+ getLookup().lookup(InstanceCookie.class).instanceCreate();
+}
+----
+
+(FileUtil.getConfigObject is available for this purpose in NB 7.1+.)
+
+A much easier way to get all instances of objects in a folder exists:
+
+[source,java]
+----
+
+for (WhatISaidToPutHere instance :
+ Lookups.forPath("MyFolder").lookupAll(WhatISaidToPutHere.class)) {
+ // ...
+}
+----
+
+Note that a default constructor is not required in an XML layer; you can also use a static method, using the following syntax:
+
+[source,xml]
+----
+
+<file name="ObjectTypes.instance">
+ <attr name="instanceCreate" methodvalue="org.netbeans.core.ui.UINodes.createObjectTypes"/>
+ <attr name="instanceOf" stringvalue="org.openide.nodes.Node"/>
+</file>
+----
+
+(The `instanceOf` attribute is optional;
+it lets the system avoid instantiating your object just to see if it is assignable to `Node`.
+This is only useful in folders that contain objects of many different types mixed together,
+which is normally true only in the semi-deprecated `Services` folder:
+code looking for instances of one type only would rather not load everything.)
+
+See also: link:DevFaqDotSettingsFiles.html[DevFaqDotSettingsFiles]
+
+<hr/>
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqInstanceDataObject[http://wiki.netbeans.org/DevFaqInstanceDataObject] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-13T23:58:07Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqInvokeActionProgrammatically.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqInvokeActionProgrammatically.asciidoc
new file mode 100644
index 0000000..0945fb1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqInvokeActionProgrammatically.asciidoc
@@ -0,0 +1,74 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqInvokeActionProgrammatically
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I invoke an action programmatically?
+
+Use `FileUtil.getConfigObject()`
+
+[source,java]
+----
+
+//provide the path to your action instance
+Action action = FileUtil.getConfigObject("Actions/Window/org-netbeans-core-windows-actions-MaximizeWindowAction.instance", Action.class);
+action.actionPerformed(ev);
+----
+
+or
+
+[source,java]
+----
+
+//provide the path to the action folder
+List<? extends Action> actions = org.openide.util.Utilities.actionsForPath("Navigation/Hierarchy/text/x-java/Actions")
+//Bonus: Create a popupmenu from these actions
+//Action[] aactions = actions.toArray(new Action[]{});
+//JPopupMenu menu = Utilities.actionsToPopup(aactions, getLookup());
+----
+
+or `Actions.forID()` (since NB 7.2)
+
+[source,java]
+----
+
+//provide category and classname
+Action action=org.openide.awt.Actions.forID("Window", "org.netbeans.core.windows.actions.MaximizeWindowAction");
+action.actionPerformed(ev);
+----
+
+See
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#getConfigObject(java.lang.String,%20java.lang.Class[http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#getConfigObject(java.lang.String,%20java.lang.Class])
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/Actions.html#forID(java.lang.String,%20java.lang.String[http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/Actions.html#forID(java.lang.String,%20java.lang.String])
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqInvokeActionProgrammatically[http://wiki.netbeans.org/DevFaqInvokeActionProgrammatically] ,
+that was last modified by NetBeans user Markiewb
+on 2016-07-23T12:51:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJSeparatorInMainToolbar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJSeparatorInMainToolbar.asciidoc
new file mode 100644
index 0000000..fa54754
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJSeparatorInMainToolbar.asciidoc
@@ -0,0 +1,77 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJSeparatorInMainToolbar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I add a JSeparator to the main toolbar?
+
+It's easy to add a separator to the menus by editing the module's layer file; in fact, the Action wizard will do this for you. Items in the main toolbar are also configured through the layer file, but you may find that adding a separator as you would for the menu does not work in the toolbar. So how do you add a separator to the toolbar?
+
+You can do this by creating a class like:
+
+[source,java]
+----
+
+package com.example.util.widgets;
+
+public class VerticalSeparator extends JSeparator {
+
+ public VerticalSeparator() {
+ super(JSeparator.VERTICAL);
+ }
+
+ @Override
+ public Dimension getMaximumSize() {
+ return new Dimension(getPreferredSize().width, super.getMaximumSize().height);
+ }
+
+ @Override
+ public Dimension getSize() {
+ return new Dimension(getPreferredSize().width, super.getSize().height);
+ }
+}
+
+----
+
+Then simply reference an instance of this separator in the layer file:
+
+[source,xml]
+----
+
+<file name="SeparatorAfterModelToolbarActions.instance">
+ <attr name="instanceClass" stringvalue="com.example.util.widgets.VerticalSeparator"/>
+ <attr name="position" intvalue="25"/>
+</file>
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJSeparatorInMainToolbar[http://wiki.netbeans.org/DevFaqJSeparatorInMainToolbar] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:37:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJavaHelp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJavaHelp.asciidoc
new file mode 100644
index 0000000..e18a4f6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJavaHelp.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJavaHelp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Is there a standard way to provide user documentation for my module?
+
+Yes. See the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/overview-summary.html[JavaHelp Integration API]
+which describes how to include JavaHelp documentation in a module under *Help > Contents*;
+and you can provide rich context help
+rather easily, linking into the same documentation.
+
+There is an IDE wizard for creating a help set for your module.
+
+--
+
+Applies to: NetBeans 5.x, 6.x
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJavaHelp[http://wiki.netbeans.org/DevFaqJavaHelp] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:47:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJavaHelpForNodeProperties.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpForNodeProperties.asciidoc
new file mode 100644
index 0000000..53be49c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpForNodeProperties.asciidoc
@@ -0,0 +1,79 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJavaHelpForNodeProperties
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How Can I Hook Up JavaHelp to Property Sets or Individual Properties?
+
+Generally speaking, you can implement HelpCtx.Provider for objects in your platform application to associate them with a JavaHelp context (page). For some reason, this approach does not work with node properties. You can set the "helpID" value to associate JavaHelp with an individual property or an entire set, as shown below:
+
+== For Individual Properties
+
+[source,java]
+----
+
+
+// in the constructor of your property class
+public LastNameProperty(String initialValue) {
+ super("lastName", String.class, "Last Name", "The user's surname");
+
+ // This is how you associate a given property with a help context.
+ setValue("helpID", "my.help.ctx");
+}
+----
+
+== For a Set of Properties
+
+[source,java]
+----
+
+@Override
+protected Sheet createSheet() {
+ Sheet s = super.createSheet();
+
+ Sheet.Set ss = s.get(Sheet.PROPERTIES);
+ if (ss == null) {
+ ss = Sheet.createPropertiesSet();
+ s.put(ss);
+ }
+
+ // Do this to specify help for a whole sheet set
+ ss.setValue("helpID", "my.help.ctx");
+
+ ss.put(new FirstNameProperty("Abe"));
+ ss.put(new LastNameProperty("Lincoln"));
+
+ return s;
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJavaHelpForNodeProperties[http://wiki.netbeans.org/DevFaqJavaHelpForNodeProperties] ,
+that was last modified by NetBeans user Jhavlin
+on 2011-12-13T16:35:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJavaHelpNotDisplayed.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpNotDisplayed.asciidoc
new file mode 100644
index 0000000..f9b6885
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpNotDisplayed.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJavaHelpNotDisplayed
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why doesn't my JavaHelp content show up?
+
+The first thing to check is that your JavaHelp configuration files are correct. Since these files contain IDs and file paths, it is easy to make a mistake. Unfortunately, the JavaHelp system does not provide you with much warning when such an error occurs.
+
+It is also worth noting that the JavaHelp implementation in NetBeans IDE 6.5.x and earlier link:http://www.netbeans.org/issues/show_bug.cgi?id=160276[seems to require the .html file extension].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJavaHelpNotDisplayed[http://wiki.netbeans.org/DevFaqJavaHelpNotDisplayed] ,
+that was last modified by NetBeans user Gregorytechsoft
+on 2011-03-23T07:26:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJavaHelpOverrideCustom.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpOverrideCustom.asciidoc
new file mode 100644
index 0000000..4596b77
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJavaHelpOverrideCustom.asciidoc
@@ -0,0 +1,150 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJavaHelpOverrideCustom
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How can I override JavaHelp to display my own help or documentation?
+
+1. link:#How_can_I_override_JavaHelp_to_display_my_own_help_or_documentation.3F[How can I override JavaHelp to display my own help or documentation?]
+1. link:#Step_1:_HelpCtx.Displayer[Step 1: HelpCtx.Displayer]
+2. link:#Step_2:_Help.class[Step 2: Help.class]
+3. link:#Step_3:_Connecting_UI_To_JavaHelp[Step 3: Connecting UI To JavaHelp]
+4. link:#Step_4:_Add_the_JavaHelp_Integration_Module[Step 4: Add the JavaHelp Integration Module]
+5. link:#Summary:_Putting_It_All_Together[Summary: Putting It All Together]
+1. link:#Apache_Migration_Information[Apache Migration Information]
+
+== Step 1: HelpCtx.Displayer
+
+First, you must create a HelpCtx.Displayer that is capable of displaying your help and register it as a service provider
+
+[source,java]
+----
+
+@ServiceProviders({
+ @ServiceProvider(service = HelpCtx.Displayer.class, position = 1000)
+})
+public class CustomHelpDisplayer implements HelpCtx.Displayer {
+
+ public boolean display(final HelpCtx helpCtx) {
+
+ // Put your displaying code here.
+ JOptionPane.showMessageDialog(
+ WindowManager.getDefault().getMainWindow(),
+ helpCtx.getHelpID());
+
+ return true;
+ }
+}
+----
+
+== Step 2: Help.class
+
+An instance of org.netbeans.api.javahelp.Help determines what to do with a particular HelpCtx. In order to use your custom help displayer, you need to create an instance of Help that can display using your custom help displayer. In this case, you want to override the Help class provided with the NetBeans platform, so you set the 'position' attribute low. The purpose of this class is two-fold:
+
+* If the HelpCtx.getHelpID() is a value we recognize and can use, we display it with our displayer. For our example below, we handle any help ID that starts with "PREFIX."
+* If not, we pass it on to the default help system.
+[source,java]
+----
+
+@ServiceProviders({
+ @ServiceProvider(service = Help.class, position = 1)
+})
+public class CustomHelp extends Help {
+
+ @Override
+ public Boolean isValidID(final String id, final boolean force) {
+ // We return true because even if it's not a valid ID for our purposes, we just pass it
+ // to the default help and let it deal with it.
+ return true;
+ }
+
+ @Override
+ public void showHelp(final HelpCtx ctx, final boolean showmaster) {
+
+ // Here, we examine the ID and if it starts with "PREFIX", we find our implementation
+ // of HelpCtx.Displayer using the Lookup API and use it to display our help.
+ if (ctx.getHelpID().startsWith("PREFIX")) {
+
+ final HelpCtx.Displayer displayer =
+ Lookup.getDefault().lookup(HelpCtx.Displayer.class);
+
+ displayer.display(ctx);
+ }
+
+ // If we don't know what do with the ID, we find all the implementations of Help and
+ // pass the HelpCtx along to the first one we find that isn't this class.
+ else {
+ final Collection<? extends Help> helps =
+ Lookup.getDefault().lookupAll(Help.class);
+
+ for (Help help : helps) {
+ if (help != this) {
+ help.showHelp(ctx, showmaster);
+
+ break;
+ }
+ }
+ }
+ }
+
+ @Override
+ public void addChangeListener(final ChangeListener listener) {
+ // *** Not sure what to do here.
+ }
+
+ @Override
+ public void removeChangeListener(final ChangeListener listener) {
+ // *** Not sure what to do here.
+ }
+}
+----
+
+== Step 3: Connecting UI To JavaHelp
+
+See link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/org/netbeans/api/javahelp/doc-files/help-guide.html[Connecting Help In NetBeans].
+
+== Step 4: Add the JavaHelp Integration Module
+
+This module is not "eager", so to force it to load, at least one module must depend on it. Simply make JavaHelp Integeration a dependency of one your modules to make Help available. The JavaHelp Integration module is in the 'platform' library.
+
+== Summary: Putting It All Together
+
+* Your UI provides the HelpCtx.
+* The CustomHelp class (invoked when the user launches help, usually by pressing F1) examines help IDs.
+* If it's one we recognize, we invoke our custom displayer.
+* If it's not, we hand it off to another Help instance.
+
+--
+Applies to: NetBeans IDE 7.2
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJavaHelpOverrideCustom[http://wiki.netbeans.org/DevFaqJavaHelpOverrideCustom] ,
+that was last modified by NetBeans user Michael.Bishop
+on 2013-03-08T19:33:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqJavaStartParms.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqJavaStartParms.asciidoc
new file mode 100644
index 0000000..04ad77a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqJavaStartParms.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqJavaStartParms
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+This is simple to do but hard to figure out.
+<ol>
+<li>Define the run.args.extra property in the suite's platform.properties file. (i.e. run.args.extra=-J-Xms48m -J-Xmx512m)</li>
+<li>Add/edit this target to your suite's build.xml file:
+
+[source,xml]
+----
+
+<target name="build-launchers" depends="suite.build-launchers">
+ <replace file="build/launcher/etc/${app.name}.conf">
+ <replacefilter token="/dev" value="/${app.version}" />
+ <replacefilter token="-J-Xms24m -J-Xmx64m" value="${run.args.extra}" />
+ </replace>
+ </target>
+----
+
+</li>
+<li>Build your application.</li>
+*Note:* The above will work with any distribution method (i.e. zip, installer, etc...)
+</ol>
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqJavaStartParms[http://wiki.netbeans.org/DevFaqJavaStartParms] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-09-21T20:28:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqKeybindings.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqKeybindings.asciidoc
new file mode 100644
index 0000000..f643e81
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqKeybindings.asciidoc
@@ -0,0 +1,76 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqKeybindings
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do keybindings work?
+
+Keybindings are specified in yet another folder in the link:DevFaqSystemFilesystem.html[system filesystem ]. The folder Shortcuts/ contains link:DevFaqInstanceDataObject.html[.instance files] or link:DevFaqDotShadowFiles.html[.shadow files] (shadow files are like symlinks to another file in the system fs) - these map to Actions.
+
+The file name for the action (`.instance` or `.shadow`) file in `Shortcuts/` is used to specify what keys are bound. This is done using an link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#stringToKey(java.lang.String)[emacs-like syntax for specifying keybindings] - e.g., `CA-P` equals Ctrl-Alt-P.
+
+For a full listing of the hard-coded and cross-platform prefixes for key definitions, see link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#stringToKey(java.lang.String)[the javadoc for Utilities.stringToKey()] - that and its analogue, `Utilities.keyToString()` are used to encode and decode these.
+
+There are special modifier characters which link:DevFaqLogicalKeybindings.html[map to Command on Mac and Ctrl on PC, Ctrl on Mac and Alt on PC]. You should use those unless you're _really sure_ your app will never be used on macintosh or never be used by someone with a non-English macintosh.
+
+Here is an example of what a layer file might look like if you bound the Ctrl+Shift+Equals sequence to the `com.tomwheeler.example.fooviewer.FooAction` action:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.0//EN"
+ "http://www.netbeans.org/dtds/filesystem-1_0.dtd">
+
+<filesystem>
+ <folder name="Actions">
+ <folder name="View">
+ <folder name="FooViewer">
+ <file name="com-tomwheeler-example-fooviewer-FooAction.instance" />
+ </folder>
+ </folder>
+ </folder>
+
+ <folder name="Shortcuts">
+ <!--
+ set up a shortcut key for executing the Foo Action:
+ Ctrl + Shift + Equals on Linux and MS Windows, but Command + Shift + Equals on a Mac
+ -->
+ <file name="DS-EQUALS.shadow">
+ <attr name="originalFile" stringvalue="Actions/View/FooViewer/com-tomwheeler-example-fooviewer-FooAction.instance"/>
+ </file>
+ </folder>
+</filesystem>
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqKeybindings[http://wiki.netbeans.org/DevFaqKeybindings] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:22:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqKeybindingsInUse.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqKeybindingsInUse.asciidoc
new file mode 100644
index 0000000..49fc7cf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqKeybindingsInUse.asciidoc
@@ -0,0 +1,58 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqKeybindingsInUse
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I find out which keybindings are already in use?
+
+For an existing release you can look at e.g. link:KeymapProfileFor60.html[KeymapProfileFor60] to see the specification.
+
+If you are developing a module for NetBeans development builds,
+you can just look at
+link:http://deadlock.netbeans.org/hudson/job/nbms-and-javadoc/lastSuccessfulBuild/artifact/nbbuild/build/generated/layers.txt[this file]
+in the section `Shortcuts/`.
+This will show all global keybindings being used by modules in the standard IDE
+as well as experimental update center
+in `link:http://hg.netbeans.org/main/[http://hg.netbeans.org/main/]` and `link:http://hg.netbeans.org/main/contrib/[http://hg.netbeans.org/main/contrib/]`
+as of a few hours ago.
+
+Editor-specific keybindings are listed in `Editors/*/*/Keybindings/` folders,
+which is unfortunately harder to browse through.
+
+Be conservative about adding new keybindings;
+they are a precious resource.
+Be careful with bindings using `Alt`, as these often clash with mnemonics,
+Linux window manager shortcuts, etc.
+If at all possible, use a multistroke binding:
+for example, `Shortcuts/D-J R C.shadow` binds the 3-stroke sequence `Ctrl-J R C`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqKeybindingsInUse[http://wiki.netbeans.org/DevFaqKeybindingsInUse] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:50:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLgpl3rdPartySources.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLgpl3rdPartySources.asciidoc
new file mode 100644
index 0000000..16183a1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLgpl3rdPartySources.asciidoc
@@ -0,0 +1,78 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLgpl3rdPartySources
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Where to download sources of LGPL third-party components?
+
+The following third-party components licensed under LGPL license have the sources available for download from netbeans.org:
+
+|===
+|3rd party component |binaries in installed product |download of sources
+
+|JNA 3.2.7 |platform/modules/ext/jna-3.2.7.jar
+platform/modules/ext/platform-3.2.7.jar |link:http://hg.netbeans.org/binaries/F9B3B55860860670C491D6D626D7B621C63746A0-jna-3.2.7-src.zip[jna-3.2.7-src.zip]
+
+|JNA 3.4.0 |platform/modules/ext/jna-3.4.0.jar
+platform/modules/ext/platform-3.4.0.jar |link:http://hg.netbeans.org/binaries/2F42653596D0044F0AB456620CBA54C9CF53C5CA-jna-3.4.0-sources.jar[jna-3.4.0-sources.jar]
+
+|nsProxyAutoConfig.js |platform/modules/ext/nsProxyAutoConfig.js |link:http://hg.netbeans.org/binaries/22C41D62B7BD70C00603B2CAE75406414224CF9F-nsProxyAutoConfig.js[nsProxyAutoConfig.js]
+
+|Swing Layout 1.0.4 |platform/modules/ext/swing-layout-1.0.4.jar |link:http://hg.netbeans.org/binaries/D2503D2217868ABAE1A5E7480A9CCA1DB3522464-swing-layout-1.0.4-src.zip[swing-layout-1.0.4-src.zip]
+
+|SwingX 0.9.5 |ide/modules/ext/swingx-0.9.5.jar |link:http://hg.netbeans.org/binaries/B214C5E96344B8F65305549E3BA6B57EB85A9963-swingx-0.9.5-sources.jar[swingx-0.9.5-sources.jar]
+
+|SwingX 1.0 |ide/modules/ext/swingx-1.0.jar |link:http://hg.netbeans.org/binaries/52E515E0F391BF233352040BB42B4957C605C994-swingx-1.0-sources.jar[swingx-1.0-sources.jar]
+
+|SwingX 1.6.4 |ide/modules/ext/swingx-all-1.6.4.jar |link:http://hg.netbeans.org/binaries/E1DB5A228834FBF0EA2A74A08098F266A43ACEA3-swingx-all-1.6.4-sources.jar[swingx-all-1.6.4-sources.jar]
+
+|Appframework 1.0.3 |java/modules/ext/appframework-1.0.3.jar |link:http://hg.netbeans.org/binaries/412D6845E910A1CE62DBE591BB5D80C72A5D0CD1-AppFramework-1.0.3-src.zip[AppFramework-1.0.3-src.zip]
+
+|Beansbinding 1.2.1 |java/modules/ext/beansbinding-1.2.1.jar |link:http://hg.netbeans.org/binaries/F37C4E71760B38E77F5B1E198010FD186E374E5D-beansbinding-1.2.1-src.zip[beansbinding-1.2.1-src.zip]
+
+|Swingworker 1.1 |java/modules/ext/swing-worker-1.1.jar |link:http://hg.netbeans.org/binaries/BADE876913ECB2135DCFD065278EFFE6CBCC5555-swing-worker-1.1-src.zip[swing-worker-1.1-src.zip]
+
+|Hibernate 4.2.6 |java/modules/ext/hibernate |link:http://hg.netbeans.org/binaries/CF34522D8E1AAFC46D9F9C7E9BDE6DCBF9B46BE5-hibernate-4.2.6.Final-sources.zip[hibernate-4.2.6.Final-sources.zip]
+
+|Bytelist 0.1 |ide/modules/ext/bytelist-0.1.jar |link:http://hg.netbeans.org/binaries/BD62DBE6D85C6695DDF8C45D69E9CFE7F39BC932-bytelist-0.1-src.zip[bytelist-0.1-src.zip]
+
+|libimobiledevice 1.1.5 |webcommon/bin/libimobiledevice.4.dylib |link:http://hg.netbeans.org/binaries/FB89FA33EB77052B46E6619664A68B0E20F97F7A-libimobiledevice-1.1.5.tar.bz2[libimobiledevice-1.1.5.tar.bz2]
+
+|libplist 1.10 |webcommon/bin/libplist.1.dylib |link:http://hg.netbeans.org/binaries/A642BB37EAA4BEC428D0B2A4FA8399D80EE73A18-libplist-1.10.tar.bz2[libplist-1.10.tar.bz2]
+
+|usbmuxd 1.0.8 |webcommon/bin/libusbmuxd.2.dylib |link:http://hg.netbeans.org/binaries/7488587303C757874A16A8C40B00C8BD15C82120-usbmuxd-1.0.8.tar.bz2[usbmuxd-1.0.8.tar.bz2]
+
+|JNA 4.0.0 |platform/modules/ext/jna-4.0.0.jar
+platform/modules/ext/jna-platform-4.0.0.jar |link:http://hg.netbeans.org/binaries/6C7D7616D86B35623DA5E590B54EB95448D7117C-jna-4.0.0-src.zip[jna-4.0.0-src.zip]
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLgpl3rdPartySources[http://wiki.netbeans.org/DevFaqLgpl3rdPartySources] ,
+that was last modified by NetBeans user Pjiricka
+on 2013-11-06T10:37:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLibrariesModuleDescriptions.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLibrariesModuleDescriptions.asciidoc
new file mode 100644
index 0000000..0bc5cae
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLibrariesModuleDescriptions.asciidoc
@@ -0,0 +1,865 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLibrariesModuleDescriptions
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== In the Libraries tab of my application's Project Properties, there sure are a lot of modules listed. What are they for?
+
+When you're creating an application on the NetBeans Platform in NetBeans IDE, you can right-click the app in the Projects window, choose Properties, and then go to the Libraries tab. There you'll see a list of clusters containing the modules you can add to your application.
+
+What are they all for? Here's the answer.
+
+*platform cluster*
+
+|===
+|Display Name |Module |Comments
+
+|Actions API |org.openide.actions
+
+|Actions SPI (Experimental) |org.netbeans.modules.spi.actions
+
+|Apache's Felix OSGi Implementation |org.netbeans.libs.felix
+
+|Apple Application Menu |org.netbeans.modules.applemenu
+
+|Auto Update Services |org.netbeans.modules.autoupdate.services
+
+|Auto Update UI |org.netbeans.modules.autoupdate.ui
+
+|Bootstrap |org.netbeans.bootstrap
+
+|Command Line Parsing API |org.netbeans.modules.sendopts
+
+|Common Annotations |org.netbeans.api.annotations.common
+
+|Core |org.netbeans.core
+
+|Core - Execution |org.netbeans.core.execution
+
+|Core - UI |org.netbeans.core.ui
+
+|Core - Windows |org.netbeans.core.windows
+
+|Datasystems API |org.openide.loaders
+
+|Dialogs API |org.openide.dialogs
+
+|ETable and Outline |org.netbeans.swing.outline
+
+|Execution API |org.openide.execution
+
+|Explorer & Property Sheet API |org.openide.explorer
+
+|Favorites |org.netbeans.modules.favorites
+
+|File System API |org.openide.filesystems
+
+|General Queries API |org.netbeans.modules.queries
+
+|I/O APIs |org.openide.io
+
+|I/O UI |org.netbeans.core.io.ui
+
+|JavaHelp Integration |org.netbeans.modules.javahelp
+
+|JNA |org.netbeans.libs.jna
+
+|JUnit 4 |org.netbeans.libs.junit4
+
+|Keymap Options |org.netbeans.modules.options.keymap
+
+|Keyring API |org.netbeans.modules.keyring
+
+|Keyring Implementations |org.netbeans.modules.keyring.impl
+
+|Look & Feel Customization Library |org.netbeans.swing.plaf
+
+|Lookup API |org.openide.util.lookup
+
+|Master Filesystem |org.netbeans.modules.masterfs
+
+|MIME Lookup API |org.netbeans.modules.editor.mimelookup
+
+|MIME Lookup on SystemFS |org.netbeans.modules.editor.mimelookup.impl
+
+|Module System API |org.openide.modules
+
+|MultiView Windows |org.netbeans.core.multiview
+
+|Native Access |org.netbeans.core.nativeaccess
+
+|NetBeans in OSGi Runtime |org.netbeans.core.osgi
+
+|NetBeans OSGi Integration |org.netbeans.core.netigso
+
+|Nodes API |org.openide.nodes
+
+|Options Dialog and SPI |org.netbeans.modules.options.api
+
+|OSGi Specification |org.netbeans.libs.osgi
+
+|Output Window |org.netbeans.core.output2
+
+|Print |org.netbeans.modules.print
+
+|Progress API |org.netbeans.api.progress
+
+|Progress UI |org.netbeans.modules.progress.ui
+
+|Quick Search API |org.netbeans.spi.quicksearch
+
+|RCP Platform |org.netbeans.modules.core.kit
+
+|Settings API |org.netbeans.modules.settings
+
+|Startup |org.netbeans.core.startup
+
+|Tab Control |org.netbeans.swing.tabcontrol
+
+|Text API |org.openide.text
+
+|UI Utilities API |org.openide.awt
+
+|Utilities API |org.openide.util
+
+|Visual Library API |org.netbeans.api.visual
+
+|Window System API |org.openide.windows
+|===
+
+*nb cluster*
+
+|===
+|Display Name |Module |Comments
+
+|Bugzilla-Exception Reporter Bridge |org.netbeans.modules.bugzilla.exceptionreporter
+
+|Exception Reporter |org.netbeans.modules.uihandler.exceptionreporter
+
+|IDE Branding |org.netbeans.modules.ide.branding.kit
+
+|NetBeans IDE Branding |org.netbeans.modules.ide.branding
+
+|Plugin Importer |org.netbeans.modules.autoupdate.pluginimporter
+
+|UI Gestures Collector Infrastructure |org.netbeans.modules.uihandler
+
+|UI Handler Library |org.netbeans.lib.uihandler
+
+|Update Centers |org.netbeans.modules.updatecenters
+
+|Upgrade |org.netbeans.upgrader
+
+|Welcome Screen |org.netbeans.modules.welcome
+|===
+
+*ide cluster*
+
+|===
+|Display Name |Module |Comments
+
+|.diff File Editor Support |org.netbeans.modules.languages.diff
+
+|,manifest file Editor Support |org.netbeans.modules.languages.manifest
+
+|Abstract XML Instance Object Model |org.netbeans.modules.xml.axi
+
+|Ant-Based Project Support |org.netbeans.modules.project.ant
+
+|Antlr 3.1.3 Runtime |org.netbeans.libs.antl3.runtime
+
+|Apache Resolver Library 1.2 |org.apache.xml.resolver
+
+|Bugzilla |org.netbeans.modules.bugzilla
+
+|Bugzilla Libraries |org.netbeans.libs.bugzilla
+
+|Classpath APIs |org.netbeans.api.java.classpath
+
+|Code Coverage Support |org.netbeans.modules.gsf.codecoverage
+
+|Common Palette |org.netbeans.spi.palette
+
+|Commons Code Integration |org.netbeans.libs.commons_codec
+
+|Common Scripting Language API (new) |org.netbeans.modules.csl.api
+
+|Common Server |org.netbeans.modules.server
+
+|Commons Logging Integration |org.netbeans.libs.commons_logging
+
+|Commons Net Integration |org.netbeans.libs.commons_net
+
+|Common Test Runner API |org.netbeans.modules.gsf.testrunner
+
+|Core IDE |org.netbeans.core.ide
+
+|CSS Editor |org.netbeans.modules.css.editor
+
+|CSS Visual Editor |org.netbeans.modules.css.visual
+
+|CVS |org.netbeans.modules.versioning.system.cvss
+
+|CVS Client Library |org.netbeans.libs.cvsclient
+
+|Database |org.netbeans.modules.db.kit
+
+|Database APIs |org.netbeans.modules.dbapi
+
+|Database Core |org.netbeans.modules.db.core
+
+|Database DataView |org.netbeans.modules.db.dataview
+
+|Database Drivers |org.netbeans.modules.db.drivers
+
+|Database Explorer |org.netbeans.modules.db
+
+|Database Metadata Model |org.netbeans.modules.db.metadata.model
+
+|Debugger Core API |org.netbeans.api.debugger
+
+|Debugger Core - UI |org.netbeans.spi.debugger.ui
+
+|Diff |org.netbeans.modules.diff
+
+|Directory Chooser |org.netbeans.swing.dirchooser
+
+|Editing Files |org.netbeans.modules.editor.kit
+
+|Editor |org.netbeans.modules.editor
+
+|Editor Actions |org.netbeans.modules.editor.actions
+
+|Editor Bookmarks |org.netbeans.modules.editor.bookmarks
+
+|Editor Brace Matching |org.netbeans.modules.editor.bracesmatching
+
+|Editor Code Completion |org.netbeans.modules.editor.completion
+
+|Editor Code Folding |org.netbeans.modules.editor.fold
+
+|Editor Code Templates |org.netbeans.modules.editor.codetemplates
+
+|Editor Error Stripe |org.netbeans.modules.editor.errorstripe.api
+
+|Editor Error Stripe Impl |org.netbeans.modules.editor.errorstripe
+
+|Editor Guarded Sections |org.netbeans.modules.editor.guards
+
+|Editor Hints |org.netbeans.spi.editor.hints
+
+|Editor Indentation |org.netbeans.modules.editor.indent
+
+|Editor Indentation for Projects |org.netbeans.modules.editor.indent.project
+
+|Editor Library |org.netbeans.modules.editor.lib
+
+|Editor Library 2 |org.netbeans.modules.editor.lib2
+
+|Editor Macros |org.netbeans.modules.editor.macros
+
+|Editor Options |org.netbeans.modules.options.editor
+
+|Editor Settings |org.netbeans.modules.options.settings
+
+|Editor Settings Storage |org.netbeans.modules.options.settings.storage
+
+|Editor Utilities |org.netbeans.modules.editor.util
+
+|Embedded Browser |org.netbeans.core.browser
+
+|Extensible Abstract Model (XAM) |org.netbeans.modules.xml.xam
+
+|External Execution Process Destroy Support |org.netbeans.modules.extexecution.destroy
+
+|External Execution Support |org.netbeans.modules.extexecution
+
+|External HTML Browser |org.netbeans.modules.extbrowser
+
+|External Libraries |org.netbeans.modules.project.libraries |Support for organizing resources into libraries.
+
+|Freemarker Integration |org.netbeans.libs.freemarker
+
+|General Online Help |org.netbeans.modules.usersguide
+
+|Git |org.netbeans.modules.git
+
+|Git Library |org.netbeans.libs.git
+
+|Glassfish Server 3 - Common |org.netbeans.modules.glassfish.common
+
+|HTML |org.netbeans.modules.html
+
+|HTML5 Parser |org.netbeans.modules.html.parser
+
+|HTML Editor |org.netbeans.modules.html.editor
+
+|HTML Editor Library |org.netbeans.modules.html.editor.lib
+
+|HTML Lexer |org.netbeans.modules.html.lexer
+
+|HTML Validation |org.netbeans.modules.html.validation
+
+|HTTP Server |org.netbeans.modules.httpserver
+
+|Hudson |org.netbeans.modules.hudson
+
+|Hudson Mercurial Bindings |org.netbeans.modules.hudson.mercurial
+
+|Hudson Subversion Bindings |org.netbeans.modules.hudson.subversion
+
+|IDE Defaults |org.netbeans.modules.defaults |Contains font, color, and shortcut defaults.
+
+|IDE Platform |org.netbeans.modules.ide.kit
+
+|Image |org.netbeans.modules.image |Supports viewing of image files.
+
+|Ini4j |org.netbeans.libs.ini4j
+
+|Issue Tracking |org.netbeans.modules.bugtracking
+
+|Issue Tracking Bridge Module |org.netbeans.modules.bugtracking.bridge
+
+|Issue Tracking Libraries |org.netbeans.libs.bugtracking
+
+|Jakarta ORO Integration |org.netbeans.libs.jakarta_oro
+
+|Java DB Database Support |org.netbeans.modules.derby
+
+|JavaScript |org.netbeans.modules.javascript.kit
+
+|JavaScript Editing |org.netbeans.modules.javascript.editing
+
+|JavaScript Hints |org.netbeans.modules.javascript.hints
+
+|JavaScript Refactoring |org.netbeans.modules.javascript.refactoring
+
+|Java Secure Channel Integration |org.netbeans.libs.jsch
+
+|Java zlib integration |org.netbeans.libs.jzlib
+
+|JAXB 2.2 Library |org.netbeans.libs.jaxb
+
+|JAXB API |org.netbeans.modules.xml.jaxb.api
+
+|Jelly Tools API |org.netbeans.modules.jellytools.ide
+
+|JRuby ByteList |org.netbeans.libs.bytelist |JRuby ByteList Library
+
+|Jump To |org.netbeans.modules.jumpto |Action to quickly navigate to a file or type.
+
+|Lexer |org.netbeans.modules.lexer
+
+|Lexer to NetBeans Bridge |org.netbeans.modules.lexer.nbbridge
+
+|Local History |org.netbeans.modules.localhistory
+
+|Lucene Integration |org.netbeans.libs.lucene
+
+|Mercurial |org.netbeans.modules.mercurial
+
+|MySQL Database Support |org.netbeans.modules.db.mysql
+
+|Native Execution |org.netbeans.modules.dlight.nativeexution
+
+|Native Terminal |org.netbeans.modules.dlight.terminal
+
+|Navigate To Test |org.netbeans.modules.gototest |An action to quickly navigate to a test for a file
+
+|Navigator API |org.netbeans.spi.navigator
+
+|Parsing API |org.netbeans.modules.parsing.api
+
+|Parsing Lucene Support |org.netbeans.modules.parsing.lucene
+
+|Plain Editor |org.netbeans.modules.editor.plain
+
+|Plain Editor Library |org.netbeans.modules.editor.plain.lib
+
+|Print Editor |org.netbeans.modules.print.editor
+
+|Project API |org.netbeans.modules.projectapi
+
+|Projects Searching |org.netbeans.modules.utilities.project
+
+|Project UI |org.netbeans.modules.projectui
+
+|Project UI API |org.netbeans.modules.projectuiapi
+
+|Project UI Build Menu |org.netbeans.modules.projectui.buildmenu
+
+|Refactoring API |org.netbeans.modules.refactoring.api
+
+|Resource Bundles |org.netbeans.modules.properties
+
+|Resource Bundle Syntax Coloring |org.netbeans.modules.properties.syntax
+
+|Rhine IDE JavaScript Handler |org.mozilla.rhino.patched
+
+|Schema Aware Code Completion |org.netbeans.modules.xml.schema.completion
+
+|Schema-to-Beans Library |org.netbeans.modules.schema2beans
+
+|Search API |org.openidex.util
+
+|Servlet 2.2 API |org.netbeans.modules.servletapi
+
+|Smack API |org.netbeans.libs.smack
+
+|Spellchecker |org.netbeans.modules.spellchecker.kit
+
+|Spellchecker API |org.netbeans.modules.spellchecker.apimodule
+
+|Spellchecker Core |org.netbeans.modules.spellchecker
+
+|Spellchecker English Dictionaries |org.netbeans.modules.spellchecker.dictionary_en
+
+|Spellchecker HTML XML Bindings |org.netbeans.modules.spellchecker.bindings.htmlxml
+
+|Spellchecker Properties Bindings |org.netbeans.modules.spellchecker.bindings.properties
+
+|SQL Editor |org.netbeans.modules.db.sql.editor
+
+|Subversion |org.netbeans.modules.subversion
+
+|Subversion Client Library |org.netbeans.libs.svnClientAdapter
+
+|Subversion JavaHL Client Library |org.netbeans.libs.svnClientAdapter.javahl
+
+|Subversion SvnKit Client Library |org.netbeans.libs.svnClientAdapter.svnkit
+
+|Swing Simple Validation API |org.netbeans.modules.swing.validation
+
+|SwingX |org.netbeans.libs.swingx
+
+|Tags Based Editors Library |org.netbeans.modules.editor.structure
+
+|Target Chooser Panel |org.netbeans.modules.target.iterator
+
+|Task List |org.netbeans.modules.tasklist.kit
+
+|Task List API |org.netbeans.spi.tasklist
+
+|Task List - Project Integration |org.netbeans.modules.tasklist.projectint
+
+|Task List UI |org.netbeans.modules.tasklist.ui
+
+|TAX Library |org.netbeans.modules.xml.tax
+
+|Terminal |org.netbeans.modules.terminal
+
+|Terminal Emulator |org.netbeans.lib.terminalemulator
+
+|ToDo Task Scanner |org.netbeans.modules.tasklist.todo
+
+|TreeTableView Model |org.netbeans.spi.viewmodel
+
+|User Utilities |org.netbeans.modules.utilities |Some basic link:http://utilities.netbeans.org/[user utilities] like Menu -> Open File
+
+|Versioning |org.netbeans.modules.versioning
+
+|Versioning-Index Bridge |org.netbeans.modules.versioning.indexingbridge
+
+|Versioning Support Utilities |org.netbeans.modules.versioning.util
+
+|Visual Query Editor |org.netbeans.modules.db.sql.visualeditor
+
+|Web Client Tools API |org.netbeans.modules.web.client.tools.api
+
+|Web Common |org.netbeans.modules.web.common
+
+|Xerces Integration |org.netbeans.libs.xerces
+
+|XML Core |org.netbeans.modules.xml.core
+
+|XML Document Model (XDM) |org.netbeans.modules.xml.xdm
+
+|XML Entity Catalog |org.netbeans.modules.xml.catalog
+
+|XML Lexer |org.netbeans.modules.xml.lexer
+
+|XML Multiview Editor |org.netbeans.modules.xml.multiview
+
+|XML Productivity Tools |org.netbeans.modules.xml.tools
+
+|XML Retriever |org.netbeans.modules.xml.retriever
+
+|XML Schema API |org.netbeans.modules.xml.schema.model
+
+|XML Support |org.netbeans.modules.xml
+
+|XML Text Editor |org.netbeans.modules.xml.text
+
+|XML Tools API |org.netbeans.api.xml
+
+|XML WSDL API |org.netbeans.modules.xml.wsdl.model
+
+|XSL Support |org.netbeans.modules.xsl
+
+|YAML Editor Support |org.netbeans.modules.languages.yaml
+
+|YAML Parser Library (jvyamlb) |org.netbeans.libs.jvyamlb
+|===
+
+*java cluster*
+
+|===
+|Display Name |Module |Comments
+
+|Ant |org.apache.tools.ant.module
+
+|Ant |org.netbeans.modules.ant.kit
+
+|Ant Code Completion |org.netbeans.modules.ant.grammar
+
+|Ant Debugger |org.netbeans.modules.ant.debugger
+
+|Bean Patterns |org.netbeans.modules.beans
+
+|Beans Binding Integration |org.jdesktop.beansbinding
+
+|Classfile Reader |org.netbeans.modules.classfile
+
+|Code Generation Library Integration |org.netbeans.libs.cglib
+
+|Database Schema (JDBC Implementation) |org.netbeans.upgrader
+
+|Eclipse J2SE Project Importer |org.netbeans.modules.projectimport.eclipse.j2se
+
+|EclipseLink (JPA 2.0) |org.netbeans.modules.j2ee.eclipselink
+
+|EclipseLink-ModelGen (JPA 2.0) |org.netbeans.modules.j2ee.eclipselinkmodelgen
+
+|Eclipse Project Importer |org.netbeans.modules.projectimport.eclipse.core
+
+|Form Editor |org.netbeans.modules.form
+
+|Freeform Ant Projects |org.netbeans.modules.ant.freeform
+
+|GUI Builder |org.netbeans.modules.form.kit
+
+|Hibernate |org.netbeans.modules.hibernate
+
+|Hibernate 3.2.5 Library |org.netbeans.modules.hibernatelib
+
+|Hudson Ant Project Support |org.netbeans.modules.hudson.ant
+
+|Internationalization |org.netbeans.modules.i18n
+
+|Internationalization of Form |org.netbeans.modules.i18n.form
+
+|J2EE Support for Form Editor |org.netbeans.modules.form.j2ee
+
+|Java |org.netbeans.modules.java.kit
+
+|Javac API Wrapper |org.netbeans.libs.javacapi
+
+|Javac Implementation Wrapper |org.netbeans.libs.javacimpl
+
+|Java Common Project API |org.netbeans.modules.java.api.common
+
+|Java Debugger |org.netbeans.modules.debugger.jpda.ui
+
+|Javadoc |org.netbeans.modules.javadoc
+
+|Java Editor |org.netbeans.modules.java.editor
+
+|Java Editor Library |org.netbeans.modules.java.editor.lib
+
+|Java EE Core Utilities |org.netbeans.modules.j2ee.core.utilities
+
+|Java EE Metadata |org.netbeans.modules.j2ee.metadata
+
+|Java EE Metadata Model Support |org.netbeans.modules.j2ee.model.support
+
+|Java Freeform Project Support |org.netbeans.modules.java.freeform
+
+|Java Guarded Sections |org.netbeans.modules.java.guards
+
+|Java Hints |org.netbeans.modules.java.hints
+
+|Java Hints Annotation Processor |org.netbeans.modules.java.hints.processor
+
+|Java Lexer |org.netbeans.modules.java.lexer
+
+|Java - Navigation |org.netbeans.modules.java.navigation
+
+|Java Persistence |org.netbeans.modules.j2ee.persistence.kit
+
+|Java Persistence API Support |org.netbeans.modules.j2ee.persistence
+
+|Java Persistence API Support API |org.netbeans.modules.j2ee.persistenceapi
+
+|Java Platform |org.netbeans.modules.java.platform
+
+|Java Project Support |org.netbeans.modules.java.project
+
+|Java Refactoring |org.netbeans.modules.refactoring.java
+
+|Java SE Platforms and Libraries |org.netbeans.modules.java.j2seplatform
+
+|Java SE Projects |org.netbeans.modules.java.j2seproject
+
+|Java SE Samples |org.netbeans.modules.java.examples
+
+|Java Source |org.netbeans.modules.java.source
+
+|Java Source Debug |org.netbeans.modules.java.debug
+
+|Java Source to Ant Bindings |org.netbeans.modules.java.source.ant
+
+|Java Source UI |org.netbeans.modules.java.sourceui
+
+|Java Support APIs |org.netbeans.modules.api.java
+
+|Java Support Documentation |org.netbeans.modules.java.helpset
+
+|Java Web Start |org.netbeans.modules.javawebstart
+
+|JAXB Wizard |org.netbeans.modules.xml.jaxb
+
+|JAX-WS 2.2 Library |org.netbeans.modules.websvc.jaxws21
+
+|JAX-WS API |org.netbeans.modules.websvc.jaxws21api
+
+|Jelly Tools |org.netbeans.modules.jellytools
+
+|Jelly Tools Java |org.netbeans.modules.jellytools.java
+
+|JPA Refactoring |org.netbeans.modules.j2ee.jpa.refactoring
+
+|JPA Verification |org.netbeans.modules.j2ee.jpa.verification
+
+|JPDA Debugger |org.netbeans.modules.debugger.jpda
+
+|JPDA Visual Debugger |org.netbeans.modules.debugger.jpda.visual
+
+|JPDA Debugger Ant Task |org.netbeans.modules.debugger.jpda.ant
+
+|JPDA Debugger API |org.netbeans.api.debugger.jpda
+
+|JPDA Debugger Projects Integration |org.netbeans.modules.debugger.jpda.projects
+
+|JUnit Tests |org.netbeans.modules.junit
+
+|Maven |org.netbeans.modules.maven.kit
+
+|Maven Dependency Graphs |org.netbeans.modules.maven.graph
+
+|Maven Editor |org.netbeans.modules.maven.grammar
+
+|Maven Editor Model |org.netbeans.modules.maven.model
+
+|Maven Embedder |org.netbeans.modules.maven.embedder
+
+|Maven Hints |org.netbeans.modules.maven.hints
+
+|Maven Hudson |org.netbeans.modules.hudson.maven
+
+|Maven JUnit |org.netbeans.modules.maven.junit
+
+|Maven OSGi |org.netbeans.modules.maven.osgi
+
+|Maven Persistence |org.netbeans.modules.maven.persistence
+
+|Maven Projects |org.netbeans.modules.maven
+
+|Maven Quick Search |org.netbeans.modules.maven.search
+
+|Maven Repository Browser |org.netbeans.modules.maven.repository
+
+|Maven Repository Indexing |org.netbeans.modules.maven.indexer
+
+|Maven Spring |org.netbeans.modules.maven.spring
+
+|Preprocessor Bridge |org.netbeans.modules.java.preprocessorbridge
+
+|Saas Services Code Generation for Java |org.netbeans.modules.websvc.saas.codegen.java
+
+|Spellchecker Java Language Bindings |org.netbeans.modules.spellchecker.bindings.java
+
+|Spring Beans |org.netbeans.modules.spring.beans
+
+|Spring Framework Library |org.netbeans.libs.springframework
+
+|Swing Application Framework Support |org.netbeans.modules.swingapp
+
+|TopLink Essentials |org.netbeans.modules.j2ee.toplinklib
+
+|Web Browser Ant Task |org.netbeans.modules.ant.browsetask
+
+|XML Tools Java Ext |org.netbeans.modules.xml.tools.java
+|===
+
+*harness cluster*
+
+|===
+|Display Name |Module |Comments
+
+|INSANE |org.netbeans.insane
+
+|Jelly Tools Platform |org.netbeans.modules.jellytools.platform
+
+|Jemmy |org.netbeans.modules.jemmy
+
+|Module Build Harness |org.netbeans.modules.apisupport.harness
+
+|NBI Ant Library |org.netbeans.libs.nbi.ant
+
+|NBI Engine Library |org.netbeans.libs.nbi.engine
+
+|NB JUnit |org.netbeans.modules.nbjunit
+|===
+
+*apisupport*
+
+|===
+|Display Name |Module |Comments
+
+|CRUD Application Platform Sample |org.netbeans.modules.apisupport.crudsample
+
+|FeedReader Application Platform Sample |org.netbeans.modules.apisupport.feedreader
+
+|Maven NetBeans Module Projects |org.netbeans.modules.maven.apisupport
+
+|Maven NetBeans Platform Application Installer |org.netbeans.modules.apisupport.installer.maven
+
+|Module Reload Ant Task |org.netbeans.modules.apisupport.ant
+
+|NetBeans Module Projects |org.netbeans.modules.apisupport.project
+
+|NetBeans Module Refactoring |org.netbeans.modules.apisupport.refactoring
+
+|NetBeans Platform & OSGi Samples |org.netbeans.modules.apisupport.osgidemo
+
+|NetBeans Plugin Development |org.netbeans.modules.apisupport.kit
+
+|PaintApp Platform Sample |org.netbeans.modules.apisupport.paintapp
+
+|RCP Installers |org.netbeans.modules.apisupport.installer
+|===
+
+*websvccommon*
+
+|===
+|Display Name |Module |Comments
+
+|Amazon Services |org.netbeans.modules.websvc.saas.services.amazon
+
+|Delicious Services |org.netbeans.modules.websvc.saas.services.delicious
+
+|FaceBook Services |org.netbeans.modules.websvc.saas.services.facebook
+
+|Flickr Services |org.netbeans.modules.websvc.saas.services.flickr
+
+|Google Services |org.netbeans.modules.websvc.saas.services.google
+
+|JAX-WS Models API |org.netbeans.modules.websvc.jaxwsmodelapi
+
+|SaaS Services API |org.netbeans.modules.websvc.saas.api
+
+|SaaS Services Code Generation |org.netbeans.modules.websvc.saas.codegen
+
+|SaaS Services UI |org.netbeans.modules.websvc.saas.ui
+
+|Software as a Service |org.netbeans.modules.websvc.saas.kit
+
+|StrikeIron Services |org.netbeans.modules.websvc.saas.services.strikeiron
+
+|Twitter Services |org.netbeans.modules.websvc.saas.services.twitter
+
+|WeatherBug Services |org.netbeans.modules.websvc.saas.services.weatherbug
+
+|Yahoo Services |org.netbeans.modules.websvc.saas.services.yahoo
+
+|Zillow Services |org.netbeans.modules.websvc.saas.services.zillow
+
+|Zvents Services |org.netbeans.modules.websvc.saas.services.zvents
+|===
+
+*profiler*
+
+|===
+|Display Name |Module |Comments
+
+|Java Profiler |org.netbeans.modules.profiler
+
+|Java Profiler (Attach - Generic J2EE Server Support) |org.netbeans.modules.profiler.j2ee.generic
+
+|Java Profiler (Attach - GlassFish Support) |org.netbeans.modules.profiler.j2ee.sunas
+
+|Java Profiler (Attach - JBoss Support) |org.netbeans.modules.profiler.j2ee.jboss
+
+|Java Profiler (Attach Support) |org.netbeans.modules.profiler.attach
+
+|Java Profiler (Attach - Tomcat Support) |org.netbeans.modules.profiler.j2ee.tomcat
+
+|Java Profiler (Attach - WebLogic Support) |org.netbeans.modules.profiler.j2ee.weblogic
+
+|Java Profiler (Attach Wizard) |org.netbeans.modules.profiler.attach.impl
+
+|Java Profiler (Charts) |org.netbeans.modules.websvc.saas.ui
+
+|Java Profiler (Common) |org.netbeans.modules.websvc.saas.kit
+
+|Java Profiler (Java Freeform Projects Support) |org.netbeans.modules.websvc.saas.services.strikeiron
+
+|Java Profiler (Java SE Projects Support) |org.netbeans.modules.websvc.saas.services.twitter
+
+|Java Profiler (JFluid) |org.netbeans.modules.websvc.saas.services.weatherbug
+
+|Java Profiler (JFluid-UI) |org.netbeans.modules.websvc.saas.services.yahoo
+
+|Java Profiler (NetBeans Module Projects Support) |org.netbeans.modules.websvc.saas.services.zillow
+
+|Java Profiler (OQL) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (OQL Language Support) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Project Support) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Root Method Selector - Java Project) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Root Method Selector SPI) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Root Method Selector UI) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Snapshots Tracer) |org.netbeans.modules.websvc.saas.services.zvents
+
+|Java Profiler (Utilities) |org.netbeans.modules.websvc.saas.services.zvents
+
+|JPDA Debugger Heap Walker |org.netbeans.modules.websvc.saas.services.zvents
+
+|Maven Profiler |org.netbeans.modules.websvc.saas.services.zvents
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLibrariesModuleDescriptions[http://wiki.netbeans.org/DevFaqLibrariesModuleDescriptions] ,
+that was last modified by NetBeans user Golthiryus
+on 2012-07-13T08:44:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLic3rdPartyComponents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLic3rdPartyComponents.asciidoc
new file mode 100644
index 0000000..39ada7a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLic3rdPartyComponents.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLic3rdPartyComponents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== What third party libraries are in the Platform and what are their licenses?
+
+You can find the information about NetBeans code license at link:http://netbeans.org/about/legal/index.html[http://netbeans.org/about/legal/index.html].
+
+Matrix of third-party libraries can be found in Third Party License link for the particular version at link:http://netbeans.org/about/legal/product-licences.html[http://netbeans.org/about/legal/product-licences.html].
+
+Note that if your application depends not only on Platform (modules from 'platform' cluster) but also on other parts of the NetBeans IDE (e.g. modules from the 'ide', or 'java' clusters) there may be derived dependencies on other 3rd party libraries.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLic3rdPartyComponents[http://wiki.netbeans.org/DevFaqLic3rdPartyComponents] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2011-12-27T17:04:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListenEditorChanges.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListenEditorChanges.asciidoc
new file mode 100644
index 0000000..ae34eab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListenEditorChanges.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListenEditorChanges
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I track what file the user is currently editing?
+
+==== EditorRegistry
+
+The editor keeps a registry of open editors; you can track the active editor using the following code:
+
+[source,java]
+----
+
+import org.netbeans.api.editor.EditorRegistry;
+
+PropertyChangeListener l = new PropertyChangeListener() {
+ public void propertyChange(PropertyChangeEvent evt) {
+ JTextComponent jtc = EditorRegistry.lastFocusedComponent();
+ if (jtc != null) {
+ Document d = jtc.getDocument();
+ // use the document
+ }
+ }
+};
+
+EditorRegistry.addPropertyChangeListener(l);
+----
+
+*IMPORTANT*: If you attach any listener to the `Document` or anything else in the active editor text component, remember to remove them when the active editor changes.
+
+Please read javadoc on `EditorRegistry` to see details about the properties delivered through the listener used in the above code. There are many property changes fired and if an event comes it does *not* necessarily mean that the active editor has changed.
+
+==== NbDocument.findRecentEditorPane
+
+If you have a `EditorCookie` you can use `NbDocument.findRecentEditorPane`
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-text/org/openide/text/NbDocument.html#findRecentEditorPane-org.openide.cookies.EditorCookie-[http://bits.netbeans.org/dev/javadoc/org-openide-text/org/openide/text/NbDocument.html#findRecentEditorPane-org.openide.cookies.EditorCookie-]
+
+Applies to: Netbeans 6.x and later
+
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListenEditorChanges[http://wiki.netbeans.org/DevFaqListenEditorChanges] ,
+that was last modified by NetBeans user Markiewb
+on 2016-02-22T22:27:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListenForChangesInNonExistentFile.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListenForChangesInNonExistentFile.asciidoc
new file mode 100644
index 0000000..64445fa
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListenForChangesInNonExistentFile.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListenForChangesInNonExistentFile
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want to listen for changes in a file that may not exist or may be deleted and re-created
+
+There are some cases where you want to listen for changes in a file or folder that does not exist, or may be created and deleted on the fly.
+
+As of NetBeans 6.7, you can use link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#addFileChangeListener(org.openide.filesystems.FileChangeListener,%20java.io.File)[FileUtil.addFileChangeListener(FileChangeListener, File)] to listen for such changes. There is also FileUtil.addRecursiveListener
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListenForChangesInNonExistentFile[http://wiki.netbeans.org/DevFaqListenForChangesInNonExistentFile] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:01:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListenForOpenEvents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListenForOpenEvents.asciidoc
new file mode 100644
index 0000000..a042b4e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListenForOpenEvents.asciidoc
@@ -0,0 +1,93 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListenForOpenEvents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I be notified when a file is opened?
+
+[source,java]
+----
+
+import java.beans.PropertyChangeEvent;
+import java.beans.PropertyChangeListener;
+import java.util.HashSet;
+import org.openide.awt.StatusDisplayer;
+import org.openide.filesystems.FileChangeAdapter;
+import org.openide.filesystems.FileEvent;
+import org.openide.filesystems.FileObject;
+import org.openide.loaders.DataObject;
+import org.openide.windows.OnShowing;
+import org.openide.windows.TopComponent;
+import org.openide.windows.WindowManager;
+
+@OnShowing
+public class Installer implements Runnable {
+ @Override
+ public void run() {
+WindowManager.getDefault().getRegistry().addPropertyChangeListener(new PropertyChangeListener() {
+ @Override
+ public void propertyChange(PropertyChangeEvent evt) {
+ if (evt.getPropertyName().equals("opened")) {
+ HashSet<TopComponent> newHashSet = (HashSet<TopComponent>) evt.getNewValue();
+ HashSet<TopComponent> oldHashSet = (HashSet<TopComponent>) evt.getOldValue();
+ for (TopComponent topComponent : newHashSet) {
+ if (!oldHashSet.contains(topComponent)) {
+ DataObject dObj = topComponent.getLookup().lookup(DataObject.class);
+ if (dObj != null) {
+ FileObject currentFile = dObj.getPrimaryFile();
+ if (currentFile != null && currentFile.getMIMEType().equals("text/x-java")) {
+StatusDisplayer.getDefault().setStatusText("Hurray! "
+ + "Opened " + currentFile.getNameExt(), 1);
+currentFile.addFileChangeListener(new FileChangeAdapter() {
+ @Override
+ public void fileChanged(FileEvent fe) {
+StatusDisplayer.getDefault().setStatusText("Hurray! "
+ + "Saved " + fe.getFile().getNameExt(), 1);
+ }
+ });
+ }
+ }
+ }
+ }
+ }
+ }
+ });
+ }
+
+}
+----
+
+See also link:http://java.net/projects/nbwicketsupport/sources/nbwicketsupport/content/WicketSuite/WicketCore/src/org/netbeans/modules/web/wicket/installer/Installer.java[http://java.net/projects/nbwicketsupport/sources/nbwicketsupport/content/WicketSuite/WicketCore/src/org/netbeans/modules/web/wicket/installer/Installer.java]
+
+Taken from nbdev-mailing list - thanks to Geertjan.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListenForOpenEvents[http://wiki.netbeans.org/DevFaqListenForOpenEvents] ,
+that was last modified by NetBeans user Markiewb
+on 2013-02-03T16:11:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListenForOpeningClosingProject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListenForOpeningClosingProject.asciidoc
new file mode 100644
index 0000000..18903d6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListenForOpeningClosingProject.asciidoc
@@ -0,0 +1,77 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListenForOpeningClosingProject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How to listen for projects to be opened/closed?
+
+== Specific for a project-type
+
+Implement a ProjectOpenedHook and register it to a project-type
+`
+
+[source,java]
+----
+
+@ProjectServiceProvider(
+ service =ProjectOpenedHook.class,
+ projectType = {"org-netbeans-modules-web-project"}
+)
+public class MyProjectOpenedHook extends ProjectOpenedHook {
+
+ private final Project project;
+
+ public MyProjectOpenedHook(Project project) {
+ this.project = project;
+ }
+
+ @Override
+ protected void projectOpened() {
+ System.out.println("opened"+project);
+ }
+
+ @Override
+ protected void projectClosed() {
+ System.out.println("closed"+project);
+ }
+}
+
+----
+
+`
+Inspired by link:https://github.com/shannah/mirah-nbm/blob/695afe895553bbcae0a2f3ad8bfc38f48963de9b/src/ca/weblite/netbeans/mirah/antproject/web/WebMirahProjectOpenedHook.java[https://github.com/shannah/mirah-nbm/blob/695afe895553bbcae0a2f3ad8bfc38f48963de9b/src/ca/weblite/netbeans/mirah/antproject/web/WebMirahProjectOpenedHook.java]
+
+== For all project-types
+
+See link:https://blogs.oracle.com/geertjan/entry/org_netbeans_spi_project_ui[https://blogs.oracle.com/geertjan/entry/org_netbeans_spi_project_ui]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListenForOpeningClosingProject[http://wiki.netbeans.org/DevFaqListenForOpeningClosingProject] ,
+that was last modified by NetBeans user Markiewb
+on 2015-03-12T18:54:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListenForSaveEvents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListenForSaveEvents.asciidoc
new file mode 100644
index 0000000..a1b94ea
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListenForSaveEvents.asciidoc
@@ -0,0 +1,79 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListenForSaveEvents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I be notified when a file is modified and saved??
+
+The link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.Registry.html[DataObject.Registry] in link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders[LoadersAPI] gives you a set of modified DataObjects. You can also add a listener and be notified when the set of modified objects changes.
+
+If you have a FileObject and want to listen for save events, you will need to get its DataObject by calling `link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataObject.html#find(org.openide.filesystems.FileObject)[DataObject.find()]`.
+
+To listen on a single DataObject for save events, simply add a `PropertyChangeListener` and listen for changes in `DataObject.PROP_MODIFIED`.
+
+Note that listening for something to be saved is _not the same as listening for any changes in the file_ - you are really listening only for (directly or indirectly) user-initiated save events, as in the user pressing CTRL-S when the file is modified and opened in the editor. For notifications about any changes in a file, instead attach a `link:DevFaqListenForChangesInNonExistentFile.html[FileChangeListener]` to the underlying `link:DevFaqFileObject.html[FileObject]`.
+
+== Track the currently modified files by DataObject Registry listening - Sample code
+
+[source,java]
+----
+
+DataObject.Registry registries = DataObject.getRegistry();
+registries.addChangeListener(new ChangeListener() {
+ public void stateChanged(ChangeEvent e) {
+ System.out.println("ChangedListener: o = " + e.getSource().getClass());
+ System.out.println("ChangedListener: o.source = " + e.getSource());
+ }
+});
+DataObject[] objects = registries.getModified();
+for (int i = 0; i < objects.length; i++) {
+ DataObject dataObj = objects[I];
+ System.out.println("data object name = " + dataObj.getName());
+ System.out.println("data object pimary file name = " + dataObj.getPrimaryFile().getName());
+ Set fss = dataObj.files();
+ Iterator iter = fss.iterator();
+ while (iter.hasNext()) {
+ FileObject fo = (FileObject) iter.next();
+ System.out.println("\tset file object: " + fo.getName());
+ }
+}
+
+----
+
+== Libraries needed
+
+* Datasystems API
+* File System API
+* Nodes API
+* Utilities API
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListenForSaveEvents[http://wiki.netbeans.org/DevFaqListenForSaveEvents] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:50:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqListeningForFileChanges.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqListeningForFileChanges.asciidoc
new file mode 100644
index 0000000..a336150
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqListeningForFileChanges.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqListeningForFileChanges
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I am listening for changes in a folder/file but when there are changes I do not receive an event
+
+If you are adding/deleting/changes using the FileSystems API - i.e. adding using link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#createData(org.openide.filesystems.FileObject,%20java.lang.String)[FileUtil.createData()] then it should work.
+
+If not, get the parent folder as a FileObject and call theFolder.getFileSystem().refresh().
+
+NetBeans will automatically do the refresh if focus is shifted away from the main window and back. However if files are created by an external process, or by using java.io.File.mkdir() or java.io.File.createNewFile() (which you shouldn't be using inside a NetBeans module unless you really need to), changes will not be noticed until something forces a refresh.
+
+The reasons for the way this is handled are twofold:
+
+1. There is not native support in Java for listening for changes in a file/folder (yet), though most OS's natively support it
+2. We used to use a system that polled on a timer, but this is a bad idea because the user can be using, say, email, and most of the in-memory copy of NetBeans can have been swapped out to disk by the OS - but to check for modified files, it has to be dragged back into memory out of the swap file to see if some files have changed, even though the user is using another application. That hurts performance of the user's other applications.
+
+If you are creating files or folders programmatically, use link:http://bits.netbeans.org/dev/javadoc/index.html[FileObject], not java.io.File and any nodes your UI shows for those files will automatically update.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqListeningForFileChanges[http://wiki.netbeans.org/DevFaqListeningForFileChanges] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-23T20:41:36Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLogActionStartup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLogActionStartup.asciidoc
new file mode 100644
index 0000000..aaf4776
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLogActionStartup.asciidoc
@@ -0,0 +1,191 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLogActionStartup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= How do you invoke the View/IDE Log Action programmatically?
+
+Problem: In a NetBeans Platform application, it is conceivable that the Output window's only use could be to show logging messages to the user. In this case, since the Output TopComponent is always persisted, and the IDE log is only attached via an Action, the Action should be invoked whenever the Output window is open.
+
+Solution: We can create an Installer class which will search for the existence of the Output window, and conditionally fire the action which attaches the IDE Log.
+
+=== Waiting for the Windows System to be ready
+
+Installer classes (those that extend ModuleInstall) will fire their restored() methods before the Windows System is available. This is a problem, since we need to be able to interrogate the TopComponent.Registry to determine if the Output window is open.
+
+The answer is to use the WindowManager.getDefault().invokeWhenUIReady() method.
+
+[source,java]
+----
+
+ @Override
+ public void restored()
+ {
+ //The TopComponent we're interested in isn't immediately available.
+ //This method allows us to delay start of our procedure until later.
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable()
+ {
+ @Override
+ public void run()
+ {
+ //Do something
+ }
+ });
+ }
+----
+
+=== Finding the Output TopComponent
+
+We find the Output TopComponent by the WindowManager.getDefault().findTopComponent() method. We must know the ID of the TopComponent we are searching for. In this case, it is "output".
+
+[source,java]
+----
+
+ @Override
+ public void run()
+ {
+ //Locate the Output Window instance
+ final String OUTPUT_ID = "output";
+ TopComponent outputWindow = WindowManager.getDefault().findTopComponent(OUTPUT_ID);
+----
+
+=== Determining if the Output window is open
+
+This is easily accomplished by using the methods of the TopComponent class.
+
+[source,java]
+----
+
+ if (outputWindow != null && outputWindow.isOpened())
+----
+
+=== Locating our Action from the System Filesystem (Layer)
+
+We can get a Lookup for a portion of the System Filesystem using Lookups.forPath(). Browse your layer file in context to determine where the instance of the action is stored. In our case, it is in Actions/View.
+
+[source,java]
+----
+
+ final String FOLDER = "Actions/View/";
+ Lookup pathLookup = Lookups.forPath(FOLDER);
+----
+
+==== Getting the Instance from our Lookup
+
+Now that we have a lookup to the appropriate folder of the System Filesystem, we need to know the instance file name of the Action we want to retrieve and invoke. We get this information from browsing our layer file in context. In our case, it is "org-netbeans-core-actions-LogAction".
+We then invoke actionPerformed() to fire the action.
+
+[source,java]
+----
+
+Action a = FileUtil.getConfigObject("Actions/org-netbeans-core-actions-LogAction.instance", Action.class);
+if (a != null) {
+ action.actionPerformed(null);
+}
+----
+
+== Putting it all together
+
+Here is the completed Installer class, with logging.
+
+[source,java]
+----
+
+/**
+ * This class makes it so that the action View/IDE-Logs is performed upon startup
+ * whenever the Output window is open.
+ */
+public class ViewLogsInstaller extends ModuleInstall
+{
+ private static final Logger logger = Logger.getLogger(ViewLogsInstaller.class.getName(), ViewLogsInstaller.class.getPackage().getName() + ".Log");
+
+ @Override
+ public void restored()
+ {
+ //The TopComponent we're interested in isn't immediately available.
+ //This method allows us to delay start of our procedure until later.
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable()
+ {
+ @Override
+ public void run()
+ {
+ //Locate the Output Window instance
+ final String OUTPUT_ID = "output";
+ logger.log(Level.FINE, "LOG_FindingWindow", OUTPUT_ID);
+ TopComponent outputWindow = WindowManager.getDefault().findTopComponent(OUTPUT_ID);
+
+ //Determine if it is opened
+ if (outputWindow != null && outputWindow.isOpened())
+ {
+ logger.log(Level.FINE, "LOG_WindowOpen", OUTPUT_ID);
+ final String FOLDER = "Actions/View/";
+ final String INSTANCE_FILE = "org-netbeans-core-actions-LogAction";
+
+ //Use Lookup to find the instance in the file system
+ logger.log(Level.FINE, "LOG_LookupAction", new Object[]{FOLDER, INSTANCE_FILE});
+ Lookup pathLookup = Lookups.forPath(FOLDER);
+ Template<Action> actionTemplate = new Template<Action>(Action.class, FOLDER + INSTANCE_FILE, null);
+ Result<Action> lookupResult = pathLookup.lookup(actionTemplate);
+ Collection<? extends Action> foundActions = lookupResult.allInstances();
+
+ //For each instance (should ony be one) call actionPerformed()
+ for (Action action : foundActions)
+ {
+ logger.log(Level.FINE, "LOG_FoundAction", action);
+ action.actionPerformed(null);
+ }
+ }
+ else
+ {
+ logger.log(Level.FINE, "LOG_WindowClosed", OUTPUT_ID);
+ }
+ }
+ });
+ }
+}
+----
+
+=== Log.properties file
+
+Place this file in the root package of your installer.
+
+[source,java]
+----
+
+LOG_FindingWindow=Attempting to locate TopComponent with ID ''{0}''
+LOG_WindowOpen=TopComponent with ID ''{0}'' is open
+LOG_LookupAction=Attempting to find Action instance at {0}{1}
+LOG_FoundAction=Found Action ''{0}''; calling actionPerformed()
+LOG_WindowClosed=TopComponent with ID ''{0}'' is closed or not instantiated
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLogActionStartup[http://wiki.netbeans.org/DevFaqLogActionStartup] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:23:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLogging.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLogging.asciidoc
new file mode 100644
index 0000000..b58dd86
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLogging.asciidoc
@@ -0,0 +1,282 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLogging
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Using java.util.logging in NetBeans
+
+The logging system in NetBeans is based on the standard JDK's java.util.logging and complies to it as much as possible. This document sumarizes the basic usecases and shall be treated as a guide for writing good NetBeans ready logging code. The info given here is valid for default configuration of the logger as it is used in NetBeans. However it is possible to fully replace the system by providing own logging properties as in any other JDK application. Then of course the behaviour may get completely different.
+
+Rather than printing raw exceptions to the console or implementing custom debug or logging facililities, code may use the Logger to access logging in a higher-level fashion. This way the logging messages can be dynamically turned on and off by single switch on command line or even during runtime.
+
+Another important thing is to chain stack traces to exceptions using Throwable.initCause(Throwable), permitting you to throw an exception of a type permitted by your API signature while safely encapsulating the root cause of the problem (in terms of other nested exceptions). Code should use Logger.log(Level.SEVERE, msg, exception) rather than directly printing caught exceptions, to make sure nested annotations are not lost and to allow pluged in handlers of logging to process the exceptions.
+
+It is possible to use global logger but it is preferred to create named and shared instances of loggers. The latter has the advantage of finer control of what is going to be logged or not, as each named instance can be turned on/off individually by using a command line property.
+
+=== Turning Logging On and Off
+
+As the logging system is completely JDK based, one can use the traditional properties of LogManager and customize logging completely by themselves.
+
+However there is a simpler way how to enable logging of an named logger. Just start NetBeans with -J-Dname.of.the.Logger.level=100 or any other number and all the log Levels with higher or equal value will immediatelly be enabled and handled by the system.
+
+It is possible to turn the logging dynamically when the application is running. It is enough to just:
+
+[source,java]
+----
+
+System.setProperty("name.of.the.Logger.level", "100");
+LogManager.getLogManager().readConfiguration();
+----
+
+and logging state for the "name.of.the.Logger" is changed. The first line in the above code snippet changes the global properties and the second one asks the system to refresh the configuration of all loggers in the system.
+
+Of course this only works if the default NetBeans logger is in place. Sometimes however it may make sence to provide completely different logger. This can be done by one of two JDK standard properties: java.util.logging.config.file or java.util.logging.config.class as described at LogManager's javadoc. If these properties are provide during the startup of the system, then the logging is fully dedicated to the configured custom loggers and of course no NetBeans standard configuration properties work.
+
+=== How to Write Logging Friendly Code
+
+==== Handling Exceptions
+
+To handle an exception and send it to the log file (and possibly show a blinking icon to the user in bottom right corner of the main window):
+
+[source,java]
+----
+
+private static final Logger logger = Logger.getLogger(ThisClass.class.getName());
+try {
+ foo.doSomething();
+} catch (IOException ioe) {
+ logger.log(Level.SEVERE, null, ioe);
+}
+----
+
+WARNING behaves the same way by default.
+
+If the exception is not important, and by default shall not be shown or logged at all one can use the Level.FINE, Level.FINER or Level.FINEST:
+
+[source,java]
+----
+
+try {
+ foo.doSomething();
+} catch (IOException ioe) {
+ logger.log(Level.FINE, "msg", ioe);
+}
+----
+
+The easiest way to make sure an exception is reported to the user is to use the dialog API with a code like this:
+
+[source,java]
+----
+
+try {
+ // some operations
+} catch (Exception ex) {
+ NotifyDescriptor.Exception e = new NotifyDescriptor.Exception(ex);
+ DialogDisplayer.getDefault().notifyLater(e);
+}
+----
+
+This code will present a dialog box with warning message extracted from the exception ex sometime in the "future" - e.g. when the AWT event queue is empty and can show the dialog. Use of notifyLater to plain notify is recommended in order to prevent deadlocks and starvations
+
+==== Retain nested stacktraces / change exception type
+
+To rethrow an exception use standard JDK's Throwable.initCause(Throwable) method. It is going to be properly annotated and printed when sent to logger:
+
+[source,java]
+----
+
+public void doSomething() throws IOException {
+ try {
+ doSomethingElse();
+ } catch (IllegalArgumentException iae) {
+ IOException ioe = new IOException("did not work: " + iae);
+ ioe.initCause(iae);
+ throw ioe;
+ }
+}
+// ...
+try {
+ foo.doSomething();
+} catch (IOException ioe) {
+ logger.log(Level.WARNING, null, ioe);
+}
+----
+
+==== Logging a warning and debug messages
+
+Logging shall usually be done with a named loggers, as that allows proper turning on and off from the command line. To log something into the log file one should use Level.INFO or higher:
+
+[source,java]
+----
+
+private static final Logger LOG =
+ Logger.getLogger("org.netbeans.modules.foo");
+
+public void doSomething(String arg) {
+ if (arg.length() == 0) {
+ LOG.warning("doSomething called on empty string");
+ return;
+ }
+ // ...
+}
+----
+
+For writing debugging messages it is also better to have a named logger, but the important difference is to use Level.FINE and lower severity levels:
+
+[source,java]
+----
+
+package org.netbeans.modules.foo;
+
+class FooModule {
+ public static final Logger LOG =
+ Logger.getLogger("org.netbeans.modules.foo");
+}
+// ...
+class Something {
+ public void doSomething(String arg) {
+ FooModule.LOG.log(Level.FINER, "Called doSomething with arg {0}", arg);
+ }
+}
+----
+
+==== Annotate Exceptions
+
+There is an easy way how to annotate exceptions with localized and non-localized messages in NetBeans. One can use Exceptions.attachMessage or Exceptions.attachLocalizedMessage . The non-localized messages are guaranteed to be printed when one does ex.printStackTrace(), to extract associated localized message one can use Exceptions.findLocalizedMessage .
+
+=== Using Structured Logging for Communication
+
+In spite of what one might think the JDK logging API is not just about sending textual messages to log files, but it can also be used as a communication channel between two pieces of the application that need to exchange structured data. What is even more interesting is that this kind of extended usage can coexist very well with the plain old good writing of messages to log files. This is all possible due to a very nice design of the single "logging record" - the LogRecord.
+
+Well written structured logging shall use the "localized" message approach and thus assign to all its LogRecords a ResourceBundle and use just a key to the bundle as the actually logged message. This is a good idea anyway, as it speeds up logging, because if the message is not going to be needed, the final string is not concatenated at all. However this would not be very powerful logging, so another important thing is to provide parameters to the LogRecord via its setParameters method. This, in combination with the MessageFormat used when the final logger is composing the logged message, further delay's the concatenations of strings. Morevoer it allows the advanced communication described above - e.g. there can be another module consumming the message which can directly get access to live objects and processes them in any way.
+
+Here is an example of the program that uses such structured logging:
+
+[source,java]
+----
+
+public static void main(String[] args) {
+ ResourceBundle rb = ResourceBundle.getBundle("your.package.Log");
+
+ int sum = 0;
+ for (int i = 0; i < 10; i++) {
+ LogRecord r = new LogRecord(Level.INFO, "MSG_Add");
+ r.setResourceBundle(rb);
+ r.setParameters(new Object[] { sum, i });
+ Logger.global.log(r);
+ sum += i;
+ }
+
+ LogRecord r = new LogRecord(Level.INFO, "MSG_Result");
+ r.setResourceBundle(rb);
+ r.setParameters(new Object[] { sum });
+ Logger.global.log(r);
+}
+----
+
+
+
+Of course the two keys has to be reasonably defined in the Log.properties bundle:
+
+[source,java]
+----
+
+# {0} - current sum
+# {1} - add
+MSG_Add=Going to add {1} to {0}
+
+
+# {0} - final sum
+MSG_Result=The sum is {0}
+----
+
+When executed with logging on, this example is going to print the expected output with the right messages and well substituted values:
+
+[source,java]
+----
+
+INFO: Going to add 0 to 0
+INFO: Going to add 1 to 0
+INFO: Going to add 2 to 1
+INFO: Going to add 3 to 3
+INFO: Going to add 4 to 6
+INFO: Going to add 5 to 10
+INFO: Going to add 6 to 15
+INFO: Going to add 7 to 21
+INFO: Going to add 8 to 28
+INFO: Going to add 9 to 36
+INFO: The sum is 45
+----
+
+This not surprising behaviour, still however it is one of the most efficient because the text Going to add X to Y is not constructed by the code itself, but by the logger, and only if really needed. So the descrbied logging style is useful of its own, however the interesting part is that one can now write following code and intercept behaviour of one independent part of code from another one:
+
+[source,java]
+----
+
+public class Test extends Handler {
+ private int add;
+ private int sum;
+ private int allAdd;
+
+ public void publish(LogRecord record) {
+ if ("MSG_Add".equals(record.getMessage())) {
+ add++;
+ allAdd += ((Integer)record.getParameters()[1]).intValue();
+ }
+ if ("MSG_Result".equals(record.getMessage())) {
+ sum++;
+ }
+ }
+ public void flush() {
+ Logger.global.info("There was " + add + " of adds and " + sum + " of sum outputs, all adding: " + allAdd);
+ }
+ public void close() { flush(); }
+
+ static {
+ Logger.global.addHandler(new Test());
+ }
+}
+----
+
+The basic trick is to register own Handler and thus get access to provided LogRecords and process them in any custom way, possibly pretty different than just printing the strings to log files. Of course, this is only possible because the handler understand the generic names of logged messages - e.g. MSG_Add and MSG_Result and knows the format of their arguments, it can do the analysis, and output:
+
+[source,java]
+----
+
+INFO: There was 10 of adds and 1 of sum outputs, all adding: 45
+----
+
+Indeed a structural logging can achive much more than shown in this simplistic example. Moreover it seems to be one of the most effective ways for logging, so it is highly recommended to use it where possible.
+
+From: link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/logging.html[Logging in NetBeans].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLogging[http://wiki.netbeans.org/DevFaqLogging] ,
+that was last modified by NetBeans user Cvdenzen
+on 2012-02-16T13:06:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLogicalKeybindings.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLogicalKeybindings.asciidoc
new file mode 100644
index 0000000..0ca59cd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLogicalKeybindings.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLogicalKeybindings
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why should I use D- for Ctrl and O- for Alt - I thought C stood for Ctrl and A stood for alt?
+
+(Wondering what this is about? See the link:DevFaqKeybindings.html[general FAQ item on keybindings]).
+
+There should be *no* Alt-bound keyboard shortcuts on Macintosh, _ever_ - it is used on international keyboards as the compose key (for a long time, we didn't know it, but Norwegian and French users could not type } or { in NetBeans - kind of limits the usefuless of a Java IDE).
+
+All standard shortcuts should be bound with wildcard keys - e.g., in the layer, not AS-P for Alt-Shift-P, but OS-P, which will map to Alt-Shift-P on PC and Ctrl-Shift-P on mac. For Ctrl/Command, in the layer put DS-P instead of CS-P to bind conditionally to ctrl on PC and command on mac.
+
+All Alt-bound keybindings in the IDE are specified with O so that they are rebound to Ctrl on mac, because they will interfere with typing in a lot of locales (the real way to think about it is "the mac does not have an Alt key" - it does but it is a composition key - you can't use it).
+
+Any alt-bound keybinding on mac is a bug. If you use the logical syntax for keybindings, your app will always work intuitively on any platform.
+
+Note that the mapping handling does skip key combinations that simply can't work on Mac - for example, Command-H and Command-Q are always consumed by the OS, so D-H and D-Q map to Ctrl-H and Ctrl-Q, respectively, everywhere.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLogicalKeybindings[http://wiki.netbeans.org/DevFaqLogicalKeybindings] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-24T21:17:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookup.asciidoc
new file mode 100644
index 0000000..3999431
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookup.asciidoc
@@ -0,0 +1,148 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a Lookup?
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/Lookup.html[Lookup] is a mechanism for finding instances of objects. It is pervasively used in NetBeans APIs. The general pattern is that you pass a Class object and get back an instance of that class or null. See the Javadoc for links to articles describing its inspiration and purpose.
+
+The simplest way to think of `Lookup` is that it is a `Map` where the keys are `Class` objects and the value for each key is an instance of the key class.
+
+There is the link:DevFaqLookupDefault.html[global lookup] which is used to find objects (often, but not always, singletons) that are registered throughout the system. Also, many types of objects have a method getLookup() that enables other code to get things specific to that object. In particular, `link:DevFaqWhatIsANode.html[Node]`s and `Project` objects have a `Lookup`.
+
+The primary purpose of Lookup is decoupling - it makes it possible to use generic objects to get very specific information, without having to cast objects to a specific type. Confused yet? It's simple. Take the example of link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/netbeans/api/actions/Openable.html[Openable] - it has one method, `open()` that will open a file in the editor.
+
+Say that I want to write some code that will open the selected file when the user does something. It could be an Action, a button, or maybe my code has just created a file and I want to open it. This is what I will do:
+
+[source,java]
+----
+
+Lookup selectedContext = Utilities.actionsGlobalContext();
+Openable o = selectedContext.lookup(Openable.class);
+if (o != null) {
+ o.open();
+}
+
+----
+
+The power of all this is in the level of decoupling it provides: My code that wants to open the file does not have to know anything at all about what happens when the file is opened, or what kind of file it is, or what module supports opening it. And the module that supports opening it does not need to know anything about who is going to open it. They both simply share a dependency on the abstract interface `Openable`. So either one can be replaced without affecting the other at all.
+
+This brings the link:apidesign:MVC.html[MVC] design pattern into link:apidesign:DCI.html[modular loosely coupled] world.
+
+A good example of this is in the link:http://platform.netbeans.org/tutorials/nbm-povray-1.html[POV-Ray tutorial]. It launches an external process that generates a `.png` file. When the process ends, it wants to open it, so it does the following:
+
+[source,java]
+----
+
+FileObject fob = FileUtil.toFileObject(new File(pathWePassedToProcess));
+if (fob != null) { //the process succeeded
+ DataObject dob = DataObject.find(fob);
+ Openable oc = dob.getLookup().lookup(Openable.class);
+ if (oc != null) { //the Image module is installed
+ oc.open();
+ }
+}
+
+----
+
+The fact is that it is the Image module that makes it possible to open `.png` files in link:NetBeans.html[NetBeans]. But the POV-Ray tutorial does not need to know or care that the Image module exists, or what it does - it simply says "open this".
+
+The common pattern you'll see for Lookup usage is one where there are three components:
+
+* Module A is pure link:API.html[API] - it provides some interfaces
+* Module B depends on A and implements those interfaces, providing them from a Node or Project or such
+* Module C wants to display some UI or do something with objects that implement those interfaces. It also depends on A, but does not need to know about B at all; either can be replaced independently, and the other will still function.
+
+For global services, the model is more simple - typically there will be some singleton object, implemented as an abstract class:
+
+[source,java]
+----
+
+public abstract class GlobalService {
+ public abstract void doSomething(Something arg);
+ public static GlobalService getDefault() {
+ GlobalService result = Lookup.getDefault().lookup(GlobalService.class);
+ if (result == null) {
+ result = new NoOpGlobalService();
+ }
+ return result;
+ }
+ private static class NoOpGlobalService extends GlobalService {
+ public void doSomething(Something arg) {}
+ }
+}
+
+----
+
+Some other module entirely actually registers an implementation of this interface in the link:DevFaqLookupDefault.html[default Lookup]. link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/StatusDisplayer.html[StatusDisplayer] is a good example of this pattern.
+
+==== What if multiple objects of the same type should be available?
+
+A `Lookup` is not limited to containing one singleton of any type. If there may be more than one of a given type in a Lookup, the syntax is slightly different:
+
+[source,java]
+----
+
+Collection<? extends SomeIface> c = Lookup.getDefault().lookupAll(SomeIface.class);
+
+----
+
+*Note:* In NetBeans versions prior to 6.0 you need to use `Lookup.Template` and `Lookup.Result.allInstances()`, because the `lookupAll()` method was not created until 6.0.
+
+The `Lookup.Result` can be listened on for changes in the result of the query. It is often useful to think of a Lookup as a _space_ in which objects appear and disappear, and your code can respond as that happens (the following code uses the NB 6.0 `lookupResult` method - just use the pattern above with the `Lookup.Template` for NetBeans 5):
+
+[source,java]
+----
+
+class ObjectInterestedInFooObjects implements LookupListener {
+ final Lookup.Result<Foo> result; //result object is weakly referenced inside Lookup
+ ObjectInterestedInFooObjects() {
+ result = someLookup.lookupResult(Foo.class);
+ result.addLookupListener(this);
+ resultChanged(null);
+ }
+ public void resultChanged(LookupEvent evt) {
+ Collection<? extends Foo> c = result.allInstances();
+ // do something with the result
+ }
+}
+
+----
+
+Another question is, on the side that's providing the lookup, if you _have_ a collection already, how can you expose that in a `Lookup`. For that, you can create your own `AbstractLookup` and use `InstanceContent` to provide the collection of objects that belong in your `Lookup`.
+
+If you need to merge together more than one lookup (for example, the lookup provided from `Node.getCookieSet().getLookup()` and one of your own which you will add and remove objects from), you can simply use [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html] `ProxyLookup`] - i.e. `new ProxyLookup (lookup1, lookup2, Lookups.singleton(someObject), ...)`
+
+Objects in a `Lookup` often are not instantiated until the first time they are requested; depending on the implementation, they may be weakly referenced, so that if an object is not used for a while, it can be garbage collected to save memory. So `Lookup` additionally enables lazy instantiation of objects, which is useful for performance reasons.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookup[http://wiki.netbeans.org/DevFaqLookup] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-14T17:13:46Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupContents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupContents.asciidoc
new file mode 100644
index 0000000..b106c9a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupContents.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupContents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I find out what is in a Lookup?
+
+The simplest way is to call `Lookup.toString()`. If you want the output in a more readable form, do the following and print/format the resulting collection as you wish:
+
+[source,java]
+----
+
+Collection<?> c = theLookup.lookupAll(Object.class);
+for (Object o : c) {
+ //do what you want
+}
+
+----
+
+*<u>Do not</u> do either of these things in production code!*
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupContents[http://wiki.netbeans.org/DevFaqLookupContents] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:16:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupCookie.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupCookie.asciidoc
new file mode 100644
index 0000000..0d41d7e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupCookie.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupCookie
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the difference between getCookie(Class), SharedClassObject.get(Class) and Lookup.lookup(Class)?
+
+All of these are really historical variations on the same theme. In all cases, you pass a `Class` object and get back null or an instance of that class. You can see the progression in genericness:
+
+`SharedClassObject` is the oldest version of the Lookup pattern in NetBeans APIs, dating to circa 1997 (because of various performance issues, eventually all usages of `SharedClassObject` should be deprecated and removed from the APIs). You'll see that form used in `SystemOption` for storing settings, and most of the singleton Action objects in the actions API. All objects returned by it will be instances of `SharedClassObject`.
+
+`getCookie()` (circa 1999) is specific to link:DevFaqWhatIsANode.html[Node]s and link:DevFaqDataObject.html[DataObject]s. It uses the same pattern, but all objects returned by it will implement the empty `Node.Cookie` marker interface.
+
+The down-side to both of the above is that they specify the return type. In the case of `Node.Cookie`, in practice, this meant that anything that might possibly need to be provided by a `DataObject` or `Node` needed to implement this silly marker interface, forcing it to have a dependency on the Nodes API, or a wrapper Cookie class had to be created to provide the underlying object, which just added useless classes and noise.
+
+link:DevFaqLookup.html[Lookup] is the most modern and generic version of this pattern, and probably the final one. It offers two advantages:
+
+1. Its return type is `java.lang.Object`, so it can be used directly with anything
+2. Having objects _own_ a lookup rather than directly providing a `lookup(Class c)` method makes it easier to replace or proxy the Lookup of some object
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupCookie[http://wiki.netbeans.org/DevFaqLookupCookie] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:51:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupDefault.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupDefault.asciidoc
new file mode 100644
index 0000000..e34e8aa
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupDefault.asciidoc
@@ -0,0 +1,96 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupDefault
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the "default lookup"?
+
+The default lookup is `Lookup.getDefault()`.
+It is the registry for global singletons and instances of objects which have been registered in the system by modules.
+(In JDK 6, `ServiceLoader` operates on the same principle.)
+The default lookup searches in two places:
+
+* The link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#metaInfServices(java.lang.ClassLoader)[META-INF/services/ Lookup] contains all objects registered by modules via the link:http://java.sun.com/j2se/1.4/docs/guide/extensions/[Java Extension Mechanism] - putting files in the `META-INF/services/` directory of their module JARs (typically done using the [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html] `@ServiceProvider`] annotation)
+* The contents of the `Services/` folder of the link:DevFaqSystemFilesystem.html[System (configuration) Filesystem] (this is harder and somewhat deprecated)
+
+Objects contained in the default lookup are instantiated lazily when first requested. Objects returned by the default lookup _may_ (or may not) be garbage collected if they become unreferenced.
+
+Here is the usual usage pattern:
+
+1. A central "controller" module defines some interface, e.g.
+
+[source,java]
+----
+
+package controller.pkg;
+public interface MyService {
+ void doSomething();
+}
+
+----
+
+2. Each module which wants to implement that service depends on the controller module which defines the interface, and creates and registers an implementation:
+
+[source,java]
+----
+
+@ServiceProvider(service=MyService.class)
+public class MyImpl implements MyService {
+ public void doSomething() {....}
+}
+
+----
+
+It is also possible to declaratively mask other people's implementations and declaratively order implementations so some will take precedence.
+
+3. The controller finds all implementations and uses them somehow:
+
+[source,java]
+----
+
+for (MyService s : Lookup.getDefault().lookupAll(MyService.class)) {
+ s.doSomething();
+}
+
+----
+
+=== More About Lookup
+
+* link:DevFaqLookup.html[DevFaqLookup]
+* link:http://bits.netbeans.org/dev/javadoc/usecases.html#usecase-Utilities[Extension Points Tutorial]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/Lookup.html[Javadoc for Lookup]
+
+<hr/>
+
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupDefault[http://wiki.netbeans.org/DevFaqLookupDefault] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:14:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupEventBus.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupEventBus.asciidoc
new file mode 100644
index 0000000..de1d0ca
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupEventBus.asciidoc
@@ -0,0 +1,151 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupEventBus
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Using Event Bus in NetBeans
+
+[source,java]
+----
+
+Dne Monday 26 November 2007 17:37:48 Rob Ratcliff napsal(a):
+> For the bus we developed, we could subscribe by a specific type, for all
+> subclasses of a type or for certain message header attributes of an
+> event. We also had a bus per "session" (the GUI could display multiple
+> sessions/workspaces using tabs -- equivalent to a JMS topic) ?so that
+> only events related to that session would be delivered. And, like I
+> mentioned earlier, there was support to register as a "GUI" listener or
+> a "business" listener so that events would automatically be delivered in
+> the correct thread to avoid EDT lockup and rendering issues.
+>
+> I'd be interested in hearing what you and others think about these types
+> of capabilities and how they compare to the NetBeans paradigms.
+----
+
+I've been thinking about this for a while and I believe that there is event
+bus like system in NetBeans. It is link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#actionsGlobalContext()[Utilities.actionsGlobalContext()]
+
+We have our event bus and it is accessible via
+link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#actionsGlobalContext()[Utilities.actionsGlobalContext()]. Indeed it may not be perfect, but it plays
+exactly the role described in the presentation. Menu, Toolbar, etc. listen on
+it, while somebody else updates it.
+
+Indeed, there could be some improvements. We do not support merging of events
+or network access, but if one really cares, there is a way to plug into the
+system. All one needs to do is to implement
+link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/ContextGlobalProvider.html[ContextGlobalProvider]
+One sample implelemention is in openide/windows and second in
+imagine.dev.java.net.
+
+I've heard a complain that...
+
+*> This is a central listener, not an event bus*
+
+... however this boils down to a question: How do you envision an event bus?
+It is a place to contain events or objects that somehow appear in the system.
+It allows anyone to selectively listen on what is happening in link:https://spar.dev.java.net/source/browse/spar/trunk/code/plugins/spar/src/com/jasperpotts/spar/event/application/[the bus]
+
+So in fact event bus is a central listener. Just like
+link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#actionsGlobalContext()[Utilities.actionsGlobalContext()].
+
+Indeed it could be improved. Is there anyone who would like to contribute in
+improving our actionsGlobalContext? If so, what should be done?
+
+[source,java]
+----
+
+Hi Jaroslav,
+
+I think it'd be useful to define exactly what an event bus is (like you
+mentioned), ?what use cases it supports and how NetBeans supports these
+use cases currently and how it might support these in the future.
+
+I used an EventBus approach in my last project ?for receiving
+asynchronous data events from the Network (such as position updates,
+network status events) and internal events such as service status
+(network disconnected) and other state change events such as "sensor
+network reconfigured"...essentially when it made more sense to use a hub
+and spoke communication model rather than a point-to-point. ?There could
+be multiple instances of the EventBus, which used a ?EDT type of model
+(dispatcher thread/queue) and supported subscriptions by type (any event
+derived from a base class) ?or property of the header.
+----
+
+Since the "Lookup Library" allows you to uncouple senders from
+receivers, and allows receivers to be notified of changes, I consider it
+as a small event bus.
+
+I consider "local lookups" as a small event bus, where you can listen to
+different "event topics". In the previous case, it would probably be enough to dedicate on Lookup for the network events and create various types holding enough information about the events. The you could add/remove/change the content of the lookup and deliver events about such changes.
+
+[source,java]
+----
+
+The instances
+could be looked up globally or injected into a given component. It
+supported "business" and "GUI" ?subscriptions to automatically deliver
+the event in the correct thread. If I did it again, ?I'm ?thinking I'd
+use a JMS style API that supported a Hibernate style OQL subscription.
+(I have some more details here:
+http://developers.sun.com/learning/javaoneonline/j1sessn.jsp?sessn=TS-3723&yr=2007&track=2)
+
+The EventBus talk given at JavaOne 2006 had some great use case examples:
+EventBus
+https://eventbus.dev.java.net/HopOnTheEventBus-Web.ppt
+
+These frameworks provide some other use cases and API examples:
+
+D-Bus
+http://www.freedesktop.org/wiki/Software/dbus
+http://www.freedesktop.org/wiki/IntroductionToDBus
+
+JUIPiter
+?http://juipiter.sourceforge.net
+
+Bradlee Johnson's ReflectionBus
+?http://sourceforge.net/projects/werx/
+
+Jasper-Potts - Why Spaghetti Is Not Tasty: Architecting Full-Scale
+Swing Apps?, 2007 JavaOne Conference, TS-3316
+http://developers.sun.com/learning/javaoneonline/j1sessn.jsp?sessn=TS-3316&yr=2007&track=2
+
+(Also see the JMS API and the OMG COS Notification Service API.)
+
+I don't have much time to spend a lot of time coding on the side right
+now, but I'd be happy to help define requirements and use cases if that
+would be useful to you.
+
+Thanks!
+Rob
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupEventBus[http://wiki.netbeans.org/DevFaqLookupEventBus] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:51:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupForDataNode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupForDataNode.asciidoc
new file mode 100644
index 0000000..f2cb202
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupForDataNode.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupForDataNode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I add support for `Lookup`s on nodes representing my file type?
+
+Any object you create can implement `Lookup.Provider`. The simplest way to create a mutable lookup is by using `InstanceContent` and `AbstractLookup`. Simplified typical usage:
+
+[source,java]
+----
+
+public SomeObject implements Lookup.Provider {
+ private InstanceContent content = new InstanceContent();
+ private final AbstractLookup lkp = new AbstractLookup(content);
+
+ public someMethod() {
+ ic.set (someCollection...);
+ }
+
+ public Lookup getLookup() {
+ return lkp;
+ }
+}
+
+----
+
+This is how you create a lookup with dynamic content of your choosing. See also Tom Wheeler's link:http://www.tomwheeler.com/netbeans/[TodoListManager] for an example of some code that illustrates how to do this.
+
+If you are using `link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html[ProxyLookup]` to proxy another (or multiple) lookups, and you want to change the set of Lookups you are proxying on the fly, you will need to subclass `ProxyLookup` and call the protected method [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html#setLookups(org.openide.util.Lookup[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html#setLookups(org.openide.util.Lookup]...) `setLookups(Lookup... lookups)`].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupForDataNode[http://wiki.netbeans.org/DevFaqLookupForDataNode] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:17:21Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupGenerics.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupGenerics.asciidoc
new file mode 100644
index 0000000..71bac61
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupGenerics.asciidoc
@@ -0,0 +1,90 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupGenerics
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I use Java Generics with Lookup?
+
+As of NetBeans 6, a number of convenience methods have been added to lookup, and support for Java generics has been added to Lookup. The following are differences (assume that `lkp` is a [[DevFaqLookup| `Lookup`]]):
+
+|===
+|NB 5.x Code |NB 6 Code
+
+|`DataObject dob = (DataObject) lkp.lookup(DataObject.class)` |`DataObject dob = lkp.lookup(DataObject.class)`
+
+|`Lookup.Result r = lkp.lookup(new Lookup.Template(X.class))` |`Lookup.Result<? extends X> r = lkp.lookupResult(X.class)`
+
+|`Collection c = r.allInstances()` |`Collection<? extends X> c = r.allInstances()`
+
+|`Lookup.Template t = new Lookup.Template(X.class);
+
+Lookup.Result r = lkp.lookup(t);
+
+Collection c = r.allInstances();`
+
+ |`Collection<? extends X> c = lkp.lookupAll(X.class);`
+
+|`Lookup.Template t = new Lookup.Template(X.class);
+
+Lookup.Result r = lkp.lookup(t);
+
+Collection c = r.allInstances();
+`
+`for (Iterator it=c.iterator(); it.hasNext();) {
+ X x = (X) it.next();
+
+ //do something with x
+
+}`
+
+ |`for (X x : lkp.lookupAll(X.class)) {
+
+ //do something with x
+
+}`
+
+
+|===
+
+
+
+Generics work well with JDK-5-style for-loops:
+
+[source,java]
+----
+
+for (SomeService s : Lookup.getDefault().lookupAll(SomeService.class)) {
+ // ...
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupGenerics[http://wiki.netbeans.org/DevFaqLookupGenerics] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-19T00:29:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupHowToOverride.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupHowToOverride.asciidoc
new file mode 100644
index 0000000..91ea294
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupHowToOverride.asciidoc
@@ -0,0 +1,81 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupHowToOverride
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I override an instance in the Default Lookup?
+
+As a result of NetBeans design for extensibility, you'll find a lot of code like this:
+
+[source,java]
+----
+
+DialogDisplayer displayer = DialogDisplayer.getDefault();
+
+----
+
+in which an API is defined `DialogDisplayer` as an abstract class or interface and an implementation is indirectly made available through a static method like `getDefault()`. This approach gives you a default implementation of `DialogDisplayer`, but also lets you "plug in" a different one of your own design.
+
+How do you do that? First, here's the implementation of the `getDefault()` method:
+
+[source,java]
+----
+
+public static DialogDisplayer getDefault() {
+ DialogDisplayer dd = (DialogDisplayer) Lookup.getDefault().lookup(DialogDisplayer.class);
+
+ if (dd == null) {
+ dd = new Trivial();
+ }
+
+ return dd;
+}
+
+----
+
+As you see, it will attempt to find some instance of `DialogDisplayer` from the default `Lookup` (in other words, one that has been registered via `META-INF/services/`). If it cannot find one, it will return the default implementation (an instance of `Trivial`, which is an inner class of `DialogDisplayer`).
+
+Therefore, it seems that you could override the default simply by registering your own implementation of `DialogDisplayer`). If you tried it, you'd find it doesn't work (or at least may not work consistently) because there are already other instances registered and they'll likely take precedence over yours.
+
+So, how do you mask out any other implementations so that yours will be used? In the file where you register the new implementation (`META-INF/services/org.openide.DialogDisplayer` in this case), you will prefix the other implementation with a pound sign and a minus sign before listing your own on a different line. For example, here's what the file should look like:
+
+[source,yaml]
+----
+
+#-org.netbeans.core.windows.services.DialogDisplayerImpl
+com.tomwheeler.example.SpecialDialogDisplayerImpl
+
+----
+
+More information about this and other Lookup-related topics, including how to set the order of registered services, can be link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/api.html[found in the Utilities API documentation].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupHowToOverride[http://wiki.netbeans.org/DevFaqLookupHowToOverride] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:15:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupImplement.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupImplement.asciidoc
new file mode 100644
index 0000000..a3b199d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupImplement.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupImplement
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I implement my own lookup or proxy another one?
+
+It is not uncommon to be subclassing a class, such as link:DevFaqWindowsTopComponent.html[TopComponent] or link:DevFaqWhatIsANode.html[Node] which has a method `getLookup()`, and to need to add to or filter the original Lookup's contents. There are a number of convenience factories and classes which make it easy to do this:
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ProxyLookup.html[ProxyLookup] - a Lookup which takes an array of Lookups and merges them together. Typical use is taking an existing lookup and providing it plus a lookup created with one of the convenience methods below
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#fixed(java.lang.Object...)[Lookups.fixed(Object... arr)] - a static method that creates a Lookup with an array of persistent objects as its contents
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#singleton(java.lang.Object)[Lookups.singleton (Object single)] - a static method that creates a Lookup with one object as its content
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/AbstractLookup.html[AbstractLookup] - a Lookup which can have dynamic content - use it in conjunction with link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/InstanceContent.html[InstanceContent], which you can add/remove things from
+
+If you need to customize a Node's lookup, read link:DevFaqNodesCustomLookup.html[the FAQ item on how to do that].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupImplement[http://wiki.netbeans.org/DevFaqLookupImplement] ,
+that was last modified by NetBeans user Geertjan
+on 2010-03-26T08:00:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupLazyLoad.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupLazyLoad.asciidoc
new file mode 100644
index 0000000..e54b000
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupLazyLoad.asciidoc
@@ -0,0 +1,141 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupLazyLoad
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I lazy-load an item in the Lookup?
+
+A node is typically used to represent some business object and it's a common idiom to place that business object in the node's lookup so that, for example, a context-sensitive action can operate on it. Sometimes fully initializing that business object can involve an expensive operation that would be wasted effort if the user never invoked the action that used it anyway.
+
+So how can you defer loading or initializing the business object until it is truly needed?
+
+There are probably several ways, but two common ones are:
+
+==== Override the `beforeLookup(Lookup.Template<?> template)` method
+
+If you are using the `AbstractLookup` class to create the lookup, you can override the `beforeLookup(Lookup.Template<?> template)`. By doing this, you will be notified just before a lookup query is processed and you could check to see if the template would match the objects for which you've deferred loading, giving you an opportunity to load them now and add them to the `InstanceContent` used by the `AbstractLookup`.
+
+==== Use `InstanceContent.Convertor` to create a placeholder object
+
+The `InstanceContent.Convertor` class can be registered in an `AbstractLookup` such that it provides a typesafe placeholder until the actual object type is requested, and at that point, the convertor can create and return the actual object.
+
+Consider the following example in which you have a `Token` class which represents a database record ID and a business object class `AnExpensiveClass` which will be populated from the database based on the supplied token's ID.
+
+[source,java]
+----
+
+public final class Token {
+
+ private final long id;
+
+ public Token(long id) {
+ this.id = id;
+ }
+
+ public long getId() {
+ return id;
+ }
+}
+
+----
+
+Now we will write a converter. Until the first time something calls `theLookup.lookup(AnExpensiveClass.class)`, only our quick-to-create `Token` object is in memory. On the first such lookup call, the following code is run:
+
+[source,java]
+----
+
+public class LazyLoadingDelegate implements InstanceContent.Convertor<Token, AnExpensiveClass> {
+
+ @Override
+ public AnExpensiveClass convert(Token token) {
+ // Return an instance based on the supplied token (i.e. assume that
+ // the AnExpensiveClass constructor will load data from the database
+ // and populate the instance we're returning).
+ return new AnExpensiveClass(token);
+ }
+
+ @Override
+ public Class<? extends AnExpensiveClass> type(Token token) {
+ return AnExpensiveClass.class;
+ }
+
+ @Override
+ public String id(Token token) {
+ return String.valueOf(token.getId());
+ }
+
+ @Override
+ public String displayName(Token token) {
+ return "my lazy loading delegate";
+ }
+}
+
+----
+
+==== Code that creates a Lookup and registers the InstanceContent:
+
+[source,java]
+----
+
+ ic = new InstanceContent();
+ al = new AbstractLookup(ic);
+
+ Token token = new Token(12345);
+ ic.add(token, new LazyLoadingDelegate());
+
+----
+
+Your link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/Actions.html#context[context-sensitive action] will behave normally—it does not need to know about the lazy loading (code not relevant to lazy loading has been removed for the sake of brevity):
+
+[source,java]
+----
+
+public final class ExpensiveClassAction implements ActionListener {
+ private final AnExpensiveClass expensiveClass;
+ public ExpensiveClassAction(AnExpensiveClass a) {
+ this.expensiveClass = a;
+ }
+
+ public void actionPerformed(ActionEvent ev) {
+ // now you have the actual do AnExpensiveClass instance,
+ // in variable expensiveClass
+ // so do something with it...
+ }
+}
+
+----
+
+==== Lifecycle With InstanceContent.Converter
+
+Objects created using an InstanceContent.Converter are only weakly cached by default. That means that, after AnExpensiveClass is instantiated, it can be garbage collected if no object holds a reference to it in a field. If the object is going to be queried for repeatedly, you may want your InstanceContent.Converter to cache the last-created value, either for some period of time, or using a SoftReference or hard reference or other caching strategy.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupLazyLoad[http://wiki.netbeans.org/DevFaqLookupLazyLoad] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:19:40Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupNonSingleton.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupNonSingleton.asciidoc
new file mode 100644
index 0000000..de1b5a3
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupNonSingleton.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupNonSingleton
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== If there is more than one of a type in a Lookup, which instance will I get?
+
+As noted in link:DevFaqLookup.html[the overview of Lookup], a Lookup can contain more than one instance of a given class; Lookup is often used for singletons, but not exclusively for singletons. For example, in the link:http://www.netbeans.org/download/dev/javadoc/ProjectAPI/overview-summary.html[Projects API], there is a class called link:http://www.netbeans.org/download/dev/javadoc/ProjectAPI/org/netbeans/spi/project/ProjectFactory.html[ProjectFactory] that recognizes different types of user projects on disk; each module that provides a project type registers another factory in the system.
+
+So the inevitable question is, if there are two instances of X in a Lookup, and I call `lookup(X.class)`, which one do I get?
+
+The answer is, it's undefined - don't do that. The next inevitable question is, but how can that be?
+
+A Lookup makes no assumptions about what's in it, or what you might want to put in it, or how many of anything there should be. That contract is an agreement between whoever tells you that you should get an instance of X from some Lookup and you. If they document that there will only be one, use `Lookup.lookup(Class)`. If they document that there can be more than one, use `Lookup.lookupAll(Class)` and iterate the results.
+
+In practice this is a non-problem - anything you are going to try to find in a `Lookup` is going to document whether it is supposed to be a singleton or not.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupNonSingleton[http://wiki.netbeans.org/DevFaqLookupNonSingleton] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-19T00:39:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupPackageNamingAndLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupPackageNamingAndLookup.asciidoc
new file mode 100644
index 0000000..a048f4a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupPackageNamingAndLookup.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupPackageNamingAndLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== After adding my class to Lookup I get a "ClassNotFoundException" when trying to look it up, why?
+
+Q: After adding my class to lookup I get a `ClassNotFoundException` when trying to look it up, why?
+
+A: You might have tried to place the interface and the implementation class in different modules but used the same package name. NetBeans prohibits two or more modules to define classes in the same package. Choose a distinctive package name (or package name prefix) for each module.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupPackageNamingAndLookup[http://wiki.netbeans.org/DevFaqLookupPackageNamingAndLookup] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T02:36:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupVsHashmap.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupVsHashmap.asciidoc
new file mode 100644
index 0000000..4a4845b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupVsHashmap.asciidoc
@@ -0,0 +1,50 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupVsHashmap
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why use this strange convention - wouldn't a Map be good enough?
+
+Other platforms do use string-keyed maps for this sort of thing, but there are some weaknesses with that approach:
+
+1. it is impossible to enforce link:DevFaqModuleDependencies.html[dependencies]. With `link:DevFaqLookup.html[Lookup]`, a module's code cannot request an object of type X unless it can load/access the `X.class`. The module trying to look up an X will not be able to see `X.class` unless it link:DevFaqModuleDependencies.html[declares a dependency] on the module that defines X _and_ the module which defines X says that it allows access to the Java package X lives in. (A `Map<Class<T>,T>` would do the same job as `Lookup`.)
+2. The class of values in a map can change without notice - so if you have `(SomeIface) foo = (SomeIface) globalMap.get("foo")`, some new version of the module that provides "foo" can change the return type, causing `ClassCastException` s; with `Lookup`, you cannot ever get an object that is not of the type you passed in the request - so Lookup's approach is more robust.
+3. `Lookup` supports listening to changes in the result.
+4. `Lookup` supports multiple instances for one key - if you call `lookup(X.class)` you get one instance. If you call `lookupAll(X.class)` you get a `Collection<? extends X>` (so with `lookupAll()` it is more like a `Map<Class<T>,List<T>>`)
+
+There are some other capabilities of `Lookup` (such as getting the specific type or number of results without actually creating objects, and providing named result items) but these are rarely used in practice.
+
+`Lookup` is very powerful, yet simple and generic; people quickly learn to love it, once they realize what it can do.
+
+See also the javadoc: [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/Lookup.html[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/Lookup.html] `org.openide.util.Lookup`]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupVsHashmap[http://wiki.netbeans.org/DevFaqLookupVsHashmap] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-18T23:58:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqLookupWhere.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqLookupWhere.asciidoc
new file mode 100644
index 0000000..c0b7cbf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqLookupWhere.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqLookupWhere
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What uses Lookup?
+
+There are a number of places link:DevFaqLookup.html[Lookup ] is commonly found/used in NetBeans. Generally, if you have found some class and you are wondering where on earth you get an actual instance of one of those, the answer is probably "from something-or-other's Lookup".
+
+Common cases:
+
+* `Lookup.getDefault()()` - you want to find some global singleton or all instances of a particular object link:DevFaqLookupDefault.html[registered in the system]
+* `Project.getLookup()` - provides objects specific to a project. The typical pattern is, you have used FileOwnerQuery to get the Project that owns some file, and now you want to find something like the classpath (from the Project's ClassPathProvider, which lives in its Lookup)
+* `link:DevFaqWhatIsANode.html[Node.getLookup()]` - this is how you get things like syntax trees, open and save interfaces and other miscellaneous stuff from Nodes representing files or other things
+* `link:DevFaqWindowsTopComponent.html[TopComponent.getLookup()]` - if you are writing a UI component, and want to affect the global selection, but your component doesn't display nodes and you don't have any use for Nodes, you probably want to provide your own Lookup here with whatever you want to include in it (things like link:http://www.netbeans.org/download/dev/javadoc/org-openide-nodes/org/openide/cookies/OpenCookie.html[OpenCookie], link:http://www.netbeans.org/download/dev/javadoc/org-openide-nodes/org/openide/cookies/SaveCookie.html[SaveCookie], objects your other UI code may want to track if you're doing a master-detail view, etc.)
+* `link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/Utilities.html#actionsGlobalContext()[Utilities.actionsGlobalContext()]` returns a `Lookup` which represents the global "selection context" in NetBeans. It is a `ProxyLookup` which proxies the lookup of whichever `link:DevFaqWindowsTopComponent.html[TopComponent]` currently has focus. So if you listen for changes in the presence or absence of a particular type in this lookup, you will receive appropriate changes whenever the backing `Lookup` being proxied changes.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqLookupWhere[http://wiki.netbeans.org/DevFaqLookupWhere] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:52:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMIMEResolver.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMIMEResolver.asciidoc
new file mode 100644
index 0000000..569e4fa
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMIMEResolver.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMIMEResolver
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I create declarative MIMEResolver and add new file type?
+
+There is a wizard available for NetBeans modules which does this for you. Just run *New File | Module Development | File Type*. Fill in the *MIME Type* text field and choose whether to recognize file by extension or XML root element. If you want more sophisticated recognition, choose "*by Filename Extension*" and edit created resolver xml after you finish the wizard. In the next step type in "*Class Name Prefix*" your preferred prefix and finish the wizard.
+
+Description of declarative MIME resolve can be found in link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/HOWTO-MIME.html[this document]. In most cases it should be enough to resolve files only by their extensions as the wizard does (see link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/resolverDocumentation.html#ext[ext element]). Other types of resolution can be more time expensive, so use them only exceptionally. Useful can be link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/resolverDocumentation.html#name[file name matching], link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/resolverDocumentation.html#pattern[file content matching] or link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/resolverDocumentation.html#magic[magic matching]
for binary files. Also consider existence of link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/resolverDocumentation.html#exit[exit element] intended for negative matching which can skips next conditions.
+
+---
+
+[source,java]
+----
+
+ Applies to: NetBeans 6.1+, pattern and name elements to 6.7+
+----
+[source,java]
+----
+
+ Related: link:DevFaqFileRecognition.html[DevFaqFileRecognition]
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMIMEResolver[http://wiki.netbeans.org/DevFaqMIMEResolver] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:53:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMainTitle.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMainTitle.asciidoc
new file mode 100644
index 0000000..afaff7b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMainTitle.asciidoc
@@ -0,0 +1,116 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMainTitle
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+By default, the main title shows the branding name plus the build number.
+
+For production deployment, it could be required to only show the branding name.
+
+There are several possible steps to achieve it:
+
+== Remove the build number
+
+The title of your application is located in a resource bundle:
+
+[source,java]
+----
+
+...\branding\modules\org-netbeans-core-windows.jar\org\netbeans\core\windows\view\ui\Bundle.properties
+----
+
+As of NetBeans 6.9, it is possible to use the link:NewAndNoteWorthy#Branding_Editor.html[Branding Editor] to edit this resource.
+
+To remove the version number prior to 6.9, manually edit the file and remove existing {0} tokens:
+
+:: *CTL_MainWindow_Title=AppBrandingName {0}*
+:: *CTL_MainWindow_Title_No_Project=AppBrandingName {0}*
+
+so it will be as:
+
+:: *CTL_MainWindow_Title=AppBrandingName*
+:: *CTL_MainWindow_Title_No_Project=AppBrandingName*
+
+Build number will not show in the application main title.
+
+== Change main title at runtime
+
+Inside the ModuleInstaller class for the GUI module:
+
+[source,java]
+----
+
+@Override
+public void restored() {
+ // some other code may go here...
+ WindowManager.getDefault().invokeWhenUIReady(new Runnable() {
+ @Override
+ public void run() {
+ JFrame mainFrame = (JFrame) WindowManager.getDefault().getMainWindow();
+ mainFrame.setTitle("Modified main title");
+ });
+ }
+ // some other code may go here...
+}
+----
+
+A word of caution related to porting existing Swing applications to NetBeans Platform.
+
+*This will not work!*
+
+[source,java]
+----
+
+@Override
+public void restored() {
+ // some other code may go here...
+ SwingUtilities.invokeLater(new Runnable(){
+ @Override
+ public void run() {
+ JFrame mainFrame = (JFrame) WindowManager.getDefault().getMainWindow();
+ mainFrame.setTitle("Modified main title");
+ });
+ }
+ // some other code may go here...
+}
+----
+
+Although it will not show any errors, *the main title will not be set!* in this case.
+
+== Other Options
+
+See also:
+
+* link:http://blogs.kiyut.com/tonny/2007/08/06/netbeans-platform-branding-and-version-info/[Branding version numbers using Ant]
+* link:DevFaqVersionNumber.html[DevFaqVersionNumber]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMainTitle[http://wiki.netbeans.org/DevFaqMainTitle] ,
+that was last modified by NetBeans user Choces
+on 2010-11-18T15:56:18Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMainwindowClosingAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMainwindowClosingAction.asciidoc
new file mode 100644
index 0000000..8a255b9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMainwindowClosingAction.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMainwindowClosingAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I change the closing action of the MainWindow?
+
+When you click the close button in the top right corner the application closes. If you want to do something before the application closes (e.g. show a dialog with OK and Cancel options) or prevent it from closing, this is possible.
+
+Make a class in your module that extends `org.openide.modules.ModuleInstall`. There is a *Module Installer* template that will create this class for you.
+
+Override the `closing` method and insert your special logic.
+If you return `false` the application will not exit.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMainwindowClosingAction[http://wiki.netbeans.org/DevFaqMainwindowClosingAction] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:52:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMakeGroupTemplate.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMakeGroupTemplate.asciidoc
new file mode 100644
index 0000000..6380e47
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMakeGroupTemplate.asciidoc
@@ -0,0 +1,53 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMakeGroupTemplate
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I make a file template which actually creates more than one file?
+
+For example, say you want to make a template which will appear in *File | New File* which will prompt the user for a name and location but then actually create several related files.
+
+Just use an arbitrary empty file as the template, and declare it to have an `instantiatingWizardURL` attribute with an instance of `WizardDescriptor.InstantiatingIterator`. The wizard iterator can specify any sequence of Swing panels you like to ask the user whatever questions you like, and at the end it can do whatever you like to create the new files. Return the created files in `instantiate()`.
+
+Here is an link:http://hg.netbeans.org/main/file/tip/apisupport.project/src/org/netbeans/modules/apisupport/project/ui/wizard/librarydescriptor/[example of a wizard that creates a number of files]. This is the link:http://hg.netbeans.org/main/file/tip/apisupport.project/src/org/netbeans/modules/apisupport/project/ui/resources/layer.xml[layer file that declares it] (look at `emptyLibraryDescriptor`).
+
+You may wish to reuse a standard GUI panel for picking a folder and name, as in
+`link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-projectuiapi/org/netbeans/spi/project/ui/templates/support/Templates.html#createSimpleTargetChooser(org.netbeans.api.project.Project,%20org.netbeans.api.project.SourceGroup[Templates.createSimpleTargetChooser]`.
+
+The NetBeans 5.0 module development support has a (meta-)wizard *New Wizard*. Choose *New File* for *Registration Type* and follow the wizard steps.
+
+See also link:https://blogs.oracle.com/geertjan/entry/multiple_files_from_a_single[https://blogs.oracle.com/geertjan/entry/multiple_files_from_a_single] (and its comments)
+---
+
+Applies to: NetBeans 5.0, 5.5, 6.X
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMakeGroupTemplate[http://wiki.netbeans.org/DevFaqMakeGroupTemplate] ,
+that was last modified by NetBeans user Markiewb
+on 2013-07-28T14:06:22Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMakeItTalk.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMakeItTalk.asciidoc
new file mode 100644
index 0000000..f5190e9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMakeItTalk.asciidoc
@@ -0,0 +1,58 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMakeItTalk
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+First add a dependency to link:https://sourceforge.net/projects/phonemic/[Phonemic], the library that does the magic, which is conveniently wrapped within the SodBeans modules. Here's the link:http://sodbeans.sourceforge.net/downloads/updates/sappy/updates.xml[update center for SodBeans].
+
+The only thing you need is two lines of code:
+
+[source,java]
+----
+
+TextToSpeech speech = TextToSpeechFactory.getDefaultTextToSpeech();
+speech.speak("Hello, World!");
+----
+
+This call also already handles making your calls thread safe and is efficient enough to handle thousands of TTS "requests" in rapid succession.
+
+Although this is the only import you will need in your code a screen reader needs to be installed in the client running the code. To overcome this just make sure to add the following modules so they are available in your application:
+
+image:Dependencies.jpg[]
+
+If you want your application to be blind accessible just include Sappy dependencies. This is not magic but does a great work on common things in the IDE. Some dependencies like Text to Speech Options are really optional but they provide option panes to customize Sappy (i.e. selecting voice, etc).
+
+And your application talks. Since link:https://sourceforge.net/projects/phonemic/[Phonemic] is a plain jar you can use it out of the platform as well.
+
+You can read more about Phonemic link:https://sourceforge.net/apps/trac/phonemic/[here].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMakeItTalk[http://wiki.netbeans.org/DevFaqMakeItTalk] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-09-19T18:21:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMavenHowToMigrateFromANT.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMavenHowToMigrateFromANT.asciidoc
new file mode 100644
index 0000000..e87509d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMavenHowToMigrateFromANT.asciidoc
@@ -0,0 +1,118 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMavenHowToMigrateFromANT
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+The following list was created while converting a simple plugin with less than 20 classes, so the migration steps of large projects might vary. But you should get the basic idea.
+
+* create a new maven based NBM using the ?New Project?-wizard (to reuse a working configuration)
+* copy the folder src and pom.xml to the old project
+* in pom.xml
+* define a groupId
+* set the name from OpenIDE-Module-Name entry in Bundle.properties
+* set the artifactid from OpenIDE-Module entry in MANIFEST.MF
+* set the version from OpenIDE-Module-Specification-Version entry in MANIFEST.MF
+* remove the line with OpenIDE-Module-Specification-Version entry from MANIFEST.MF
+* remove the line with OpenIDE-Module entry from MANIFEST.MF
+* remove nbproject/genfiles.properties
+* remove nbproject/platform.properties
+* remove nbproject/build-impl.xml
+* remove build.xml
+* move manifest.mf to folder src/main/nbm
+* move your sources (*.java) to src/main/java (or src/test/java) (GIT is very useful here, the commit history isn?t lost)
+* move your resources (not *.java) to src/main/resources (or src/test/resources) (especially Bundle.properties)
+* add dependencies (the most annoying part)
+* foreach dependency entry (code-name-base) in nbproject/project.xml add a dependency via the ?Add dependency? dialog OR add a dependency manually to pom.xml
+
+For example use
+
+[source,xml]
+----
+
+ <dependency>
+ <groupId>org.netbeans.api</groupId>
+ <artifactId>org-netbeans-modules-projectapi</artifactId>
+ <version>RELEASE73</version>
+ </dependency>
+----
+
+for
+
+[source,xml]
+----
+
+ <dependency>
+ <code-name-base>org.netbeans.modules.projectapi</code-name-base>
+ <build-prerequisite/>
+ <compile-dependency/>
+ <run-dependency>
+ <release-version>1</release-version>
+ <specification-version>1.46.1</specification-version>
+ </run-dependency>
+ </dependency>
+----
+
+(!) Note that the dots in the dependency name have to replaced by a dashes
+
+* add test dependenciesFor example use
+[source,xml]
+----
+
+ <dependency>
+ <groupId>org.netbeans.api</groupId>
+ <artifactId>org-netbeans-libs-junit4</artifactId>
+ <version>RELEASE73</version>
+ <scope>test</scope>
+ </dependency>
+----
+
+for
+
+[source,xml]
+----
+
+ <test-dependencies>
+ <test-type>
+ <name>unit</name>
+ <test-dependency>
+ <code-name-base>org.netbeans.libs.junit4</code-name-base>
+ <compile-dependency/>
+ </test-dependency>
+ </test-type>
+ </test-dependencies>
+----
+
+There is still more to do. Like to configure export packages, signing, homepage and so one. Most of these configuration settings defined in the original project.properties have a counterpart in the plugin configuration of the nbm-maven-plugin. See the detailed goal documentation at link:http://mojo.codehaus.org/nbm-maven/nbm-maven-plugin/nbm-mojo.html[http://mojo.codehaus.org/nbm-maven/nbm-maven-plugin/nbm-mojo.html]
+
+Copied from link:http://benkiew.wordpress.com/2013/10/21/how-convert-an-ant-based-netbeans-module-to-a-maven-based-netbeans-module/[http://benkiew.wordpress.com/2013/10/21/how-convert-an-ant-based-netbeans-module-to-a-maven-based-netbeans-module/]. Tested with NB7.4
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMavenHowToMigrateFromANT[http://wiki.netbeans.org/DevFaqMavenHowToMigrateFromANT] ,
+that was last modified by NetBeans user Markiewb
+on 2013-10-22T19:52:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMavenL10N.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMavenL10N.asciidoc
new file mode 100644
index 0000000..94e6b56
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMavenL10N.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMavenL10N
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I create localization modules using Maven?
+
+If you have localized versions of resources _in your own modules_, you can simply place them alongside the base version; for example, `src/main/resources/my/module/Bundle_de.properties` would provide a German translation of `src/main/resources/my/module/Bundle.properties`.
+
+But to localize _other people's modules_, then as explained in link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/i18n-branding.html#placement[Physical Placement of Localized Resources] you will need to create `modules/locale/*_*.jar` JARs with the localized resources. (Simply bundling localized resources in your own module will not work, because these are usually searched for starting with the original module's `ClassLoader`, which cannot "see" your modules.)
+
+The simplest way to do this is to use the existing [link:http://mojo.codehaus.org/nbm-maven-plugin/branding-mojo.html[http://mojo.codehaus.org/nbm-maven-plugin/branding-mojo.html] `nbm:branding` goal], which despite its name can handle localization as well as branding. (These are nearly interchangeable in the NB Platform.) image:Localedemo.zip[] demonstrates how to localize parts of the Options dialog to Czech. Take note of:
+
+* `lokalizace/pom.xml` asks to use this goal when building the module. It overrides the "branding token" (otherwise inherited from the parent POM) with your locale identifier. (Specifying this custom execution is required in the 3.3 plugin; future versions may run the goal automatically during the package phase when there is anything to process, but you would still need to declare the locale in your plugin configuration.)
+* `lokalizace/src/main/nbm-branding/` contains the actual localizations.
+* Localizations must be grouped by module to be localized, under a folder path matching the path of the original module in its cluster.
+* The locale suffix (`_cs` in this case) is inserted automatically by the build, so the source file should be named simply `Bundle.properties`.
+* `application/pom.xml` specifies `--locale cs` so that you can quickly test the localization just by running the app.
+* It also turns on `NbBundle` debugging mode when requested by a special profile. This can be helpful to pinpoint where a particular English string is coming from: every visible string will be annotated with a bundle number (cross reference with console output) and line number. You can also use the Search field in the branding editor (available from the context menu of `lokalizace`) to find all potentially localizable strings in the Platform matching some keyword; this editor also creates the right folder structure for you automatically when localizing new bundles.
+
+The module bundling the localizations can now be included in your app, or distributed by any other means. When the specified locale is active, your localizations will be applied.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMavenL10N[http://wiki.netbeans.org/DevFaqMavenL10N] ,
+that was last modified by NetBeans user Jglick
+on 2011-01-21T13:59:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMavenPlatformRebel.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMavenPlatformRebel.asciidoc
new file mode 100644
index 0000000..67fde13
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMavenPlatformRebel.asciidoc
@@ -0,0 +1,92 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMavenPlatformRebel
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Can I use JRebel to speed up development?
+
+Yes, you can. Once you have obtained JRebel and installed it locally, paste the following snippet into your application's root pom (parent of both the NetBeans application project and any NetBeans module projects you want to have reloaded upon change).
+
+[source,xml]
+----
+
+ <profile>
+ <id>rebel</id>
+ <activation>
+ <file>
+ <exists>/Users/mkleint/jrebel/jrebel.jar</exists>
+ </file>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.zeroturnaround</groupId>
+ <artifactId>jrebel-maven-plugin</artifactId>
+ <version>1.1.1</version>
+ <executions>
+ <execution>
+ <id>generate-rebel-xml</id>
+ <phase>process-resources</phase>
+ <goals>
+ <goal>generate</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+
+ <pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>nbm-maven-plugin</artifactId>
+ <configuration>
+ <!-- only works if additionalArguments not defined in the application's pom -->
+ <additionalArguments>-J-javaagent:/Users/mkleint/jrebel/jrebel.jar=org.netbeans.JarClassLoader,org.netbeans.StandardModule.OneModuleClassLoader</additionalArguments>
+ </configuration>
+ </plugin>
+ </plugins>
+ </pluginManagement>
+ </build>
+ <properties>
+ <netbeans.compile.on.save>app</netbeans.compile.on.save>
+ </properties>
+ </profile>
+----
+
+You will have to edit the path to your jrebel.jar you have locally. if multiple people are going to work on the project use an expression and define the path property in your settings.xml file.
+
+Please note that any layer or manifest registrations are not likely to be reloaded as JRebel doesn't have any special knowledge about NetBeans internals.
+
+The solution was tested with nbm-maven-plugin 3.8 and JRebel 5.0.1
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMavenPlatformRebel[http://wiki.netbeans.org/DevFaqMavenPlatformRebel] ,
+that was last modified by NetBeans user Mkleint
+on 2012-09-07T10:58:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMavenSystemScope.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMavenSystemScope.asciidoc
new file mode 100644
index 0000000..7f1871a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMavenSystemScope.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMavenSystemScope
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Why can't I use system scope for a library wrapper module?
+
+System-scope dependencies, like provided scope, are never packaged with a project's artifacts.
+
+See link:http://jira.codehaus.org/browse/MNBMODULE-120[MNBMODULE-120] for discussion and alternative solutions.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMavenSystemScope[http://wiki.netbeans.org/DevFaqMavenSystemScope] ,
+that was last modified by NetBeans user Jglick
+on 2010-11-09T14:09:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMemoryLeaks.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMemoryLeaks.asciidoc
new file mode 100644
index 0000000..089f564
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMemoryLeaks.asciidoc
@@ -0,0 +1,121 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMemoryLeaks
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I fix memory leaks?
+
+The first problem is to identify what is the root problem causing memory to not be used effectively.
+The usual approach for this is to analyze the complete contents of memory when the problem appears, using one of a number of appropriate tools, and ideally then find a solution.
+
+Below are some hints on how to analyze the content of memory:
+
+=== `jmap` and built-in dumpers in JDK
+
+==== Obtain the dump.
+
+If the problem causes `OutOfMemoryError`, it is possible to customize the JVM to provide a memory dump automatically whenever an `OutOfMemoryError` is thrown.
+link:FaqNetBeansAndOOME.html[FaqNetBeansAndOOME] describes what options can be used for this.
+If you are developing modules, it is a very good idea to set the option `-J-XX:+HeapDumpOnOutOfMemoryError`.
+
+If the memory leak is not so aggresive to fill all the available memory and cause an `OutOfMemoryError`, it is still possible to use `jmap` to generate the same dump.
+Running full GC before you create this dump can be a good idea as it can strip the size of dump file and remove some unimportant objects from the snapshot.
+You can do this by turning memory toolbar on (do a right click in toolbar area and check *Memory*).
+Repeating this several times can even collect large amounts of data held in various caches through soft or weak references and make it easier to browse the dump.
+
+==== Analyze the problem.
+
+Once you have the dump of the heap in a file, it is possible to open it using
+the NetBeans profiler.
+This has a number of analysis features and is integrated with the IDE, e.g. to browse sources.
+
+Alternately, you can use the JDK's tool `jhat`.
+It will start simple web server and you can use a web browser to see the data.
+There are many functions starting with lists of classes with numbers of objects and their size, navigation between references,
+finding of reference chains from GC root to certain objects.
+JavaScript can be used to express more complex queries.
+
+=== Other tools
+
+INSANE is a home-grown tool that is useful for analysis of memory content and also can be used in automated tests - so once you have fixed a memory leak, you can write a test that will fail if the memory leak is ever recreated.
+`NbTestCase.assertGC` is all you need to know. See also link:FitnessMemoryLeaks.html[FitnessMemoryLeaks].
+
+link:FitnessViaTimersCounter.html[Timers/counters] module can be used to register objects of interest in the code, then inspect them during IDE run via Runtime Watches window.
+
+Advanced: link:http://www.opensolaris.org/os/community/dtrace/[DTrace] can be used to monitor object allocation and garbage collection. Nice article about using DTrace with the HotSpot provider: link:http://www.solarisinternals.com/wiki/index.php/DTrace_Topics_Java[Java and DTrace].
+
+=== Tips and tricks
+
+==== Common leaking objects
+
+There are some typical classes where it should be easily possible to tell
+what the appropriate number of their instances in memory should be,
+and if these are leaking there is a serious problem:
+
+* Projects - it means instances of all subclasses of `org.netbeans.api.project.Project`
+* Editors (or `TopComponent`s) - it can be useful to check for `org.openide.text.QuietEditorPane` instances to see if closed editors can release substantial part of associated memory. If the editor component is held it often means that associated editor support is held too linking to parsing data, sidebars providing versioning information and probably also project metadata. It is also possible to look for instance of `org.openide.windows.TopComponent` if there is some suspicion or better to search for its particular subclasses. Generally there will be always certain numbers of `TopComponent`s.
+* Documents - somewhat related to editors. An important class where you can start is `org.netbeans.modules.editor.NbEditorDocument`.
+* Top-level windows - undisposed dialogs can be a problem as these hold native resources that can be limited in the system.
+* `ClassLoader` - we need to be very careful and check that class loaders created dynamically during runtime can be GC'ed when they are no longer used. Without this the result is OOME signaling that perm gen area is full.
+* `CompilationInfo` (`java.source` module) - related to Java infrastructure. An important class where you can start is `com.sun.tools.javac.code.Symtab`, which is a singleton in a javac instance.
+
+==== Leaks vs. retained memory
+
+There are two different ways how memory can be wasted: leaks and improper retention of memory.
+
+_Leaks_ are cases when repeated invocation of certain activity creates new set of objects that cannot be reclaimed after
+activity is finished.
+The biggest problem is accumulation of these objects that leads to increased memory usage
+and after a long enough time leads to `OutOfMemoryError`.
+The nature of this error is that it leaves data structures of an application in undefined state
+so anything executed after this moment may lead to unexpected results.
+
+_Retained memory_ is memory occupied by objects that were created to serve some purpose but these objects
+are held longer than necessary.
+This may mean that some action has to be performed that flushes these objects or they will remain in memory until the end of the session.
+An example of the former is LRU caches (often holding last component in UI, files or projects).
+A common example of the latter is resources like parsed bundles or images statically referenced in classes that use them.
+
+`-J-Dnetbeans.debug.heap` can make profiling easier as it more quickly releases references to collapsed nodes.
+
+If you have the *Timers* module enabled (normally it is in dev builds),
+click its button in the *Memory* toolbar
+to get a summary of interesting live objects and statistics.
+
+---
+Applies to: NetBeans 6.5 and above
+
+Platforms: All
+
+link:Category:Performance:HowTo.html[Category:Performance:HowTo]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMemoryLeaks[http://wiki.netbeans.org/DevFaqMemoryLeaks] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:17:25Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMigratingToNewerPlatform.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMigratingToNewerPlatform.asciidoc
new file mode 100644
index 0000000..83bdec1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMigratingToNewerPlatform.asciidoc
@@ -0,0 +1,85 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMigratingToNewerPlatform
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Migrating to a newer version of the Platform
+
+When migrating a module suite application to use a newer version of the platform you may want to be aware of the following issues:
+
+* *The newer platform may contain new modules in the platform and/or ide cluster that are not excluded in your platform.properties*
+* The clusters that your application depends on may have added new modules. If you enabled a cluster and disabled all the modules you did not need before, you may be surprised when you go to build your application with the newer platform and get warning about module dependency errors. This is because the cluster has added new modules that are not listed as being excluded for your project. If you get errors regarding module dependencies when you migrate, you may want to check your project's settings to see if there are new modules that were introduced that you do not need and disable them.
+
+* *The newer platform may include modules with newer versions*
+* For example, in 6.9, the Lookup classes have been moved into a separate module, named Lookup API. Therefore, all modules making use of Lookup need a new dependency on this new module. Also, dependencies on the Utilities API module, which previously contained the Lookup classes, need to be updated to the latest version. For Ant-based NetBeans Platform applications, run this target for each module making use of Lookup-related classes:
+
+ <pre> ant fix-dependencies </pre>
+
+* In the IDE, you can do the following to run the above Ant target:
+* Important Files > Build Scripts (right click) > Run target > fix-dependencies.
+* Also, instead of the above, you can simply add the Lookup API module to each module that makes use of the Lookup classes. For each module, right-click the module in NetBeans IDE, choose Properties, go to the Libraries panel, click Add Dependency, and then add the Lookup module. For the Utilities API module, you can remove it from the list of dependencies and then readd it to set the correct version of the dependency.
+* The difference between the above two options is as follows: The second option is much faster - perhaps 15 seconds for each module. The first option (ant fix-dependencies) is much slower - perhaps two minutes or more per module - but it is much more complete and generic in that it removes old unused dependencies as well as adding new dependencies.
+* To achieve the above for Maven-based NetBeans Platform applications
+* you need to add the Lookup dependency to the POM of all modules that use Lookup:
+[source,xml]
+----
+
+<dependency>
+ <groupId>org.netbeans.api</groupId>
+ <artifactId>org-openide-util-lookup</artifactId>
+ <version>${netbeans.version}</version>
+</dependency>
+----
+
+
+
+* For Maven-based applications
+* you also need to update the "platform" definition (from "platform11" to "platform") in the application module:
+[source,xml]
+----
+
+<dependency>
+ <groupId>org.netbeans.cluster</groupId>
+ <artifactId>platform</artifactId>
+ <version>${netbeans.version}</version>
+ <type>pom</type>
+</dependency>
+----
+
+* *API-changes/New or Deprecated API/Incompatibilities*
+* link:http://bits.netbeans.org/dev/javadoc/apichanges.html[http://bits.netbeans.org/dev/javadoc/apichanges.html]
+
+== Further Resources
+
+* link:http://bruehlicke.blogspot.com/2016/10/porting-my-nb-65-rcp-app-to-nb-82.html[http://bruehlicke.blogspot.com/2016/10/porting-my-nb-65-rcp-app-to-nb-82.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMigratingToNewerPlatform[http://wiki.netbeans.org/DevFaqMigratingToNewerPlatform] ,
+that was last modified by NetBeans user Markiewb
+on 2016-11-24T13:02:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMixingLightweightHeavyweight.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMixingLightweightHeavyweight.asciidoc
new file mode 100644
index 0000000..fbcfa51
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMixingLightweightHeavyweight.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMixingLightweightHeavyweight
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to mix lightweight (Swing) and heavyweight (AWT) components?
+
+Since JDK 6 update 12 and JDK 7, support for mixing of AWT (heavyweight, native widgets) and Swing (lightweight, pure Java widgets) is available and usually works quite well. However, placing a native AWT Component within a Swing container hierarchy with customizations may cause unwanted side-effects and can therefor be disabled.
+
+As of NetBeans 7.3, an additional option has been added to
+etc/netbeans.conf to disable mixing by default:
+
+[source,java]
+----
+
+-J-Dsun.awt.disableMixing=true
+----
+
+In some cases, such as displaying OpenGL content via JOGL, it may be necessary to add a native component to a NetBeans TopComponent. In that case, the default setting breaks usability of the platform application by incorrectly drawing menus and other lightweight components behind the native component. To re-enable the mixing, the above option needs to be set to false:
+
+[source,java]
+----
+
+-J-Dsun.awt.disableMixing=false
+----
+
+For reference, see link:http://docs.oracle.com/javase/7/docs/webnotes/tsg/TSG-Desktop/html/awt.html[Oracle Notes on AWT]
+
+<hr/>
+Applies to: NetBeans 7.3 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMixingLightweightHeavyweight[http://wiki.netbeans.org/DevFaqMixingLightweightHeavyweight] ,
+that was last modified by NetBeans user Nhoffmann
+on 2013-02-26T14:08:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModifyOpenFile.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModifyOpenFile.asciidoc
new file mode 100644
index 0000000..a52b128
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModifyOpenFile.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModifyOpenFile
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Is it safe to programmatically modify a file which is open in the editor?
+
+It is not safe to modify a `FileObject` (via `getOutputStream`) which is open and _modified_ in the editor. In fact, it is not possible: calling `FileObject.lock()` will fail. If you modify the `java.io.File` (bypassing the Filesystems API) you may cause a conflict.
+
+If the file is not modified in the editor (easily checkable via `DataObject.isModified()`) then after your output stream is closed the file will be reloaded with the new contents.
+
+If the file _is_ modified you can make changes to the open editor buffer: use `EditorCookie` to acquire the Swing `Document` and make changes through that. It may be considered impolite to then save the file if it was modified before.
+
+--
+
+Applies to: NetBeans 4.0 and newer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModifyOpenFile[http://wiki.netbeans.org/DevFaqModifyOpenFile] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T13:28:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleCCE.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleCCE.asciidoc
new file mode 100644
index 0000000..b885063
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleCCE.asciidoc
@@ -0,0 +1,98 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleCCE
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Why am I getting a `ClassCastException` when the class is clearly of the right type?
+
+Q: I am getting an exception when I run my module, such as
+
+[source,java]
+----
+
+java.lang.ClassCastException: Implementation cannot be cast to Interface
+ at Factory.newInstance (Factory.java:123)
+----
+
+But `Implementation` implements `Interface`, so why is this a CCE?
+
+A: Usually this is because the `Interface` that `Implementation` actually implements was loaded from a different class loader than what `Factory` sees.
+
+That is very likely the immediate cause of the CCE. The root cause is not always obvious, but it is likely to be that some code uses `Thread.currentThread().getContextClassLoader()` to load a class by name. In NB by default the context class loader just looks around in loaded modules (lacking any better information), so it is possible for the following situation to arise:
+
+[source,java]
+----
+
+module A: Interface, Factory
+module B > A: Implementation implements Interface
+module C: Interface, Factory
+module D > A: Implementation implements Interface
+----
+
+where `Factory` does something like:
+
+[source,java]
+----
+
+Interface i = (Interface) Class.forName("Implementation", true,
+ Thread.currentThread().getContextClassLoader()).newInstance();
+----
+
+(This is a common design pattern for XML parsers, etc.)
+
+Now if A's `Factory` happens to get D's `Implementation` (or C's gets B's) then you get a CCE at runtime.
+
+An especially silly variant of this problem, known to occur at least in Xerces (), is that `Implementation` actually resides in the same JAR as `Interface` and `Factory`, and is the standard impl almost everyone uses unless overridden somehow - yet `Factory` loads it by name from the CCL rather than simply loading it directly using e.g. `new Implementation()`.
+
+The usual workaround is to wrap the problematic call(s) in a dynamic block:
+
+[source,java]
+----
+
+ClassLoader orig = Thread.currentThread().getContextClassLoader();
+Thread.currentThread().setContextClassLoader(SomeReferenceClass.class.getClassLoader());
+try {
+ Factory.load(...);
+} finally {
+ Thread.currentThread().setContextClassLoader(orig);
+}
+----
+
+Note: NetBeans forbids ambiguous delegations. ()
+If a class could be loaded from two (or more) places, it will not be loaded at all.
+This does not solve your problem but it at least ensures it gets reported more reliably
+and with a descriptive message rather than an odd `ClassCastException`.
+
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleCCE[http://wiki.netbeans.org/DevFaqModuleCCE] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:11:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleDependencies.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleDependencies.asciidoc
new file mode 100644
index 0000000..5b31b76
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleDependencies.asciidoc
@@ -0,0 +1,76 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleDependencies
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do module dependencies and class loading work?
+
+The nuts and bolts of module dependencies are as follows:
+
+* Modules can load classes from modules they depend on. They have to declare a dependency on them.
+* NetBeans does not care about things like the `CLASSPATH` environment variable - it knows how to find modules in an installation of NetBeans, and enforces dependencies between them.
+
+What this means is that if
+
+* Module B tries to use a class from module A, but module B does not _explicitly state_ that it depends on A, or...
+* Module B tries to use a class from module A, and it _does_ declare a dependency on Module A, _but_ the package that class is in is not in the list of packages A says other modules can touch...
+
+then a `NoClassDefFoundException` will be thrown at runtime.
+(If you even get that far - the module build harness will refuse to even compile module B in such cases.)
+
+An exception to the second item is that if Module B declares an _implementation dependency_ on module A, then it will have access to the full set of classes.
+Normally you should not need to do this,
+and anyway it will then be hard to upgrade B independently of A.
+
+Modules can also load classes from libraries - JAR files that are packaged with the module (see link:DevFaqHowPackageLibraries.html[DevFaqHowPackageLibraries]).
+Some points to remember about libraries:
+
+* They are delivered to the user inside the NBM file if they are not part of a full application based on NetBeans.
+* When unpacked, the module will end up in `$SOMECLUSTER/modules/` and any libraries will end up in `$SOMECLUSTER/modules/ext/`.
+* The module will use the library by having an entry in its manifest `Class-Path: ext/someLibrary.jar` the same way any JAR would.
+
+If you are using the IDE's module development support,
+you will manage module dependencies in the properties dialog for your module
+(or the *Libraries* node in the *Projects* tab).
+This just modifies `yourmodule/nbproject/project.xml`.
+The data saved there is then used to generate the appropriate manifest entries for you.
+
+If you are writing a module that will use some third party libraries,
+you probably want to read link:DevFaqWrapperModules.html[DevFaqWrapperModules] and also link:DevFaqWhenUseWrapperModule.html[DevFaqWhenUseWrapperModule].
+
+For more details, see the link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/classpath.html[reference documentation about classloading in NetBeans].
+
+<hr/>
+
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleDependencies[http://wiki.netbeans.org/DevFaqModuleDependencies] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T13:40:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleDupePackages.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleDupePackages.asciidoc
new file mode 100644
index 0000000..a91d9d5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleDupePackages.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleDupePackages
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can two or more modules contain the same package?
+
+Yes, NetBeans does permit multiple modules to load from a single package.
+However, this should be considered poor style and avoided whenever possible.
+In particular, the Java runtime forbids package-private accesses
+between classes defined by different class loaders
+(e.g. classes contained in different modules).
+
+Applies to: NetBeans 6.1 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleDupePackages[http://wiki.netbeans.org/DevFaqModuleDupePackages] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:12:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleLoadUnloadNotification.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleLoadUnloadNotification.asciidoc
new file mode 100644
index 0000000..2e14b9c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleLoadUnloadNotification.asciidoc
@@ -0,0 +1,103 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleLoadUnloadNotification
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can code in one module be notified when other modules are loaded or unloaded?
+
+Let's begin by stating that you probably do not _need_ to know when other modules are loaded or unloaded.
+The module system takes care of dependency management for you,
+so your module should never be loaded unless all of its stated dependencies are loaded too.
+
+The normal means of communicating between modules about available services
+(which you could consider _indirect dependencies_) is using the Lookup API.
+If what you really wanted was to know when a _service_ became available,
+you do not need to listen to module load or unload events as such;
+which module hosts the service is not of direct interest.
+Instead:
+
+1. Define a service `some.Interface` in some module.
+2. Implement that interface using `some.Implementation` in some other module. Register it with `@ServiceProvider(service=Interface.class)`.
+3. In some module consuming the service, use
+[source,java]
+----
+
+ import some.Interface;
+ // ...
+ private static final Lookup.Result<Interface> services =
+ Lookup.getDefault().lookupResult(Interface.class);
+ static {
+ services.addLookupListener(new LookupListener() {
+ public void resultChanged(LookupEvent ev) {
+ // some module was loaded or unloaded!
+ }
+ });
+ }
+ // ...
+ for (Interface service : services.allInstances()) {
+ // use a currently available service
+ }
+----
+
+If you simply want to run some code when _your_ module loads or unloads,
+registering an instance of
+link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html[ModuleInstall]
+will do the trick.
+There is even a wizard in the IDE for setting this up.
+
+But in the very rare case that you want to be notified when _other_ modules are loaded or unloaded,
+it is possible because:
+
+1. You can use link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/Lookup.Result.html[Lookup.Result] to listen to changes in the contents of a `Lookup`, even the global lookup.
+2. Every module installs an instance of link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInfo.html[ModuleInfo] into the default `Lookup` so the module system (or other code) can find out details about the module including its code name base, version numbers and display name.
+
+By using these two facts together, it is possible to listen to changes in the installed modules by running code like this at some point in the application's lifecycle (link:DevFaqAppLifecycleHooks.html[DevFaqAppLifecycleHooks]):
+
+[source,java]
+----
+
+ final Lookup.Result<ModuleInfo> result =
+ Lookup.getDefault().lookupResult(ModuleInfo.class);
+ result.addLookupListener(new LookupListener() {
+ public void resultChanged(LookupEvent event) {
+ // it seems a module was installed or removed
+ }
+ });
+----
+
+Once you detect that a module has been created you may also want to register a `PropertyChangeListener` and listen to `ModuleInfo.PROP_ENABLED`.
+(A module present in the installation will provide a `ModuleInfo` but `isEnabled` might be false if it is not currently loaded.)
+
+<hr/>
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleLoadUnloadNotification[http://wiki.netbeans.org/DevFaqModuleLoadUnloadNotification] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:18:59Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleObfuscation.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleObfuscation.asciidoc
new file mode 100644
index 0000000..b1a5f83
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleObfuscation.asciidoc
@@ -0,0 +1,229 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleObfuscation
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I obfuscate a module?
+
+If you want to protect a NetBeans module from disassembly, you can obfuscate it.
+For example you can use link:http://proguard.sourceforge.net/[ProGuard], an open-source obfuscator.
+
+1. Copy `proguard.jar` somewhere on disk, referenced by `proguard.jar.path`. You can do this for example by creating a `build.properties` in the module directory and reference it in the `build.xml` like
+
+[source,xml]
+----
+
+ <!-- Load project's default properties -->
+ <property file="${basedir}/build.properties"/>
+
+ <import file="nbproject/build-impl.xml"/>
+
+<!-- ### BEGIN OBFUSCATION TARGETS ###-->
+
+----
+
+This example is assuming that you have created a directory called `tools` parallel to your module. Under that `tools` directory have you copied the proguard jar file into <pre>tools/obfuscating/jar/proguard.jar</pre>
+
+The `build.properties` could look like the following example.
+
+[source,java]
+----
+
+tools.dir=../tools
+proguard.jar.path=${tools.dir}/obfuscating/jar/proguard.jar
+----
+
+2. Edit the `build.xml` of your module and override some targets as in the following excerpt:
+
+[source,xml]
+----
+
+<!-- Replace the non-obfuscated jar with the obfuscated one when compiling -->
+<target name="netbeans-extra" depends="obfuscate">
+ <copy file="${suite.dir}/build/obfuscated/${module.jar}"
+ tofile="${cluster}/${module.jar}"/>
+</target>
+
+<!-- Overridden debug target that depends on netbeans-debug -->
+<target name="debug" depends="netbeans-debug,-jdk-presetdef-nbjpdastart">
+ <ant antfile="${harness.dir}/run.xml" target="debug"/>
+</target>
+
+<!-- netbeans-debug DOES NOT depends on netbeans-extra
+ (then DOES NOT depends on obfuscate) -->
+<target name="netbeans-debug"
+ depends="init,jar,module-xml-regular,module-xml-autoload,
+ module-xml-eager,javahelp,module-auto-deps,release,verify-class-linkage">
+ <genlist outputfiledir="${cluster}" module="${module.jar}">
+ <fileset dir="${cluster}">
+ <patternset refid="module.files"/>
+ </fileset>
+ </genlist>
+</target>
+
+<!-- Overridden to delete also the obfuscated jar -->
+<target name="clean" depends="files-init,testuserdir-delete">
+ <delete failonerror="false" includeemptydirs="true">
+ <fileset dir="build">
+ <exclude name="testuserdir/"/>
+ </fileset>
+ </delete>
+ <delete dir="${netbeans.javadoc.dir}/${code.name.base.dashes}"/>
+ <delete file="${netbeans.javadoc.dir}/${code.name.base.dashes}.zip"/>
+ <delete failonerror="false"> <!-- #59457: OK if cluster does not exist currently -->
+ <fileset dir="${cluster}">
+ <patternset refid="module.files"/>
+ </fileset>
+ </delete>
+ <delete file="${cluster}/update_tracking/${code.name.base.dashes}.xml"/>
+ <delete file="${suite.dir}/build/obfuscated/${module.jar}"/>
+</target>
+
+<!-- Just a cut and paste of how the proguard obfuscator works.
+ This is not supposed to work below. In fact, this seems to work
+ on jars, not .class files, so it will have to be placed in a
+ post jar target, which I haven't identified yet -->
+<target name="obfuscate" depends="init">
+ <taskdef resource="proguard/ant/task.properties"
+ classpath="${proguard.jar.path}" />
+
+ <echo message="Obfuscating ${cluster}/${module.jar}..."/>
+ <mkdir dir="${suite.dir}/build/obfuscated"/>
+ <proguard printmapping="${suite.dir}/build/obfuscated/${code.name.base.dashes}.map"
+ renamesourcefileattribute="SourceFile" ignorewarnings="true">
+
+ <!-- Specify the input jars, output jars, and library jars. -->
+ <injar file="${cluster}/${module.jar}" />
+ <outjar file="${suite.dir}/build/obfuscated/${module.jar}" />
+
+ <libraryjar path="${module.run.classpath}" />
+ <libraryjar file="${nbjdk.home}/jre/lib/rt.jar" />
+
+ <!-- Keep some useful attributes. -->
+
+ <keepattribute name="InnerClasses" />
+ <keepattribute name="SourceFile" />
+ <keepattribute name="LineNumberTable" />
+ <keepattribute name="Deprecated" />
+ <keepattribute name="*Annotation*" />
+ <keepattribute name="Signature" />
+
+ <!-- Preserve all public classes,
+ and their public and protected fields and methods. -->
+
+ <keep access="public">
+ <field access="public protected" />
+ <method access="public protected" />
+ </keep>
+
+
+ <!-- Preserve all .class method names. -->
+
+ <keepclassmembernames access="public">
+ <method type ="java.lang.Class"
+ name ="class$"
+ parameters="java.lang.String" />
+ <method type ="java.lang.Class"
+ name ="class$"
+ parameters="java.lang.String,boolean" />
+ </keepclassmembernames>
+
+ <!-- Preserve all native method names and the names of their classes. -->
+
+ <keepclasseswithmembernames>
+ <method access="native" />
+ </keepclasseswithmembernames>
+
+ <!-- Preserve the methods that are required in all enumeration classes. -->
+
+ <keepclassmembers extends="java.lang.Enum">
+ <method access="public static"
+ type="**[]"
+ name="values"
+ parameters="" />
+ <method access="public static"
+ type="**"
+ name="valueOf"
+ parameters="java.lang.String" />
+ </keepclassmembers>
+
+ <!-- Explicitly preserve all serialization members. The Serializable
+ interface is only a marker interface, so it wouldn't save them.
+ You can comment this out if your library doesn't use serialization.
+ With this code serializable classes will be backward compatible -->
+
+ <keepnames implements="java.io.Serializable"/>
+ <keepclassmembers implements="java.io.Serializable">
+ <field access ="final"
+ type ="long"
+ name ="serialVersionUID" />
+ <field access ="!static !transient"
+ name ="**"/>
+ <field access ="!private"
+ name ="**"/>
+ <method access ="!private"
+ name ="**"/>
+ <method access ="private"
+ type ="void"
+ name ="writeObject"
+ parameters="java.io.ObjectOutputStream" />
+ <method access ="private"
+ type ="void"
+ name ="readObject"
+ parameters="java.io.ObjectOutputStream" />
+ <method type ="java.lang.Object"
+ name ="writeReplace"
+ parameters="" />
+ <method type ="java.lang.Object"
+ name ="readResolve"
+ parameters="" />
+ </keepclassmembers>
+
+ <!-- Your application may contain more items that need to be preserved;
+ typically classes that are dynamically created using Class.forName -->
+
+ </proguard>
+</target>
+----
+
+In this way when running and when creating the NBM (as well from a suite) the module will be obfuscated.
+When debugging your module you use the non-obfuscated JAR, so you can step through source as well.
+
+NOTE: This example will obfuscate all your private classes and methods only. This approach should protect you against problems which a full obfuscation could create as `layer.xml` references to classes will not be found and other lookup/services mechanism would fail. Design your code accordingly.
+
+NOTE2: As a practical suggestion you could also decide not to overwrite the `debug` target and simply comment out the `netbeans-extra` target as long as you develop. Only activate the `netbeans-extra` target when you do a release build or create new `NBM's` for an update.
+
+<hr/>
+
+This is verified to work on NB 6.5 running Solaris or Windows using Proguard 4.1. (`proguard.jar` 548 Kb) Issues were found with 4.2. Others versions (current Feb 2010) the 4.5 beta is out has not been tested yet. For Mac OS X you will need to softlink the classes.jar to rt.jar as described in link:http://bruehlicke.blogspot.com/search/label/Mac%20OS%20X[ This blog entry]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleObfuscation[http://wiki.netbeans.org/DevFaqModuleObfuscation] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:35:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModulePatching.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModulePatching.asciidoc
new file mode 100644
index 0000000..e8ceb18
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModulePatching.asciidoc
@@ -0,0 +1,58 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModulePatching
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I create a patch for a preexisting NetBeans module?
+
+If you need to patch an existing module, you can place a JAR file relative to the original.
+For example, to patch `ide/modules/org-openide-example.jar`
+you make a JAR like `ide/modules/patches/org-openide-example/mypatch.jar`.
+The `mypatch` part of your JAR file patch can be named anything you like.
+The JAR file should only contain those classes you want to patch.
+It does not need a manifest, though an empty manifest is harmless.
+
+The patch must be in the same cluster as the original. ()
+If you want to create an NBM containing a patch,
+you must ensure it will be installed in the same cluster
+(use the `nbm.target.cluster` property),
+but note that you cannot test such a dummy module as part of a module suite
+(since this property is interpreted only by Plugin Manager).
+If you are distributing a complete application including a patch to the NB Platform,
+you will need to either manually preinstall the patch JAR in your copy of the Platform;
+or override your `build-zip` target to include the JAR in the final ZIP
+(in which case testing using *Run Project* will not have the patch active).
+
+<hr/>
+Applies to: NetBeans 6.x
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModulePatching[http://wiki.netbeans.org/DevFaqModulePatching] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:13:42Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModuleReload.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModuleReload.asciidoc
new file mode 100644
index 0000000..1e23574
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModuleReload.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModuleReload
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Do I need to restart NetBeans every time to debug new changes?
+
+Q: I am going to develop something on the NetBeans platform, and the question is - do I need to restart NetBeans every time to debug new changes?
+
+For example, I want to enhance the Search dialog. I have built the utilities module (containing SearchPane) using Ant - what is next?
+
+A: You have several options:
+
+1. Debug Project from the (development) IDE. After making changes - within a method body only! - use Apply Code Changes from the IDE, and they should take effect immediately in the target platform.
+2. Run Project (no need for the debugger). After making changes to code, shut down the platform and Run Project again - the module will be rebuilt and the platform started with your changes in effect.
+3. Run Project. After making changes, select Reload in Target Platform from the project's context menu in the IDE. This will try to disable the module and reenable the new version. Only works for regular modules (not autoload or eager), and will likely cause mayhem if a lot of other modules depend on this one, so not always feasible.
+4. Install link:Javeleon.html[Javeleon] in the development IDE. Then use the steps from #3, with the advantages that autoload and eager modules are supported (as of NB 7.2 only), modules with many incoming dependencies work fine, and (like #1 but without its restrictions) any running state is preserved.
+5. Do not run the project; just select Reload in Development IDE from the context menu. Similar to #3 but reloads inside the current IDE, not in a separate target platform.
+
+Procedure #2 is safest. #1 is fine for minor tweaks. #4 basically supersedes #3 if you do not mind using an added tool, and is most convenient when you are making a lot of nontrivial changes in rapid succession. #5 is not recommended except for demos.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModuleReload[http://wiki.netbeans.org/DevFaqModuleReload] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:36:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModulesDeclarativeVsProgrammatic.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModulesDeclarativeVsProgrammatic.asciidoc
new file mode 100644
index 0000000..4d23f4c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModulesDeclarativeVsProgrammatic.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModulesDeclarativeVsProgrammatic
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Installing things declaratively as opposed to programmatically
+
+Long ago, in a galaxy far far away, most objects in NetBeans were created during startup. That works fine for a small application. It is disaster for a large application - with each new component in the system, startup time gets longer, garbage collections get more frequent and memory requirements rise.
+
+Because of this, today, most of the APIs you will use to install things into the the IDE or a link:http://platform.netbeans.org/[NetBeans Platform-based application] involve a text entry of some sort,
+such as link:DevFaqModulesLayerFile.html[putting something in an XML file]), or a plain-text file naming some classes in your JAR file's `META-INF/services` directory — _not_ running Java code.
+*A well-behaved module should do nothing on startup.*
+
+The main ways to accomplish this goal are to use either the [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html] `@ServiceProvider`] annotation (which generates the aforementioned `META-INF/services` files at compile-time), or by registering files or objects in your module's link:DevFaqModulesLayerFile.html[XML layer file]. As of NetBeans 6.9, there are link:http://wiki.apidesign.org/wiki/CompileTimeCache[a number of annotations] which can be used to generate the this XML data at compile-time.
+
+Using declarative mechanisms, your objects will be instantiated when they are needed to do actual work. Until something really needs to call them, they don't need to be created and their classes are not loaded.
+
+If you really need to run some code on startup, create a subclass of `link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html[ModuleInstall]`
+
+link:DevFaqWhenToUseWhatRegistrationMethod.html[More about registration mechanisms]
+<hr/>
+
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModulesDeclarativeVsProgrammatic[http://wiki.netbeans.org/DevFaqModulesDeclarativeVsProgrammatic] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-18T19:38:16Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModulesGeneral.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModulesGeneral.asciidoc
new file mode 100644
index 0000000..2569b8c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModulesGeneral.asciidoc
@@ -0,0 +1,129 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModulesGeneral
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are the ways a module can influence the system?
+
+There are four basic ways a module can install configuration data or objects.
+Three of the ways are
+declarative (link:DevFaqModulesDeclarativeVsProgrammatic.html[DevFaqModulesDeclarativeVsProgrammatic]); these mechanisms are preferred.
+
+If you are writing a module that has an API you want other modules to plug in to, you probably want to read link:DevFaqWhenToUseWhatRegistrationMethod.html[DevFaqWhenToUseWhatRegistrationMethod].
+
+==== `@ServiceProvider`
+
+For global services, singletons and such, using this annotation is the preferred technique.
+
+What exactly you register is a contract between you and whatever module is providing the interface and will, presumably, do something with what you put there.
+What's really happening is that you are adding your implementation of this interface to the link:DevFaqLookupDefault.html[default Lookup]. At build-time, registration files are generated into `META-INF/services` in your module's JAR file. The default lookup (or JDK 6's link:http://java.sun.com/javase/6/docs/api/java/util/ServiceLoader.html[ServiceLoader]) knows how to read such files. Typically the classes need to be public and have a public no-argument constructor.
+
+Any module can specify interfaces or classes that it would like other modules to implement and register instances of. For example, the Project API module asks that each module that implements a _project type_ (the things you see in the New Project wizard in NetBeans) register their `ProjectFactory`s in default lookup.
+
+To get an instance of something registered this way, call
+
+[source,java]
+----
+
+TheInterface i = Lookup.getDefault().lookup(TheInterface.class);
+----
+
+If there might be more than one registered object of this type, you can get them all as follows:
+
+[source,java]
+----
+
+for (TheInterface i : Lookup.getDefault().lookupAll(TheInterface.class)) {...}
+----
+
+==== Registering objects in the System Filesystem
+
+The system filesystem (see link:DevFaqSystemFilesystem.html[DevFaqSystemFilesystem]) allows for more detailed configuration when registering objects.
+It is a virtual filesystem composed of XML fragments (see link:DevFaqModulesLayerFile.html[DevFaqModulesLayerFile])
+from modules in the system.
+The top layer of the system filesystem is `$USERDIR/config` which is where changes that are written at runtime are put.
+
+The system filesystem is composed of folders. Some folders have special meanings to the system; which folders exist and are meaningful depends on which modules you have installed.
+For example, the core window system defines the folder `Menu/`, which contains one subfolder for each menu in the main window's menu bar.
+If you add a file to the folder `Menu/File` called `com-foo-mymodule-MyAction.instance`,
+an instance of `com.foo.mymodule.MyAction` will be created, and a menu item will be put on the menu for it.
+
+For more details on registering objects, defining an order in which they should appear, etc., see link:DevFaqModulesLayerFile.html[DevFaqModulesLayerFile].
+In the short form, a module registers a layer by including a line in its manifest:
+
+[source,java]
+----
+
+OpenIDE-Module-Layer: com/foo/mymodule/resources/layer.xml
+----
+
+which points to an actual XML file by that name inside the module JAR file. A layer file is an XML file defining a mini-filesystem:
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="SomeFolder">
+ <file name="SomeFile"/>
+ </folder>
+</filesystem>
+----
+
+More and more layer registrations can be made by using various source code annotations.
+If you use these exclusively, you will not need to declare a layer in your module's sources at all.
+
+==== Registering objects in the module's manifest
+
+Some types of objects used to be installed by adding a section to the module manifest.
+This is now deprecated.
+
+==== Programmatic registration - `ModuleInstall` classes
+
+The module system allows you to provide a `ModuleInstall` class, which runs some code during startup or when the module is loaded, and can run cleanup code when it is uninstalled or disabled. This is the least desirable way to do things, because running code on startup means slowing down startup.
+Before you use such a class, be sure there is no declarative way to do what you're trying to do;
+see: link:DevFaqModulesDeclarativeVsProgrammatic.html[DevFaqModulesDeclarativeVsProgrammatic]
+
+To have some code run on startup/installation/uninstallation/etc., add a line like the following to your module's manifest file:
+
+[source,java]
+----
+
+OpenIDE-Module-Install: org/netbeans/modules/paintcatcher/PaintCatcherModule.class
+----
+
+This line should be part of the group of lines at the top of the manifest, with no blank lines before it. It is a pointer to a class file inside the module. The class file must extend the class `org.openide.modules.ModuleInstall`.
+There is a wizard in the development support to create and register such a class for you.
+
+<hr/>
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModulesGeneral[http://wiki.netbeans.org/DevFaqModulesGeneral] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-13T23:55:02Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModulesLayerFile.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModulesLayerFile.asciidoc
new file mode 100644
index 0000000..8749271
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModulesLayerFile.asciidoc
@@ -0,0 +1,67 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModulesLayerFile
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a layer file, or "module layer"?
+
+Layer files are small XML files provided by modules, which define a virtual filesystem (link:DevFaqFileSystem.html[DevFaqFileSystem]).
+The layer file defines folders and files that will be merged into the system filesystem (link:DevFaqSystemFilesystem.html[DevFaqSystemFilesystem])
+that makes up the runtime configuration information NetBeans and its modules use.
+
+Layer files help to make it possible for modules to be dynamically installed.
+If you've read about `FileObject`s (link:DevFaqFileObject.html[DevFaqFileObject])
+and `FileSystem`s (link:DevFaqFileSystem.html[DevFaqFileSystem]),
+you know that you can listen for changes in folders and files in a filesystem.
+That's exactly what the components of NetBeans whose content is composed from folders in the system filesystem do.
+So if a module is added at runtime, the system filesystem fires changes;
+the UI notices that the contents of the folder has
+changed and updates the UI to reflect the changes.
+
+If you created your module using the IDE, you may already have an XML layer in your
+module, and you can expand the node for it under *Important Files* in your module project to see and modify its contents.
+The way it is declared is simple:
+
+* In your JAR, provide the layer file - e.g. `com/foo/mymodule/resources/layer.xml`
+* In your module's manifest, include the following line somewhere in the top section:
+[source,java]
+----
+
+OpenIDE-Module-Layer: com/foo/mymodule/resources/layer.xml
+----
+
+Some Java source code annotations generate layer entries for you (you do not need to have a `layer.xml` in your module's source tree).
+
+<hr/>
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModulesLayerFile[http://wiki.netbeans.org/DevFaqModulesLayerFile] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:16:01Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqModulesStartupActions.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqModulesStartupActions.asciidoc
new file mode 100644
index 0000000..2e6120d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqModulesStartupActions.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqModulesStartupActions
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I run some code when my module starts/loads/unloads?
+
+To run some code when your module is loaded, and basically every time the IDE starts and your module is enabled, simply create a subclass of `org.openide.modules.ModuleInstall` and override the `restored()` method. Bear in mind that this is being executing during the time the IDE/platform is starting up. You should limit the work you do here to that which is absolutely necessary.
+
+Once the class is created, you must declare it in your module's `manifest.mf` file, like so:
+
+[source,java]
+----
+
+OpenIDE-Module-Install: org/netbeans/modules/editor/EditorModule.class
+----
+
+Likewise, to execute code when the IDE is shutting down, you can override the `close()` method. This method of `ModuleInstall` is called when the IDE is shutting down, contrary to the `closing()` method, which is called to alert the module that the IDE is about to shut down. However, another module may veto the shutdown by returning `false` from the `closing()` method, so the `close()` method is best for performing any cleanup work for your module.
+
+You can simply use *File > New File > Module Development | Module Installer* to create the `ModuleInstall` class and its registration in the manifest.
+
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqModulesStartupActions[http://wiki.netbeans.org/DevFaqModulesStartupActions] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T13:43:29Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMoreDocsOnCertainAPIs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMoreDocsOnCertainAPIs.asciidoc
new file mode 100644
index 0000000..8c5d14a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMoreDocsOnCertainAPIs.asciidoc
@@ -0,0 +1,48 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMoreDocsOnCertainAPIs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== Where can I find more documentation on certain APIs?
+
+The NetBeans Javadoc has some additional documentation about using certain APIs. Unfortunately, the index page does not link to these and so they can be difficult to find. Here are direct links to these documents from the most recent builds:
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-actions/org/openide/actions/doc-files/api.html[Actions API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/doc-files/api.html[DataSystems API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/api.html[Explorer API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/api.html[FileSystem API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html[Module System API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/doc-files/api.html[Nodes API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/api.html[Utilities API]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[Window System API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMoreDocsOnCertainAPIs[http://wiki.netbeans.org/DevFaqMoreDocsOnCertainAPIs] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:54:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMpl3rdPartySources.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMpl3rdPartySources.asciidoc
new file mode 100644
index 0000000..1d54bbf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMpl3rdPartySources.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMpl3rdPartySources
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Where to download sources of MPL third-party components?
+
+The following third-party components licensed under MPL license have the sources available for download from netbeans.org:
+
+|===
+|3rd party component |binaries in installed product |download of sources
+
+|Rhino js.jar |ide/modules/ext/js.jar |link:http://hg.netbeans.org/binaries/BD5B3921DE68DBC1EAC1D7D233C9E78E8269A7F9-rhino-src.zip[rhino-src.zip]
+
+|Saxon-B 9.1.0.8 |ide/modules/ext/saxon9B.jar |link:http://hg.netbeans.org/binaries/185ACF7DA49C4A925C45472138E46A397835B44B-saxonb9-1-0-8source.zip[saxonb9-1-0-8source.zip]
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMpl3rdPartySources[http://wiki.netbeans.org/DevFaqMpl3rdPartySources] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2012-03-14T14:08:38Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMultiViewChangeTabInCode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMultiViewChangeTabInCode.asciidoc
new file mode 100644
index 0000000..be465a0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMultiViewChangeTabInCode.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMultiViewChangeTabInCode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to change selected tab of Multiview?
+
+Using `org.netbeans.core.api.multiview.MultiViews` you can get an instance of `org.netbeans.core.api.multiview.MultiViewHandler`.
+
+For example: Get the handler for the current TopComponent
+
+[source,java]
+----
+
+TopComponent activated = WindowManager.getDefault().getRegistry().getActivated();
+MultiViewHandler mvh = MultiViews.findMultiViewHandler(activated);
+----
+
+Using this handler you can call
+
+* `getPerspectives()` to get all available tabs
+* `requestActive/requestVisible(MultiViewPerspective desc)` to activate the tab
+
+See also
+link:http://bits.netbeans.org/dev/javadoc/org-netbeans-core-multiview/org/netbeans/core/api/multiview/MultiViewHandler.html[http://bits.netbeans.org/dev/javadoc/org-netbeans-core-multiview/org/netbeans/core/api/multiview/MultiViewHandler.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMultiViewChangeTabInCode[http://wiki.netbeans.org/DevFaqMultiViewChangeTabInCode] ,
+that was last modified by NetBeans user Markiewb
+on 2016-02-10T19:04:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMultipleProgrammaticEdits.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMultipleProgrammaticEdits.asciidoc
new file mode 100644
index 0000000..604a366
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMultipleProgrammaticEdits.asciidoc
@@ -0,0 +1,86 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMultipleProgrammaticEdits
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want to make some programmatic changes to the edited file. How can I do it so one Undo undoes it all?
+
+Create a `Runnable` that will do all of the code generation/munging you want to do. Pass it to `org.openide.text.NbDocument.runAtomic(doc, runnable)`.
+
+Example:
+
+[source,java]
+----
+
+...
+import org.openide.text.NbDocument;
+import org.netbeans.api.editor.EditorRegistry;
+...
+
+public final class MyAction
+ implements ActionListener
+{
+ private class RunnableAction
+ implements Runnable
+ {
+ private JTextComponent ed;
+ private Document doc;
+
+ private RunnableAction( JTextComponent ed, Document doc )
+ {
+ this.ed = ed;
+ this.doc = doc;
+ }
+
+ @Override
+ public void run()
+ {
+ ...
+ }
+ }
+
+ public void actionPerformed( ActionEvent e )
+ {
+ JTextComponent ed = EditorRegistry.lastFocusedComponent();
+ StyledDocument doc = ( StyledDocument ) ed.getDocument();
+
+ // Perform all of the changes atomically so that they can be undone with one undo.
+ NbDocument.runAtomic( doc, new RunnableAction( ed, doc ) );
+ }
+}
+----
+
+Applies to: All Netbeans versions
+
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMultipleProgrammaticEdits[http://wiki.netbeans.org/DevFaqMultipleProgrammaticEdits] ,
+that was last modified by NetBeans user TheloniousBonk
+on 2012-03-06T22:14:01Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqMultipleTopComponentAction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqMultipleTopComponentAction.asciidoc
new file mode 100644
index 0000000..035a123
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqMultipleTopComponentAction.asciidoc
@@ -0,0 +1,223 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqMultipleTopComponentAction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I have a non-singleton TopComponent. Can I write actions which show all available instances in the main menu?
+
+Some people applications where there is one primary kind of window component - an editor of some kind, or something that visualizes some data. There may be several such components open at any time, and they all are just instances of the same TopComponent subclass which are showing different data.
+
+In this case, it can be useful to list all such components in the main menu, to facilitate switching between components. This involves three steps:
+
+1. Track all opened instances of the TopComponent subclass
+2. Write an Action which provides an array of menu items, one for each TopComponent instance
+3. Register that action in one of the main window menus
+
+==== Tracking TopComponents And Creating Actions For Them
+
+Keeping track of all of the instances of our TopComponent subclass is simple. Whenever a new one is constructed, we will just add it to a list. There are only two caveats:
+
+* We do not want memory leaks, so we should use a `link:http://java.sun.com/javase/6/docs/api/java/lang/ref/WeakReference.html[WeakReference]`. That way a component which has been closed can be garbage collected
+* It is not guaranteed that, during restart, previously opened components will be deserialized on the event thread (though they should be). So the list should be synchronized
+
+We will add a static method which creates a list of `link:http://java.sun.com/javase/6/docs/api/javax/swing/Action.html[Action]`s suitable for use with standard Swing `link:http://java.sun.com/javase/6/docs/api/javax/swing/JMenuItem.html[JMenuItem]`s.
+
+[source,java]
+----
+
+//Helper annotation to allow our component to be remembered across restarts.
+//The DTD does not have to be defined, it just needs to be a unique name
+@ConvertAsProperties(dtd = "-//org.netbeans.demo.multitopcomponent//MultiTopComponent//EN", autostore = false)
+public class MultiTopComponent extends TopComponent {
+ //A index for our display name, so we can tell the components apart
+
+ static int ix;
+ //Keep a list of all components we create. Synchronize it because
+ //they could be deserialized on some random thread; use WeakReferences
+ //so we don't hold a closed TopComponent in memory if it will never
+ //be used again
+ private static List<Reference<TopComponent>> all =
+ Collections.synchronizedList(
+ new ArrayList<Reference<TopComponent>>());
+
+ public MultiTopComponent() {
+ setDisplayName("Component " + ix++);
+ all.add(new WeakReference<TopComponent>(this));
+ setLayout(new BorderLayout());
+ add(new JLabel(getDisplayName()), BorderLayout.CENTER);
+ }
+
+ public static List<Action> allActions() {
+ List<Action> result = new ArrayList<Action>();
+ for (Iterator<Reference<TopComponent>> it = all.iterator(); it.hasNext();) {
+ Reference<TopComponent> tc = it.next();
+ TopComponent comp = tc.get();
+ if (comp == null) {
+ it.remove();
+ } else {
+ result.add(new ShowAction(comp.getDisplayName(), tc));
+ }
+ }
+ return result;
+ }
+
+ private static final class ShowAction extends AbstractAction {
+ //Our action should not hold a strong reference to the TopComponent -
+ //if it is closed, it should get garbage collected. If a menu
+ //item holds a reference to the component, then it won't be
+
+ private final Reference<TopComponent> tc;
+
+ public ShowAction(String name, Reference<TopComponent> tc) {
+ this.tc = tc;
+ putValue(NAME, name);
+ }
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ TopComponent comp = tc.get();
+ if (comp != null) { //Could have been garbage collected
+ comp.requestActive();
+ } else {
+ //will almost never happen
+ Toolkit.getDefaultToolkit().beep();
+ }
+ }
+
+ @Override
+ public boolean isEnabled() {
+ TopComponent comp = tc.get();
+ return comp != null && comp.isOpened();
+ }
+ }
+
+ @Override
+ public int getPersistenceType() {
+ return PERSISTENCE_ONLY_OPENED;
+ }
+
+ void readProperties(java.util.Properties p) {
+ setDisplayName(p.getProperty("name"));
+ }
+
+ void writeProperties(java.util.Properties p) {
+ p.setProperty("name", getDisplayName());
+ }
+}
+----
+
+This class contains _persistence_ code - particularly the `link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-settings/org/netbeans/api/settings/ConvertAsProperties.html[@ConvertAsProperties]` annotation and the methods `readProperties()``writeProperties()` and `getPersistenceType()`. These methods save some information about our TopComponent to disk on shutdown, in the form of a `link:http://java.sun.com/javase/6/docs/api/java/util/Properties.html[Properties]` object. If we do not want our components to be reopened after an application restart, we can just return `PERSISTENCE_NEVER` from `getPersistenceType()`, and delete the other persistence-related methods and the annotation. Note that you can omit the `*Properties()` methods and the annotation, and the components _will_ be reopened on startup—but without persistence code, this is done by serializing the whole component to disk, which is both slower and stores more data than necessary. Typically, for an edi
tor component, just storing the path to the file being edited is enough.
+
+==== Writing an Action which provides an array of menu items
+
+The `link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/DynamicMenuContent.html[DynamicMenuContent]` interface allows an Action to act as a factory for menu items - to control what components are shown in a menu to represent it. It also allows a single action to produce multiple menu items.
+
+Here we will create an action which produces an array of menu items. All of them will be shown inline in the main menu:
+
+[source,java]
+----
+
+public class MultiComponentAction extends AbstractAction implements DynamicMenuContent {
+
+ @Override
+ public void actionPerformed(ActionEvent e) {
+ throw new AssertionError("Should never be called");
+ }
+
+ @Override
+ public JComponent[] getMenuPresenters() {
+ List<Action> actions = MultiTopComponent.allActions();
+ List<JComponent> result = new ArrayList<JComponent>(actions.size());
+ for (Action a : actions) {
+ result.add (new JMenuItem(a));
+ }
+ return result.toArray(new JComponent[result.size()]);
+ }
+
+ @Override
+ public JComponent[] synchMenuPresenters(JComponent[] jcs) {
+ //We could iterate all of our JMenuItems from the previous call to
+ //getMenuPresenters() here, weed out those for dead TopComponents and
+ //add entries for newly created TopComponents here
+ return getMenuPresenters();
+ }
+}
+----
+
+This will create an _inline_ array of menu items, not a submenu. If you want a submenu instead, then implement `getMenuPresenters()` as follows:
+
+[source,java]
+----
+
+ List<Action> actions = MultiTopComponent.allActions();
+ JMenu menu = new JMenu("Multi TopComponents");
+ for (Action a : actions) {
+ menu.add (a);
+ }
+ return new JComponent[] { menu };
+----
+
+==== Registering The Action
+
+Now we just need to actually add our multi-item action to the main menu, by registering it in our module's link:DevFaqModulesLayerFile.html[XML layer].
+
+In this example, we register it in the `Actions/Window` folder and then create a link in the Window menu folder using a link:DevFaqDotShadowFiles.html[.shadow file]. Note that we could simply put the link:DevFaqInstanceDataObject.html[.instance file] directly in the `Menu/Window` folder, but this approach is the preferred practice:
+
+[source,java]
+----
+
+&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
+&lt;!DOCTYPE filesystem PUBLIC
+ &quot;-//NetBeans//DTD Filesystem 1.1//EN&quot;
+ &quot;http://www.netbeans.org/dtds/filesystem-1_1.dtd&quot;&gt;
+&lt;filesystem&gt;
+ &lt;folder name=&quot;Actions&quot;&gt;
+ &lt;folder name=&quot;Window&quot;&gt;
+ &lt;file name=&quot;org-netbeans-demo-multitopcomponent-MultiComponentAction.instance&quot;&gt;
+ &lt;attr name=&quot;position&quot; intvalue=&quot;230&quot;/&gt;
+ &lt;/file&gt;
+ &lt;/folder&gt;
+ &lt;/folder&gt;
+ &lt;folder name=&quot;Menu&quot;&gt;
+ &lt;folder name=&quot;Window&quot;&gt;
+ &lt;!-- This is the action that actually shows all available components --&gt;
+ &lt;file name=&quot;MultiComponent.shadow&quot;&gt;
+ &lt;attr name=&quot;position&quot; intvalue=&quot;230&quot;/&gt;
+ &lt;attr name=&quot;originalFile&quot;
+ stringvalue=&quot;Actions/Window/org-netbeans-demo-multitopcomponent-MultiComponentAction.instance&quot;/&gt;
+ &lt;/file&gt;
+ &lt;/folder&gt;
+ &lt;/folder&gt;
+&lt;/filesystem&gt;
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqMultipleTopComponentAction[http://wiki.netbeans.org/DevFaqMultipleTopComponentAction] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-03-11T15:01:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNBMPack200.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNBMPack200.asciidoc
new file mode 100644
index 0000000..390f9f9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNBMPack200.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNBMPack200
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Using pack200 compression for NBM files
+
+Starting with NetBeans 6.9 we have possibility to significantly decrease NBM file size by using pack200 compression. By default, all modules are now compressed during the build.
+There are several options to override that behaviour :
+
+* Set _use.pack200=false_ in module's project.properties if you want to completely disable using pack200 compression for the module. This can be used e.g. if you create module using 6.9 (and above) harness and need to have ability to install this module in older NetBeans versions (e.g. 6.8).
+
+* Set _pack200.excludes=modules/somecodename.jar_ (supports standard Ant's patterns) to exclude particular module jar files. This can be used to disable compression for some jars in case pack200 cause troubles for there jars after installation.
+
+More info: link:FitnessForNBMs.html[FitnessForNBMs]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNBMPack200[http://wiki.netbeans.org/DevFaqNBMPack200] ,
+that was last modified by NetBeans user Dlipin
+on 2010-06-15T12:07:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNativeLibraries.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNativeLibraries.asciidoc
new file mode 100644
index 0000000..cf1fca0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNativeLibraries.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNativeLibraries
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add native libraries to my module?
+
+DLLs or SOs can be placed in the folder `release/modules/lib/` in a module project's sources (look in the *Files* tab). This will make them appear in the final NBM or application in a `lib` subdirectory beneath where the module's JAR resides. Then just use `System.loadLibrary` as usual.
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html#jni[API Reference: JNI in modules]
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNativeLibraries[http://wiki.netbeans.org/DevFaqNativeLibraries] ,
+that was last modified by NetBeans user Akochnev
+on 2010-11-30T22:13:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNbIdiosyncracies.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNbIdiosyncracies.asciidoc
new file mode 100644
index 0000000..2dbb1fd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNbIdiosyncracies.asciidoc
@@ -0,0 +1,53 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNbIdiosyncracies
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Common calls that should be done slightly differently in NetBeans than standard Swing apps (loading images, localized strings, showing dialogs)
+
+There are a few cases where NetBeans has convenience classes or facilities that you should use, instead of doing them the way you may be used to. They are:
+
+* *Loading images* - Don't use `ImageIO.read()` or `Toolkit.loadImage()` - instead, use link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/ImageUtilities.html#loadImage(java.lang.String)[ImageUtilities.loadImage()] - it has an optimized image caching strategy, and will play nicely with NetBeans module class loaders
+* *Creating icons from images* - Rather than use `new ImageIcon(someImage)`, use link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/ImageUtilities.html#image2Icon(java.awt.Image)[ImageUtilities.image2Icon(someImage)] which manages memory better.
+* *Loading resource bundles/localized strings* - Don't use `ResourceBundle` directly - instead, use link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbBundle.html#getMessage(java.lang.Class,%20java.lang.String)[NbBundle.getMessage()] - it will play nicely with NetBeans class loaders, and `String`s resolved this way can be branded using the standard branding mechanism (this is the way you change the title of your application from "NetBeans" to something else). Also, do not hold a reference to a resource bundle - just call `NbBundle.getMessage()` every time - bundles are cached for a period of time, the call is fast. In a large application, holding resource bundles eats memory wastefully
+* *Assigning mnemonics to labels and buttons* - use link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/Mnemonics.html[Mnemonics] to assign text and mnemonic to a widget with one call using one key value pair in properties file and annotate the mnemonic with & character. Also do not reuse the same text if it is used in different UI components. This is more freindly to localization.
+_Tip: Check 'Generate Mnemonics Code' checkbox in properties of your form if you are using NetBeans GUI editing support._
+* *Showing dialogs* - instead of creating a `JDialog` and showing it, or using `JOptionPane`, use link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/org/openide/NotifyDescriptor.html[NotifyDescriptor] or link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/org/openide/DialogDescriptor.html[DialogDescriptor] to define your dialog and its contents, then pass these to link:http://bits.netbeans.org/dev/javadoc/org-openide-dialogs/org/openide/DialogDisplayer.html#notify(org.openide.NotifyDescriptor)[DialogDisplayer.notify] - such dialogs will play nicely with NetBeans' windowing system, global actions, etc.
+* *Reading/writing/listing files* - in most cases, rather than work with `java.io.File`, you will want to work with `link:DevFaqFileObject.html[org.openide.filesystems.FileObject]`.
+
+* *Quiting application* - you can of course still continue to quit using System.exit() but polite NBP apps should employ link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/LifecycleManager.html[LifecycleManager] instead. Typical Usage pattern is `LifecycleManager.getDefault().exit()` that is equals to `System.exit(0)` you don't provide custom LifecycleManager.
+
+<hr/>
+
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNbIdiosyncracies[http://wiki.netbeans.org/DevFaqNbIdiosyncracies] ,
+that was last modified by NetBeans user LiborJelinek
+on 2011-08-14T15:48:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNbPlatformAndHarnessMixAndMatch.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNbPlatformAndHarnessMixAndMatch.asciidoc
new file mode 100644
index 0000000..2f390f6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNbPlatformAndHarnessMixAndMatch.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNbPlatformAndHarnessMixAndMatch
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want to use one version of the Platform with another version of the build harness. Can I?
+
+Yes, you can use a pristine platform download (or platform built from sources)
+and use an external harness from another platform version without sacrificing repeatable builds.
+
+The simplest way to set this up is to use *Tools > NetBeans Platform Manager* in IDE add/switch to the platform you want to change and select harness on *Harness* tab.
+Note that in-IDE module development support defaults to using the harness included with the IDE,
+ignoring the harness bundled with the platform. You can also
+configure your module or suite manually to use a specific harness location. As described in `harness/README` set up a relative path for the platform, but make the harness separate, e.g.
+
+[source,java]
+----
+
+suite.dir=${basedir}
+netbeans.dest.dir=${suite.dir}/../nb_sources/nbbuild/netbeans
+# Rather than:
+#harness.dir=${netbeans.dest.dir}/harness
+# use:
+harness.dir=${suite.dir}/../special-harness
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNbPlatformAndHarnessMixAndMatch[http://wiki.netbeans.org/DevFaqNbPlatformAndHarnessMixAndMatch] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:15:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNbmPostInstall.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNbmPostInstall.asciidoc
new file mode 100644
index 0000000..d2f57af
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNbmPostInstall.asciidoc
@@ -0,0 +1,120 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNbmPostInstall
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to specify post-install code in link:NBM.html[NBM]
+
+link:NBM.html[NBM] allows to declare its own custom code in link:NBM.html[NBM] archive. This code is called-back by `Autoupdate/Updater` at the end of installation of link:NBM.html[NBM] into IDE.
+
+[source,java]
+----
+
+
+your_module.nbm
+ |
+ +- Info
+ | |
+ | +--- info.xml
+ |
+ +- netbeans
+ |
+ +--- modules...
+ |
+ +-main
+ |
+ +--- main.properties
+ +--- <custom code>
+
+----
+
+If Autoupdate/Updater detects `main` directory in the NBM archive then `main.properties` descriptor contains information about the own code. `Updater` runs specified Java code according to these properties.
+
+The properties expected in _main.properties_ are:
+
+|===
+|Property |Value
+
+|mainClass |name of the main class, run after module installation from the NBM
+
+|relativeClassPath |classpath elements, may contain more elements
+
+|jvm.parameters |properties for JVM, arguments inserted before the main class name
+
+|mainClass.arguments |more arguments for the main class, added after the main class name
+|===
+
+The run command is built on top of properties above.
+
+link:#1[#1] *Problem*: There was a bug: variable `%IDE_USER%` contained as same value as `%IDE_HOME%` i.e. both links to the platform cluster directory and %IDE_HOME% *didn't* contain user directory as should be. It was fixed in NetBeans 6.5 platform.
+
+The properties can contain several special variables which `Autoupdate` replaces by real values:
+
+|===
+|Variable |Value
+
+|%IDE_HOME% |platform directory
+
+|%IDE_USER% |user directory link:1.html[1]
+
+|%FS% |file separator char
+
+|%PS% |path separator char
+
+|%JAVA_HOME% |the current Java home
+|===
+
+==== Example
+
+* Download and unzip a project link:Media:samplepostinstall_DevFaqNbmPostInstall.zip.html[samplepostinstall_DevFaqNbmPostInstall.zip]
+* Go into `samplepostinstall/main` directory
+* In `main` directory is main class `Hello` which should use most of possibilities of _post-install_ hooks
+* Using properties `mainClass`, `relativeClassPath`, `jvm.parameters` etc.
+* Reads all special variables like `%IDE_HOME%`, `%JAVA_HOME%` etc.
+* Opens some GUI
+* Runs a JDK demo
+
+To see that `samplepostinstall` project in action
+
+1. download link:Media:org-netbeans-samplepostinstall_DevFaqNbmPostInstall.nbm.html[NBM]
+2. run NetBeans IDE (6.0 or newer)
+3. invoke _Tools|Plugins_ and switch to _Download_ tab
+4. add the downloaded NBM
+5. install it and then watch post-install hook what will be executed while installing that plugin
+
+---
+
+_I'm not author of this feature, it's only my investigation._
+
+Do not hesitate to contact me on mailto:jrechtacek@netbeans.org if you have any question.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNbmPostInstall[http://wiki.netbeans.org/DevFaqNbmPostInstall] ,
+that was last modified by NetBeans user Jtulach
+on 2011-07-14T09:51:25Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNetBeansClasspath.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNetBeansClasspath.asciidoc
new file mode 100644
index 0000000..6349009
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNetBeansClasspath.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNetBeansClasspath
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== My module uses some libraries. I've tried setting CLASSPATH but it doesn't work. Help!
+
+Setting `$CLASSPATH` or `%CLASSPATH%` on the command line will not affect anything -
+NetBeans uses its own class loader system to find classes from modules.
+
+What you need is for your libraries to _be_ a module; see link:DevFaqWrapperModules.html[DevFaqWrapperModules].
+
+<hr/>
+
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNetBeansClasspath[http://wiki.netbeans.org/DevFaqNetBeansClasspath] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T13:40:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNetBeansFullHack.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNetBeansFullHack.asciidoc
new file mode 100644
index 0000000..c3acae9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNetBeansFullHack.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNetBeansFullHack
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Can I test changes to the IDE without going through the license check and so on?
+
+If you set the system property `netbeans.full.hack` to `true`,
+the following IDE behaviors will be disabled
+to make it quicker or more reliable to test other functionality:
+
+* Auto Update background check (to see if updates are available); you can still use AU via *Tools > Plugin Manager*
+* prompting about still-running tasks when shutting down
+* license dialog
+* import of old user directory
+* IDE registration dialog
+* dialog suggesting that you submit usage statistics
+* welcome screen displayed by default and RSS feed refreshed
+* blocking dialog when some modules could not be loaded
+* use of `~/NetBeansProjects/` for newly created projects (`java.io.tmpdir` will be used instead)
+* resizing gesture submit dialog (`SubmitStatus.resize`)
+* weekly Maven repository indexing (can be configured in Options dialog)
+* long package name for default group ID in new Maven project (`test` used instead)
+
+This property is set by default when you:
+
+* run the IDE from sources using `ant tryme`
+* run the IDE from a netbeans.org module project using *Run Project* (`ant run`)
+* run a functional test using `NbModuleSuite` or a unit test using `NbTestCase`
+
+If you need to test one of the suppressed behaviors
+(e.g. you are working on the license dialog),
+just do not set this property.
+For the `ant tryme` and `ant run` cases, add
+
+[source,java]
+----
+
+tryme.args=
+----
+
+to `nbbuild/user.build.properties` or `~/.nbbuild.properties`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNetBeansFullHack[http://wiki.netbeans.org/DevFaqNetBeansFullHack] ,
+that was last modified by NetBeans user Lfischmeistr
+on 2013-11-25T13:00:42Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNetBeansPlatformManager.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNetBeansPlatformManager.asciidoc
new file mode 100644
index 0000000..2f95181
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNetBeansPlatformManager.asciidoc
@@ -0,0 +1,120 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNetBeansPlatformManager
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I set up a NetBeans Platform in the IDE
+
+By default, a NetBeans Platform application will use the developer's copy of the IDE as the platform. This is certainly easy, but there are also link:http://wiki.netbeans.org/DevFaqGeneralWhereIsPlatformHowToBuild[drawbacks to using the current IDE as a platform]. With that in mind, lets check out, and reference our own copy of the NetBeans source code. This way we can also use breakpoints to step through the NetBeans source code, make changes, and create patches!
+
+At a high level the steps are as follows. First get the NetBeans source code checked out. This part is interesting because what you end up with is a complete copy of the NetBeans source repository on your local file system. The second thing you need to do is build the NetBeans platform using the source repository that you just checked out. This is important because without building the platform you will not have the dependencies required by the platform modules. The next step is to create a new platform reference. Of course the platform to reference will be the one that you just checked out and built. Then finally, in your module suite's project properties, select the platform reference that you just created.
+
+So, in more detail then...
+
+==== 1. Check Out NetBeans Source Code
+
+First link:HgNetBeansSources.html[get the source code] from the Mercurial repository. In the following example the source code is checked out to a local ~/netbeans-repository/ directory. In this example the tilde is used to represent the home directory of your file system.
+
+So far, so good, but you still need to build the source code so that you have a complete NetBeans Platform, along with all the jar dependencies.
+
+==== 2. Build The NetBeans Source
+
+Building the NetBeans source is very easy, and very satisfying to watch! Just open up your favorite terminal client and navigate to your local repository.
+
+[source,java]
+----
+
+cd ~/netbeans-repository/main/
+----
+
+Set the available memory that Ant can use:
+
+[source,java]
+----
+
+set ANT_OPTS=-Xmx256M
+----
+
+
+(or on Unix, `export ANT_OPTS=-Xmx256M`)
+
+Then simply run ant.
+
+[source,java]
+----
+
+ant -Dpermit.jdk6.builds=true
+----
+
+Note, I am choosing to build NetBeans using JDK1.6 so I have to explicitly tell NetBeans that I understand that only JDK1.5 is supported. As of NetBeans 6.9, NetBeans is built with JDK 6, and this flag is no longer needed.
+
+==== 3. Create A New Platform Reference In NetBeans
+
+In order to work with the NetBeans platform that you just built it needs to be added as a platform in the IDE.
+
+1. Click Tools -> NetBeans Platforms (note that the menu item name varies slightly in older versions)
+
+2. Click the "Add Platform..." button in the lower right
+
+3. Locate the platform binary and click OK. In this example the proper path is ~/netbeans-repository/main/nbbuild/netbeans/.
+
+4. You can associate sources and javadoc for this platform using the respective tabs in the platform manager
+
+5. You can also choose which version of the build scripts you want to us on the Harness tab. You'll usually want to use the version corresponding to that platform.
+
+==== 4. Reference The New NetBeans Platform
+
+Now just select the platform in your module suite's Project Properties. There you will see a Netbeans Platform dropdown box where you can select the platform that you set up.
+
+_Note: I did have to go through and resolve some of the cluster dependencies. That just means that I had to check the dependencies that Netbeans said that other modules needed. Once you get this far it will be very obvious what to do._
+
+==== Appendix: NetBeans Platform And Using JDK1.6
+
+In order to use JDK1.6 with the Netbeans source code we need to tell the Netbeans platform that we understand that only JDK1.5 is supported. What you need to do is create a "user.build.properties" file and put it in the nbbuild directory.
+
+[source,java]
+----
+
+touch ~/netbeans-repository/main/nbbuild/user.build.properties
+----
+
+Inside the user.build.properties file put the following line.
+
+[source,java]
+----
+
+permit.jdk6.builds=true
+----
+
+_This tutorial applies to: versions 6.7 and earlier of the NetBeans Java IDE. _
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNetBeansPlatformManager[http://wiki.netbeans.org/DevFaqNetBeansPlatformManager] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T05:10:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNetBeansProjectsDirectory.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNetBeansProjectsDirectory.asciidoc
new file mode 100644
index 0000000..a79418d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNetBeansProjectsDirectory.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNetBeansProjectsDirectory
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I customize the default project directory for my application, replacing "NetBeansProjects"?
+
+You configure such things either in the launcher (netbeans.conf for the NB IDE, some other *.conf for a custom app), or at runtime in a ModuleInstall.
+
+[source,java]
+----
+
+File userDir = new File(System.getProperty("user.home"));
+File myProjectsDir = new File(userDir, "My Projects");
+if (!myProjectsDir.exists()) {
+ myProjectsDir.mkdirs();
+}
+System.setProperty("netbeans.projects.dir", myProjectsDir.getAbsolutePath());
+----
+
+<hr/>
+
+Source:
+
+link:http://osdir.com/ml/java.netbeans.modules.openide.devel/2007-12/msg00195.html[http://osdir.com/ml/java.netbeans.modules.openide.devel/2007-12/msg00195.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNetBeansProjectsDirectory[http://wiki.netbeans.org/DevFaqNetBeansProjectsDirectory] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:26:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNewXMLFileType.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNewXMLFileType.asciidoc
new file mode 100644
index 0000000..d1c1a97
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNewXMLFileType.asciidoc
@@ -0,0 +1,261 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNewXMLFileType
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+> I want to add some special
+
+> functionality to the initial handling of xml files with a xul extension, but
+
+> then allow users to use the existing NB functionality for editing,
+
+> validation etc.
+
+>
+
+> Did you solve this without patching?
+
+In 5.0, it can be done without a patch. It does, however, require an
+impl dependency on xml-core. I'd really like this to be simpler, and a
+supported API.
+
+See below for issues with pre-release 6.0
+
+Anyway, here's how I do it for an xml flavor called SCXML:
+
+1. Register the link:DevFaqDataLoader.html[loader] for text/xml mimetype
+
+2. The loader:
+
+[source,java]
+----
+
+import java.io.IOException;
+import org.netbeans.modules.xml.core.XMLDataLoader;
+import org.openide.filesystems.FileObject;
+import org.openide.loaders.DataObjectExistsException;
+import org.openide.loaders.MultiDataObject;
+import org.openide.loaders.UniFileLoader;
+import org.openide.util.NbBundle;
+
+public class ScxmlDataLoader extends UniFileLoader
+{
+
+ public static final String REQUIRED_MIME = "application/scxml+xml";
+
+ private static final long serialVersionUID = 1L;
+
+ public ScxmlDataLoader()
+ {
+ super("com.nuance.tools.xhmi.ScxmlDataObject");
+ }
+
+ protected String defaultDisplayName()
+ {
+ return NbBundle.getMessage(ScxmlDataLoader.class, "LBL_Scxml_loader_name");
+ }
+
+ protected void initialize()
+ {
+ super.initialize();
+ getExtensions().addMimeType(REQUIRED_MIME);
+ }
+
+ protected MultiDataObject createMultiObject(FileObject primaryFile) throws DataObjectExistsException, IOException
+ {
+ return new ScxmlDataObject(primaryFile, this);
+ }
+
+ protected MultiDataObject.Entry createPrimaryEntry (MultiDataObject obj, FileObject primaryFile) {
+ return new XMLDataLoader.XMLFileEntry (obj, primaryFile); //adds smart templating
+ }
+
+ protected String actionsContext()
+ {
+ return "Loaders/" + REQUIRED_MIME + "/Actions";
+ }
+}
+
+
+----
+
+<hr/>
+
+3. The data object:
+
+[source,java]
+----
+
+import java.io.IOException;
+import org.netbeans.modules.xml.core.XMLDataObjectLook;
+import org.netbeans.modules.xml.core.cookies.DataObjectCookieManager;
+import org.netbeans.modules.xml.core.sync.DataObjectSyncSupport;
+import org.netbeans.modules.xml.core.sync.Synchronizator;
+import org.netbeans.modules.xml.core.text.TextEditorSupport;
+import org.netbeans.spi.xml.cookies.CheckXMLSupport;
+import org.netbeans.spi.xml.cookies.DataObjectAdapters;
+import org.netbeans.spi.xml.cookies.ValidateXMLSupport;
+import org.openide.filesystems.FileObject;
+import org.openide.loaders.DataObjectExistsException;
+import org.openide.loaders.MultiDataObject;
+import org.openide.nodes.CookieSet;
+import org.openide.nodes.Node;
+import org.openide.text.DataEditorSupport;
+import org.xml.sax.InputSource;
+
+public class ScxmlDataObject extends MultiDataObject implements
+XMLDataObjectLook
+{
+ private transient final DataObjectCookieManager cookieManager;
+ private transient Synchronizator synchronizator;
+
+ public ScxmlDataObject(FileObject pf, ScxmlDataLoader loader) throws DataObjectExistsException, IOException {
+ super(pf, loader);
+ CookieSet cookies = getCookieSet();
+ cookieManager = new DataObjectCookieManager (this, cookies);
+
+ cookies.add((Node.Cookie) DataEditorSupport.create(this, getPrimaryEntry(), cookies));
+
+ InputSource is = DataObjectAdapters.inputSource(this);
+ cookies.add(new CheckXMLSupport(is));
+ cookies.add(new ValidateXMLSupport(is));
+
+ // editor support defines MIME type understood by EditorKits registry
+ TextEditorSupport.TextEditorSupportFactory editorFactory =
+ new TextEditorSupport.TextEditorSupportFactory (this, org.netbeans.modules.xml.core.XMLDataObject.MIME_TYPE);
+ editorFactory.registerCookies (cookies);
+
+ }
+
+ protected Node createNodeDelegate() {
+ return new ScxmlDataNode(this);
+ }
+
+ ////////// XMLDataObjectLook interface /////////////////
+ public DataObjectCookieManager getCookieManager() {
+ return cookieManager;
+ }
+
+ public synchronized Synchronizator getSyncInterface() {
+ if (synchronizator == null) {
+ synchronizator = new DataObjectSyncSupport (ScxmlDataObject.this);
+ }
+ return synchronizator;
+ }
+}
+
+----
+
+<hr/>
+4. The layer file:
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="Loaders">
+ <folder name="application">
+ <folder name="scxml+xml">
+ <folder name="Actions">
+ <file name="org-openide-actions-OpenAction.instance"/>
+ <attr name="org-openide-actions-OpenAction.instance/org-openide-actions-FileSystemAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-FileSystemAction.instance"/>
+ <attr name="org-openide-actions-FileSystemAction.instance/sep-1.instance" boolvalue="true"/>
+ <file name="sep-1.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ </file>
+ <attr name="sep-1.instance/org-openide-actions-CutAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-CutAction.instance"/>
+ <attr name="org-openide-actions-CutAction.instance/org-openide-actions-CopyAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-CopyAction.instance"/>
+ <attr name="org-openide-actions-CopyAction.instance/sep-2.instance" boolvalue="true"/>
+ <file name="sep-2.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ </file>
+ <attr name="sep-2.instance/org-openide-actions-DeleteAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-DeleteAction.instance"/>
+ <attr name="org-openide-actions-DeleteAction.instance/org-openide-actions-RenameAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-RenameAction.instance"/>
+ <attr name="org-openide-actions-RenameAction.instance/sep-3.instance" boolvalue="true"/>
+ <file name="sep-3.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ </file>
+ <attr name="sep-3.instance/org-openide-actions-SaveAsTemplateAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-SaveAsTemplateAction.instance"/>
+ <attr name="org-openide-actions-SaveAsTemplateAction.instance/sep-4.instance" boolvalue="true"/>
+ <file name="sep-4.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ </file>
+ <attr name="sep-4.instance/org-openide-actions-ToolsAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-ToolsAction.instance"/>
+ <attr name="org-openide-actions-ToolsAction.instance/org-openide-actions-PropertiesAction.instance" boolvalue="true"/>
+ <file name="org-openide-actions-PropertiesAction.instance"/>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+ <folder name="Services">
+ <folder name="MIMEResolver">
+ <file name="ScxmlResolver.xml" url="resources/ScxmlResolver.xml">
+ <attr name="SystemFileSystem.localizingBundle" stringvalue="com.nuance.tools.xhmi.Bundle"/>
+ </file>
+ </folder>
+ </folder>
+ <folder name="Templates">
+ <folder name="Other">
+ <file name="ScxmlTemplate.scxml" url="resources/ScxmlTemplate.scxml">
+ <attr name="SystemFileSystem.localizingBundle" stringvalue="com.nuance.tools.xhmi.Bundle"/>
+ <attr name="template" boolvalue="true"/>
+ </file>
+ </folder>
+ </folder>
+
+----
+
+<hr/>
+5. the MIME resolver:
+
+[source,xml]
+----
+
+<MIME-resolver>
+ <file>
+ <ext name="scxml"/>
+ <resolver mime="application/scxml+xml"/>
+ </file>
+</MIME-resolver>
+
+----
+
+<hr/>
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNewXMLFileType[http://wiki.netbeans.org/DevFaqNewXMLFileType] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:59:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNoClassDefFound.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNoClassDefFound.asciidoc
new file mode 100644
index 0000000..1532789
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNoClassDefFound.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNoClassDefFound
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== My module uses some class from NetBeans' APIs. It compiles, but I get a NoClassDefFoundError at runtime. Why?
+
+Normally this should not happen because the module build harness tries to protect you from such cases. Still, if it does happen, it could mean
+
+1. your module is trying to use a class, but your module does not declare a dependency on the module that provides that class ... or
+2. you are declaring a dependency on the right module, but you are accessing a class that is not in one of the packages that module says are public (for use by other modules) ... or
+3. your module is not a "friend" of the module that provides the class.
+
+If the problem is #1, you need to declare a dependency on the module where the class is (remember that all of NetBeans APIs are modules, and in separate jars - so if it's the IO API, that's a module `org.openide.io`, if it's the Window System, that's a module `org.openide.windows`... and so forth).
+
+Setting dependencies is easy - open the *Properties* for your project, and choose the *Libraries* page. (Or just get the context menu for the *Libraries* node under the project in the *Projects* window.) Click *Add* and a small dialog opens - just type the name of a class you need to use, and it will filter the list to find the module that provides that class - so you don't have to memorize a huge list of mappings from classes to modules.
+
+If it's problem #2, then you are already declaring a dependency, but to get full access to all classes in a module, you need to declare an implementation dependency (link:DevFaqImplementationDependency.html[DevFaqImplementationDependency]).
+Be sure you _really_ need to use the class you're trying to use, in this case - it will make your module hard to upgrade because generally it will need to be paired with the exact version of the other module's JAR that it was built with - if that module is upgraded, your module may end up being disabled.
+
+Also check if class you are trying to use from other module is mark as public to outside modules (right-click on module and select _Properties_, then _API Versioning_ and in _Public Packages_ check whether package of your class is ticked).
+
+Problem #3 may happen if you change your modules name. If some module declared yours as a friend
+it will no longer recognize it.
+
+==== Checking for errors eagerly
+
+For a nice way to resolve all module dependencies at once, to force all of the errors to be exposed simultaneously, just add the following to the command line when starting NetBeans:
+
+`-J-Dnetbeans.preresolve.classes=true`
+
+The message displayed states that when using this flag, you should _not_ use the `-J-Xverify:none` flag (often specified in the IDE configuration file), so you may need to edit the `.conf` file to remove the -Xverify option before using the pre-resolve option.
+
+==== More tips
+
+For help on working with class paths, please see
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/classpath.html[http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/classpath.html]
+
+Applies to: NetBeans 6.x
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNoClassDefFound[http://wiki.netbeans.org/DevFaqNoClassDefFound] ,
+that was last modified by NetBeans user LiborJelinek
+on 2011-08-19T08:08:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeChildrenDotLeaf.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeChildrenDotLeaf.asciidoc
new file mode 100644
index 0000000..512dc3a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeChildrenDotLeaf.asciidoc
@@ -0,0 +1,67 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeChildrenDotLeaf
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Why do my nodes in the Explorer always have an expand-box by them, even though they have no children?
+
+Nodes are not asked for their child nodes until the user tries to expand them - to do otherwise would be very bad for performance. If your Node is not supposed to have child nodes, use `Children.LEAF` as the children object passed to the constructor. That will eliminate the expand handle.
+
+==== Remove the expander, if you know the parent-/child-hierarchy at creation time
+
+(Taken from platform-dev mailinglist - author Mark J.Koch - mark@maehem.com)
+
+In my case, our Nodes are backed by actual objects that know their own parent/child hierarchy. First we create our Nodes always as LEAF nodes by default and then set the children (if there are children) later. I have a method in my Node that get's called whenever our data model changes. First we check if we are already a LEAF node, and if we are, and we have children, we simply initialize the children. If we already have children, we check if our current data model has children here and either update our children keys or explicitly set Children.LEAF if there are no children.
+
+This will properly make the expander disappear when there are no children.
+
+[source,java]
+----
+
+void myModelChanged() {
+ if (this.isLeaf()) {
+ if (getObject().hasChildren()) {
+ initChildren();
+ }
+ } else {
+ if (getObject().hasChildren()) {
+ // Cause children to regenerate it's key list.
+ this.getChildren().addNotify();
+ } else {
+ // We no longer have children. Change to leaf.
+ setChildren(Children.LEAF);
+ }
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeChildrenDotLeaf[http://wiki.netbeans.org/DevFaqNodeChildrenDotLeaf] ,
+that was last modified by NetBeans user Markiewb
+on 2012-12-27T13:42:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeDataObject.asciidoc
new file mode 100644
index 0000000..f799c8e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeDataObject.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I get a Node for a DataObject?
+
+Very simply:
+
+[source,java]
+----
+
+theDataObject.getNodeDelegate()
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeDataObject[http://wiki.netbeans.org/DevFaqNodeDataObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:55:55Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeDeletionDialog.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeDeletionDialog.asciidoc
new file mode 100644
index 0000000..fad4e64
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeDeletionDialog.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeDeletionDialog
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I prevent (or override) the node deletion dialog?
+
+By default, you will be prompted to confirm your intention whenever you try to delete a node from within an explorer manager view (for example, the projects tab). You can prevent this dialog from being shown, which is handy if the node is not important enough to warrant confirmation or if you want to instead show your own confirmation.
+
+To do this, call `setValue("customDelete", Boolean.TRUE)` on the node on which you want to suppress confirmation. This can be done at any time before the `destroy()` method is invoked.
+
+The above will suffice if you just want to suppress the aforementioned dialog which is sufficient for most customization cases. But if you need *total* control over node deletion, you can implement the link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/ExtendedDelete.html[ExtendedDelete] interface.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeDeletionDialog[http://wiki.netbeans.org/DevFaqNodeDeletionDialog] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:56:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeInjectingLookupContents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeInjectingLookupContents.asciidoc
new file mode 100644
index 0000000..86722f1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeInjectingLookupContents.asciidoc
@@ -0,0 +1,162 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeInjectingLookupContents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I want to allow other modules to inject objects into my Node's Lookup or elsewhere (Actions, Properties...)
+
+There is a simple general method for allowing you to define your own registry of objects as a folder in the System Filesystem, and look them up on demand.
+
+[source,java]
+----
+
+class BaseNode extends AbstractNode {
+ //...
+ private static final String PATH_IN_SFS = "path/to/some/folder/actions";
+ public Action[] getActions(boolean ignored) {
+ return Lookups.forPath(PATH_IN_SFS).lookupAll(Action.class).toArray(new Action[0]);
+ }
+ //...
+}
+----
+
+You can use this pattern for properties, or whatever. If you want your Node to respond to new modules being loaded on the fly, you may want to get a Lookup.Result and listen for changes on it (not necessary in the example above, but necessary for things like Lookup contents or Properties, which are cached).
+
+=== Injecting Lookup Contents
+
+First, be sure this is something you really need. Typically, you expose some model object from your Node, and link:http://wiki.netbeans.org/DevFaqActionContextSensitive[write Actions that are sensitive to it].
+
+However, if you want to use built-in actions (such as link:http://bits.netbeans.org/dev/javadoc/org-openide-actions/org/openide/actions/OpenAction.html[OpenAction]) over your custom Nodes, and the module which created the Node does not provide the `Openable` or `OpenCookie` object which, for example, `OpenAction` needs, then you do need some way for other modules to inject contents into your lookup. If you are both injecting an object into the lookup, and writing an action against that object in the same module (and not expecting other modules to also add actions sensitive to your Converter's type), you can probably skip the injecting of lookup contents, and just go straight to the Node's model object.
+
+Lookup contents should not be added programmatically - that would mean every module that cares about a Node type would have to be called to add contents (which may never be used) to it - meaning a performance penalty. Also this breaks things like FilterNode, which cannot transparently proxy methods that exist on the Node it is acting as a clone of.
+
+It is simple to create a declarative registry for lookup contents. It makes use of the fact that the contents of an link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/AbstractLookup.html[AbstractLookup] are provided by a mutable link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/InstanceContent.html[InstanceContent] object, and that a factory class can be added to an InstanceContent, link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/InstanceContent.Convertor.html[InstanceContent.Converter]. So you can create a folder where other modules will register instances of InstanceContent.Converter for Nodes which hold an object of your type. When you create the Node's lookup, you can collect all such Converters, and add them to your Lookup's contents. Unless the lookup is queried for the type one Converter creates, it will never be called.
+
+Here is an example base Node class that will do this:
+
+[source,java]
+----
+
+public class BaseNode<T> extends AbstractNode {
+ final InstanceContent content;
+ final Class<T> type;
+ public BaseNode(Class<T> type, T modelObject) {
+ this(type, modelObject, new InstanceContent());
+ }
+ public BaseNode(Class<T> type, T modelObject, InstanceContent content){
+ super(Children.LEAF, new ProxyLookup(Lookups.fixed(modelObject), new AbstractLookup(content)));
+ this.content = content;
+ this.type = type;
+ //Populate lookup based on declaratively registered factories
+ String pathInSystemFS = getRegistrationPath("lookupContents");
+ Collection<? extends InstanceContent.Convertor> all =
+ Lookups.forPath(pathInSystemFS).
+ lookupAll(InstanceContent.Convertor.class);
+ for (InstanceContent.Convertor<T, ?> factory : all) {
+ content.add(modelObject, factory);
+ }
+ //if you want to handle modules being loaded/unloaded in a running app,
+ //use lookupResult() instead of lookupAll(), retain a reference to the
+ //Lookup.Result, listen on it for changes, and remove all acquired
+ //InstanceContent objects if it changes, then rerun the above code
+ }
+ @Override
+ public Action[] getActions(boolean context) {
+ return Lookups.forPath(getRegistrationPath("actions")).
+ lookupAll(Action.class).toArray(new Action[0]);
+ }
+ String getRegistrationPath(String subfolder) {
+ //e.g. pass "lookupContents" and get
+ //MyModule/com/foo/mymodule/MyType/lookupContents
+ return "MyModule/" + type.getName().replace('.', '/') + "/" + subfolder;
+ }
+}
+----
+
+Suppose that we have some BaseNodes whose model objects are instances of Strings. We want to add a Foo object to their Lookups, and register an action which operates against Foo objects. So, we have an InstanceContent.Converter implementation:
+
+[source,java]
+----
+
+public class FooFactory implements InstanceContent.Convertor<String, Foo> {
+ @Override
+ public Foo convert(String string) {
+ return new Foo(string);
+ }
+ @Override
+ public Class<? extends Foo> type(String obj) {
+ return Foo.class;
+ }
+ @Override
+ public String id(String obj) {
+ return getClass().getName() + obj;
+ }
+ @Override
+ public String displayName(String obj) {
+ return obj;
+ }
+}
+
+----
+
+The action implementation can be any Action subclass, so we can omit the code for that - but its classname for this example will be `org.netbeans.demo.elookup.FooAction`.
+
+All we need to do now is register both of these objects in the link:http://wiki.netbeans.org/DevFaqSystemFilesystem[System Filesystem] and we will have working code.
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN"
+"http://www.netbeans.org/dtds/filesystem-1_1.dtd">
+<filesystem>
+ <folder name="MyModule">
+ <folder name="java">
+ <folder name="lang">
+ <folder name="String">
+ <folder name="lookupContents">
+ <file name="org-netbeans-demo-elookup-FooFactory.instance"/>
+ </folder>
+ <folder name="actions">
+ <file name="org-netbeans-demo-elookup-FooAction.instance"/>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+ </folder>
+</filesystem>
+
+----
+
+Note that objects created by such factories will be _weakly cached_ by the lookup - if no object is holding a reference to the object, it can be garbage collected. If such objects are expensive to create, or if you expect callers to attach listeners to the factory-created objects, you may want to cache them in your implementation of `InstanceContent.Converter`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeInjectingLookupContents[http://wiki.netbeans.org/DevFaqNodeInjectingLookupContents] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:35:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodePropertyForFiles.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodePropertyForFiles.asciidoc
new file mode 100644
index 0000000..8b7156a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodePropertyForFiles.asciidoc
@@ -0,0 +1,67 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodePropertyForFiles
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I have a Node.Property for a file. How can I control the file chooser that is the custom editor?
+
+A number of the built-in property editors in NetBeans can have their behavior controlled by passing "hints" to them. Hints are providing by calling link:http://java.sun.com/j2se/1.5.0/docs/api/java/beans/FeatureDescriptor.html?is-external=true#setValue(java.lang.String,%20java.lang.Object)[setValue("something", someValue)] on the Node.Property. For example, to suppress the custom editor button for a property, use
+
+[source,java]
+----
+
+ Node.Property<String> myProp = new MyStringProp();
+ myProp.setValue ("suppressCustomEditor", Boolean.TRUE);
+
+----
+
+The built-in property editors for files and arrays of files support a number of hints:
+
+|===
+|String Hint Name |Value Type |Effect
+
+|`filter` |`java.io.FilenameFilter` or `javax.swing.filechooser.FileFilter` or `java.io.FileFilter` |Sets the file filter used by the file chooser
+
+|`directories` |`java.lang.Boolean` |Set the file chooser to accept only directories. If combined with the "files" hint set to true (see below), will accept both directories and files.
+
+|`files` |`java.lang.Boolean` |Set the file chooser to accept only files (unless combined with the "directories" hint set to true above - in which case simply not using either hint has the same effect
+
+|`currentDir` |`java.io.File` |The directory the file chooser should default to when it is first opened
+
+|`baseDir` |`java.io.File` |The _base directory_ for the file property. This is needed only if the file has a relative path. Java files are just wrappers for a path name, and need not exist on disk. So if the file property is `foo/MyFile.txt` that is a perfectly legal file name (presumably the Java Bean or Node the property belongs to knows how to find the parent directory of "foo"). The file chooser needs to know the full path to `foo/` - so you would pass a file here to provide the parent folder for `foo/`. For example, if the complete path to `MyFile.txt` is `/Users/tim/Documents/foo/MyFile.txt`, you would call `setValue("baseDir", new File("/Users/tim/Documents")`
+
+|`file_hiding` |`java.lang.Boolean` |Value to call `JFileChooser.setFileHidingEnabled()` with (remember, if your filter filters out directories and you set file hiding enabled, the user will not be able to usefully change directories)
+|===
+
+The built-in bean property editors in NetBeans are found in the package `org.netbeans.beaninfo` editors in the module `o.n.core` in NetBeans' sources.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodePropertyForFiles[http://wiki.netbeans.org/DevFaqNodePropertyForFiles] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:22:43Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeSelectAll.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeSelectAll.asciidoc
new file mode 100644
index 0000000..d0f49a7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeSelectAll.asciidoc
@@ -0,0 +1,244 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeSelectAll
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I select/deselect `Node`s?
+
+Applications which manage sets of data items often offer to users the capability of selecting and deselecting all the items currently on the screen with a single menu (or key shortcut). In some cases even a "Invert selection" option could be useful which selects all unselected nodes an vice versa.
+
+Implementing such a feature with the OpenIDE API is quite a simple task. We first define a subclass of SystemAction which listens for changes in the selection of the current link:DevFaqWindowsTopComponent.html[TopComponent ] and tracks the currently active ExplorerManager:
+
+[source,java]
+----
+
+public abstract class ExplorerManagerAction extends SystemAction
+ {
+ private ExplorerManager activeExplorerManager;
+
+ public ExplorerManagerAction()
+ {
+ TopComponent.getRegistry().addPropertyChangeListener(new PropertyChangeListener()
+ {
+ public void propertyChange (PropertyChangeEvent event)
+ {
+ if (TopComponent.Registry.PROP_ACTIVATED.equals(event.getPropertyName()))
+ {
+ Object value = event.getNewValue();
+
+ if (value instanceof ExplorerManager.Provider)
+ {
+ activeExplorerManager = ((ExplorerManager.Provider)value).getExplorerManager();
+ setEnabled(true);
+ }
+
+ else
+ {
+ activeExplorerManager = null;
+ setEnabled(false);
+ }
+ }
+ }
+ });
+ }
+
+ final public void actionPerformed (ActionEvent actionEvent)
+ {
+ if (activeExplorerManager != null)
+ {
+ try
+ {
+ performAction(activeExplorerManager);
+ }
+ catch (PropertyVetoException e)
+ {
+ // ...
+ }
+ }
+ }
+
+ abstract protected void performAction (ExplorerManager explorerManager)
+ throws PropertyVetoException;
+
+ public HelpCtx getHelpCtx()
+ {
+ return HelpCtx.DEFAULT_HELP;
+ }
+
+ protected void initialize()
+ {
+ super.initialize();
+ putValue("noIconInMenu", Boolean.TRUE);
+ }
+
+ protected boolean asynchronous()
+ {
+ return false;
+ }
+ }
+
+----
+
+Now in order to implement the specific node selection actions we just have to subclass and provide a concrete implementation of the performAction() method which takes an ExplorerManager as parameter.
+
+For the "Select All" action we have:
+
+[source,java]
+----
+
+public final class SelectAllAction extends ExplorerManagerAction
+ {
+ protected void performAction (ExplorerManager explorerManager)
+ throws PropertyVetoException
+ {
+ explorerManager.setSelectedNodes(explorerManager.getRootContext().getChildren().getNodes());
+ }
+ public String getName()
+ {
+ return NbBundle.getMessage(SelectAllAction.class, "CTL_SelectAllAction");
+ }
+ }
+
+----
+
+For the "Deselect all" action we have:
+
+[source,java]
+----
+
+public final class DeselectAllAction extends ExplorerManagerAction
+ {
+ protected void performAction (ExplorerManager explorerManager)
+ throws PropertyVetoException
+ {
+ explorerManager.setSelectedNodes(new Node[0]);
+ }
+ public String getName()
+ {
+ return NbBundle.getMessage(DeselectAllAction.class, "CTL_DeselectAllAction");
+ }
+
+----
+
+At last for the "Invert selection" action we have:
+
+[source,java]
+----
+
+public final class InvertSelectionAction extends ExplorerManagerAction
+ {
+ protected void performAction (ExplorerManager explorerManager)
+ throws PropertyVetoException
+ {
+ List nodes = new ArrayList(Arrays.asList(explorerManager.getRootContext().getChildren().getNodes()));
+ nodes.removeAll(Arrays.asList(explorerManager.getSelectedNodes()));
+ explorerManager.setSelectedNodes((Node[[ | ]])nodes.toArray(new Node[0]));
+ }
+ public String getName()
+ {
+ return NbBundle.getMessage(InvertSelectionAction.class, "CTL_InvertSelectionAction");
+ }
+ }
+
+----
+
+The above code for "Select All" and "Invert selection" only works for "flat" node structures with a root and a single level of children. For more complex structures we just need to replace explorerManager.getRootContext().getChildren().getNodes() with a piece of code that recursively explores the node tree contents.
+
+To complete our work, this is the XML code to put in the layer.xml in order to add actions in the menu, the toolbar and to define the proper key bindings:
+
+[source,java]
+----
+
+<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN" "http://www.netbeans.org/dtds/filesystem-1_1.dtd">
+<filesystem>
+ <!-- Declares the relevant actions. -->
+ <folder name="Actions">
+ <folder name="Select">
+ <file name="my-package-action-SelectAllAction.instance"/>
+ <file name="my-package-action-DeselectAllAction.instance"/>
+ <file name="my-package-action-InvertSelectionAction.instance"/>
+ </folder>
+ </folder>
+ <!-- Adds the actions to the Select main menu. -->
+ <folder name="Menu">
+ <folder name="Select">
+ <file name="my-package-action-SelectAllAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-SelectAllAction.instance"/>
+ </file>
+ <attr name="my-package-action-SelectAllAction.shadow/my-package-action-DeselectAllAction.shadow" boolvalue="true"/>
+ <file name="my-package-action-DeselectAllAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-DeselectAllAction.instance"/>
+ </file>
+ <attr name="my-package-action-DeselectAllAction.shadow/my-package-action-InvertSelectionAction.shadow" boolvalue="true"/>
+ <file name="my-package-action-InvertSelectionAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-InvertSelectionAction.instance"/>
+ </file>
+ <attr name="my-package-action-InvertSelectionAction.instance/it-tidalwave-bluemarine-catalog-tagstamper-action-separatorBefore.instance" boolvalue="true"/>
+ </folder>
+ </folder>
+ <!-- Declares the shortcuts. D- maps to "command" on Mac OS X and to "ctrl" on Linux and Windows. -->
+ <folder name="Shortcuts">
+ <file name="D-A.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-SelectAllAction.instance"/>
+ </file>
+ <file name="D-D.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-DeselectAllAction.instance"/>
+ </file>
+ <file name="D-I.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-InvertSelectionAction.instance"/>
+ </file>
+ </folder>
+ <!-- Adds the actions to the Select toolbar -->
+ <folder name="Toolbars">
+ <folder name="Select">
+ <file name="my-package-action-InvertSelectionAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-InvertSelectionAction.instance"/>
+ </file>
+ <attr name="my-package-action-InvertSelectionAction.shadow/my-package-action-DeselectAllAction.shadow" boolvalue="true"/>
+ <file name="my-package-action-DeselectAllAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-DeselectAllAction.instance"/>
+ </file>
+ <attr name="my-package-action-DeselectAllAction.shadow/my-package-action-SelectAllAction.shadow" boolvalue="true"/>
+ <file name="my-package-action-SelectAllAction.shadow">
+ <attr name="originalFile" stringvalue="Actions/Select/my-package-action-SelectAllAction.instance"/>
+ </file>
+ </folder>
+ </folder>
+</filesystem>
+
+----
+
+-- Main.fabriziogiudici - 06 Jul 2006
+
+link:CategoryNeedCleanup.html[PENDING: Review/cleanup]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeSelectAll[http://wiki.netbeans.org/DevFaqNodeSelectAll] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:16:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeSerialize.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeSerialize.asciidoc
new file mode 100644
index 0000000..7e047b0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeSerialize.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeSerialize
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I serialize my nodes?
+
+When you serialize your nodes, you save them to disk so that when the application restarts, they can be used again in the application in the state that they were when the application shut down.
+
+From link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/doc-files/api.html#serial[ Serialization and traversal] in the NetBeans Javadoc:
+
+''"If you need to store (serialize) a node for any reason, this is generally impossible due to the welter of Java-level references connecting it to the rest of the system. Rather, you must use a special serializable handle which represents the node by its position in the hierarchy, and permits finding the original node again after deserialization (if it still exists). To create a handle, just call Node.getHandle(), and to restore the node call Node.Handle.getNode().
+
+Creation of a usable handle is implemented in AbstractNode, and you should not need to override it. However, note that a handle consists of a handle for the root node of the target node's hierarchy together with a path (by system name) down to the target node; so if you are creating a root node, and want it or its children to be serializable, then you should create a specific implementation of Node.Handle capable of reconstructing your root from scratch, and return it from Node.getHandle().
+
+The methods in NodeOp such as NodeOp.findPath(...) may also be used for general-purpose navigation along the hierarchy, should this be necessary."''
+
+Some concrete examples:
+
+* link:http://blogs.sun.com/geertjan/entry/serializing_nodes[ Serializing Nodes]
+* link:http://blogs.sun.com/geertjan/entry/multiple_nodes_serialization[ Serializing Marilyn Monroe]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeSerialize[http://wiki.netbeans.org/DevFaqNodeSerialize] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:56:25Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeSubclass.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeSubclass.asciidoc
new file mode 100644
index 0000000..eb20520
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeSubclass.asciidoc
@@ -0,0 +1,57 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeSubclass
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Creating Node Subclasses
+
+Nodes are useful for many things beyond just representing files. If you just need a placeholder `Node`, you do not need a subclass - just instantiate an `AbstractNode` - despite its name, `AbstractNode` is not an abstract class. For example:
+
+[source,java]
+----
+
+AbstractNode nue = new AbstractNode (Children.LEAF);
+nue.setDisplayName ("Please wait...");
+nue.setIcon (Utilities.loadImage ("path/in/jar/to/image.gif"));
+return nue;
+----
+
+If you are creating link:DevFaqWhatIsANode.html[Node]s, you will typically deal with one of four things
+
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/AbstractNode.html[AbstractNode] - create a Node which represents anything you want - you will implement all its logic, provide children, etc. Typically most logic goes in the Children object.
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/BeanNode.html[BeanNode] - a very convenient Node subclass, which can represent any JavaBean as a Node and expose its bean properties as Property objects that can be edited on the property sheet
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/FilterNode.html[FilterNode] - a Node subclass that proxies another Node. You can subclass this to take an existing Node (possibly representing a file on disk or in the link:DevFaqSystemFilesystem.html[system filesystem ] and keep most of its attributes, but provide different actions or display name or icons or properties
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/DataNode.html[DataNode] - a Node subclass specific to editing files. If you are writing a module that adds support for a new file type (such as `.svg` files), you will write a `DataNode` subclass to give files of that type icons, display names, and possibly provide access to the file's content
+
+Note that if you just want to write context sensitive code, not provide your own Nodes, you may be able to do it without a dependency on the Nodes API, using link:DevFaqTrackGlobalSelection.html[Utilities.actionsGlobalContext()].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeSubclass[http://wiki.netbeans.org/DevFaqNodeSubclass] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T05:48:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodeViewCapability.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodeViewCapability.asciidoc
new file mode 100644
index 0000000..818f15c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodeViewCapability.asciidoc
@@ -0,0 +1,55 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodeViewCapability
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I add a "View" capability for data my node represents
+
+Let's say that you've added support for a new file type in your application. You want to be able to provide an action by which users can "view" the file, which might open it up in the source editor (for text-based files) or a custom editor you've created in Swing. How can you add this view action?
+
+It turns out that there are a few ways:
+
+1. Create a `ViewCookie` for your node and in display the contents in the cookie's view() method.
+2. Create a subclass of `NodeAction` and displays the node's contents in its performAction() method.
+3. Create a subclass of `Node.Cookie` that my node should return in its lookup and then create a `CookieAction` that acts upon this.
+
+The first approach (`ViewCookie`) is the simplest of the three, though it can really only operate on a single node. If you just need something quick and easy, then it is probably your best bet.
+
+The second approach (`NodeAction`) will work but is discouraged since someone creating a `FilterNode` on your node might inadvertently disable your action.
+
+The third approach (`Node.Cookie/CookieAction`) is the most difficult of the three but also the most versatile. Your `CookieAction` can be enabled for multiple classes and can also operate on several nodes at once.
+
+=== See also:
+
+* link:DevFaqActionContextSensitive.html[How do I create an Action that is automatically enabled and disabled depending on the selection?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodeViewCapability[http://wiki.netbeans.org/DevFaqNodeViewCapability] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:56:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodesChildFactory.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodesChildFactory.asciidoc
new file mode 100644
index 0000000..ec4d3f1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodesChildFactory.asciidoc
@@ -0,0 +1,57 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodesChildFactory
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Computing Node Children Asynchronously
+
+If you have a Node that needs to provide child Nodes, and computing the objects the child nodes represent is slow or expensive (i.e. you need to parse a file, connect to a database, or do some sort of I/O), you do not want to compute the child nodes in the event thread (which is what happens by default).
+
+NetBeans 6.0 introduces `org.openide.nodes.ChildFactory` and `Children.create(ChildFactory factory, boolean asynchronous)`. Simply subclass `ChildFactory` and implement `protected boolean createKeys(List <T> toPopulate)` to build the list of objects that will be represented by the child nodes. Implement `protected Node createNodeForKey(T key)` to create a Node - it will be passed each object in the list of child objects. `createKeys` will be called on a background thread.
+
+Typically you'll want to make the model object from `createKeys` available on the Node you create. So a simple implementation of `createNodeForKey` would look something like:
+
+[source,java]
+----
+
+ protected Node createNodeForKey(T key) {
+ AbstractNode result = new AbstractNode (Children.LEAF, Lookups.singleton (key));
+ result.setDisplayName (key.getName()); //or whatever
+ result.setIcon (Utilities.loadImage ("path/in/jar/to/image.gif"));
+ return result;
+ }
+
+----
+
+ChildFactory can also simplify creating Nodes synchronously, and has the convenience that by using generics, your code can be type safe with respect to key objects. Generally it can be used anywhere `Children.Keys` would be used (it uses `Children.Keys` under the hood).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodesChildFactory[http://wiki.netbeans.org/DevFaqNodesChildFactory] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T18:45:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodesCustomLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodesCustomLookup.asciidoc
new file mode 100644
index 0000000..86e06aa
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodesCustomLookup.asciidoc
@@ -0,0 +1,126 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodesCustomLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I need to add-to/remove-from/customize the content of my Node/DataObject/TopComponent's Lookup. How do I do it?
+
+If it's just adding something, use
+
+[source,java]
+----
+
+return new ProxyLookup(
+ new Lookup[] {
+ super.getLookup(),
+ Lookups.fixed(
+ something, somethingElse)
+ });
+
+----
+
+If there's only one object, substitute `Lookups.singleton ( someObject )`.
+
+If you need to change the content of the lookup on the fly, it's a little more complicated, but not too much. Use the above
+ProxyLookup technique if there's a Lookup returned by the superclass and you still want to use its content.
+What you'll use to change content on the fly is the combination of `AbstractLookup` (which, as fate would
+have it, is not actually abstract), and `InstanceContent`, which is a grab bag of stuff you can add to and
+remove from.
+
+The result will look something like this:
+
+[source,java]
+----
+
+class MyNode extends AbstractNode {
+ private final InstanceContent lookupContents;
+ public MyNode() {
+ this(new InstanceContent());
+ }
+ private MyNode(InstanceContent ic) {
+ super(Children.LEAF, new AbstractLookup(ic));
+ this.lookupContents = ic;
+ }
+}
+
+----
+
+When you need to change the contents of your lookup, you can call `InstanceContent.add()` or and `InstanceContent.remove()`, e.g.:
+
+[source,java]
+----
+
+lookupContents.add(someObject);
+lookupContents.remove(someObject);
+
+----
+
+Your lookup will be updated to include all items in the InstanceContent.
+
+==== Custom Lookup Contents with DataObjects
+
+DataObjects have a Lookup, but also use an older variant on the Lookup pattern, called a `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/CookieSet.html[CookieSet]`. Since this is a somewhat bewildering term, and `CookieSet` will eventually be deprecated, you may want to avoid using it. A `CookieSet` ordinarily provides the `Lookup` for a DataObject; and certain APIs such as `DataEditorSupport` require it.
+
+However, it is possible to work with the more modern idioms of Lookup as described above, with a few caveats. Such a DataObject typically looks like:
+
+[source,java]
+----
+
+public class FooDataObject extends MultiDataObject {
+ private final Lookup lookup;
+ private final InstanceContent lookupContents = new InstanceContent();
+ public FooDataObject(FileObject pf, MultiFileLoader loader) throws DataObjectExistsException, IOException {
+ super(pf, loader);
+ lookup = new ProxyLookup(getCookieSet().getLookup(), new AbstractLookup(lookupContents));
+ lookupContents.add (...whatever...);
+ }
+
+ @Override
+ public Lookup getLookup() {
+ return lookup;
+ }
+
+ @Override
+ protected Node createNodeDelegate() {
+ return new DataNode (this, Children.LEAF, getLookup());
+ }
+ //...
+
+----
+
+You can then add and remove objects from your `InstanceContent` and the `DataObject` will behave as expected.
+
+*Caveat 1: You really must override `createNodeDelegate()`* or otherwise (in your `DataNode` subclass) pass your `DataObject`'s `Lookup` to your `DataNode`'s constructor. Otherwise its lookup will be `getCookieSet().getLookup()` and nothing added to your `InstanceContent` will appear in the `Lookup` of your `Node`. So, _if you use AbstractLookup in a DataObject, make sure its Node is really using your DataObject's Lookup_.
+
+*Caveat 2: A DataObject should always appear in its own Lookup* — If you are _really sure_ that nothing is going to use your `DataObject`'s `CookieSet` at all, you can omit merging `getCookieSet().getLookup()` into the `ProxyLookup` in the constructor. However, many things will not work correctly if _the DataObject itself_ cannot be found in its own `Lookup`. If you are going to do that, replace `getCookieSet().getLookup()` with `Lookups.singleton(this)` to ensure it is present and cannot be removed or replaced.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodesCustomLookup[http://wiki.netbeans.org/DevFaqNodesCustomLookup] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:02:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNodesDecorating.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNodesDecorating.asciidoc
new file mode 100644
index 0000000..82fcdab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNodesDecorating.asciidoc
@@ -0,0 +1,156 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNodesDecorating
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Decorating an entire tree of Nodes
+
+Say you have a reference to the root of a tree of `Node` instances, and you want to add icons or actions to those nodes. First, what you *do not* do is call `setDisplayName` or any other setter on that Node (unless you created it - the point here is that it is rude and can have bad side effects to call setters on random Nodes somebody else created - setters in APIs are bugs - the fact that Node has them is a historical artifact, not proper design).
+
+If you own the component that will display the Nodes, this sort of thing is very easily done by subclassing `FilterNode` and overriding the appropriate methods (e.g. `getActions()`, `getIcon()`, etc.), wrapping the original node inside your `FilterNode`. Now let's say that the Node you want to decorate builds out its children in a lazy fashion, that is, only when the user expands the tree in some tree view. How would you decorate that node and all of its children, without traversing the entire tree and effectively undoing the benefits of the lazy population of the tree?
+
+Fortunately, while this sounds rather challenging, it turns out to be surprisingly easy and simple to achieve. The trick is to subclass the `FilterNode.Children` class and override the `copyNode()` method. Below is a short example:
+
+[source,java]
+----
+
+class NodeProxy extends FilterNode {
+
+ public NodeProxy(Node original) {
+ super(original, new ProxyChildren(original));
+ }
+
+ // add your specialized behavior here...
+}
+
+class ProxyChildren extends FilterNode.Children {
+
+ public ProxyChildren(Node owner) {
+ super(owner);
+ }
+
+ protected Node copyNode(Node original) {
+ return new NodeProxy(original);
+ }
+}
+
+----
+
+As you can see, `NodeProxy` is intended to wrap around another `Node` and provide some additional appearance or behavioral changes (e.g. different icons or actions). The fun part is the `ProxyChildren` class. While very short and simple, it provides that critical ability for our `NodeProxy` to act as a decorator for not only the root node, but all of its children, and their children, and so on, without having to traverse the entire tree at once.
+
+While `FilterNode` should NOT be used to insert additional nodes at the beginning or end of the list (see its JavaDoc), it can be easily used to filter out some of the children nodes. For instance, this refinement of `ProxyChildren` overrides the `createNodes()` method and conditionally selects the children nodes by submitting them to a custom `accept()` method:
+
+[source,java]
+----
+
+ class ProxyChildren extends FilterNode.Children {
+
+ public ProxyChildren (Node owner) {
+ super(owner);
+ }
+
+ @Override
+ protected Node copyNode (Node original){
+ return new NodeProxy(original);
+ }
+
+ @Override
+ protected Node[] createNodes (Object object) {
+ List<Node> result = new ArrayList<Node>();
+
+ for (Node node : super.createNodes(object)) {
+ if (accept(node)) {
+ result.add(node);
+ }
+ }
+
+ return result.toArray(new Node[0]);
+ }
+
+ private boolean accept (Node node) {
+ // ...
+ }
+ }
+
+----
+
+Below a complete example of a `FileFilteredNode` that can be used to show a file hierarchy where only a subset of files is shown, selected by means of the standard `java.io.FileFilter` class:
+
+[source,java]
+----
+
+class FileFilteredNode extends FilterNode {
+
+ static class FileFilteredChildren extends FilterNode.Children {
+ private final FileFilter fileFilter;
+
+ public FileFilteredChildren (Node owner, FileFilter fileFilter) {
+ super(owner);
+ this.fileFilter = fileFilter;
+ }
+
+ @Override
+ protected Node copyNode (Node original) {
+ return new FileFilteredNode(original, fileFilter);
+ }
+
+ @Override
+ protected Node[] createNodes (Object object) {
+ List<Node> result = new ArrayList<Node>();
+
+ for (Node node : super.createNodes(object)) {
+ DataObject dataObject = (DataObject)node.getLookup().lookup(DataObject.class);
+
+ if (dataObject != null) {
+ FileObject fileObject = dataObject.getPrimaryFile();
+ File file = FileUtil.toFile(fileObject);
+
+ if (fileFilter.accept(file)) {
+ result.add(node);
+ }
+ }
+ }
+
+ return result.toArray(new Node[result.size()]);
+ }
+ }
+
+ public FileFilteredNode (Node original, FileFilter fileFilter) {
+ super(original, new FileFilteredChildren(original, fileFilter));
+ }
+ }
+
+----
+
+Note that if you're showing the filtered nodes in a tree view according to the code above, you might find expansion handles on leaf nodes. link:http://openide.netbeans.org/servlets/ReadMsg?listName=dev&msgNo=11595[This thread from the dev@openide list] discusses some solutions to this problem.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNodesDecorating[http://wiki.netbeans.org/DevFaqNodesDecorating] ,
+that was last modified by NetBeans user J.boesl
+on 2010-08-19T14:20:51Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNonGuiPlatformApp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNonGuiPlatformApp.asciidoc
new file mode 100644
index 0000000..e6fac19
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNonGuiPlatformApp.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNonGuiPlatformApp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Can I create a console or server (non-GUI) app with the NetBeans Platform?
+
+While most documentation explains the NetBeans Platform in terms of Java desktop applications, it is possible to build a non-GUI application on the NetBeans Platform. This might be useful, for example, when creating a platform-based application which will distribute computationally expensive work among a group of machines. Note that this explains how to develop an application which is only ever meant to run headless, not how to develop a single application which can run in either GUI _or_ command line mode (which is described in the second half of this page).
+
+This is done by simply starting with the NetBeans Platform and removing all but the most essential components. NetBeans architect link:http://www.apidesign.org/[Jaroslav Tulach] calls this subset of the NetBeans platform the "link:http://wiki.apidesign.org/wiki/NetBeans_Runtime_Container[runtime container]" and wrote an application which uses it to link:http://dvbcentral.sourceforge.net/[control his television].
+
+Here are the steps for creating a runtime container application:
+
+1. Create a new suite
+2. Exclude all clusters from the suite
+3. Re-enable the platform cluster, but disable all but the following modules:
+* Bootstrap
+* File System API
+* Lookup API
+* Module System API
+* Startup
+* Utilities API
+4. Add a new module to the suite
+5. Create and register a `ModuleInstall` class
+6. The `restored()` method is effectively your application's `main` method.
+7. You may optionally override the `close()` method of your `ModuleInstall` to clean up resources upon shutdown, but be sure then to call `LifecycleManager.getDefault().shutDown()`.
+
+You will also need to suppress the splash screen by passing `--nosplash` argument when starting the app.
+
+== How Can I Make My NetBeans Platform Run in GUI or Command-Line Mode?
+
+If your application performs some repetitive task like engineering analysis and you have some users who prefer using the command line and some who don't, you may be asked to modify your application so that it can run in either the normal GUI mode or in batch processing mode from the command line.
+
+The exact method for doing this will vary per application, but you will typically need to add a module to interpret some custom command-line arguments using the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-sendopts/[Command Line Processing API]. Inside the process(Env env, Map<Option, String[]> map) method of your option processor, you'll invoke whatever code corresponds to the arguments the user specified (e.g. myapp --import path/to/file.txt might import some file).
+
+Remember that you should not use System.out, System.err and System.in for the output, error and input streams in the options processor but instead get them from the Env object passed as a parameter to the process method.
+
+When running a platform application which contains the Window System and other GUI modules, you will also need to specify --nosplash --nogui on the command line at startup to prevent the splash screen and window system from being displayed. You may also wish to set the netbeans.logger.console system property to true (e.g. specify -J-Dnetbeans.logger.console=true on the command line) so that you will see NetBeans' error messages on the console. It might also be a good idea to specify the plugin.manager.check.interval=NEVER system property to avoid checks for new plugins when running in command line mode.
+
+Finally, note that prior to NetBeans 6.10, the current working directory available from the Env object was set to the directory of the application's installation, not the directory from which the command was executed. The consequence of this is that resolving relative file paths did not work as expected on Microsoft Windows systems, although it does work correctly on all versions of UNIX I tested. This has been resolved (link:http://netbeans.org/bugzilla/show_bug.cgi?id=189791[http://netbeans.org/bugzilla/show_bug.cgi?id=189791]), but the suggested workaround for affected versions of the platform is to introduce an additional batch file which invokes the NetBeans executable by passing in a Java system property that specifies the current (execution) directory.
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNonGuiPlatformApp[http://wiki.netbeans.org/DevFaqNonGuiPlatformApp] ,
+that was last modified by NetBeans user Tomwheeler
+on 2010-09-10T16:38:01Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqNonSingletonTopComponents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqNonSingletonTopComponents.asciidoc
new file mode 100644
index 0000000..c30c669
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqNonSingletonTopComponents.asciidoc
@@ -0,0 +1,131 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqNonSingletonTopComponents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I change my TopComponent to not be a singleton (NB version up to 6.9)?
+
+The "New Window Component" wizard in the NetBeans IDE generates a link:http://en.wikipedia.org/wiki/Singleton_pattern[singleton] TopComponent. That's fine for windows that there should only be one of. Particularly if you are link:DevFaqEditorTopComponent.html[creating some kind of editor], you will want to create multiple instances of your TopComponent.
+
+==== The really easy way
+
+If you have not already used the *New Window* template to create your TopComponent subclass, don't.
+
+Instead, use _New > JPanel Form_. Once the new JPanel is created, switch to the Code tab, and replace `extends javax.swing.JPanel` with `extends TopComponent`. Then do the following things:
+
+* Override `getPersistenceType()`.
+* If you _do not_ want your components reopened on restart
+* return `PERSISTENCE_NEVER`—that is all you need to do to make sure they are not preserved across restarts.
+* If you _do_ want your components reopened on restart, then
+* return `PERSISTENCE_ONLY_OPENED` from `getPersistenceType()`
+* Add the following slightly-cryptic annotation to the class: `@ConvertAsProperties(dtd = "-//com.yourmodule.yourpackage//YourTopComponent//EN", autostore = false)`, replacing the package and class name with your own. This identifies a DTD. You do not need to define the DTD. You just need to give it a unique namespace that nothing else is using. Package and class name work well for that.
+* Add two additional methods (you are not overriding anything and they can be package-private, like serialization methods):
+* `void writeProperties(Properties p)` - here we will call `p.put()` passing enough information to reconstruct your component on restart. If we are editing a file, we might save the path to the file. If we are viewing a URL, we might save the URL. If we want to be particularly fastidious, we might save the scroll position, or what line the editor caret was on , or anything else useful to restore the state of our component.
+* `void readProperties(Properties p)` - here we will reading whatever keys we wrote out in `writeProperties` and (re)initializing the component to its pre-shutdown state. This method will be called on startup to restore our component to its pre-shutdown state as best can be done. If we were, say, editing a file that no longer exists, the appropriate thing to do is throw an exception.
+
+==== If you already have a generated singleton TopComponent subclass
+
+The good news is that you won't have to write any code -- you'll just have to delete some of the code that was generated for you.
+
+In your TopComponent's .java source file:
+
+* Delete the static `instance` variable, which ought to be declared a few lines above the constructor.
+* Make sure your TopComponent class is `public`
+* Make sure your TopComponent has a no-argument constructor which is `public`
+* Delete the `getDefault()` method (typically somewhere around the middle of the file)
+* Delete the `findInstance()` method (which typically follows the `getDefault()` method)
+* Update the persistence code which saves your component's state on shutdown and restores it on restart to reopen your component as follows
+* Locate the `getPersistenceType` method and change its return value to either `link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html#PERSISTENCE_NEVER[TopComponent.PERSISTENCE_NEVER]` or `link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html#PERSISTENCE_ONLY_OPENED[TopComponent.PERSISTENCE_ONLY_OPENED]` (see below for why).
+* If you have methods called `writeReplace()`and an inner class called `ResolvableHelper` (NetBeans 6.8 and earlier):
+* Delete the `writeReplace()` method (typically towards the end of the file)
+* Delete the `ResolvableHelper` inner class (typically towards the end of the file)
+* If you _do not want persistence across restarts_ — you are returning PERSISTENCE_NEVER from `getPersistenceType()`
+* If you have a `@ConvertAsProperties` annotation and `readProperties(Properties)` and `writeProperties(Properties)` methods, delete the annotation and both methods
+* If _do want persistence across restarts_ — you are returning `PERSISTENCE_ONLY_OPENED` from`getPersistenceType()`
+* If you already have the `@ConvertAsProperties` annotation and `readProperties(Properties)` and `writeProperties(Properties)` methods just leave them there
+* If you do not have the annotation and those methods, implement them as described in the previous section
+
+Next we will need to delete the metadata that registers the component:
+
+* For version 6.9 of NetBeans:
+* Delete the settings XML file for your component. If your component class is `MyWindow` then that file will be in the same folder and will be called `MyWindowSettings.xml`.
+* Delete the link:DevFaqWindowsWstcrefAndFriends.html[wstcrf] ("window system TopComponent reference") XML file in that folder. If your component class is `MyWindow` then that file will be named `MyWindowWstcrf.xml`
+* Edit your module's [DevFaqModulesLayerFile| layer.xml file] to
+* Remove any references to either of these files (just use Ctrl-F to search for e.g. `MyWindowSettings.xml` and `MyWindowWstcrf.xml`). They will be in `<file>` tags.
+* If you have removed a `<file>` entry, and it was the only entry in that folder, you can remove the XML for parent folder (and its parent if it is now empty, and so forth)
+* Find where an Action is registered for to open your (formerly) singleton TopComponent
+* _NetBeans 6.9 and later:_
+* Look for an `<file>` registered in `Actions/Window`in the XML file. It will have an `<attr>` element that refers to your TopComponent class, e.g. `<attr name="component" methodvalue="com.foo.MyWindow.findInstance"/>`. Delete the entire `<file>` entry.
+* Look for `<file>` entry for a `.shadow` file in `Actions/Menu` in the XML, with its `originalFile` pointing to the file entry you just deleted. Delete the `.shadow` `<file>` too.
+* _NetBeans 6.8 and earlier:_
+* There will be an `Action` class in your sources which is registered, e.g. `MyWindowAction.java`. Delete the java source file.
+* Look for an `<file>` registered in `Actions/Window`in the XML file. It will be a `<file>` whose name is the munged fully-qualified class name of the `Action` you just deleted, e.g. `com-foo-MyWindowAction.instance`. Delete the `<file>` entry for it
+* Look for `<file>` entry for a `.shadow` file in `Actions/Menu` in the XML, with its `originalFile` pointing to the file entry you just deleted. Delete the `.shadow` `<file>` too.
+
+==== Creating And Opening Your TopComponents
+
+Now that you have deleted the actions for your TopComponent, presumably they will be created some other way (for example, from a file's popup menu). You can create new instances of your TopComponent, open them and give them focus as follows:
+
+[source,java]
+----
+
+TopComponent win = new MyTopComponent();
+win.open();
+win.requestActive();
+----
+
+If you wrote your persistence code correctly, your components will magically reopen on restart with no further work.
+
+==== What About PERSISTENCE_ALWAYS?
+
+There is one other value you can return from `link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html#getPersistenceType()[TopComponent.getPersistenceType()]`. That value is `TopComponent.PERSISTENCE_ALWAYS`.
+
+While it is _legal_ to return this value from a non-singleton TopComponent, it is almost never what you want to do. What will happen if you do this is:
+
+* Every instance of your component that is *ever created* will be persisted on shutdown, _forever_
+* Even if it is closed
+* Even if nothing can use it, or it represents a file that was deleted, or is in some other way invalid
+* Even if no code will ever be able to find it and open it again
+* One every restart, _forever_
+* Every instance of your component that has _ever existed_ will be read back from disk
+* Each one will slow down startup a little bit
+* Each one will be wasting disk space
+
+`PERSISTENCE_ALWAYS` is for singleton components that need to be remembered forever across restarts. Don't use it for non-singletons.
+
+==== If you do not have any persistence code, but your components are reopening on restart...
+
+You are returning either `PERSISTENCE_ONLY_OPENED` or `PERSISTENCE_ALWAYS` from `getPersistenceType()`. If there is no persistence code, but you _are_ returning one of these values, NetBeans will use plain old Java serialization to store and reload your component.
+
+Either use `PERSISTENCE_NEVER` or write persistence code as described above. Serialization is slower and more fragile than proper persistence, and is never a good option for production code.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqNonSingletonTopComponents[http://wiki.netbeans.org/DevFaqNonSingletonTopComponents] ,
+that was last modified by NetBeans user Cvdenzen
+on 2012-09-18T10:54:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOWColorText.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOWColorText.asciidoc
new file mode 100644
index 0000000..884c33e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOWColorText.asciidoc
@@ -0,0 +1,72 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOWColorText
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to use color text in Output Window
+
+You can use IO extension classes like `IOColorPrint`, `IOColorLines`. Default colors can be changed via `IOColors`.
+
+[source,java]
+----
+
+InputOutput io = IOProvider.getDefault().getIO("test", true);
+
+// change default color for output in corresponding tab
+if (IOColors.isSupported(io)) {
+ IOColors.setColor(io, IOColors.OutputType.OUTPUT, Color.GRAY);
+}
+
+// print line in specific color
+if (IOColorLines.isSupported(io)) {
+ IOColorLines.println(io, "Green line", Color.GREEN);
+}
+
+
+class L implements OutputListener {
+//...
+}
+
+// print parts of line in specific color
+if (IOColorPrint.isSupported(io)) {
+ IOColorPrint.print(io, "Green part", Color.GREEN);
+ IOColorPrint.print(io, " pink part", Color.PINK);
+ IOColorPrint.print(io, " hyperlink with custom color", new L(), false, Color.MAGENTA);
+}
+----
+
+See link:http://plugins.netbeans.org/plugin/39695/?show=true[here] for a plugin that has a convenient class that takes care of the dirty work and even handles `OutputListeners`.
+
+<hr/>
+Applies to: NetBeans 6.7 or later, (IOColorPrint 6.8 or later).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOWColorText[http://wiki.netbeans.org/DevFaqOWColorText] ,
+that was last modified by NetBeans user Jhavlin
+on 2011-12-12T13:36:25Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOWTabEmbedding.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOWTabEmbedding.asciidoc
new file mode 100644
index 0000000..66166e4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOWTabEmbedding.asciidoc
@@ -0,0 +1,133 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOWTabEmbedding
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I embed output window tab to another component?
+
+You have to create `IOContainer` which provides access (for `IOProvider`) to your component where you want to embed OW tab (IO tab). Then you need to pass `IOContainer` instance to `IOProvider.getIO(String name, Actionlink:_.html[ ] actions, IOContainer ioContainer)`. `IOContainer` is created by `IOContainer.create(IOContainer.Provider)`. The following code demonstrates how to add OW to custom TopComponent.:
+
+[source,java]
+----
+
+ IOContainer ioc = IOContainer.create(new IOC());
+ InputOutput io = IOProvider.getDefault().getIO("test", new Action[0], ioc);
+ io.getOut().println("Hi there");
+ io.select();
+
+ // implement IOContainer.Provider in TopComponent where OW tab will be added
+ class IOC extends TopComponent implements IOContainer.Provider {
+ JComponent ioComp;
+ CallBacks ioCb;
+
+ public IOC() {
+ setLayout(new BorderLayout());
+ setDisplayName("Test");
+ }
+
+ @Override
+ public int getPersistenceType() {
+ return PERSISTENCE_NEVER;
+ }
+
+ public void add(JComponent comp, CallBacks cb) {
+ if (ioComp != null) {
+ remove(ioComp);
+ if (ioCb != null) {
+ ioCb.closed();
+ }
+ }
+ ioComp = comp;
+ ioCb = cb;
+ add(comp);
+ validate();
+ }
+
+ public JComponent getSelected() {
+ return ioComp;
+ }
+
+ boolean activated;
+ public boolean isActivated() {
+ return activated;
+ }
+
+ @Override
+ protected void componentActivated() {
+ super.componentActivated();
+ activated = true;
+ if (ioCb != null) {
+ ioCb.activated();
+ }
+ }
+
+ @Override
+ protected void componentDeactivated() {
+ super.componentDeactivated();
+ activated = false;
+ if (ioCb != null) {
+ ioCb.deactivated();
+ }
+ }
+
+ public boolean isCloseable(JComponent comp) {
+ return false;
+ }
+
+ public void remove(JComponent comp) {
+ if (comp == ioComp) {
+ ioComp = null;
+ ioCb = null;
+ }
+ }
+
+ public void select(JComponent comp) {
+ }
+
+ public void setIcon(JComponent comp, Icon icon) {
+ }
+
+ public void setTitle(JComponent comp, String name) {
+ }
+
+ public void setToolTipText(JComponent comp, String text) {
+ }
+
+ public void setToolbarActions(JComponent comp, Action[] toolbarActions) {
+ }
+ }
+----
+
+<hr/>
+Applies to: NetBeans 6.7
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOWTabEmbedding[http://wiki.netbeans.org/DevFaqOWTabEmbedding] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:58:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqObtainSourcesOfAJavaClass.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqObtainSourcesOfAJavaClass.asciidoc
new file mode 100644
index 0000000..280618d
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqObtainSourcesOfAJavaClass.asciidoc
@@ -0,0 +1,63 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqObtainSourcesOfAJavaClass
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I obtain a source file for a Java class and open it in the editor?
+
+Sometimes it is necessary to open source code for a Java file from your NetBeans plug-in.
+The source code may be located in the currently open projects, in a library or in the platform JRE.
+It is assumed that libraries and platform JRE have associated sources in your environment.
+The associations are configured from the *Tools > Libraries* and
+*Tools > Java Platform* menu items.
+
+Here is an example of how to find a `FileObject` corresponding to the class `javax.swing.JComponent`:
+
+[source,java]
+----
+
+String classResource = "javax/swing/JComponent.java";
+for (FileObject curRoot : GlobalPathRegistry.getDefault().getSourceRoots()) {
+ FileObject fileObject = curRoot.getFileObject(classResource);
+ if (fileObject != null) {
+ // source file object found
+ // do something, e.g. openEditor(fileObject, lineNumber);
+ return;
+ }
+}
+----
+
+In the `if` block you can do something with the source file you found.
+For example, you can open it in the Java editor.
+link:DevFaqOpenFileAtLine.html[DevFaqOpenFileAtLine] describes how.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqObtainSourcesOfAJavaClass[http://wiki.netbeans.org/DevFaqObtainSourcesOfAJavaClass] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:57:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenFile.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenFile.asciidoc
new file mode 100644
index 0000000..d298adc
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenFile.asciidoc
@@ -0,0 +1,65 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenFile
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Approach 1
+
+Answer from link:http://forums.netbeans.org/topic32140.html&highlight=[this] post:
+
+[source,java]
+----
+
+FileObject fo = FileUtil.toFileObject(new File("test.js").getAbsoluteFile());
+DataObject newDo = DataObject.find(fo);
+final Node node = newDo.getNodeDelegate();
+Action a = node.getPreferredAction();
+if (a instanceof ContextAwareAction) {
+ a = ((ContextAwareAction) a).createContextAwareInstance(node.getLookup());
+}
+if (a != null) {
+ a.actionPerformed(new ActionEvent(node, ActionEvent.ACTION_PERFORMED, "")); // NOI18N
+}
+----
+
+Keep in mind that this must be called from the EDT thread, it'll raise a RuntimeException otherwise.
+
+=== Approach 2
+
+[source,java]
+----
+
+FileObject fileObject=...
+DataObject.find(fileObject).getLookup().lookup(OpenCookie.class).open();
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenFile[http://wiki.netbeans.org/DevFaqOpenFile] ,
+that was last modified by NetBeans user Markiewb
+on 2013-05-16T18:09:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenFileAtLine.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenFileAtLine.asciidoc
new file mode 100644
index 0000000..3cc7e97
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenFileAtLine.asciidoc
@@ -0,0 +1,104 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenFileAtLine
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I open a particular file at a particular line number and column?
+
+Here is the basic idea (there are variations depending on your needs, so read the Javadoc):
+
+[source,java]
+----
+
+File f = ...;
+int lineNumber = ...;
+FileObject fobj = FileUtil.toFileObject(f);
+DataObject dobj = null;
+try {
+ dobj = DataObject.find(fobj);
+} catch (DataObjectNotFoundException ex) {
+ ex.printStackTrace();
+}
+if (dobj != null)
+{
+ LineCookie lc = (LineCookie) dobj .getCookie(LineCookie.class);
+ if (lc == null) {/* cannot do it */ return;}
+ Line l = lc.getLineSet().getOriginal(lineNumber);
+ l.show(Line.SHOW_GOTO);
+}
+----
+
+---
+
+Applies to: NetBeans 5.x, 6.0, 6.1
+
+For NetBeans 6.5 and later you should use something like:
+
+[source,java]
+----
+
+File f = ...;
+int lineNumber = ...;
+FileObject fobj = FileUtil.toFileObject(f);
+DataObject dobj = null;
+try {
+ dobj = DataObject.find(fobj);
+} catch (DataObjectNotFoundException ex) {
+ ex.printStackTrace();
+}
+if (dobj != null)
+{
+ LineCookie lc = (LineCookie) dobj .getCookie(LineCookie.class);
+ if (lc == null) {/* cannot do it */ return;}
+ Line l = lc.getLineSet().getOriginal(lineNumber);
+ l.show(Line.ShowOpenType.OPEN, Line.ShowVisibilityType.FOCUS);
+}
+----
+
+See the JavaDoc for `Line.ShowOpenType` and `Line.ShowVisibilityType` to see different options of showing the line (with focus, without focus, opening the editor if not open, etc.).
+
+Example "How to open a document at line and at a specific column"
+
+[source,java]
+----
+
+ int lineNumber=42;
+ int colNumber=43;
+
+ //misses checks for NPEs
+ FileObject fo = ...;
+ LineCookie lc = DataObject.find(fo).getLookup().lookup(LineCookie.class);
+ Line line = lc.getLineSet().getOriginal(lineNumber);
+ line.show(Line.ShowOpenType.OPEN, Line.ShowVisibilityType.FRONT, colNumber);
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenFileAtLine[http://wiki.netbeans.org/DevFaqOpenFileAtLine] ,
+that was last modified by NetBeans user Markiewb
+on 2016-08-28T10:23:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenFilesAfterProjectCreation.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenFilesAfterProjectCreation.asciidoc
new file mode 100644
index 0000000..7cf34fb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenFilesAfterProjectCreation.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenFilesAfterProjectCreation
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to open files in editor after project creation?
+
+Q: I have created my own project type for my platform application. After project being created I would like to open a file contained in this project. Just like it is done when you create new java application in netbeans. After project creation your main java class is opened in editor.
+
+A: your new project wizard iterator should be a WizardIterator<Set<FileObject>> - and you should just be able to add the files you want opened to that set
+
+<hr/>
+Taken from nbdev mailing list. April 2013
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenFilesAfterProjectCreation[http://wiki.netbeans.org/DevFaqOpenFilesAfterProjectCreation] ,
+that was last modified by NetBeans user Markiewb
+on 2013-04-29T21:18:22Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenOptionsAtCategory.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenOptionsAtCategory.asciidoc
new file mode 100644
index 0000000..3fd9e6b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenOptionsAtCategory.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenOptionsAtCategory
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do you open the option dialog with a preselected category?
+
+See link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/api/options/OptionsDisplayer.html#open-java.lang.String-[http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-options-api/org/netbeans/api/options/OptionsDisplayer.html#open-java.lang.String-]
+
+For example
+`
+OptionsDisplayer.getDefault().open("Java"+ "/de.markiewb.netbeans.plugins.eclipse.formatter.options");
+`
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenOptionsAtCategory[http://wiki.netbeans.org/DevFaqOpenOptionsAtCategory] ,
+that was last modified by NetBeans user Markiewb
+on 2016-02-13T11:36:25Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenProjectProgramatically.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenProjectProgramatically.asciidoc
new file mode 100644
index 0000000..a52066b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenProjectProgramatically.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenProjectProgramatically
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+Here's the link:http://wiki.netbeans.org/OpenProjectsProgramaticallyInNetBeansIDE[source] of this FAQ:
+
+Just wanted to put the core of it here for future reference as this was not easy for me to find:
+
+[source,java]
+----
+
+ File projectToBeOpenedFile = new File(getPath());
+ FileObject projectToBeOpened = FileUtil.toFileObject(projectToBeOpenedFile);
+ Project project = ProjectManager.getDefault().findProject(projectToBeOpened);
+ Project[] array = new Project[1];
+ array[0] = project;
+ OpenProjects.getDefault().open(array, false);
+----
+
+Remember to add references to Project API and Project UI API.
+
+Go to the link:http://wiki.netbeans.org/OpenProjectsProgramaticallyInNetBeansIDE[link] to see the explanation of the code.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenProjectProgramatically[http://wiki.netbeans.org/DevFaqOpenProjectProgramatically] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-07-28T14:00:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOpenReadOnly.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOpenReadOnly.asciidoc
new file mode 100644
index 0000000..606e533
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOpenReadOnly.asciidoc
@@ -0,0 +1,83 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOpenReadOnly
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I open a file in the editor in read-only mode?
+
+You will need to make a special file editor which refuses to take a write lock:
+
+[source,java]
+----
+
+public final class ROEditor extends DataEditorSupport {
+ private ROEditor(DataObject d) {
+ super(d, new E(d));
+ }
+ public ROEditor(FileObject fo) throws DataObjectNotFoundException {
+ this(DataObject.find(fo));
+ }
+ private static final class E extends DataEditorSupport.Env {
+ public E(DataObject d) {
+ super(d);
+ }
+ protected FileObject getFile() {
+ return getDataObject().getPrimaryFile();
+ }
+ protected FileLock takeLock() throws IOException {
+ throw new IOException("No way!");
+ }
+ }
+}
+----
+
+Demo of usage:
+
+[source,java]
+----
+
+JFileChooser jfc = new JFileChooser();
+if (jfc.showOpenDialog(null) != JFileChooser.APPROVE_OPTION) {
+ return;
+}
+File f = jfc.getSelectedFile();
+FileObject fo = FileUtil.toFileObject(f);
+try {
+ new ROEditor(fo).open();
+} catch (DataObjectNotFoundException e) {
+ e.printStackTrace();
+}
+----
+
+Applies to: NetBeans 4.0 and newer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOpenReadOnly[http://wiki.netbeans.org/DevFaqOpenReadOnly] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T13:28:46Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOrderActions.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOrderActions.asciidoc
new file mode 100644
index 0000000..17924b6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOrderActions.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOrderActions
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want my action to appear between to existing items/in a specific place in the menu. Can I do that?
+
+Yes. Use link:DevFaqOrderAttributes.html[ordering attributes] in the link:DevFaqModulesLayerFile.html[layer file] for your module.
+
+If you are using the IDE's module project, the new *Action* template will let you specify a location for the action in the wizard and generate the right attribute for you.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOrderActions[http://wiki.netbeans.org/DevFaqOrderActions] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:57:29Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOrderAttributes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOrderAttributes.asciidoc
new file mode 100644
index 0000000..5a80f44
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOrderAttributes.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOrderAttributes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I specify the order for my menu items/toolbar buttons/files in the system filesystem?
+
+If you are using module development support the IDE,
+you can manage the order of menu or toolbar items
+by the help of special node *XML Layer*
+which can be found underneath your *Important Files*.
+Just find your menu/toolbar item and drag and drop it wherever you need.
+Appropriate content in the project metadata (layer file) will be generated for you.
+If this does not work, or you want to know more, read on.
+
+`FileObject`s (link:DevFaqFileObject.html[DevFaqFileObject]) in a folder have no defined order by default.
+You can use `FileUtil.getOrder` to sort them.
+(`DataObject`s (link:DevFaqDataObject.html[DevFaqDataObject]) in a folder are always sorted this way.)
+The order is determined by numeric `position` attributes.
+For all details, see: link:FolderOrdering103187.html[FolderOrdering103187]
+
+<hr/>
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOrderAttributes[http://wiki.netbeans.org/DevFaqOrderAttributes] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:01:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOrphanedNetBeansOrgModules.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOrphanedNetBeansOrgModules.asciidoc
new file mode 100644
index 0000000..81522c0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOrphanedNetBeansOrgModules.asciidoc
@@ -0,0 +1,94 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOrphanedNetBeansOrgModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I work on just one or two modules from the NetBeans source base by themselves?
+
+==== Introduction
+
+Normally to work on modules versioned in the NetBeans `main` Mercurial repository you need to clone the entire repository.
+(For modules in `contrib`, you need `contrib` cloned as a subdirectory of `main`.)
+For people interested in just playing with patches to one or two modules this can be onerous, however.
+As an alternative, you can work on "orphan" modules from the netbeans.org source base ( has details).
+There are two issues to consider:
+
+1. Mercurial link:http://www.selenic.com/mercurial/bts/issue515[currently] does not let you clone or check out just a subdirectory of a repository, so you will need to get module sources some other way (we are still considering some possibilities).
+2. Since "upstream" modules (that the module of interest depends on) are not available in source form, you need to have a recent development build of NetBeans available to compile against.
+
+==== Quick usage guide
+
+1. Create an `nb_all` dir wherever you like. It must have at least the `nbbuild` dir from the netbeans.org source tree.
+2. Create `nbbuild/user.build.properties` and in it set the property `netbeans.dest.dir` to the full path to a NetBeans IDE installation you would like to both compile against and build into (you should not use your real development IDE, rather a copy).
+3. Run: `ant -f nbbuild/build.xml bootstrap`
+4. Add subdirs for any netbeans.org module projects you would like to work on. (The modules may be already present in the target platform. If they are not, you need to check out sources for any transitive dependencies not in the target platform too.)
+5. Using the IDE, open the desired projects and work normally.
+
+==== What works
+
+Source projects should open without error and without displaying error badges, assuming all dependencies are available in either source or binary form.
+
+You can build the projects normally. The modules will be built into the target platform (overwriting any existing copy of the module).
+
+You can use Run and Debug to start the target platform with a test userdir after building the modules, set breakpoints etc.
+
+You can Test the source projects normally.
+
+Code completion should work against APIs present in other modules.
+If those modules are available in source form, you will get popup Javadoc automatically, and can navigate to sources.
+If not, you can still add popup Javadoc capability for all published APIs:
+
+1. Download "NetBeans API Documentation" from AU.
+2. Open NetBeans Platform Manager.
+3. Select the "default" platform and note the location of `NetBeansAPIDocs.zip` in the Javadoc tab.
+4. Create a new platform; select the same dir as you specified for `netbeans.dest.dir`.
+5. In the new platform, add `NetBeansAPIDocs.zip` to the Javadoc tab.
+
+==== Caveats
+
+* If you want to work on unit or functional tests, you need to have all test-to-test dependencies available as source projects, because we do not distribute test libraries. Sometimes the transitive dependency tree can get a bit big. For example, if the functional tests use `org.netbeans.junit.ide.ProjectSupport`, then you need to check out `java.j2seproject` (in whose unit test dir this class resides), then its dependencies in turn: `projectapi`, `projectui`, `openide.filesystems`, and `openide.util`. Test-to-module dependencies (e.g. `nbjunit`, `jellytools`, ...) can however be satisfied from the target platform's binaries.
+
+* If you add new source modules to the tree, you will need to both restart NetBeans and delete the `nbbuild/nbproject/private/` dir in order to reset all caches and ensure that the new sources are recognized.
+
+* Various targets in `nbbuild/build.xml` not used in the above scenarios may or may not work usefully, though this should not affect routine module development.
+
+* The target platform needs to be new enough to support any API calls you are making from source modules into binary modules. If the platform is older, you could see error badges. Besides getting a newer platform, this can be corrected by adding sources of the new version of the API module to the tree.
+
+* Note that the `bootstrap` ant target will not work if you just copy `nbbuild` from the netbeans.org source tree into `nb_all`. Other than `nbbuild` you also need to copy directories:
+1. `ide/launcher`
+2. `javahelp`
+3. `apisupport.harness`
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOrphanedNetBeansOrgModules[http://wiki.netbeans.org/DevFaqOrphanedNetBeansOrgModules] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:10:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOutlineViewHorizontalScrolling.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOutlineViewHorizontalScrolling.asciidoc
new file mode 100644
index 0000000..21aeb31
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOutlineViewHorizontalScrolling.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOutlineViewHorizontalScrolling
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I add horizontal scrolling support in the OutlineView component?
+
+The OutlineView component already contains a JScrollPane, but the component's default behavior is to fit all the columns in the available space. If you have a large number of columns, say twenty or more, you may find that the horizontal space allocated to any one column is insufficient. In this case, you will likely want to disable table column resizing so that you can scroll left or right to see the data. This can be accomplished by adding one line of code:
+
+[source,java]
+----
+
+outlineView.getOutline().setAutoResizeMode(JTable.AUTO_RESIZE_OFF);
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOutlineViewHorizontalScrolling[http://wiki.netbeans.org/DevFaqOutlineViewHorizontalScrolling] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:39:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOutputWindow.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOutputWindow.asciidoc
new file mode 100644
index 0000000..f0b6386
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOutputWindow.asciidoc
@@ -0,0 +1,88 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOutputWindow
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I create my own tab in the output window and write to it?
+
+NetBeans contains classes that make writing to the output window very simple - you don't have to worry about components, you just get an instance of a thing called `InputOutput`, which has methods `getOut()` and `getErr()` that return `OutputStream`s. There is a utility class, `IOProvider` that can supply `InputOutput` objects - you pass it a string name that should be shown on the output tab, and a boolean (whether or not it should reuse an existing tab with the same name if there is one). So, hello world code for the output window looks like this:
+
+[source,java]
+----
+
+InputOutput io = IOProvider.getDefault().getIO ("Hello", true);
+io.getOut().println ("Hello from standard out");
+io.getErr().println ("Hello from standard err"); //this text should appear in red
+io.getOut().close();
+io.getErr().close();
+----
+
+It is important to close the output streams when you are done with them - output is written to a memory mapped file, which cannot be deleted if the stream is still open - and the tab title will remain boldfaced until the streams are closed, which helps indicate to the user that the process has finished.
+
+-- Main.timboudreau - 10 Jun 2006
+
+Note: For platform based applications to correctly use InputOutput and IOProvider an Output Window implementation must be available and enabled. Follow the below steps to be sure you include everything to allow the output window and tabs to be used and shown.
+
+1. Open your module projects properties. (Right click the project and select properties).
+2. Select libraries
+3. Check to see if 'I/O APIs' is in the dependency list.
+4. If it is not it needs to be added.
+
+To add 'I/O APIs'
+
+1. Choose 'Add' from 'Module Dependencies'
+2. Select 'I/O APIs' from the list
+3. Press OK
+
+To force 'Output Window' (the implementation of the tabbed output window) to be enabled,
+
+1. Choose 'Add' from 'Required Tokens'
+2. Pick =org.openide.windows.IOProvider=
+3. Press OK
+
+Note: this shall not be necessary in the current 6.0 trunk version..
+
+Relevent to 6.0: If the dependencies do not show up in the selection list check the 'Module Suite' to make sure they have not been excluded from the platform.
+
+1. Right click on the module suite
+2. Click Properties
+3. Go to Libraries
+4. Locate the platform 'Clusters and Modules'
+5. Make sure I/O API is checked
+6. Make sure Output Window is checked
+7. Click OK
+
+Hint: It is sometimes helpful to call InputOutput.select() to make sure the tab is made visible in the output window.
+
+See link:http://plugins.netbeans.org/plugin/39695/?show=true[here] for a plugin that has a convenient class for all output purposes.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOutputWindow[http://wiki.netbeans.org/DevFaqOutputWindow] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-08-01T14:18:43Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOutputWindowExternalProcess.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOutputWindowExternalProcess.asciidoc
new file mode 100644
index 0000000..ece3da8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOutputWindowExternalProcess.asciidoc
@@ -0,0 +1,125 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOutputWindowExternalProcess
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I route the output from an external process to the output window?
+
+*NetBeans 6.8 and up:* Use the External Execution API. Implement a Callable which will actually start the process:
+
+[source,java]
+----
+
+private class ProcessLaunch implements Callable<Process> {
+ private final String[] commandLine;
+ public ProcessLaunch(String... commandLine) {
+ this.commandLine = commandLine;
+ }
+ public Process call() throws Exception {
+ ProcessBuilder pb = new ProcessBuilder(cmdline);
+ pb.directory(new File(System.getProperty("user.home"))); //NOI18N
+ pb.redirectErrorStream(true);
+ return pb.start();
+ }
+}
+----
+
+Create an ExecutionDescriptor:
+
+[source,java]
+----
+
+ExecutionDescriptor descriptor = new ExecutionDescriptor().controllable(true).frontWindow(true).
+ preExecution(new SomeRunnableToCallBeforeStart()).postExecution(new SomeRunnableToCallAfterExit());
+----
+
+The before and after runnables can be used to, say, update the user interface when the process starts and stops.
+
+Then actually launch your process. Standard output and standard error (if you leave in the call to `redirectErrorStream(true)` above) output will be redirected to the output window, and the tab name in the Output Window will be what you specify below. The variable `theCommandLineArguments` is an array of strings, just as you would pass to `Runtime.exec()` - the command-line to run whatever program you want to run.
+
+[source,java]
+----
+
+ExecutionService exeService = ExecutionService.newService(
+ new ProcessLaunch(theCommandLineArguments),
+ descriptor, "My Process");
+Future<Integer> exitCode = exeService.run();
+----
+
+(you can use the returned Future to wait for the process to exit and get its exit code - just don't do that in the Swing event thread).
+
+Applies to: NetBeans 6.8 and up.
+link:DevFaqOutputWindowExternalProcessNb67.html[How to do this in NetBeans 6.7 and older]
+
+== What about processes using the System.out/System.err?
+
+Sometimes we are using a third party package that we don't have access to its source or we don't want to modify.
+
+In this case you just need to redirect the system streams like this:
+
+[source,java]
+----
+
+private void redirectSystemStreams() {
+ out = new OutputStream() {
+
+ @Override
+ public void write(int i) throws IOException {
+ OutputHandler.output(outputName, String.valueOf((char) i));
+ }
+
+ @Override
+ public void write(byte[] bytes) throws IOException {
+ OutputHandler.output(outputName, new String(bytes));
+ }
+
+ @Override
+ public void write(byte[] bytes, int off, int len) throws IOException {
+ OutputHandler.output(outputName, new String(bytes, off, len));
+ }
+ };
+ System.setOut(new PrintStream(out, true));
+ System.setErr(new PrintStream(out, true));
+ }
+----
+
+OutputHandler is just a helper class that I've been using for a while. Feel free to use it. You need to add a dependency to I/O APIs package even if you don't use it to avoid run time issues. If you don't use it replace the OutputHandler calls for something like this:
+
+[source,java]
+----
+
+IOProvider.getDefault().getIO(name, false).getOut().println(mess);
+----
+
+The OutputHandler referenced above has been transformed into a plugin for easier use. See link:http://plugins.netbeans.org/plugin/39695/?show=true[here] for more details.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOutputWindowExternalProcess[http://wiki.netbeans.org/DevFaqOutputWindowExternalProcess] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2012-07-17T21:47:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqOverrideDefaultWindowSize.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqOverrideDefaultWindowSize.asciidoc
new file mode 100644
index 0000000..f427ea5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqOverrideDefaultWindowSize.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqOverrideDefaultWindowSize
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to override the default size of an existing window?
+
+Since the window already exists and has a default size, it must be registered under a specific mode in the filesystem.
+
+Find the file defining the size, i.e., the "wsmode" file that defines the mode under which it is registered, and change it. Then register the changed mode under the same name as the original mode in the layer. If you want to make sure that yours overrides the default, set a dependency in your module on the module that defines the original mode.
+
+Generally it is better to create a whole new mode, since you then will never have a conflict between two different definitions.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqOverrideDefaultWindowSize[http://wiki.netbeans.org/DevFaqOverrideDefaultWindowSize] ,
+that was last modified by NetBeans user Geertjan
+on 2010-09-14T06:50:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPlatformAppAuthStrategies.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPlatformAppAuthStrategies.asciidoc
new file mode 100644
index 0000000..d3d1c21
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPlatformAppAuthStrategies.asciidoc
@@ -0,0 +1,86 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPlatformAppAuthStrategies
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Other strategies for authentication and authorization
+
+There are cases in which you want to exercise great control over who is allowed to use your application. You might, for example, be required to check the user's network credentials, validate client-side certificate or check a license server before the platform application is even launched.
+
+It is important to note that because the platform has not been initialized at this point, none of the usual platform capabilities will be available. If you simply want to enable a single module based on some criteria (for example, the existence of a license file), you can use link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html#validate()[ModuleInstall.validate()].
+
+A platform application is typically started from an executable launcher (Windows) or shell script (Unix).
+This invokes the `org.netbeans.core.startup.Main.main` method.
+However, as described in the link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/architecture-summary.html[Module System documentation], you can use the `netbeans.mainclass` link:DevFaqPlatformRuntimeProperties.html[system property] to specify a different class to run at startup.
+
+This class should exist in a JAR file in the startup classpath (you can put it alongside `core.jar` in the `platform/core` directory). This class must also have a main method which can invoke whatever authorization logic you like. If authorization fails, you'll probably want to show a dialog and call `System.exit`. If it succeeds, you can invoke the `org.netbeans.core.startup.Main` class' `main` method yourself to continue the normal NetBeans startup procedure. But because `org.netbeans.core.startup.Main` is not a public API, you will need to invoke it indirectly using reflection. Here is an example of a custom startup class that does this:
+
+[source,java]
+----
+
+package com.tomwheeler;
+
+import java.lang.reflect.Method;
+
+public class CustomStartup {
+
+ private static final String NB_MAIN_CLASS = "org.netbeans.core.startup.Main";
+
+ public static void main(String[] args) throws Exception {
+ // do whatever you need here (e.g. show a custom login form)
+ System.out.println("Hello world! I am a custom startup class");
+
+
+ // once you're done with that, hand control back to NetBeans
+ ClassLoader classloader = Thread.currentThread().getContextClassLoader();
+ Class<?> mainClass = Class.forName(NB_MAIN_CLASS, true, classloader);
+
+ Object mainObject = mainClass.newInstance();
+ Method mainMethod = mainClass.getDeclaredMethod("main", new Class[]{String[].class});
+ mainMethod.invoke(mainObject, (Object) args);
+ }
+}
+----
+
+The easiest thing to do is create a Java Class Library project (not a module project) in the NetBeans IDE, create a class like the one above and then build the project to create a JAR file. Copy that JAR file to the `platform/core` directory of your platform and then start your application using the following command line:
+
+[source,java]
+----
+
+ myapp.exe -J-Dnetbeans.mainclass=com.tomwheeler.CustomStartup
+----
+
+You will probably want to put this system property in the application's configuration file (where you'd add JVM memory flags) so it will be permanent.
+
+Clever users could work around this by editing the command line and bypassing the restriction, so the security of this approach is limited by itself. If this is a concern, you may overcome it by having your custom main class encrypt a flag value (which perhaps contains a nonce/timestamp to prevent replay attacks) and passing it (e.g. as a system property) to your platform application which will then decrypt and verify it. Thus, the logic for validating the user is entirely in the custom main class (or the code which it invokes), while the platform application need only verify that this step has actually been performed.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPlatformAppAuthStrategies[http://wiki.netbeans.org/DevFaqPlatformAppAuthStrategies] ,
+that was last modified by NetBeans user Tomwheeler
+on 2011-08-16T18:17:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPlatformRuntimeProperties.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPlatformRuntimeProperties.asciidoc
new file mode 100644
index 0000000..7303daf
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPlatformRuntimeProperties.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPlatformRuntimeProperties
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I want to set some flags or CLI arguments for running my NB RCP/Platform based application (such as disable assertions). How do I do that?
+
+To disable assertions or set some other VM property for your application, there are two places to pay attention to. First, `$APP_HOME/etc/*.conf` in your distribution should set things for users of your application - do this for things that should be set for any user.
+
+You also will probably want to test these settings - and `*.conf` is not going to be used when you launch your application by running your project from Ant (nor the NetBeans IDE). So to handle this, you can set any of the properties documented in `$NB_HOME/harness/README`. For example, to disable assertions when testing your application from the IDE, edit your module suite's `nbproject/project.properties` to include `run.args.extra=-J-da` or similar.
+
+See `$NB_HOME/harness/README` in your copy of NetBeans for the full list of properties that affect how NetBeans-based-applications are run when developing them in the IDE.
+
+<hr/>
+Applies to: NetBeans 6.5 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPlatformRuntimeProperties[http://wiki.netbeans.org/DevFaqPlatformRuntimeProperties] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T15:24:03Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPossibleToExtend.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPossibleToExtend.asciidoc
new file mode 100644
index 0000000..05e7f5a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPossibleToExtend.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPossibleToExtend
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Is it possible to extend an existing project type?
+
+Yes.
+
+You can add new actions, tabs, nodes, and lookups to an existing project type. See the link:http://platform.netbeans.org/tutorials/nbm-projectextension.html[NetBeans Project Type Extension Module Tutorial] for details.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPossibleToExtend[http://wiki.netbeans.org/DevFaqPossibleToExtend] ,
+that was last modified by NetBeans user Geertjan
+on 2010-03-03T17:28:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqProfiling.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqProfiling.asciidoc
new file mode 100644
index 0000000..41a2633
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqProfiling.asciidoc
@@ -0,0 +1,147 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqProfiling
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I profile NetBeans?
+
+There are many possibilities how to profile Java applications and that can be applied to NetBeans profiling.
+For different task it can be good to select different ways because each of them has its strengths and weaknesses.
+
+See also: link:DevFaqMemoryLeaks.html[DevFaqMemoryLeaks]
+
+To be able to profile an application it is usually needed to start it with a modified command
+that typically adds some (JVMPI or JVMTI) libraries, some classes to (boot)classpath, specifies
+options for profiling and often initializes profiling support before the application starts to run its code.
+
+=== NetBeans profiler
+
+The NB module development support is integrated with the NB Profiler.
+Just select a module and click *Profile* to start.
+
+_Want to cover some typical activities like:_
+
+* action execution (invoked from menu or by shortcut)
+* window/dialog opening/closing
+* use of editor including tracking what happens in background
+* startup
+
+=== Analyzer
+
+It is a sampling profiler working on Solaris and Linux (with limited functionality) that collects data during runtime.
+These data are later available for offline processing.
+
+It provides some capabilities that are not available in other Java profilers namely timeline view.
+This view shows timeline for each thread visualizing if the thread actually executes some code or not.
+
+==== Download and install Analyzer tool
+
+Performance Analyzer that is part of Sun Studio tools and can be downloaded
+from the link:http://developers.sun.com/sunstudio/downloads/express.jsp[developers' site].
+
+==== Run the Analyzer
+
+* Set the environment. `PATH` should contain `bin` directory of Analyzer installation. `LD_LIBRARY_PATH` should similarly contain `lib` dir (and also `/usr/lib/lwp` if you want to run it on Solaris 2.8). Optionally you can also set `MAN_PATH`. Set the `_NB_PROFILE_CMD`:
+[source,java]
+----
+
+export _NB_PROFILE_CMD='collect -p 1 -j on -S off -g NetBeans.erg -y 38 -d /export/home/radim/analyzer
+----
+
+
+
+-p _num_ stands for sampling period (_on_, _hi_, _lo_ are also accepted), -j on turns on Java profiling, -y _num_ determines the signal to trigger profiling on/off. -y _num_,r means that profiling will be resumed at the begining. Use `man collect` to get detailed explanation of all options.
+
+* `mkdir /export/home/radim/analyzer` (It is only need first time. Next experiments will be added.)
+* Install & start the IDE
+* Send signal 38 to Java process to start data collecting (`kill -38 $pid`). Or use another signal like PROF (this works well on Linux).
+* Perform the analyzed activity
+* Send the signal again to stop profiling (there can be more evaluated periods during one run).
+* Shut down the IDE.
+* Run the analyzer to evaluate the experiment in GUI environment: `analyzer /export/home/radim/analyzer/NetBeans.x.er`
+
+==== Profiling hints
+
+Startup: start with profiling enabled, send a signal when startup is completed.
+When sampling every 1ms it takes 70 seconds instead of 40.
+
+=== Other tools
+
+Quite simple way how to measure time spent in some code is to wrap the code with
+
+[source,java]
+----
+
+long t0 = System.nanoTime();
+try {
+ ... measured code
+} finally {
+ long t1 = System.nanoTime();
+ System.out.println("action took "+(t1-t0)/1000000+"ms");
+}
+----
+
+_JVMTI_ is powerful interface that allows to write custom libraries that will track behavior of application.
+
+link:http://www.opensolaris.org/os/community/dtrace/[DTrace] is a comprehensive dynamic tracing framework for the Solaris? Operating Environment.
+It is one of the few tools that allows to track activities running deeply in the system and analyze the system.
+Because there are also probes provided by Java VM and function like `jstack` it is also possible to map
+observed actions to parts of Java code in running application.
+
+=== Tips and trick
+
+Node pop-ups: interesting starting point is `o.o.awt.MouseUtils$PopupMouseAdapter.mousePressed()`
+
+=== How to measure performance/responsiveness?
+
+See link:http://performance.netbeans.org/responsiveness/whatisresponsiveness.html[What is UI responsiveness] for overview.
+
+Older link:http://performance.netbeans.org/[Performance] web page contains few links to documentation of one possible approach
+how to measure and profile responsiveness.
+This is based on use of modified event queue and patches classes from JDK.
+
+Recently we changed the support a bit to avoid modifications of core JDK's classes and and use small utility library
+available in Hg.
+This is used in current automated testing and can be used for manual checks too.
+To run such test:
+
+1. Build `performance` project.
+2. Copy the JAR file to `netbeans/platform/core`
+3. Start the IDE with `-J-Dnetbeans.mainclass=org.netbeans.performance.test.guitracker.Main -J-Dguitracker.mainclass=org.netbeans.core.startup.Main`
+4. ... watch process output when you perform an action
+
+<hr/>
+Applies to: NetBeans 6.5 and above
+
+link:Category:Performance:HowTo.html[Category:Performance:HowTo]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqProfiling[http://wiki.netbeans.org/DevFaqProfiling] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:22:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertyEditorHints.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertyEditorHints.asciidoc
new file mode 100644
index 0000000..0c6b9ce
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertyEditorHints.asciidoc
@@ -0,0 +1,94 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertyEditorHints
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I have a Node.Property. I want to control its appearance or custom editor somehow. What options are available?
+
+NetBeans built-in property editors support a number of "hints" which will affect how the property editor behaves. A few are global to all property editors; the rest are specific to property editors for specific types.
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/propertyViewCustomization.html[http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/propertyViewCustomization.html]
+
+Note that all of these are _hints_ - a property editor is free to ignore them or not support them in the future. However all of these have been present since NetBeans 3.6 and are _should_ still work as of NetBeans 6.9.
+
+|===
+|Property Type |Hint Name |Value Type |Effect
+
+|Any |`suppressCustomEditor` |`java.lang.Boolean` |Causes the property not to show a [...] button in the property sheet
+
+|Any |`valueIcon` |`javax.swing.Icon` |Causes the property not to show an icon beside the value (should be 16x16 or smaller) when not in edit mode
+
+|Most editors (string, etc.) |`htmlDisplayValue` |`java.lang.String` |An HTML-ized string which should be rendered using HTML rendering, not literally. The subset of HTML supported by link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/HtmlRenderer.html[org.openide.awt.HtmlRenderer] is supported. Generally the value should be a formatted variant of the actual value - otherwise when the user edits the value, it will suddenly seem to have changed.
+
+|All property editors |`nameIcon` |`java.awt.Image` or `javax.swing.Icon` |An icon which should be displayed next to the property name in the property sheet (16x16 or smaller)
+
+|All property editors |`helpID` |`java.lang.String` |A JavaHelp help ID to provide custom help for this property's _custom editor_ (not when the property sheet has focus)
+
+|All property editors |`postSetAction` |`javax.swing.Action` |An action which should be invoked after the property sheet has updated the property's value from the property editor (not very useful unless you need access to the `TableCellEditor` - not sure what this was used for)
+
+|`java.lang.String` and editors which show a combo box |`initialEditValue` |`java.lang.String` |A string which should be the initial value when the user starts editing, even if the actual property value is null
+
+|Most editors (string, etc.) |`htmlDisplayValue` |`java.lang.String` |An HTML-ized string which should be rendered using HTML rendering. Has effect only when a cell in the property sheet or tree table or outline is _not_ in edit mode.
+
+|Any editor that shows a combo box in the property sheet |`canEditAsText` |`java.lang.Boolean` |Causes the combo box to be editable by text entry
+
+|`java.io.File` and `java.io.File[]` |_See the link:DevFaqNodePropertyForFiles.html[separate FAQ entry for File properties]_
+
+|`java.lang.String[]` (array of strings) |`item.separator` |`java.lang.String` |The delimiter for splitting a user entered string into an array (the default is a , character)
+
+|`java.lang.Integer` |`stringKeys` |`java.lang.String[]` (array of strings) |Keys - allows an integer editor to show a combo box with strings, instead of a text editor. If this property is used, the additional hint `intValues`; for custom code generation in the form editor, optionally `codeValues` may also be set.
+
+|`java.lang.Integer` |`intValues` |`int[]` (_not `java.lang.Integer`_ - array of ints) |The values that map to the strings passed in the `stringKeys` hint
+
+|`java.lang.Integer` |`codeValues` |`java.lang.String[]` (array of strings) |The value that should be returned by the property editor's `getJavaInitializationString()` method if the corresponding value is selected
+
+|`java.lang.Boolean` |`stringValues` |`java.lang.String[]` (array of strings) |Alternate names to show instead of `true` and `false` (note, this will result in a radio-button boolean editor instead of a checkbox; to use radio buttons in all boolean editors, set the system property `netbeans.ps.forceRadioButtons` to `true`)
+
+|`java.lang.String` |`instructions` |`java.lang.String` |Localized instructions to the user which should be visible above the text field/area in the custom editor
+
+|`java.lang.String` |`oneline` |`java.lang.Boolean` |Instruct the custom editor to use a single-line JTextField instead of a mult-line JTextArea
+
+|`java.awt.Image` |`images` |`java.awt.Image[]` |An array of images the user can select from
+
+|`java.awt.Image` |`values` |`java.lang.String[]` |Names for the images passed in the `images` hint
+
+|`java.awt.Image` |`descriptions` |`java.lang.String[]` |An array of descriptions corresponding to the array of images passed in the `images` hint
+
+|`java.lang.Object` (yes, you can have a property of Object and there is an editor for it - the user can select from all objects of a type in the link:DevFaqDefaultLookup.html[default Lookup] or a specific lookup [see below] using a combo box) |`superClass` |`java.lang.Class` |The superclass, passed to `Lookup.getDefault().lookupAll()` to find all possible values
+
+|`java.lang.Object` |`nullValue` |`java.lang.Object` (must be of the same type as the type passed in the `superClass` hint) |The value the editor should show if the property initially has a value of null
+
+|`java.lang.Object` |`lookup` |`org.openide.util.Lookup` |A specific lookup for this editor to query for possible values, instead of using the default lookup
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertyEditorHints[http://wiki.netbeans.org/DevFaqPropertyEditorHints] ,
+that was last modified by NetBeans user Jmborer
+on 2015-02-05T15:53:11Z.
+
+
+|===
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertySheetEditors.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetEditors.asciidoc
new file mode 100644
index 0000000..03d1482
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetEditors.asciidoc
@@ -0,0 +1,89 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertySheetEditors
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I change the default behavior of PropertySheet editors?
+
+*Issue:* How do I specify the kind of renderer which will represent the look of property value cell (in the same manner as it usually does for JTable)? For example, I want a string property not to be shown in grey if it's not editable.
+
+*Solution:* If you specify a custom inplace editor it will also be used for rendering.
+
+--
+
+*Issue:* How can I provide a new kind of inplace editor? For example, I want to have a property which should be shown at Property Sheet like a combo-box or a spinner control.
+
+*Solution:* See the docs for the link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/propertysheet/InplaceEditor.html[InplaceEditor] interface.
+
+--
+
+*Issue:* How do I specify that a value is not editable in-place?
+
+*Solution:* Provide a custom inplace editor that provides a disabled component for the inplace editor. Or mark it non-editable, but supply a custom editor that does edit it.
+
+--
+
+*Issue:* How do I specify that a property has a custom editor?
+
+*Solution:* See the docs for the link:http://java.sun.com/j2se/1.5.0/docs/api/java/beans/PropertyEditor.html[PropertyEditor] interface.
+
+--
+
+*Issue:* How can I copy text from a non-editable property?
+
+*Solution:* If the non-editable property has a Custom editor ('...' button) you can easily use Ctrl+c on content of a Custom editor. If the non-editable property doesn't have a Custom editor you can select property cell and press Ctrl+c, but whole line is copied (property name and value).
+
+--
+
+*Issue:* How do I access the Node the property belongs to?
+
+*Solution:*
+
+[source,java]
+----
+
+class MyEditor implements ExPropertyEditor {
+ PropertyEnv env;
+
+ public void attachEnv(e) {
+ env = e;
+ }
+
+ public void anyMethod() {
+ Object[] arr = env.getBeans();
+ // now arr contains either the real bean objects if invoked on Object
+ // or it contains Node that the properties belong to
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertySheetEditors[http://wiki.netbeans.org/DevFaqPropertySheetEditors] ,
+that was last modified by NetBeans user JPESKA
+on 2011-12-20T12:49:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertySheetHideDescription.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetHideDescription.asciidoc
new file mode 100644
index 0000000..5301574
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetHideDescription.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertySheetHideDescription
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I hide the description area in property window
+
+By tweaking the preferences of the "showDescriptionArea". In any layer.xml file (for example the one of branding) add
+
+[source,java]
+----
+
+ &lt;folder name="Preferences"&gt;
+ &lt;folder name="org"&gt;
+ &lt;folder name="openide"&gt;
+ &lt;file name="explorer.properties" url="explorer.properties"/&gt;
+ &lt;/folder&gt;
+ &lt;/folder&gt;
+ &lt;/folder&gt;
+----
+
+and then next to your layer.xml file create the explorer.properties that contains:
+
+[source,java]
+----
+
+showDescriptionArea=false
+sortOrder=0
+----
+
+I found this by looking at the PropUtils class in the NBP sources.
+
+Taken from mailing list, contributed by Jean-Marc Borer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertySheetHideDescription[http://wiki.netbeans.org/DevFaqPropertySheetHideDescription] ,
+that was last modified by NetBeans user Markiewb
+on 2016-04-10T10:27:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertySheetNodes.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetNodes.asciidoc
new file mode 100644
index 0000000..b4938f9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetNodes.asciidoc
@@ -0,0 +1,69 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertySheetNodes
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I show my node's properties in the Properties view?
+
+I want to have the properties of my custom nodes displayed in the Properties view when they are selected in my tree view. How do I go about doing that?
+
+Listen for changes in the selected nodes in the [link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/ExplorerManager.html[http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/ExplorerManager.html] `ExplorerManager`], and set the `activatedNodes` property on the parent [[DevFaqWindowsTopComponent| `TopComponent`]] which contains your tree view:
+
+[source,java]
+----
+
+public class MyComponent extends TopComponent implements PropertyChangeListener {
+ private ExplorerManager explorerManager;
+----
+[source,java]
+----
+
+ public MyComponent() {
+ explorerManager = new ExplorerManager();
+ explorerManager.addPropertyChangeListener(this);
+ }
+----
+[source,java]
+----
+
+ public void propertyChange(PropertyChangeEvent evt) {
+ if (evt.getSource() == explorerManager &&
+ ExplorerManager.PROP_SELECTED_NODES.equals(evt.getPropertyName())) {
+ setActivatedNodes(explorerManager.getSelectedNodes());
+ }
+ }
+}
+----
+
+Note that the example above is not a complete `TopComponent` implementation with a tree view and nodes. It is simply demonstrating how to have the selected node's properties shown in the Properties view.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertySheetNodes[http://wiki.netbeans.org/DevFaqPropertySheetNodes] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-25T16:17:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertySheetReadonlyProperty.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetReadonlyProperty.asciidoc
new file mode 100644
index 0000000..fe2b882
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetReadonlyProperty.asciidoc
@@ -0,0 +1,59 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertySheetReadonlyProperty
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add a readonly property?
+
+You can customize your properties by using the setValue method.
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/propertyViewCustomization.html[http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/propertyViewCustomization.html]
+
+Example:
+
+[source,java]
+----
+
+PropertySupport.ReadOnly<String> javaVersionProperty = new PropertySupport.ReadOnly<String>(RuntimeProxyBean.PROP_VMVERSION, String.class, "JVM version", "Java VM version") {
+
+ @Override
+ public String getValue() throws IllegalAccessException, InvocationTargetException {
+ return runtimeProxyBean.getVmVersion();
+ }
+ };
+
+javaVersionProperty.setValue("suppressCustomEditor", true);
+----
+
+Taken from mailing list, contributed by Jean-Marc Borer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertySheetReadonlyProperty[http://wiki.netbeans.org/DevFaqPropertySheetReadonlyProperty] ,
+that was last modified by NetBeans user Markiewb
+on 2016-04-10T10:30:21Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqPropertySheetTabs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetTabs.asciidoc
new file mode 100644
index 0000000..17fb1c9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqPropertySheetTabs.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqPropertySheetTabs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I display different groups of properties on buttons in the property sheet the way Matisse does?
+
+This is only really useful if you have a *lot* of properties - and having lots of properties is usually not a great idea, as the user has to search for the things they want to change.
+
+Nonetheless, if you want to group different sets of properties on different buttons, it is quite simple. `Node.PropertySet` extends `java.beans.FeatureDescriptor`. It inherits the methods `putValue (key, value)` and `getValue(key, value)` which allow you to add ad-hoc key/value pairs to any `PropertySet`. What you do is pass a String with the text that should be on the button, assigned to the key "tabName":
+
+[source,java]
+----
+
+somePropertySet.putValue ("tabName", NbBundle.getMessage (getClass(), "KEY_Something"));
+----
+
+(the above code gets you a localized string - you can also pass a hard-coded one if you are sure your UI will never need to be translated).
+
+All `PropertySet`s that have the same value will be included under the same button/tab in the property sheet.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqPropertySheetTabs[http://wiki.netbeans.org/DevFaqPropertySheetTabs] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:58:53Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRebindingKeys.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRebindingKeys.asciidoc
new file mode 100644
index 0000000..5547304
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRebindingKeys.asciidoc
@@ -0,0 +1,71 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRebindingKeys
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I bind one key to more than one action?
+
+The simple answer is no: The
+global keymap (get `Keymap` from Lookup)
+is a master keymap for the whole application, and like all keymaps accepts
+only one action per binding. If you want multiple actions to be
+run, you must create a "wrapper" action that runs them all in turn
+(or in parallel).
+
+==== What about binding a key differently in different windows?
+
+You may bind a key differently in different windows, by using
+the normal Swing techniques of binding keystrokes to components. In
+fact, some work went into implementing the global map so that it
+would work across arbitrary components; it is overridden by local
+bindings, such as navigation keys on dialogs or Explorer trees, or
+various editing keys in the Editor.
+
+Before you bind a key performing a high-level specific action,
+such as *Ctrl-N* for *New File*,
+to a different action in a local component (e.g. window), think
+carefully whether this is really the right approach. In many cases
+the UI of your extension and the IDE as a whole will be better
+served by leaving the key binding alone, and instead providing an
+appropriate cookie, action performer, or other callback associated
+with your component, so that the action (and potentially other code
+unknown to you) will function naturally. If you must rebind a
+global key, consider whether it is appropriate to determine the
+current key binding for the action (if any) in the global keymap,
+and use this keystroke to rebind - so user customizations will
+remain intact.
+
+`CallbackSystemAction`s such as *Find* or
+*Delete* can easily have different bindings in each component,
+using `ActionMap`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRebindingKeys[http://wiki.netbeans.org/DevFaqRebindingKeys] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:58:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRegisterObjectsViaInstanceOrSettingsFiles.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRegisterObjectsViaInstanceOrSettingsFiles.asciidoc
new file mode 100644
index 0000000..344bf8b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRegisterObjectsViaInstanceOrSettingsFiles.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRegisterObjectsViaInstanceOrSettingsFiles
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Should I register an object in my layer file using .instance or .settings files? What about .shadow files or serialization?
+
+There are a number of kinds of files which are treated (and can be transformed into) instances of objects.
+
+|===
+|What |When to Use It |How
+
+|`.instance` files |Almost all the time |Create a file whose name is the fully qualified name of the class you want to register, with the . characters replaced with - characters and the extension `.instance` - e.g. `<file name="com-foo-mymodule-MyStatusBarElementProvider.instance"/>`. You can also give the file a different name and instead declare the type using a link:DevFaqFileAttributes.html[FileObject attribute], e.g. <blockquote>`<file name="x.instance">
+ <attr name="instanceClass" stringvalue="com.foo.mymodule.MyStatusBarElementProvider"/>
+</file> `</blockquote>
+[source,xml]
+----
+
+ If you want to use a factory method and set up some configuration of the object using your own link:DevFaqFileAttributes.html[FileObject attributes], you can instead <ul><li>Create a public static method on some class, which takes a `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileObject.html[FileObject]` as an argument, e.g.<blockquote>`<file name="x.instance"> <attr name="instanceClass" stringvalue="com.foo.mymodule.MyStatusBarElementProvider"/> <attr name="instanceCreate" methodvalue="com.foo.mymodule.MyStatusBarElementProvider.factoryMethod"/> attr name="yourCustomAttribute" stringvalue="someValueYouCareAbout"/></file>`</blockquote>
+----
+
+
+|`.settings` files |In specialized situations when the object may be saved back to disk with changed state at runtime and you cannot simply use `NbPreferences` |Create an XML file in your module for your settings file, populated as described in link:DevFaqDotSettingsFiles.html[the .settings file FAQ]. Register that file in some folder by specifying the XML file as the URL of the `<file>` entry in your layer, e.g. `<file name="MyObject.settings" url="theActualFile.xml"/>` (in this case, the layer.xml file and the settings file are in the same Java package in your sources).
+
+|`.shadow` files |If you want your object to be a pseudo-singleton, but it will be registered in multiple folders, or the user may delete the shadow file and you need to provide a way for the user to recover it (i.e. a way to create a new `.shadow` file) |`link:DevFaqDotShadowFiles.html[.shadow]` files are like unix symbolic links - they point to another file somewhere else in the link:DevFaqSystemFilesystem.html[system filesystem] or on disk, and behave as if they were really that file. Use one of the other registration mechanisms described here to register your object in some folder. Then create a shadow file as link:DevFaqDotShadowFiles.html[described here] which points to it.
+ An example of this is Menu and Toolbar actions — all actions are registered in subfolders of the `Actions/` folder in the system filesystem. The user might manually delete or rearrange them; the UI that allows this can also show all available actions, so that the user can replace accidentally deleted actions.
+
+|`.ser` (serialized object) files |Basically never |Write a serialized object out to disk in a file with the extension `.ser`, either on the fly at runtime into some folder under `link:http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/FileUtil.html#getConfigFile(java.lang.String)[FileUtil.getConfigFile()]`, or serialize an object ahead of time somehow, copy it into your module sources, and register something like `<file name="foo.ser" url="relative/path/in/module/sources/from/layer/dot/xml/to/foo.ser"/>`. Remember that if you use serialization, _any_ change to the class you serialized is likely to break loading of existing `.ser` files - this is almost never a good idea.
+
+|Your own file type |Basically never |Any link:DevFaqDataObject.html[DataObject] type which contains an `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/cookies/InstanceCookie.html[InstanceCookie]` (and ideally also an `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/cookies/InstanceCookie.Of.html[InstanceCookie.Of]`) can be registered in some folder. If this is done ` link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#forPath(java.lang.String)[Lookups.forPath(&quot;path/to/parent/folder&quot;)] ` can be used to find it and any other objects registered in that folder (whatever their file type). So you could create your own file type which provides these objects.
+Unless you are doing something very, very unusual, one of the existing registration mechanisms will almost always be sufficient.
+This mechanism may be useful if you have existing code which reads and writes files in some format, and you cannot change that code.
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRegisterObjectsViaInstanceOrSettingsFiles[http://wiki.netbeans.org/DevFaqRegisterObjectsViaInstanceOrSettingsFiles] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:30:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRemoveStatusBar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRemoveStatusBar.asciidoc
new file mode 100644
index 0000000..b888fe5
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRemoveStatusBar.asciidoc
@@ -0,0 +1,108 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRemoveStatusBar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I remove the status bar?
+
+Never be afraid to read the code :-) Looking at org.netbeans.core.windows.view.ui.MainWindow, there is getCustomStatusLine(), and it does this:
+
+[source,java]
+----
+
+ private static JComponent getCustomStatusLine() {
+ try {
+ String fileName = Constants.CUSTOM_STATUS_LINE_PATH;
+ if (fileName == null) {
+ return null;
+ }
+ FileObject fo = FileUtil.getConfigFile(fileName);
+ if (fo != null) {
+ DataObject dobj = DataObject.find(fo);
+ InstanceCookie ic = (InstanceCookie)dobj.getCookie(InstanceCookie.class);
+ if (ic != null) {
+ return (JComponent)ic.instanceCreate();
+ }
+ }
+ } catch (Exception e) {
+ Exceptions.printStackTrace(e);
+ }
+ return null;
+ }
+----
+
+Constants.CUSTOM_STATUS_LINE_PATH is defined as
+System.getProperty("netbeans.winsys.status_line.path");
+
+So, have a module which, in its ModuleInstall (or as a command-line parameter in their myApp.conf), does
+
+System.setProperty("netbeans.winsys.status_line.path", "com/foo/com-foo-MyStatusBar.instance");
+
+and in its layer file, does something like
+
+<folder name="com">
+
+[source,xml]
+----
+
+<folder name="foo">
+ <file name="com-foo-MyStatusBar.instance"/>
+</folder>
+----
+
+</folder>
+
+and then a class
+
+package com.foo;
+public class MyStatusBar extends JLabel {
+
+[source,java]
+----
+
+ public Dimension getPreferredSize() { return new Dimension(0,0); }
+ public Dimension getMaximumSize() { return new Dimension(0,0); } //may not be necessary
+----
+
+}
+
+and you should get a status bar whose preferred size is to have no size at all.
+
+Note you will probably want to provide your own instance of StatusDisplayer in the default lookup so there is *some* way for things to display status unless you really don't need it.
+
+Another option (exception on Mac OS) is to move the status line to the main menu (it will use the space to the right of the last menu item) -
+
+netbeans -Dnetbeans.winsys.statusLine.in.menuBar=true
+
+or the equivalent System.setProperty() from a ModuleInstall
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRemoveStatusBar[http://wiki.netbeans.org/DevFaqRemoveStatusBar] ,
+that was last modified by NetBeans user Geertjan
+on 2010-02-17T20:05:05Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRenamingMenuItem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRenamingMenuItem.asciidoc
new file mode 100644
index 0000000..22fa539
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRenamingMenuItem.asciidoc
@@ -0,0 +1,53 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRenamingMenuItem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Some module in the IDE etc. already has a menu item I can use. I just want to rename it. Can I?
+
+If you are creating a custom application (e.g. *Standalone Application* in suite project properties) you specify a _branding_ for the application. You can then override localized text strings from platform modules without modifying those modules directly; the overrides will be active whenever your branding is selected (this part is taken care of for you by the suite build harness). You will need to locate the module which defines the menu item and find the localized `Bundle.properties` which gives a label for it. Then you can create a file in your suite project like
+
+`branding/modules/''jarname''.jar/''path''/Bundle.properties`
+
+containing definitions of overridden labels.
+
+When you enable branding on a suite the IDE automatically brands a few bundle strings for the main window title and so on, so you can look at these files for examples.
+
+The Branding menu item on a suite (or Maven app project) lets you search for other strings and override them easily.
+
+See also link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/i18n-branding.html[Technical details]
+
+----
+
+Applies to: NetBeans 5.0, 5.5, 6.x
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRenamingMenuItem[http://wiki.netbeans.org/DevFaqRenamingMenuItem] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:19:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqReplaceWindowSystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqReplaceWindowSystem.asciidoc
new file mode 100644
index 0000000..5f66450
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqReplaceWindowSystem.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqReplaceWindowSystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How Can I Replace the Window Manager?
+
+Perhaps your users are a bit confused by the ability to close, slide or dock windows or maybe you're trying to retain the behavior of some existing application's window system. There are times, however rare, in which you want to replace the typical NetBeans Window Manager `org.netbeans.core.windows.WindowManagerImpl` with a different one.
+
+Before doing this you should know that starting with NetBeans 6.5, it link:http://blogs.sun.com/geertjan/entry/limiting_the_netbeans_window_system[will be easy to change certain behaviors of the window system]. So needing to replace the window manager is rare already and will be needed even less often in the future.
+
+But if you still want to do it, you can:
+
+* Create an implementation of the `org.openide.windows.WindowManager` interface
+* Register your implementation into the default lookup and link:http://wiki.netbeans.org/DevFaqLookupHowToOverride[replace any others]
+
+Of course, there's a lot of work involved in creating your own WindowManager implementation, but you can have a look at the `org.openide.windows.DummyWindowManager` class for starters. It's a simple implementation that opens all TopComponents in their own frame but which can also make windows invisible which is handy for testing.
+
+The `DummyWindowManager` is used as a last resort when no other window manager is present; you will not need to register it in the default Lookup as described earlier. If you want to use it, keep in mind these two tips:
+
+* Do not include the `Core - Windows` or `Core` modules in your application. Including `Core` will result in an error message from the NonGui class because it seems to expect an implementation of the `NbTopManager.WindowManager` class which you cannot (easily) provide.
+
+* No windows will be shown by default on startup. Use a `ModuleInstall` class' `restored()` method to display your TopComponent.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqReplaceWindowSystem[http://wiki.netbeans.org/DevFaqReplaceWindowSystem] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:59:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRequestProcessor.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRequestProcessor.asciidoc
new file mode 100644
index 0000000..1aae9ed
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRequestProcessor.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRequestProcessor
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== When should I use RequestProcessor.getDefault() and when should I create my own RequestProcessor?
+
+`RequestProcessor.getDefault()` is tempting to use, but it is also dangerous. This FAQ item will tell you when *not* to use it.
+
+One of the most common threading bugs in NetBeans happens like this:
+
+* Someone needs to run a background operation, so they use [link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/RequestProcessor.html#getDefault([http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/RequestProcessor.html#getDefault(]) `RequestProcessor.getDefault()`, the global thread pool
+* They don't realize that it is possible for either that code to be called repeatedly (by the user, in a loop or whatever)
+* The background work can take some time to run
+* A user notices that NetBeans is slow, takes a thread dump, and there are 40 background threads all doing the same thing at the same time
+
+`RequestProcessor` has a constructor argument for its _throughput_. That says how many threads this `RequestProcessor` is allowed to use at the same time. When you call `new RequestProcessor("Useful name for thread dump", 3)` you are creating a thread pool that can have 3 threads available to run things on simultaneously.
+
+*The throughput of `RequestProcessor.getDefault()` is `Integer.MAX_VALUE`*. Think about what that means: it can potentially create thousands of threads; but your OS cannot necessarily handle thousands of threads, and you probably don't have thousands of CPUs. More threads than CPUs means the OS does extra work time-slicing between the threads and things get slower, not faster.
+
+`RequestProcessor.getDefault()` is useful for _one-off_ operations - you have some situation that happens once in a great while, and, say, while constructing some object, you need to do some work in the background; that work will probably never need to be done again for the life of the Java VM. That's a perfect case for `RequestProcessor.getDefault()`.
+
+Now here is the *anti-example*: You are creating a `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/Node.html[Node]` that represents a file. It needs to mark itself with an error badge and color its text in red if the file contains errors. You can't read the file when you create the Node - that takes too long. So when the node is created, it runs a background task to check its status, and updates its icon and display name after it has read the file. Now imagine you did this with `RequestProcessor.getDefault()`. What happens when the user expands a folder that contains 1000 of your files? 1000 threads get created, and the whole application gets very, very slow. For that, you are much better off creating one new `RequestProcessor` and using it for all your nodes. The FAQ entry about `link:DevFaqRequestProcessorTask.html[RequestProcessor.Task]` shows how to do this correctly.
+
+If you create your own RequestProcessor, please always use a name. If you get a deadlock it makes debugging much easier.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRequestProcessor[http://wiki.netbeans.org/DevFaqRequestProcessor] ,
+that was last modified by NetBeans user Braiam
+on 2010-03-03T22:04:22Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRequestProcessorTask.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRequestProcessorTask.asciidoc
new file mode 100644
index 0000000..38e8cf9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRequestProcessorTask.asciidoc
@@ -0,0 +1,83 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRequestProcessorTask
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I operation occasionally on a background thread, but reschedule it if something happens to delay it?
+
+There are a lot of reasons you might want to reschedule a background operation. For example, you want to re-parse a file 3 seconds after the user stops typing, so you can show errors. But at 2 seconds she starts typing again. You don't want that task to run a second from now anymore. You can either cancel the task, or even simpler, call `task.schedule(3000)` every time a key is pressed. If it was already scheduled, it will be rescheduled for 3 seconds from now again.
+
+Or imagine you have the situation described in link:DevFaqRequestProcessor.html[the FAQ about RequestProcessor.getDefault()] - a node for a file needs to read the file after it is created to mark itself if the file has errors. `RequestProcessor.Task` makes this sort of thing easy.
+
+[source,java]
+----
+
+public class FooDataNode extends DataNode implements PropertyChangeListener, Runnable {
+ private boolean error;
+ private static final RequestProcessor THREAD_POOL = new RequestProcessor("FooDataNode processor", 1);
+ private final RequestProcessor.Task task = THREAD_POOL.create(this);
+
+ FooDataNode(FooDataObject obj) {
+ super(obj, Children.LEAF);
+ obj.addPropertyChangeListener(WeakListeners.propertyChange(this, obj));
+ task.schedule(100);
+ }
+
+ public void propertyChange(PropertyChangeEvent evt) {
+ DataObject obj = (DataObject) evt.getSource();
+ if (DataObject.PROP_MODIFIED.equals(evt.getPropertyName()) && !obj.isModified()) { //file was saved
+ task.schedule(100);
+ }
+ }
+
+ @Override
+ public String getHtmlDisplayName() {
+ return error ? "<font color=\"!nb.errorForeground\">" + getDisplayName() : null;
+ }
+
+ public void run() {
+ boolean old = error;
+ error = doesTheFileHaveErrors();
+ if (old != error) {
+ fireDisplayNameChange(null, null);
+ }
+ }
+
+ private boolean doesTheFileHaveErrors() {
+ assert !EventQueue.isDispatchThread();
+ //parse the file here
+ return true; //whatever the value should be
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRequestProcessorTask[http://wiki.netbeans.org/DevFaqRequestProcessorTask] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:59:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqRuntimeMemory.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqRuntimeMemory.asciidoc
new file mode 100644
index 0000000..3b8e12b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqRuntimeMemory.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqRuntimeMemory
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to run a module with more memory settings
+
+When we run the module from NetBeans IDE and we want to pass JVM options to increase PermGen and Heap Memory then add the following settings to the project.properties file of your module, or module suite.
+
+[source,java]
+----
+
+run.args.extra=-J-Xmx512m
+-J-XX:+UseConcMarkSweepGC
+-J-XX:+CMSClassUnloadingEnabled
+-J-XX:+CMSPermGenSweepingEnabled
+-J-XX:MaxPermSize=256m
+----
+
+Please write the complete setting in one line.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqRuntimeMemory[http://wiki.netbeans.org/DevFaqRuntimeMemory] ,
+that was last modified by NetBeans user Tusharvjoshi
+on 2011-11-13T05:35:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSampleCode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSampleCode.asciidoc
new file mode 100644
index 0000000..9217b8a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSampleCode.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSampleCode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Where can I find examples of how to use various APIs?
+
+There are a large number of samples. Many of these correspond to the tutorials. You can find the samples in module `platform` in `main/misc` repository at `hg.netbeans.org`. They are in the `samples/` subdirectory.
+
+The `platform/samples/` folder can be link:http://hg.netbeans.org/main/misc/file/tip/platform/samples/[browsed online here]. But for really trying things out it is usually more useful to link:HgHowTos.html[have a local copy] - then you can open them as projects in the IDE.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSampleCode[http://wiki.netbeans.org/DevFaqSampleCode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:59:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqScanForClasses.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqScanForClasses.asciidoc
new file mode 100644
index 0000000..b6d62ee
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqScanForClasses.asciidoc
@@ -0,0 +1,77 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqScanForClasses
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I scan a classpath to find all classes of a particular type?
+
+==== Prerequisites
+
+* find the ClassPath on which the subtypes should be found. Use e.g. ClassPath.getClassPath(<file>, ClassPath.SOURCE)
+* if the supertype is given as a FQN, convert to ElementHandle<TypeElement> via ElementHandle.create inside a Task or CancellableTask.
+
+==== Finding all subtypes of given type
+
+All subtypes of a given type on a given ClassPath can be found using ClassIndex. As ClassIndex contains only direct subtypes, the indirect subtypes need to be found on the client side:
+
+[source,java]
+----
+
+private Set<ElementHandle<TypeElement>> findAllSubTypes(ClassPath on, ElementHandle<TypeElement> of) {
+ ClasspathInfo cpInfo = ClasspathInfo.create(ClassPath.EMPTY, ClassPath.EMPTY, on);
+
+ List<ElementHandle<TypeElement>> todo = new LinkedList<ElementHandle<TypeElement>>(of);
+ Set<ElementHandle<TypeElement>> result = new HashSet<ElementHandle<TypeElement>>();
+
+ while (!todo.isEmpty()) {
+ //TODO: if cancellable, check for cancel here
+
+ ElementHandle<TypeElement> curr = todo.remove(0);
+
+ result.add(curr);
+
+ Set<ElementHandle<TypeElement>> typeElements = cpInfo.getClassIndex().getElements(eh, EnumSet.of(ClassIndex.SearchKind.IMPLEMENTORS), EnumSet.of(ClassIndex.SearchScope.SOURCE));
+
+ if (typeElements != null) { //can be null for cancellable tasks
+ todo.addAll(typeElements);
+ }
+ }
+
+ return result;
+}
+----
+
+==== Getting FileObjects corresponding to ElementHandles
+
+The FileObject corresponding to a given ElementHandle<TypeElement> can be found using SourceUtils.getFile.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqScanForClasses[http://wiki.netbeans.org/DevFaqScanForClasses] ,
+that was last modified by NetBeans user Jlahoda
+on 2011-12-15T08:29:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSellingModules.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSellingModules.asciidoc
new file mode 100644
index 0000000..2a03493
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSellingModules.asciidoc
@@ -0,0 +1,40 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSellingModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have written a module. Can I sell it?
+
+Yes. The license is very non-restrictive. For details, see the
+link:http://www.netbeans.org/about/legal/license.html[license].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSellingModules[http://wiki.netbeans.org/DevFaqSellingModules] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T15:59:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSetPrefs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSetPrefs.asciidoc
new file mode 100644
index 0000000..9b668ad
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSetPrefs.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSetPrefs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I let the user set preferences/options/customization/configuration for my module/application?
+
+From 6.0 onwards, you can use the link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/NbPreferences.html[NbPreferences API].
+
+Read the following related blog entries:
+
+* link:http://blogs.oracle.com/geertjan/entry/preferences_api_and_netbeans_ide[ Preferences API and NetBeans IDE (Part 1)]
+* link:http://blogs.oracle.com/geertjan/entry/preferences_api_and_netbeans_ide1[ Preferences API and NetBeans IDE (Part 2)]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSetPrefs[http://wiki.netbeans.org/DevFaqSetPrefs] ,
+that was last modified by NetBeans user Zolta
+on 2013-06-09T10:11:46Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSignNbm.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSignNbm.asciidoc
new file mode 100644
index 0000000..e4ba5e2
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSignNbm.asciidoc
@@ -0,0 +1,253 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSignNbm
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+1. link:#Can_I_sign_Ant_based_NBMs_I_create.3F[Can I sign Ant based NBMs I create?]
+1. link:#Isn.27t_there_an_easier_way.3F[Isn't there an easier way?]
+2. link:#Great.21_Can_you_translate_that.3F[Great! Can you translate that?]
+2. link:#How_can_I_sign_Maven_based_NBMs_I_create.3F[How can I sign Maven based NBMs I create?]
+1. link:#Example[Example]
+3. link:#How_can_I_create_a_keystore_file_and_sign_Maven_based_NBMs_within_the_build_process.3F[How can I create a keystore file and sign Maven based NBMs within the build process?]
+1. link:#Resources[Resources]
+4. link:#Apache_Migration_Information[Apache Migration Information]
+
+=== Can I sign Ant based NBMs I create?
+
+Yes, though there is not yet any GUI support for this.
+
+1. Make a module project.
+
+2. Generate a keystore, e.g.
+
+[source,java]
+----
+
+cd .../path/to/module/
+keytool -genkey -storepass specialsauce -alias myself -keystore nbproject/private/keystore
+----
+
+and answer the questions posed.
+
+To make NetBeans build script sign the NBM module. The keystore and key password needs to be the same.
+At keytool, when the question below is asked, just press ENTER key, to make keystore and key alias the same password.
+
+[source,java]
+----
+
+Enter key password for <myself>
+ (RETURN if same as keystore password):
+----
+
+3. Edit `nbproject/project.properties` to contain e.g.
+
+[source,java]
+----
+
+keystore=nbproject/private/keystore
+nbm_alias=myself
+----
+
+4. Edit `nbproject/private/platform-private.properties` to contain e.g.
+
+[source,java]
+----
+
+storepass=specialsauce
+----
+
+You could also pass `-Dstorepass=specialsauce` on the command line.
+If you specify a keystore but `${storepass}` is undefined, you will be prompted for the password during the build.
+
+5. Build the NBM for the module. (Context menu of the project.) It should be signed.
+
+6. Try installing the NBM. (Expand `build` folder in *Files* view and double-click it.) It will not be trusted initially (and so the checkbox to really install it will initially be unchecked), since NetBeans does not know about your signature. But you can click *View Certificate* to examine the certificate. If you allow installation of this module, NetBeans will remember you approved this certificate and it will not ask you for confirmation next time.
+
+Some notes:
+
+1. You can probably get a root-authorized certificate from VeriSign or the like, and the Auto Update wizard should treat this as more trusted. Not yet investigated (please update this FAQ entry if you experiment with this).
+
+2. Keeping the keystore and its password in the `private` dir ensures that you will not accidentally commit either to source repository or include it in a source ZIP made with the Project Packager module. It may be safe to put the keystore in a shared directory (e.g. `nbproject`) if you are sure that the storepass is too hard to guess.
+
+==== Isn't there an easier way?
+
+Of course. Based on the above notes this script has been contributed by our community. Just put this in your suite's build.xml file:
+
+[source,xml]
+----
+
+ <target name="-init" depends="suite.-init,init-netbeans,init-hudson">
+ <!--Create/Update keystore-->
+ <delete file="${keystore.location}${keystore.name}"/>
+ <mkdir dir="${keystore.location}"/>
+ <genkey alias="${keystore.alias}" storepass="${keystore.password}"
+ dname="${keystore.dname}"
+ keystore="${keystore.location}${keystore.name}"/>
+ <!--Update keystore info in projects-->
+ <antcall target="update-keystore-info"/>
+ </target>
+
+ <target name="update-keystore-info">
+ <for list="${modules}" delimiter=":" param="cur" trim="true">
+ <sequential>
+ <mkdir dir="@{cur}/nbproject/"/>
+ <!--Place the information in the properties file-->
+ <propertyfile file="@{cur}/nbproject/project.properties">
+ <entry key="keystore" value="../${keystore.location}${keystore.name}"/>
+ <entry key="nbm_alias" value="${keystore.alias}"/>
+ </propertyfile>
+ <mkdir dir="@{cur}/nbproject/private/"/>
+ <!--Place the password in the private properties file-->
+ <propertyfile file="@{cur}/nbproject/private/platform-private.properties">
+ <entry key="storepass" value="${keystore.password}"/>
+ </propertyfile>
+ </sequential>
+ </for>
+</target>
+----
+
+The script use ant-contrib library so make sure to have it available.
+
+You can import it using one of the following:
+
+1. If the ant-contrib-x.jar is in ant directory:
+
+[source,xml]
+----
+
+<taskdef resource="net/sf/antcontrib/antcontrib.properties"/>
+----
+
+2. Otherwise:
+
+[source,xml]
+----
+
+ <taskdef resource="net/sf/antcontrib/antcontrib.properties">
+ <classpath>
+ <pathelement location="path/to/ant-contribx.jar"/>
+ </classpath>
+ </taskdef>
+----
+
+Also you'll need this values defined in your suite's project.properties file:
+
+[source,java]
+----
+
+keystore.dname=CN=x, OU=x, O=x, C=x
+keystore.location=x/
+keystore.name=x
+keystore.alias=x
+keystore.password=x
+----
+
+Just replace x with the desired value.
+
+==== Great! Can you translate that?
+
+Ok, here's a summary:
+
+1. Create a keystore with genkey task.
+
+2. Using the defined module list (${modules} this is defined by the IDE itself) go to all your modules and add the keystore location and alias information in its `nbproject/private/platform-private.properties` file.
+
+3. Call Netbeans build task so everything keeps going.
+
+Enjoy!
+
+<hr/>
+NOTE: If you get an warning about your plugins not being trusted (and you're using self-signed certificates), you need to create and register your own
+implementation of `org.netbeans.spi.autoupdate.KeyStoreProvider` which provides access to a truststore into which your self-signed certificate has been imported as a trusted entry. In other words, the keystore (private key) is used at compile time to sign the NBM file, while the truststore (created by exporting the key from the keystore, then importing it into a new store to mark it trusted) is needed at runtime to validate the signature). All of this may not be necessary if you are signing with a certificate issued by a well-known CA.
+
+
+Applies to: NetBeans 6.8 and above
+
+=== How can I sign Maven based NBMs I create?
+
+Yes. link:https://github.com/mojohaus/nbm-maven-plugin[nbm-maven-plugin] will sign your NBM files if you set keystore, alias and password parameters correctly.
+
+==== Example
+
+1. Create a keystore (see the instructions above)
+
+2. Save the keystore file into a directory like `nbproject/private`. Make sure that it will not get committed to VCS like git/svn/hg! Or save it outside of the project. It depends on your preference.
+
+3. Update the `nbm-maven-plugin`-configuration in the pom.xml like this
+`
+
+[source,xml]
+----
+
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>nbm-maven-plugin</artifactId>
+ <version>3.11.1</version>
+ <extensions>true</extensions>
+ <configuration>
+ <!-- keep it for backwards compatibility to previous versions-->
+ <codeNameBase>com.johndoe.netbeans.myplugin</codeNameBase>
+ <author>JohnDoe (john.doe@mail.foo)</author>
+ <homePageUrl>link:https://github.com/johndoe/myplugin[https://github.com/johndoe/myplugin]</homePageUrl>
+ <!-- keystore: only required, if you don't want to pass the path to the keystore file via cmdline-->
+ <keystore>nbproject/private/keystore</keystore>
+ <keystorealias>myself</keystorealias>
+ <licenseName>Apache 2.0</licenseName>
+ <licenseFile>LICENSE-2.0.txt</licenseFile>
+ </configuration>
+ </plugin>
+----
+
+`
+Update the codeNameBase, keystore and other properties to your needs.
+
+More details about configuring the plugin can be found at the offical plugin page [2]
+
+4. Call `mvn clean package nbm:nbm -Dkeystorepass=yourpassword` to build a signed nbm.OR
+
+Call `mvn clean package nbm:nbm -Dkeystorepass=yourpassword -Dkeystore=/path/to/the/keystore.file`, if you want to reference the keystore manually. For more options see [3]
+
+=== How can I create a keystore file and sign Maven based NBMs within the build process?
+
+See that example at
+link:https://github.com/born2snipe/netbean-plugin-parent/blob/master/pom.xml[https://github.com/born2snipe/netbean-plugin-parent/blob/master/pom.xml]
+to generate a key file via the keytool-maven-plugin.
+
+==== Resources
+
+[1] link:https://github.com/mojohaus/nbm-maven-plugin[https://github.com/mojohaus/nbm-maven-plugin]
+
+[2] link:http://www.mojohaus.org/nbm-maven-plugin/[http://www.mojohaus.org/nbm-maven-plugin/]
+
+[3] link:http://www.mojohaus.org/nbm-maven-plugin/nbm-mojo.html[http://www.mojohaus.org/nbm-maven-plugin/nbm-mojo.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSignNbm[http://wiki.netbeans.org/DevFaqSignNbm] ,
+that was last modified by NetBeans user Markiewb
+on 2017-06-10T19:35:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSortableTTVColumns.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSortableTTVColumns.asciidoc
new file mode 100644
index 0000000..4f80edb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSortableTTVColumns.asciidoc
@@ -0,0 +1,42 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSortableTTVColumns
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I make sortable columns in a TreeTableView?
+
+See "How to Sort Columns in a TreeTableView" in Geertjan's blog:
+
+* link:http://blogs.sun.com/geertjan/entry/enriching_your_treetableview[http://blogs.sun.com/geertjan/entry/enriching_your_treetableview]
+* link:https://blogs.oracle.com/geertjan/entry/how_to_suppress_editing_in[https://blogs.oracle.com/geertjan/entry/how_to_suppress_editing_in]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSortableTTVColumns[http://wiki.netbeans.org/DevFaqSortableTTVColumns] ,
+that was last modified by NetBeans user Markiewb
+on 2012-10-10T20:09:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSourceTreeModuleDescriptions.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSourceTreeModuleDescriptions.asciidoc
new file mode 100644
index 0000000..71dfc0e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSourceTreeModuleDescriptions.asciidoc
@@ -0,0 +1,715 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSourceTreeModuleDescriptions
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== There sure are a lot of modules in the source tree. What are they for?
+
+If you've unpacked or checked out the NetBeans sources, you'll see more then 600 directories. Almost every one of these directories is a module. Although the directory names indicate the purpose of each, sometimes it's still not clear what each does.
+
+The easiest way to find out about a module in the source tree is to open its manifest file, then look for the entry named `OpenIDE-Module-Localizing-Bundle`. The file referenced there (located deeper inside the module directory) typically contains the module's display name, descriptions and other information. You could automate the extraction of these values through a simple shell or perl script, but for your convenience, I've included the short description of each one below:
+
+[source,java]
+----
+
+ant.browsetask=Adds an Ant task <nbbrowse> to run inside NetBeans to open a web browser.
+ant.debugger=Enables debugging on Ant scripts.
+ant.freeform=Special project type for projects with pre\u00EBxisting Ant scripts.
+ant.grammar=Code completion for textual editing of Ant scripts.
+ant.kit=Support for Ant build scripts.
+antlr=Antlr Developement Libraries
+api.debugger=Enables debugging with the AAA debugger implementation.
+api.debugger.jpda=JPDA Debugger API
+api.debugger=NetBeans Debugger APIs.
+api.java.classpath=Classpath APIs
+api.java=APIs for Java development support modules
+api.mobility=Mobility Core API module.
+api.progress=Task progress visualization APIs.
+apisupport.apidocs=Local documentation for the NetBeans APIs.
+apisupport.feedreader=Feed Reader Application
+apisupport.feedreader=Wrapper for JDOM library
+apisupport.feedreader=Wrapper for ROME Fetcher Library
+apisupport.feedreader=Wrapper for ROME Library
+apisupport.feedreader=Bundles a demonstration application using the NetBeans Platform.
+apisupport.harness=Lets you build external plug-in modules from sources.
+apisupport.paintapp=Sample NetBeans platform application.
+apisupport.project=Defines an Ant-based project type for NetBeans modules and module suites.
+apisupport.project=Some short description
+apisupport.refactoring=Additional refactoring support for NetBeans module projects.
+api.visual=Visual Library API
+api.web.webmodule=APIs for web module development support modules.
+api.xml=This module contains XML tools API and SPI.
+applemenu=Enables proper support for the Apple \
+asm=Assembler support
+autoupdate.services=Support for searching for module updates on Update Center and for downloading and installing modules
+autoupdate.ui=Supplies UI of Auto Update Services
+beans=Support for creating JavaBeans(TM) components.
+bpel.core=BPEL Core.
+bpel.debugger.api=Enables debugging on BPEL files.
+bpel.debugger.bdi=BPEL Debugger RMI.
+bpel.debugger=BPEL Debugger.
+bpel.debugger.ui=BPEL Debugger UI.
+bpel.editors.api=BPEL Editors API.
+bpel.editors=BPEL Editors.
+bpel.help=BPEL Help.
+bpel.kit=BPEL development support.
+bpel.mapper=BPEL Mapper.
+bpel.model=Object model for BPEL 2.0.
+bpel.project=Composite Application Base Project.
+bpel.project=BPEL Project.
+bpel.refactoring=BPEL Refactoring.
+bpel.samples=BPEL Samples.
+bpel.validation=BPEL Validation.
+classfile=Provides read-only access to Java class files.
+clearcase=Clearcase Versioning System
+cnd.antlr=Supports the C/C++ Code Model - contains ANTLR parser generator library
+cnd.api.model=API that represents C/C++ code
+cnd.api.project=A bridge between C/C++ project system and C/C++ code assistance
+cnd.apt=APT presentation for files with preprocessor
+cnd.callgraph=C/C++ Call Graph
+cnd.classview=C/C++ Class View
+cnd.completion=Code completion for C, C++, and Fortran languages
+cnd.debugger.gdb=Supports debugging of native programs with gdb
+cnd.discovery=C/C++ Discovery API/SPI
+cnd.dwarfdiscovery=C/C++ Dwarf-based Discovery Provider
+cnd.dwarfdump=Reading dwarf debugging information
+cnd.editor=C/C++ Editor
+cnd.folding=C/C++ APT-based Folding
+cnd.gotodeclaration=C/C++ Go To Declaration
+cnd.highlight=Provides error highlighting for the C/C++ languages.
+cnd.kit=C/C++ development support.
+cnd.lexer=Lexical analysis for C/C++ Pack languages
+cnd.makeproject=Supports C/C++ projects
+cnd.modeldiscovery=C/C++ Model-based Discovery Provider
+cnd.modelimpl=Implementation of C/C++ Code Model API
+cnd.model.services=Code Model Services
+cnd.modelui=UI for Implementation of C/C++ Code Model API
+cnd.modelutil=Miscellaneous utilities used by C/C++ Code Model
+cnd.navigation=C/C++ Code Navigation
+cnd.qnavigator=Provides navigator content for C/C++ files
+cnd.refactoring=C/C++ Experimental Refactoring
+cnd.remote=Support remote developement
+cnd.repository.api=Api for the CND repository
+cnd.repository=Persistence mechanism for Code Assistance features
+cnd=Enables development of C and C++ programs in the IDE
+cnd=Enables editing of C, C++, and Fortran files in the IDE.
+cnd.utils=C/C++ Utilites
+collab.channel.chat.java=Support for developer-friendly instant messaging chat (Java).
+compapp.casaeditor=Composite Application Service Assembly editor.
+compapp.configextension=JBI descriptor configuration extensions.
+compapp.help=Composite Application Help Topics.
+compapp.kit=Composite application development support.
+compapp.manager.jbi=Composite Application JBI Manager.
+compapp.projects.base=Composite Application Project.
+compapp.projects.jbi=Composite Application JBI Project.
+compapp.projects.wizard=Supplies the generic wizard interface for CAPS projects in the IDE.
+core.execution=Implementation of the Execution engine.
+core.ide=Makes the IDE from the platform.
+core.kit=NetBeans Platform
+core.multiview=MultiView Windows framework and APIs
+core.nativeaccess=Uses native bindings via JNA library to provide advanced visual effects for window system.
+core.output2=A simple text area based output window implementation
+core.startup=Loads and enables modules.
+core.ui=User interface of the platform.
+core.windows=Implementation for windowing support.
+css.editor=Editor support for editing CSS files
+css.visual=CSS authoring support module for visual CSS editing
+dbapi=Database support APIs
+db.core=Core database support.
+db.dataview=SQL query editable resultset view
+db.drivers=JDBC database drivers
+db.kit=Database browser, visual and text SQL editor.
+db.mysql.sakila=Provides Sakila sample database for NetBeans MySQL support
+db.mysql=Provides MySQL-specific db support for NetBeans
+dbschema=Enables you to capture and view the structure of a database in the IDE.
+db.sql.editor=Supports editing SQL files in the IDE
+db.sql.visualeditor=Visual Query Editor
+db=Views and modifies the structure of the connected database.
+debugger.jpda.ant=Lets you use the NetBeans JPDA debugger from Ant.
+debugger.jpda.heapwalk=Provides heap walking functionality in Java Debugger.
+debugger.jpda.projects=JPDA Debugger integration with Java projects.
+debugger.jpda=Enables debugging with the JPDA debugger implementation.
+debugger.jpda.ui=JPDA Debugger.
+defaults=Contains font, color and shortcut defaults for IDE.
+deployment.wm=Windows Mobile Deployment
+derby=Integration with the Java DB database.
+diff=Provides the diff action to view file differences.
+editor.bookmarks=Contains support for bookmarks handling in the edited files
+editor.bracesmatching=Support for highlighting matching braces
+editor.codetemplates=Contains support for creation and using of code templates
+editor.completion=Contains support for Code Completion in Editor
+editor.errorstripe.api=The API for the right hand side bar showing errors, hints, etc.
+editor.errorstripe=The right hand side bar showing errors, hints, etc.
+editor.fold=Contains support for Code Folding in Editor
+editor.guards=Provides support for manipulating garded sections in a document.
+editor.indent=Contains indentation APIs and SPIs.
+editor.kit=Editting support for various types of files.
+editor.lib2=Contains core editor APIs and SPIs.
+editor.lib=Contains Editor functionality independent on the IDE
+editor.macros=Support for editor macros
+editor.mimelookup.impl=The default implementation of MimeDataProvider.
+editor.mimelookup=The MIME lookup API.
+editor.plain.lib=Contains plain editor library implementation
+editor.plain=Contains plain text editor implementation
+editor.settings=Contains support for editor settings
+editor.settings.storage=Implements Netbeans editor settings storage
+editor=Enables editing of files in the IDE.
+editor.structure=Contains Editor support functionality for tag based editors
+editor.util=Contains various support classes for editor related modules
+el.lexer=Lexical Analysis for Expression Language
+etl.editor=Data Editor for editing and creating extract-transform-load collaboration documents.
+etl.project=Data Integrator Application Projects.
+extbrowser=Enables integration of external web browsers with the IDE.
+extbrowser=Webclient module enables embedding of external web browsers into the IDE.
+extexecution=Supports execution of external processes
+favorites=Support for organizing favorite files.
+form.kit=Enables you to visually design Java desktop (AWT and Swing) applications.
+glassfish.common=Shared support module for GlassFish V3 server integration
+glassfish.eecommon=shared code for glassfish servers
+glassfish.javaee=GlassFish V3 server support for JavaEE projects.
+glassfish.jruby=GlassFish V3 server support for Ruby on Rails projects
+gototest=An action to quicky \
+groovy.editor=Support for editing Groovy files
+groovy.grailsproject=Support for Grails projects
+groovy.grails=Interface to in-process or ex-process Grails runtime
+groovy.gsp=Support for Groovy Server Pages (GSP)
+groovy.kit=Wrapper module for all Groovy and Grails functionality
+groovy.refactoring=Groovy refactorings
+groovy.samples=Groovy and Grails sample projects
+groovy.support=Enables editing and running of scripts written in Groovy language.
+groovy.support=Groovy script execution support
+gsf.api=API for defining custom languages in the IDE
+gsfpath.api=APIs for handling paths in the Common Scripting Language Framework
+gsf=Generic support for language integration in the IDE
+gsf=Adds support for structural views of Java \
+gsf=Java Source Infrastructure
+hibernatelib=Wrapper module for Hibernate 3.2.5 jars
+hibernate=Hibernate Support
+hibernateweb=Hibernate Support for Web Projects.
+html.editor.lib=Contains HTML editor library implementation
+html.editor=Contains HTML editor implementation
+html.lexer=Lexical analysis for html language
+html=Supports creation, editing, and viewing of HTML files.
+httpserver=Provides infrastructure for testing applets, RMI applications, and so on.
+i18n.form=Enables internationalization of files created with the IDE's Form Editor.
+i18n=Simplifies internationalization of applications.
+ide.branding.kit=NetBeans IDE content and branding.
+ide.branding=Provides NetBeans IDE specific branding
+ide.kit=IDE Platform
+identity.kit=Plugin for securing web services and clients using Sun Java System Access Manager.
+identity.samples=Identity Sample Projects
+iep.editor=Intelligent Event Processor Editor
+iep.help=Intelligent Event Processor Help Topics.
+iep.project=Intelligent Event Processing Module Project
+iep.samples=Intelligent Event Processing Samples.
+image=Supports viewing of image files.
+installer=Provides integration services between the NetBeans installer and the Plugin Manager
+j2ee.ant=Lets you use j2eeserver from Ant.
+j2ee.api.ejbmodule=APIs for ejb jar development support modules.
+j2eeapis=J2EE Application Deployment and Management API Library
+j2ee.archive=Java EE Binary Archives support
+j2ee.clientproject=Support for Application Client (CAR) Module Projects.
+j2ee.common=Utilities for J2EE projects
+j2ee.core.utilities=Core Java EE Utilities.
+j2ee.ddloaders=J2EE Deployment Descriptors files loaders
+j2ee.dd=Deployment Descriptor API.
+j2ee.dd=J2EE Deployment Descriptor API.
+j2ee.dd.webservice=Web Services Deployment Descriptor API.
+j2ee.earproject=Supports development of composite Java EE applications.
+j2ee.ejbcore=Support for Enterprise JavaBeans (EJB) Development.
+j2ee.ejbjarproject=Support for Enterprise JavaBeans (EJB) Module Projects.
+j2ee.ejbverification=EJB Verification
+j2ee.genericserver=Generic J2EE Server Plugin
+j2ee.jboss4=Plugin for JBoss Application Server
+j2ee.jpa.verification=Detects and solves problems with usage of the Java Persistence API
+j2ee.kit=J2EE / Java EE application support
+j2ee.metadata=Java EE Metadata
+j2ee.persistenceapi=API for supporting Java Persistence API
+j2ee.persistence.kit=Java Persistence API support
+j2ee.persistence=Support for the Java Persistence Technology
+j2ee.platform=Java EE Documentation
+j2ee.samples=Java Enterprise Samples from the GlassFish samples project
+j2eeserver=Supports Java EE application servers
+j2eeserver=JSR88/77 test server plugin
+j2ee.sun.appsrv81=Map Java classes to database schema
+j2ee.sun.appsrv81=GlassFish and Sun Java System Application Server integration
+j2ee.sun.appsrv=Sun Java System Application Server Common APIs
+j2ee.sun.dd=Sun Java Sytem Application Server J2EE Deployment Descriptor API.
+j2ee.sun.ddui=Sun Java Sytem Application Server (or Glassfish) JavaEE Deployment Descriptor Loaders.
+j2ee.sun.ddui=Sun Java Sytem Application Server J2EE Deployment Descriptor GUI.
+j2ee.toplinklib=Java Persistence API and TopLink Essentials Library
+j2ee.weblogic9=Plugin for BEA WebLogic Server
+j2ee.websphere6=Plugin for IBM WebSphere Application Server, Version 6.0 and 6.1
+j2me.cdc.kit=Support for Connected Device Configuration development (JSR 36 and JSR 218)
+j2me.cdc.platform.bdj=Java ME CDC BD-JRay Platform Support
+j2me.cdc.platform.nsicom=Java ME CDC NSIcom VM Platform Implementation
+j2me.cdc.platform=Java ME CDC Platform
+j2me.cdc.project.bdj=Java ME CDC BD-J Plugin Implementation
+j2me.cdc.project.execuiimpl=Implementation of executable classes chooser in CDC profiles
+j2me.cdc.project.execui=Internal API for executable classes chooser in CDC profiles
+j2me.cdc.project.nsicom=Java ME CDC NSIcom Plugin Implementation
+j2me.cdc.project=Supports Java ME CDC Projects, such as for mobile client-side Java.
+java.api.common=API implementations common to all the project types.
+java.debug=Navigator for Java AST
+javadoc=Supports Javadoc creation and searches.
+java.editor.lib=Contains java editor library implementation
+java.editor=Contains java editor implementation
+java.examples=Provides Java SE application samples.
+java.freeform=Support of Java development in Freeform project.
+java.guards=Provides Java Guarded Sections implementation
+java.helpset=Java Support Documentation
+javahelp=Permits JavaHelp help sets to be added to the IDE.
+java.hints.analyzer=Javadoc Analyzer
+java.hints.analyzer=Task List window implementation
+java.hints=Hints Provider for Java
+java.j2seplatform=General-purpose Java platform and library definitions.
+java.j2seproject=Supports plain Java projects, such as for client-side Java SE.
+java.kit=Support for development in Java.
+java.lexer=Lexical analysis for java language
+java.navigation=Adds support for structural views of Java \
+java.platform=Infrastructure and APIs for configuring and searching Java platforms.
+java.project=Support for defining Ant-based project types involving Java sources.
+javascript.hints=Additional source code hints for JavaScript
+javascript.kit=An umbrella module covering all modules required for JavaScript support: editing, refactoring, hints, etc.
+javascript.libraries.dojo=Installs the Dojo JavaScript Library
+javascript.libraries.jquery=Installs the jQuery JavaScript Library
+javascript.libraries.prototype=Installs the Prototype JavaScript Library
+javascript.libraries.scriptaculous=Installs the Scriptaculous JavaScript Library
+javascript.libraries=JavaScript Library Manager
+javascript.libraries.yahooui=Installs the YahooUI JavaScript Library
+java.source=Java Source Infrastructure
+java.sourceui=UI classes for Java source files
+javawebstart=Support for Java Web Start
+jconsole=JConsole module
+jellytools=A library used for GUI-testing NetBeans IDE.
+jemmy=Jemmy test library.
+jmx.common=Common classes for JMX and JConsole NetBeans modules
+jmx=JMX Wizard module
+jsp.lexer=Lexical analysis for JSP language
+jumpto=An action to quicky \
+jumpto=Open Type allows you to jump to type declarations in other files
+junit=Creates tests suitable for the JUnit framework.
+languages.bat=Support for .bat files editing.
+languages.css=Support for editing CSS files.
+languages.diff=Support for editing .diff files.
+languages.javascript=Support for editing JavaScript files.
+languages.manifest=Support for editing .manifest files.
+languages.php=PHP editor.
+languages.refactoring=Refactorings for Generic Support for Integration of Programming Languages into NetBeans IDE
+languages.sh=Support for editing .sh files.
+languages=Generic Support for Integration of Programming Languages into NetBeans IDE
+languages.yaml=Support for editing YAML files.
+lexer.editorbridge=Enables use of the lexer module with the current editor
+lexer.nbbridge=Allows to search for language descriptions by using MimeLookup
+lexer=Enables lexical analysis
+lib.cvsclient=A CVS client library, that substitutes the client side of the native CVS executable.
+libs.aguiswinglayout=Free Layout for AGUI Profile based on org.jdesktop.layout.GroupLayout
+libs.bytelist=JRuby ByteList Library
+libs.cglib=This module bundles Code Generation Library
+libs.commons_fileupload=This plugin bundles Commons FileUpload.
+libs.commons_logging=This module bundles Apache Commons Logging.
+libs.commons_net=This plugin bundles Commons Net.
+libs.freemarker=This module bundles Freemarker.
+libs.glassfish_logging=This module bundles Glassfish Commons Logging.
+libs.httpunit=HttpUnit Test.
+libs.ini4j=Bundles ini4j.jar.
+libs.jakarta_oro=This plugin bundles Jakarta ORO.
+libs.javacapi=The javac public API
+libs.javacimpl=The javac implementation classes.
+libs.javacup=Java CUP 11a integration
+libs.jna=Bundles JNA library.
+libs.jsch=Bundles JSch (SSH implementation).
+libs.jsr223=This module bundles the Scripting APIs
+libs.junit4=Bundles the JUnit 4.x testing library.
+libs.jvyamlb=YALM Library Library (jvyamlb)
+libs.lucene=Bundles Apache Lucene (a Search Engine).
+libs.ppawtlayout=Free Layout for Personal Profile based on org.jdesktop.layout.GroupLayout
+libs.springframework=Bundles the Spring Framework.
+libs.svnClientAdapter=Bundles tigris.org's svnClientAdapter.jar.
+libs.svnjavahlwin32=Bundles subversion client for windows
+libs.xerces=Bundles Apache Xerces (an XML parser).
+libs.xmlbeans=XMLBeans development and runtime libraries
+lib.terminalemulator=A terminal emulator library written in Java.
+lib.uihandler=Collects Information about UI Gestures
+loadgenerator=Generic load generation infrastructure
+localhistory=Implemets Local History for the IDE
+masterfs=Merges multiple filesystem providers into a single logical tree.
+maven.kit=NetBeans Maven project system support
+maven.spring=Module bridging Maven and Spring features
+mercurial=Mercurial Versioning System
+mobility.antext=Provides Java ME extensions to Ant.
+mobility.cldcplatform.catalog=Java ME Platform SDK Catalog
+mobility.cldcplatform=Java Micro Edition CLDC Platform
+mobility.databindingme=Provides runtime libraries for databinding on mobile devices.
+mobility.deployment.ftpscp=FTP/SCP Deployment of Java ME Project
+mobility.deployment.nokia=Deployment on Nokia phones
+mobility.deployment.ricoh=Deployment on Ricoh devices
+mobility.deployment.sonyericsson=Sony Ericsson Deployment of Java ME Project
+mobility.deployment.webdav=WebDAV Deployment of Java ME Project
+mobility.editor=Java Micro Edition Editor Support module
+mobility.end2end.kit=Support for mobile end-to-end applications such as Java ME web services or mobile to web
+mobility.end2end=Java ME Client to Web Application Generator
+mobility.javahelp=Online documentation for Java ME.
+mobility.jsr172=Stub generator for Java ME Web Service Clients (JSR 172)
+mobility.kit=Java Mobile Edition System Core
+mobility.licensing=Mobility Licensing module.
+mobility.midpexamples=Provides a lot of MIDP examples.
+mobility.plugins.mpowerplayer=SDK MPowerPlayer support for Netbeans Mobility
+mobility.proguard=Provides ProGuard Obfuscator for Java ME extensions to Ant.
+mobility.project.ant=Debugger support for Java ME Build System Core
+mobility.project.bridge.impl=Implementation of isolation API between core Mobility project and advanced IDE functionality
+mobility.project.bridge=Isolation API between core Mobility project and advanced IDE functionality
+mobility.project=Java Mobile Edition Build System Core
+mvd=Java Mobile Edition Visual Editor
+nbjunit=NetBeans extensions to JUnit
+o.apache.jmeter.kit=JMeter load generator integration bundle
+o.apache.jmeter.module=JMeter integration module
+o.apache.tools.ant.module.docs=Documentation for the Ant build tool.
+o.apache.tools.ant.module=Supports writing of build scripts.
+o.apache.xml.resolver=Apache Resolver library for development time
+o.jdesktop.beansbinding=Bundles beans-binding library.
+o.jdesktop.layout=Bundles swing-layout library.
+o.jruby.distro=Bundled distribution of JRuby and Ruby on Rails
+o.jruby=The actual JRuby implementation
+o.kxml2=XML Pull Parser implementation
+o.mozilla.rhino.patched=A patched version of Rhino for IDE language processing
+o.n.bluej=Allows to work with BlueJ projects in NetBeans
+o.n.bootstrap=The core bootstrap of NetBeans-based applications.
+o.n.core=The basic framework of NetBeans-based applications.
+o.n.insane=INSANE heap profiling library.
+o.n.soa.libs.jgo=Wrapper module for the JGO visual library.
+o.n.soa.libs.wsdl4j=WSDL4J
+o.n.soa.libs.xmlbeans=XMLBeans development and runtime libraries
+o.n.swing.dirchooser=\
+o.n.swing.plaf=Handles per-look-and-feel UIManager customizations for NetBeans
+o.n.swing.tabcontrol=The tab control used by the window system
+o.n.upgrader=Import IDE environment and settings.
+o.n.xml.libs.jxpath=JXPath Library.
+o.openidex.util=Search API for use by various modules.
+openide.actions=Definition of common actions for NetBeans
+openide.awt=User interface utilities.
+openide.compat=Some old classes that are now deprecated.
+openide.dialogs=Handles dialogs and wizards.
+openide.execution=Execution API from the Open APIs.
+openide.explorer=Various view for displaying node structures.
+openide.filesystems=Virtual File System API.
+openide.io=Open APIs relating to displaying output.
+openide.loaders=NetBeans Open API for manipulating data objects.
+openide.modules=APIs for getting information about installed modules.
+openide.nodes=API for defining generic tree-like structures.
+openide.options=Support for storing preferences.
+openide.text=Generic API wrapping Swing based EditorKits.
+openide.util.enumerations=Enumeration API that is in wrong package.
+openide.util=Basic Utilities API.
+openide.windows=API for managing components on a screen.
+options.api=Provides the Options dialog and an SPI to add panels to it.
+options.editor=Provides the editor related panels in the Options dialog.
+o.rubyforge.debugcommons=Integration of debug-commons-java library
+performance=The basic core framework of the IDE.
+performance=The basic core framework of the IDE.
+php.dbgp=PHP Debugger.
+php.doc=PHP Documentation.
+php.editor=Support for editing PHP files
+php.help=Online help pages for the IDE's PHP support
+php.kit=Provides tools and support for php development.
+php.lexer=PHP Lexer
+php.model=PHP model.
+php.project=Support for PHP projects.
+php.rt=PHP runtime explorer.
+php.samples=PHP Sample projects for NetBeans Sample Catalog
+print=Implementation of print module.
+profiler.attach=Attach wizard integration provider SPI
+profiler.loadgen=Profiler -> LoadGenerator Bridge
+progress.ui=Task progress visualization.
+project.ant=Supports all project types based on Ant as a build tool.
+projectapi=General API for accessing and loading IDE projects.
+projectimport.eclipse.core=Imports projects created in Eclipse IDEs into NetBeans.
+projectimport.jbuilder=Imports projects created by JBuilder IDE into NetBeans.
+project.libraries=Support for organizing resources into libraries.
+projectuiapi=Supplies the APIs/SPIs for user interface of projects in the IDE.
+projectui.buildmenu=Supplies the Run and Debug menu for java/c++ projects.
+projectui=Supplies the basic user interface for projects in the IDE.
+properties=Supports editing of .properties files.
+properties.syntax=Syntax coloring for .properties files in the source editor.
+queries=Acts as a general communication channel between modules.
+quiz=Quiz Module
+registration=Enables user to register to Sun Online Account
+ruby.debugger=Ruby Debugger
+ruby.extrahints=Extra source code hints for Ruby
+ruby.help=Online help pages for the IDE's Ruby support
+ruby.hints=Additional source code hints for Ruby
+ruby.javaint=Support for accessing Java libraries using JRuby in Ruby projects
+ruby.kit=An umbrella module covering all modules required for Ruby support: editing, projects, Rails, etc.
+ruby.platform=Infrastructure and APIs for configuring and searching Ruby platforms.
+ruby.project=Supports plain Ruby projects
+ruby.rakeproject=Supports all project types based on Rake as a build tool.
+ruby.rspec=Support for RSpec, a testing framework for Ruby
+ruby.samples.depot=Depot Sample Application
+ruby.testrunner=Ruby Test Runner
+ruby.themes=Additional editor color themes designed for use with the Ruby file types in NetBeans.
+schema2beans=Library for representing XML as java beans; development time variant.
+schema2beans=Library for representing XML as JavaBeans.
+sendopts=GetOpts compliant API for parsing command line
+server=Provides server integration.
+servletapi=Servlet 2.2 API Library
+servletjspapi=Servlet 2.5/JSP 2.1 API Library
+settings=A library for storing settings in custom formats.
+soa.kit=Shared classes for XSLT and BPEL modules.
+soa.mappercore=SOA Mapper Core.
+soa.mapper=SOA Mapper.
+soa.reportgenerator=SOA Report Generator Framework.
+soa.ui=SOA UI.
+soa.validation=SOA Validation.
+spi.debugger.ui=Basic shared debugger UI.
+spi.editor.hints=Editor Hints Infrastructure
+spi.navigator=Navigation support SPIs and APIs
+spi.palette=Common Palette visualization and APIs
+spi.quicksearch=Infrastructure for quick search in menu items, actions, files etc.
+spi.tasklist=Provides API for Task List plugins
+spi.viewmodel=TreeTableView Model
+spring.beans=Spring Beans Support
+spring.webmvc=Spring Web MVC Support
+sql.help=JDBC Help.
+sql.project=Composite Application Base Project.
+sql.project=Support for SQL Application Projects.
+sql.wizard=JDBC Wizard.
+subversion=Integrates Subversion actions into IDE workflow.
+swingapp=Swing Application Framework Support for Form Editor
+tasklist.projectint=Integrates the Task List window with Projects system
+tasklist.todo=Scan for ToDo items in source file comments
+tasklist.ui=Task List window implementation
+templates=Advanced Templating not only for Datasystems
+testtools: Module providing additional support for XTest, Jemmy and Jelly technologies.
+timers=Timers API
+tomcat5=Tomcat servlet container integration
+uihandler.exceptionreporter=Allows automatic reporting of exceptions to our UI Gestures Server
+uihandler.interactive=Collects Information about UI Gestures
+uihandler=Collects Information about UI Gestures
+uml.codegen=Code Generation for the UML Tools
+uml.designpattern=The Design Center provides the design pattern catalog.
+uml.documentation=Provides a control to view and modify the documentation of a model element.
+uml.dom4jlib=Dom4j Dependency Libraries
+uml.drawingarea=The modeling drawing area control.
+uml.drawingarea=Reverse Engineer GUI Addin.
+uml.integration=Enables model-driven analysis, design and implementation using the Unified Modeling Language (UML).
+uml.kit=NetBeans 5.5, UML Modeling Module
+uml.parser.java=Provides parsing support for the Java 5.0 language.
+uml.project=Supports plain UML projects
+uml.propertysupport=Supports UML properties
+uml.reporting=Provides the ability to execute web report.
+uml.requirements.doorsprovider=A requirements provider that uses DOORS to persist requirements.
+uml.requirements=The requirements framework.
+uml.requirements.xmlrequirements=A requirements provider that uses an XML file to persist requirements.
+uml.samples=A sample Java project with its reversed engineered UML project counterpart.
+uml.samples=Sample UML Model Projects
+uml=Contains the core functionality for all modeling projects.
+uml=Associate With Dialog Addin.
+updatecenters=Declares NetBeans autoupdate centers.
+usersguide=Online documentation for the IDE.
+utilities.project=Support for searching projects for files.
+utilities=Support for file searching, bookmarks.
+versioning=Support module for Versioning systems.
+versioning.system.cvss=Integrates CVS actions into IDE workflow.
+visdev.prefuse=Library for Prefuse Graphing Toolkit
+visualweb.api.designer=Visual Editor Hack APIs
+visualweb.api.insync=InSync Source Modeler APIs
+visualweb.api.j2ee=API Extensions for J2EE
+visualweb.api.portlet.dd=Provides an API for a portlet deployment descriptor
+visualweb.compatibilitykit=Contains libraries needed for Visual Web JSF web application development in certain environments
+visualweb.dataconnectivity.designtime=Design Time Classes for Data Connectivity
+visualweb.dataconnectivity=Database and Data Source related
+visualweb.designer.markup=Designer Markup and CSS Impl.
+visualweb.designer=The Visual Designer enables you to create pages in WYSIWYG mode
+visualweb.designtime.base=Base design-time implementations
+visualweb.designtimeext=Design-Time API Extension for component authors
+visualweb.designtime=Design-Time API
+visualweb.designtime=Design-Time API for component authors
+visualweb.ejb=Enterprise Java Bean Support
+visualweb.errorhandler.client=Web Application error handler client
+visualweb.errorhandler=Web Application error handler server
+visualweb.extension.openide=Extends Openide.
+visualweb.gravy=A library used for GUI-testing NetBeans IDE Visual Web features.
+visualweb.insync=InSync provides abstract source manipulation support for Java, XML, and HTML
+visualweb.jsfsupport.components=JSF Components
+visualweb.jsfsupport.designtime=Visual Web Design-Time support and standard JSF components
+visualweb.jsfsupport=JSF Support Container
+visualweb.kit=Visual development of web applications with Java Server Pages
+visualweb.libs.batik=Batik CSS Parser (modified)
+visualweb.libs.jtidy=JTidy HTML cleaner (modified)
+visualweb.libs.rowset=JDBC RI Rowset Library
+visualweb.project.jsfloader=JSF Loaders faking one JSF object.
+visualweb.project.jsf=Support for development of web applications based on JavaServer Faces.
+visualweb.project.jsf=Supplies the basic user interface for projects in the IDE.
+visualweb.propertyeditors=Property Editors
+visualweb.ravehelp.rave_nbpack=Online help pages for the IDE
+visualweb.websvcmgr=Web Service Support
+visualweb.web.ui.appbase=Application Runtime API
+visualweb.webui=Wrapper module for Sun Web User Interface Component runtime library
+visualweb.webui.themes=Default themes for the Sun Web UI Components
+visualweb.xhtml=Defines beans for most XHTML elements
+vmd.analyzer=Visual Mobile Designer - Analyzer
+vmd.codegen=Visual Mobile Designer - Code Generator
+vmd.components.midp.pda=JSR 75: Accessing the PIM database and File system custom components.
+vmd.components.midp=Provides basic set of Netbeans MIDP custom components.
+vmd.components.midp.wma=Wireless Messaging API (WMA) custom components.
+vmd.componentssupport=Visual Mobile Designer - components creation
+vmd.componentssupport=VMD Custom Component Project
+vmd.componentssupport=VMD Custom Component Project
+vmd.componentssupport=VMD Custom Component Project
+vmd.flow=Visual Mobile Designer - Flow Designer
+vmd.game=Visual editing support for MIDP 2.0 Game API
+vmd.inspector=Visual Mobile Designer - Inspector
+vmd.io.javame=Visual Mobile Designer - Java ME Communication IO Implementation
+vmd.io=Visual Mobile Designer - Input Output
+vmd.kit=Support for visual development in JavaME.
+vmd.midpnb=Visual Mobile Designer - MIDP NetBeans Components
+vmd.midp=Visual Mobile Designer - MIDP
+vmd.model=Visual Mobile Designer - Model
+vmd.palette=Visual Mobile Designer - Palette
+vmd.properties=VMD Properties
+vmd.screen=Visual Mobile Designer - Screen Designer
+vmd.structure=VMD Structure Browser
+web.client.javascript.debugger.ant=Lets you use the NetBeans JavaScript debugger from Ant.
+web.client.tools.firefox.extension=This module implements the JavaScript Debugger Firefox Extension.
+web.client.tools.impl=This module contains the Web Client JavaScript Debugger API classes.
+web.client.tools.impl=This module contains the Web Client JavaScript Debugger UI classes.
+web.client.tools.impl=Web Client Tools Implementation.
+web.client.tools.internetexplorer=This module implements the NetBeans Add-on for Internet Explorer.
+web.client.tools.kit=Support for web client tools.
+web.core=Supports the creation, editing, compiling, and testing of JavaServer Pages.
+web.core.syntax=Provides editing support for JSP files.
+web.debug=Supports the debugging of JSP
+web.examples=Provides web application examples.
+web.flyingsaucer=Allows to render XHTML documents using CSS
+web.freeform=Support of Web development in Freeform project.
+web.jsf12ri=Wrapper module for JavaServer Faces 1.2 RI
+web.jsf12=Installs the JavaServer Faces 1.2 Library
+web.jsf.kit=JavaServer Faces support.
+web.jsf.navigation=The Page Flow Editor lets you edit page flow
+web.jsf=Support for development of web applications based on JavaServer Faces.
+web.jspparser=Provides support for parsing JSP files using the Jakarta JSP parser.
+web.jstl11=Installs the JSP Standard Tag Library 1.1.
+web.kit=Basic Java web application support.
+web.libraries.jsf1102=Installs the JavaServer Faces 1.1.02 Library
+web.monitor=Tracks data flow inside the servlet engine
+web.project=Support for web module projects.
+web.struts=Support for Struts Framework
+websvc.axis2=Axis2 Support
+websvc.clientapi=SPI for modules that are web service consumers.
+websvc.core=Provides generic support for development and consumption of web services.
+websvc.customization=Provides support for JAX-WS customization.
+websvc.design=Visual Designer for Web Services
+websvc.editor.hints=Hints support for JAXWS Web Services
+websvc.jaxrpc16=Installs the JAX-RPC libraries from JWSDP 1.6
+websvc.jaxrpckit=JAX-RPC Web Services Development Support
+websvc.jaxrpc=Provides support for development and consumption of JAX-RPC web services.
+websvc.jaxws21api=JAX-WS 2.1 API
+websvc.jaxws21=Installs the JAX-WS 2.1 client libraries
+websvc.jaxwsapi=SPI for modules that are JAX-WS service providers.
+websvc.jaxwsmodel=JAX-WS(wsimport) WSDL to Java model and project support for JAX-WS technology.
+websvc.kit=Provides generic support for development and consumption of web services.
+websvc.manager=IDE-wide registration for web services
+websvc.metro.samples=Provides examples of Metro web services
+websvc.projectapi=Web Services Project API
+websvc.registry=Web Services Implementation
+websvc.registry=Web Service Registry Implementation
+websvc.restapi=API/SPI for RESTful Web Services Support
+websvc.restkit=RESTful Web Services Development Support
+websvc.restlib=Installs JAR files for JSR-311 API and reference implementation.
+websvc.rest.samples=RESTful Web Services Sample Projects
+websvc.rest=Support for creation of RESTful Web Services
+websvc.saas.api=API supporting consumers of SaaS (Software as a Services)
+websvc.saas.codegen.j2ee=Provides code generation support for consuming SaaS services in Java EE applications.
+websvc.saas.codegen.java=Provides code generation support for consuming SaaS services in Java desktop applications.
+websvc.saas.codegen.php=Provides code generation support for consuming SaaS services in PHP applications.
+websvc.saas.kit=Provides support for consuming SaaS services.
+websvc.saas.services.strikeiron=StrikeIron Service Component
+websvc.saas.services.strikeiron=StrikeIron Service Component
+websvc.saas.ui=SaaS Services UI
+websvc.utilities=Utilities for Web Services
+websvc.websvcapi=SPI for modules that are JAX-RPC service providers.
+websvc.wsitconf=Provides support for web services interoperability technologies.
+websvc.wsitmodelext=Provides WSDL extensions to other (WSIT or other) modules.
+websvc.wsstackapi=Web Services Stack API
+websvc.wsstack.jaxws=JAX WS Stack Description
+welcome=Shows welcome content after the first startup of the IDE.
+wsdlextensions.file=FILE extension for wsdl editor.
+wsdlextensions.ftp=FTP extensions in WSDL editor.
+wsdlextensions.jms=Provides JMS extensions in WSDL editor.
+wsdlextensions.snmp=Provides SNMP extensions in WSDL editor.
+xml.catalog=The module allows to persistently mount entity catalogs.
+xml.core=This module keeps some miscellaneous APIs.
+xml.jaxb=Java XML binding wizard and utilities.
+xml.kit=XML, Schema and WSDL related tools.
+xml.multiview=XML Multiview Editor Infrastructure
+xml.nbprefuse=Prefuse Customization Module
+xml.refactoring=Refactoring support for XML-based components.
+xml.refactoring=Graph Analysis of XML Schema Relationships
+xml.retriever=Retriever and XML catalog support
+xml.schema.abe=Support for the graphical design view of the schema editor
+xml.schema.model=API for manipulating XML Schema
+xml.schema.refactoring=Refactoring of Schema Component Usages
+xml.schema=The module provides support for XML Schema.
+xml.search=XML Search.
+xml=The module is a base for all XML related modules.
+xml.tax=The module contains Tree API for XML ("TAX") library.
+xml.text=The module provides text editing capabilities.
+xml.tools.java=The module contains various actions and generators.
+xml.tools=The module contains various actions and tools.
+xml.validation=XML Validation module
+xml.wsdl.bindingsupport.api=WSDL Binding Support API
+xml.wsdl.bindingsupport=WSDL Extensibility Elements Support
+xml.wsdl.extensions=Extensions to WSDL Model
+xml.wsdlextui=WSDL Editor Extensions.
+xml.wsdl.kit=WSDL related tools.
+xml.wsdl.model=WSDL Model
+xml.wsdl.refactoring=Support for XML Refactoring in WSDL
+xml.wsdlui=WSDL Editor for editing and creating WSDL documents.
+xml.wsdlui=FTP extensions in WSDL editor.
+xml.wsdlui=Provides JMS extensions in WSDL editor.
+xml.xam=Framework for design synchronous object model from textual document.
+xml.xam.ui=Interface code common to clients of the XAM model.
+xml.xdm=An toolable document model for XML
+xml.xpath.ext=XPath model with deep resolving of schema objects
+xml.xpath=XPath 1.1 Model.
+xsl=The module contains simple XSL support.
+xslt.core=XSLT Core.
+xslt.help=XSLT Help.
+xslt.kit=XSLT development support.
+xslt.mapper=XSLT Mapper.
+xslt.model=XSLT Model.
+xslt.project=XSLT Project.
+xslt.tmap=Transformmap Core.
+xslt.validation=XSLT Validation.
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSourceTreeModuleDescriptions[http://wiki.netbeans.org/DevFaqSourceTreeModuleDescriptions] ,
+that was last modified by NetBeans user Geertjan
+on 2009-12-02T12:27:06Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSpecifyJdkVersion.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSpecifyJdkVersion.asciidoc
new file mode 100644
index 0000000..f93b2ab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSpecifyJdkVersion.asciidoc
@@ -0,0 +1,67 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSpecifyJdkVersion
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== My module requires JDK 6; how do I keep it from being loaded in JDK 5?
+
+Add a line to your manifest, specifying which version of Java you need. E.g. to only run on JDK 6 and higher, not 5:
+
+[source,java]
+----
+
+OpenIDE-Module-Java-Dependencies: Java > 1.6
+----
+
+Note that `>` really means `>=`, and that the traditional "internal" version numbers like "1.5", "1.6", etc. must be used despite the new Java naming scheme (JDK 5, JDK 6, ...).
+
+Requesting 5+ is pointless since no recent version of NetBeans runs on JDK 1.4 anyway.
+
+There is also a syntax for requesting a particular version of the virtual machine
+(as opposed to Java platform APIs) but this is seldom if ever used.
+
+By default, your module will depend on the same Java version as you specify for `javac.source`,
+i.e. the version of the Java language your module requires.
+
+The NetBeans module development support permits you to pick a JDK to use for compiling
+(and running) a module or suite.
+Obviously you must specify a JDK at least as new as what your dependency requests;
+it is unwise to specify a newer JDK than that:
+you might accidentally use some newer APIs without realizing it,
+making your code not actually run on the declared minimum version.
+
+
+Applies to: NetBeans 6.x
+
+Platforms: all
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSpecifyJdkVersion[http://wiki.netbeans.org/DevFaqSpecifyJdkVersion] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:00:17Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSuitesVsClusters.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSuitesVsClusters.asciidoc
new file mode 100644
index 0000000..ead82f1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSuitesVsClusters.asciidoc
@@ -0,0 +1,102 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSuitesVsClusters
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the difference between a suite and a cluster?
+
+A suite is a project which bundles together a number of link:DevFaqWhatIsAModule.html[module] projects, lets you build them all together, and puts the resulting JARs in a directory structure the NetBeans Platform understands.
+
+That directory structure is a link:DevFaqWhatIsACluster.html[cluster]. A cluster is a directory structure which the application launcher and module system understand. A cluster is a _runtime artifact_ where the module system can find the modules that make up an application.
+
+While it is common to think of a suite as _being_ a cluster (the build product of a suite _is_ a cluster, after all), they are not the same thing.
+
+==== Suites
+
+A suite is a container project used to group _module projects_ into a unit whose members can depend on one another, and also depend on a copy of the NetBeans platform.
+
+The structure generated on disk when you compile a suite project is a link:DevFaqWhatIsACluster.html[cluster].
+
+If you are creating a single module (perhaps an IDE extension or a _very simple_ link:http://platform.netbeans.org[NetBeans Platform-based application]) you can ignore suites, and just build/run/distribute a single stand-alone module. You will still get a cluster structure on disk when you compile the module. However, suite projects offer some additional features, such as building zip and JNLP application distributions.
+
+You can always start with a stand-alone module project and later create a suite project and add your module to the suite. If you are going to bundle multiple third-party libraries, and want the ability to provide updates of those libraries, you probably want a suite.
+
+==== Inter-suite Dependencies
+
+A suite may depend on
+
+* Another suite
+* A stand-alone module
+* An external binary cluster (a cluster directory somewhere on disk which you might not have the source code to: link:DevFaqWhatIsACluster.html[DevFaqWhatIsACluster]). Use the *Add Cluster* button on the Libraries tab of your suite's *Project Properties* dialog to set up such dependencies.
+
+See link:DevFaqHowToReuseModules.html[DevFaqHowToReuseModules] for more details.
+
+==== Clusters
+
+A cluster is typically a subdirectory of a NB-based application's binary installation. Every module in the installation lives in one (and only one) cluster. For details on the structure of clusters, see link:DevFaqWhatIsACluster.html[DevFaqWhatIsACluster].
+
+The installation is divided into clusters for purposes of:
+
+1. Conceptual clarity.
+2. Mapping to native packaging systems such as RPM, Debian/Ubuntu packages, Solaris packages, etc.
+
+The NetBeans team has a policy of treating inter-cluster module dependencies as more significant than intra-cluster module dependencies with respect to backward compatibility. The goal is to make it possible for product teams building on top of the NetBeans IDE to select a subset of the IDE to use—with cluster granularity rather than with module granularity.
+
+Cluster-granularity is simpler to grasp and integrate with native packaging (if the NetBeans IDE consisted of 500 Debian packages, nobody would be particularly happy about that). But there is nothing preventing you from reusing a subset with module granularity.
+
+The NetBeans launcher (`nbexec`) accepts a list of cluster directories to load modules from—basically a search path. There are no further semantics to clusters.
+
+The suite project type has a standard build target to assemble a complete application. For simplicity, it simply places all modules built from suite sources into their own cluster named in accordance with the suite's name.
+
+NBMs may specify a cluster. The `netbeans/` subdirectory of the NBM (which is a ZIP file) has a file layout which matches the layout of files within a single cluster. Each cluster managed by Auto Update has an `update_tracking/` subdirectory with one XML file per module, enumerating the files which that module contributes to the cluster.
+
+Currently the "NB Platform" is just the `platform` cluster from the IDE. The entire contents of the `platform` cluster may not be exactly what you want for every "platform" application, so a suite project allows you to exclude modules you do not wish to include.
+
+Clusters are supposed to be medium-grained or coarse-grained, unlike modules which are generally fine-grained units.
+
+See also:
+
+* `harness/README` in your IDE distribution
+* the *Help > Contents* pages on modules and applications
+* link:http://platform.netbeans.org/articles/installation.html[http://platform.netbeans.org/articles/installation.html]
+
+===== No Suites In NetBeans IDE Sources
+
+The NetBeans IDE build (from sources on `hg.netbeans.org`) _does not use suites._
+
+It uses a historical build infrastructure which partially overlaps the external module/suite build harness introduced in NetBeans 5.0, but which has different requirements, and is considerably more complex.
+
+Module projects physically inside the netbeans.org source tree cannot be "standalone" modules nor "suite component" modules. They are simply netbeans.org modules, and as such use a (slightly) different format for metadata, and have access to somewhat different facilities specific to netbeans.org practices.
+
+The resulting build artifacts are, nonetheless, clusters. These clusters are simply built using a different build-infrastructure, where the cluster names and contents are defined in `.properties` files in `$NB_SRC/nbbuild/`.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSuitesVsClusters[http://wiki.netbeans.org/DevFaqSuitesVsClusters] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:02:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSuppressEditTTVColumns.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSuppressEditTTVColumns.asciidoc
new file mode 100644
index 0000000..7fdc7ab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSuppressEditTTVColumns.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSuppressEditTTVColumns
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How can I add support for a new language via ANTLR?
+
+See the blog entry "How to Suppress Editing in a TreeTableView" in Geertjan's blog:
+
+link:https://blogs.oracle.com/geertjan/entry/how_to_suppress_editing_in[https://blogs.oracle.com/geertjan/entry/how_to_suppress_editing_in]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSuppressEditTTVColumns[http://wiki.netbeans.org/DevFaqSuppressEditTTVColumns] ,
+that was last modified by NetBeans user Beholder
+on 2013-02-11T08:38:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSuppressExistingModule.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSuppressExistingModule.asciidoc
new file mode 100644
index 0000000..80f6118
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSuppressExistingModule.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSuppressExistingModule
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want my module to disable some of the modules that would normally be enabled. Possible?
+
+If you're building a complete application (for example, selecting the *Standalone Application* option for a module suite) just use the *Libraries* panel of the suite's *Properties* dialog to exclude modules you don't need from clusters you are otherwise including.
+
+If you have a single module which you want to install in an existing application (e.g. the NetBeans IDE) and disable another module, it's a little trickier. You can do it in your `ModuleInstall.restored()` method:
+
+link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html#listing[Modules API - List of Modules]
+
+Sample:
+
+link:http://hg.netbeans.org/main/file/tip/versioning.system.cvss/src/org/netbeans/modules/versioning/system/cvss/ModuleLifecycleManager.java[ModuleLifecycleManager.java] of the Java CVS Module
+
+You can also go through the Auto Update Services API:
+link:http://blogs.sun.com/geertjan/entry/parsing_the_command_line_to1[Geertjan shows how]
+
+-
+
+Applies to: NetBeans 6.5 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSuppressExistingModule[http://wiki.netbeans.org/DevFaqSuppressExistingModule] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T14:01:41Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSwitchingMenusByContext.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSwitchingMenusByContext.asciidoc
new file mode 100644
index 0000000..85982f8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSwitchingMenusByContext.asciidoc
@@ -0,0 +1,78 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSwitchingMenusByContext
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I change the contents of a menu according to the selected file in the editor?
+
+* Create your action and let it implement link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.Menu.html[Presenter.Menu]
+* Return a special `JMenuItem` subclass that implements link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/DynamicMenuContent.html[DynamicMenuContent] from `getMenuPresenter()`
+* Implement link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/DynamicMenuContent.html[DynamicMenuContent] methods to return the desired menu content, using link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.Registry.html[TopComponent.Registry] for finding the selected file in the editor.
+
+link:https://bitbucket.org/jglick/dynamicmenudemo/[https://bitbucket.org/jglick/dynamicmenudemo/] also does something similar.
+
+=== Can I hide or show a whole menu or toolbar?
+
+To hide a menu or toolbar you have to edit your `layer.xml` and append `_hidden` to the name of the desired menu or toolbar. You may also hide `*.instance` files.
+
+<syntaxhighlight lang="xml" enclose="div" highlight="6">
+<folder name="Menu">
+
+[source,xml]
+----
+
+ <!-- Hide View menu -->
+ <folder name="View_hidden"/>
+ <folder name="SomeMenu">
+ <!-- Hide a single menu item -->
+ <file name="SomeAction.instance_hidden"/>
+ </folder>
+----
+
+</folder>
+<folder name="Toolbars">
+
+[source,xml]
+----
+
+ <!-- Hide Edit toolbar -->
+ <folder name="Edit_hidden"/>
+----
+
+</folder>
+</syntaxhighlight >
+
+It's generally much easier to do this from the NetBeans IDE, link:http://forums.netbeans.org/post-77476.html[as described here].
+
+Note that to hide the Navigate menu one has to declare GoTo_hidden instead of Navigate_hidden (the menu was originally named GoTo, but was later renamed to Navigate by the means of Bundle.properties).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSwitchingMenusByContext[http://wiki.netbeans.org/DevFaqSwitchingMenusByContext] ,
+that was last modified by NetBeans user Jglick
+on 2011-12-14T00:20:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSyntaxColoring.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSyntaxColoring.asciidoc
new file mode 100644
index 0000000..8dca6a9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSyntaxColoring.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSyntaxColoring
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add syntax coloring for my own data object/MIME type?
+
+Yes, but it is not trivial. There is a tutorial on the subject: link:http://wiki.netbeans.org/How_to_create_support_for_a_new_language[http://wiki.netbeans.org/How_to_create_support_for_a_new_language]
+
+<hr/>
+
+Applies to: NetBeans 6.7 and later, but most concepts (not the exact APIs) have been available since 6.0
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSyntaxColoring[http://wiki.netbeans.org/DevFaqSyntaxColoring] ,
+that was last modified by NetBeans user Vstejskal
+on 2010-06-16T14:00:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSyntaxHighlight.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSyntaxHighlight.asciidoc
new file mode 100644
index 0000000..d5e66a9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSyntaxHighlight.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSyntaxHighlight
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I add syntax highlighting for my language?
+
+Problem: I have a custom programming language that I want to make available in the NetBeans platform. How do I add syntax highlighting for my language?
+
+Solution: Here is a tutorial on syntax highlighting for custom languages: link:http://wiki.netbeans.org/SyntaxColoringANTLR[http://wiki.netbeans.org/SyntaxColoringANTLR]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSyntaxHighlight[http://wiki.netbeans.org/DevFaqSyntaxHighlight] ,
+that was last modified by NetBeans user Stefika
+on 2010-10-01T19:56:10Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSysFsLookupRegistration.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSysFsLookupRegistration.asciidoc
new file mode 100644
index 0000000..e35f6d1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSysFsLookupRegistration.asciidoc
@@ -0,0 +1,105 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSysFsLookupRegistration
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I register services into the default lookup using the system filesystem?
+
+In short, you probably do not want to.
+The typical way of registering services is via `META-INF/services` registration: link:DevFaqLookupDefault.html[DevFaqLookupDefault].
+That method is easier to use and offers compatibility with non-platform applications via the Java Extension Mechanism.
+
+But there are some special cases when registration via the system filesystem is needed.
+One example might be when you want to dynamically change or unregister services,
+since the system filesystem is writable at runtime.
+Again such needs are rare and you should probably avoid doing this unless there is no alternative.
+(Usually the service interface should be defined so that the service itself is a singleton,
+but it can create other objects on demand and signal certain events.)
+Another minor use case is to register several services with the same implementation class but different parameters;
+`META-INF/services` registrations require a zero-argument constructor,
+meaning you need a different implementation class for each distinct service.
+
+As an example, assume that Module 1 defines an interface `com.tomwheeler.example.intf.SampleInterface` which is exported to other modules.
+Module 2 depends on Module 1 and provides an implementation of that interface named `com.tomwheeler.example.impl.SampleImplementation`.
+Module 1 does not need anything in its layer file (or even need a layer file at all),
+but Module 2 can register the service like this:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.2//EN"
+ "http://www.netbeans.org/dtds/filesystem-1_2.dtd">
+<filesystem>
+ <folder name="Services">
+ <folder name="wheeler-sample">
+ <file name="com-tomwheeler-example-this-name-is-Irrelevant.instance">
+ <attr name="instanceClass"
+ stringvalue="com.tomwheeler.example.impl.SampleImplementation"/>
+ <attr name="instanceOf"
+ stringvalue="com.tomwheeler.example.intf.SampleInterface"/>
+ </file>
+ </folder>
+ </folder>
+</filesystem>
+
+----
+
+The name of the file is arbitrary but must end with `.instance`.
+The value of the `instanceClass` attribute needs to define the implementation class being registered,
+while `instanceOf` defines the interface (or abstract class) being implemented.
+
+If you want to create the implementation using a factory method rather than calling a zero-argument constructor,
+replace `instanceClass` with `instanceCreate`, e.g.:
+
+[source,xml]
+----
+
+<attr name="instanceCreate"
+ methodvalue="com.tomwheeler.example.impl.SampleImplementations.make"/>
+
+----
+
+It is also possible to pass parameters to the factory method;
+see link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/api.html#instances[API documentation] for details.
+
+Client code is unaware of the registration mechanism, so the code used to look up a registered implementation of the interface would be the same as always; for example:
+
+[source,java]
+----
+
+SampleInterface intf = Lookup.getDefault().lookup(SampleInterface.class);
+// now do something with intf...
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSysFsLookupRegistration[http://wiki.netbeans.org/DevFaqSysFsLookupRegistration] ,
+that was last modified by NetBeans user Silhanek
+on 2011-01-28T21:16:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqSystemFilesystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqSystemFilesystem.asciidoc
new file mode 100644
index 0000000..ac4706c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqSystemFilesystem.asciidoc
@@ -0,0 +1,90 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqSystemFilesystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the System Filesystem?
+
+The system filesystem is the central repository for configuration data in NetBeans.
+It is composed at runtime of a stack of XML layers (link:DevFaqModulesLayerFile.html[DevFaqModulesLayerFile])
+supplied by modules in the system.
+Modules use folders in the system filesystem to define _extension points_ -
+a module can define a folder and document what files or objects
+(typically instance files: link:DevFaqInstanceDataObject.html[DevFaqInstanceDataObject])
+other modules can put there, and then, at runtime, scan the
+contents and do something with the result.
+
+The top layer of the System Filesystem is the `config/` subfolder of the user directory.
+(link:DevFaqUserDir.html[DevFaqUserDir])
+That is what makes the System Filesystem read-write -
+diffs are written there,
+and there are semantics for programmatically deleting files
+by creating an empty file called, e.g., `TheFile.instance_hidden`.
+
+Any type of file can be put into the System Filesystem;
+what is done with those files is a contract between the module that defines a folder
+and documents what can be put there, and the modules that put things there.
+You can use `FileUtil.getConfigFile` to access entries at runtime.
+
+The same mechanism for file recognition that recognizes user files on disk
+recognizes files in the system filesystem -
+so you can put a `.java` file in the system filesystem,
+and it can be opened in the editor and edited just as a file on disk can
+(if saved, it will be written to the user dir on disk,
+and the newly written file will then be the actual content.
+In fact, this is why file templates in the IDE can be edited.
+
+Some folders have special meaning to the system,
+because they are defined by modules that are part of the NetBeans Platform.
+Some of them are:
+
+* `Actions/` - A global repository for actions in the system, it contains subfolders which categorize actions into ad-hoc categories. This folder supplies raw actions for the Key Bindings part of the Options dialog. If you install actions, the typical pattern is to put an `*.instance` files here.
+* `Menu` - The contents of the menu bar in the main window - it has a folder for each menu; subfolders of these represent submenus, and `*.instance` files represent `Action`s to be shown on the menus.
+* `Loaders` - Contains subfolders that define mime types (e.g. `Loaders/text/x-java`) which are used to define various attributes such as popup menu items that should appear when the user right clicks on a file of a given MIME type.
+
+There are several things which affect how objects are used, all or some of which may be specified by a module's API:
+
+* The location of a file - a module may define a folder that modules put objects directly into, or request that client modules create subfolders in that folder in cases where the entire path to the file has semantic meaning (see below).
+* The type of the file - very often you will install `*.instance` files that represent Java objects; typically the module will specify what classes or interfaces objects in a folder should be assignable from.
+* File attributes (link:DevFaqFileAttributes.html[DevFaqFileAttributes]) - for cases where additional information is required to describe what to do with the files that client modules add to the folder, some optional or mandatory key/value attributes may be specified.
+
+==== Available documentation on System Filesystem contents
+
+link:http://bits.netbeans.org/dev/javadoc/layers.html[List of files and folders in the system filesystem]
+in NetBeans API Javadoc lists some locations.
+Feel free to file documentation bugs for modules you know read other locations
+but which fail to list them in their `arch.xml` file.
+
+<hr/>
+Applies to: NetBeans 6.5 and newer
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqSystemFilesystem[http://wiki.netbeans.org/DevFaqSystemFilesystem] ,
+that was last modified by NetBeans user Jglick
+on 2009-12-03T13:51:54Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTaskLongRunningAsyncTask.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTaskLongRunningAsyncTask.asciidoc
new file mode 100644
index 0000000..f77c9b9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTaskLongRunningAsyncTask.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTaskLongRunningAsyncTask
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to execute a long running task from an action without blocking the GUI?
+
+The easy way if you might need to run a long task when some action is involved:
+
+[source,java]
+----
+
+@ActionRegistration(asynchronous = true)
+...
+public void actionPerformed(ActionEvent ev) {
+ if (isLongTaskRequired) {
+ // maybe run a ProgressHandler
+ doLongTask();
+ }
+ EventQueue.invokeLater(new Runnable() {
+ @Override public void run() {
+ // do domething with the gui
+ }
+ });
+}
+----
+
+This way you don't even need to care about threading yourself, GUI will be updated as long as the task is finished.
+
+Taken from dev@platform.netbeans.org (Oct 2013)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTaskLongRunningAsyncTask[http://wiki.netbeans.org/DevFaqTaskLongRunningAsyncTask] ,
+that was last modified by NetBeans user Markiewb
+on 2013-10-03T17:04:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTemplatesInNonIdeApp.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTemplatesInNonIdeApp.asciidoc
new file mode 100644
index 0000000..fe817b7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTemplatesInNonIdeApp.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTemplatesInNonIdeApp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I am creating a non-IDE application. How do I enable/control templates?
+
+If the projectui module is installed, templates are only made available inside projects.
+
+If you want to enable templates outside of a project (like folder is, by default), then you need to remove the projectui module but make sure the favorites (org.netbeans.modules.favorites) module is enabled for your suite.
+
+To make your template available as one of the choices on the New File context menu (as opposed to having to choose the type in the wizard), then you have to list it as a privileged template.
+
+See Tom Wheeler's link:http://www.tomwheeler.com/netbeans/[TodoListManager] for an example of code that does these things.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTemplatesInNonIdeApp[http://wiki.netbeans.org/DevFaqTemplatesInNonIdeApp] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:01:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTestDataObject.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTestDataObject.asciidoc
new file mode 100644
index 0000000..f2d3b5a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTestDataObject.asciidoc
@@ -0,0 +1,109 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTestDataObject
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Writing Tests For DataObjects and DataLoaders
+
+Quite easy. At least in NetBeans 6.5 and newer. Everything shall work as
+declarative MIME resolvers are loaded automatically from unit tests and
+loaders are available from unit tests automatically.
+
+Example code is below:
+
+[source,java]
+----
+
+ private static final String BAD_MANIFEST_CONTENT =
+ "Manifest-Version: 1.0\n" +
+ "junk junk junk\n" +
+ "some more junk\n";
+ private static final String GOOD_MANIFEST_CONTENT =
+ "Manifest-Version: 1.0\n" +
+ "Java-Bean: true\n" +
+ "OpenIDE-Module-Name: com.foo.bar\n\n";
+
+ @Test public void checkContent() throws Exception {
+ FileSystem fs = FileUtil.createMemoryFileSystem();
+ FileObject good = fs.getRoot().createData("good.mf");
+ writeFile(GOOD_MANIFEST_CONTENT, good);
+ DataObject goodDob = DataObject.find(good);
+
+ FileObject bad = fs.getRoot().createData("bad.mf");
+ writeFile(BAD_MANIFEST_CONTENT, bad);
+ DataObject badDob = DataObject.find(bad);
+
+ YourInterface y = goodDob.getLookup().lookup(YourInterface.class);
+ y.doYourTest();
+ }
+
+ private void writeFile(String content, FileObject file) throws Exception {
+ OutputStream os = file.getOutputStream();
+ os.write(content.getBytes("UTF-8"));
+ os.close();
+ }
+----
+
+In the somewhat unusual case in which your unit test resides in a different module from that which contains your file support code (DataLoader, DataObject, etc.), you will need to add a `<test />` dependency on the module which contains the file support code. Currently this can only be done by editing the `project.xml` file for the module containing your unit tests. See the build harness' README for more information; you can find the relevant section by searching for `test-dependencies` in that file.
+
+==== Older versions than 6.5
+
+If you are writing a test for a `DataObject`,
+you need to set up enough of the `DataLoader` infrastructure
+that `DataObject.find()` will locate your `DataLoader`
+and call it to create your `DataObject` subtype.
+
+First, use the setup code described in
+link:TestingThingsThatUseFileObjectDataObjectDataFolder.html[Testing Things That Use File Objects].
+Add to the test's `setUp()` method a call to `FileUtil.setMIMEType()`
+to manually assign the file extension to the MIME type of your `DataLoader`.
+
+[source,java]
+----
+
+FileUtil.setMIMEType("mf", "text/x-manifest");
+----
+
+(`setMIMEType()` is deprecated with respect to usage from inside a module,
+but it is fine to use it in a unit test).
+
+(For XML file subtypes, `FileUtil.setMIMEType()` on `*.xml` is not likely to work.
+You can instead register a `MIMEResolver` in default lookup which does whatever you need.)
+
+Second, you need to make sure your `DataLoader` is registered in the
+link:DevFaqLookupDefault.html[default Lookup]
+so that `DataObject.find()` will find it.
+In 6.0, the *New File Type* template will set this up automatically
+by creating the correct file in `test/unit/META-INF/services`.
+(Or you can get better control by using `org.openide.util.test.MockLookup`.)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTestDataObject[http://wiki.netbeans.org/DevFaqTestDataObject] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:02:09Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTestUsingSystemFileSystem.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTestUsingSystemFileSystem.asciidoc
new file mode 100644
index 0000000..3924990
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTestUsingSystemFileSystem.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTestUsingSystemFileSystem
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I test something which uses the System Filesystem?
+
+There is a fake System FileSystem provided by as soon as FileSystem link:API.html[API] is on classpath. It understands link:NetBeans.html[NetBeans] layer definitions and is generally suitable for running unit tests.
+
+In case you see difference from expected behavior:
+
+* Try to run tests in link:DevFaqUsingSimpletests.html[real mode]
+* Report link:NetBeans.html[NetBeans] a bug (product platform/filesystems) with a test case
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTestUsingSystemFileSystem[http://wiki.netbeans.org/DevFaqTestUsingSystemFileSystem] ,
+that was last modified by NetBeans user Jtulach
+on 2009-12-08T11:51:31Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqThreading.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqThreading.asciidoc
new file mode 100644
index 0000000..b7e1f60
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqThreading.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqThreading
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I need to run some code on a background thread. Can the platform help me?
+
+First, ask yourself why you need to do this and if it is really necessary. Generally there is only one reason: _You are doing something takes some time (file I/O, computing something large and complicated, talking to a network socket) that will block the UI._
+
+NetBeans contains a thread pool `org.openide.util.RequestProcessor`. (You can use the thread pools that exist today in `java.util.concurrent` but it is more typical to use `RequestProcessor`.) There is a general purpose built-in thread pool - `RequestProcessor.getDefault()`. You can use that for things that only happen once in a while; otherwise you are probably better off creating your own instance of `RequestProcessor`. There is a link:DevFaqRequestProcessor.html[FAQ item about how to know when to do which]. In its most simple usage, `RequestProcessor.post()` is called with a `Runnable`. The call returns a `RequestProcessor.Task` which you can use to monitor the status of the task and listen to task finish among other.
+
+Note that if you are doing something in the background, you may want to use the link:http://bits.netbeans.org/dev/javadoc/org-netbeans-api-progress/org/netbeans/api/progress/ProgressHandleFactory.html[Progress API] to show a progress indicator in the status-bar (or use it to put up a modal progress dialog if the UI really needs to be blocked - use with care, only when really necessary).
+
+Remember that if you are running more threads than you have processors (or cores) - and your OS is probably using some as well - then when you ask to multi-thread, you are asking your CPU to divide the time of the CPUs you have between more virtual threads. And switching the context a CPU is working in - sending it off to some other memory space and set of instructions, and then another - takes time. So heavy use of multi-threading, especially on single CPU machines, can slow things down rather than speed them up. If you can make your code run faster, do that first.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqThreading[http://wiki.netbeans.org/DevFaqThreading] ,
+that was last modified by NetBeans user Dsimonek
+on 2009-12-03T15:28:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqThreadingBuiltIn.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqThreadingBuiltIn.asciidoc
new file mode 100644
index 0000000..922653b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqThreadingBuiltIn.asciidoc
@@ -0,0 +1,46 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqThreadingBuiltIn
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What APIs come with built-in background thread handling
+
+A few APIs come with built in multi-threading - if you want your code to run on a background thread, you don't have to do any special set up to do that.
+
+Specifically they are
+
+* The Actions API - if you override `asynchronous` to return true (or don't override it - for historical reasons this is the default), your action's `performAction` method will run in the background
+* The Nodes API - to compute node children that are expensive to create, use `link:http://wiki.netbeans.org/DevFaqNodesChildFactory[ChildFactory]` and specify `true` as the boolean argument to `link:http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/nodes/Children.html#create(org.openide.nodes.ChildFactory,%20boolean)[Children.create()]`
+* Various parsing APIs - for syntax highlighting languages and so forth - usually you just provide a task to do, and it will automatically call you in the background when a reparse is being done
+* QuickSearch API - searchers are typically called in background thread by infrastructure in link:http://bits.netbeans.org/dev/javadoc/org-netbeans-spi-quicksearch/org/netbeans/spi/quicksearch/SearchProvider.html#evaluate%28org.netbeans.spi.quicksearch.SearchRequest,%20org.netbeans.spi.quicksearch.SearchResponse%29[SearchProvider.evaluate(...)]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqThreadingBuiltIn[http://wiki.netbeans.org/DevFaqThreadingBuiltIn] ,
+that was last modified by NetBeans user Dsimonek
+on 2009-12-03T15:38:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqToggleActionAddToEditorToolbar.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqToggleActionAddToEditorToolbar.asciidoc
new file mode 100644
index 0000000..22bf4a8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqToggleActionAddToEditorToolbar.asciidoc
@@ -0,0 +1,110 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqToggleActionAddToEditorToolbar
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How do I add a toggle-able action to the toolbar/main menu?
+
+* extend from link:http://bits.netbeans.org/dev/javadoc/org-openide-util-ui/org/openide/util/actions/BooleanStateAction.html[org.openide.util.actions.BooleanStateAction]
+* in the constructor add a property-change listener to the action itself and let the action implement `PropertyChangeListener `
+* within `PropertyChangeListener#propertyChange` check for the propertyName `PROP_BOOLEAN_STATE` to distinguish the toggle event from other events
+
+Example
+
+[source,java]
+----
+
+package de.markiewb.netbeans.plugins.debuggerutils;
+
+import java.beans.PropertyChangeEvent;
+import java.beans.PropertyChangeListener;
+import javax.swing.Action;
+import org.netbeans.api.annotations.common.StaticResource;
+import org.openide.awt.ActionID;
+import org.openide.awt.ActionReference;
+import org.openide.awt.ActionReferences;
+import org.openide.awt.ActionRegistration;
+import org.openide.util.*;
+import org.openide.util.NbBundle.Messages;
+import org.openide.util.actions.BooleanStateAction;
+
+@ActionID(
+ category = "Debug",
+ id = "de.markiewb.netbeans.plugins.debuggerutils.SkipAllBreakpoints"
+)
+@ActionRegistration(
+ lazy = false,
+ displayName = "#CTL_SkipAllBreakpoints"
+)
+@ActionReferences({
+ @ActionReference(path = "Toolbars/Debug", position = 1050),
+ @ActionReference(path = "Menu/RunProject", position = 2350)
+}
+)
+@Messages("CTL_SkipAllBreakpoints=Skip all breakpoin&ts")
+
+public final class SkipAllBreakpoints extends BooleanStateAction implements PropertyChangeListener {
+
+ @StaticResource
+ private static final String iconpath = "de/markiewb/netbeans/plugins/debuggerutils/Breakpoint_stroke.png";
+
+ public SkipAllBreakpoints() {
+ addPropertyChangeListener(this);
+
+ setBooleanState(false); //initially unchecked
+ }
+
+ @Override
+ public void propertyChange(PropertyChangeEvent evt) {
+ if (evt.getPropertyName().equals(PROP_BOOLEAN_STATE)) {
+ /* your action here, get the state by getBooleanState()*/
+ }
+ }
+
+ public HelpCtx getHelpCtx() {
+ return HelpCtx.DEFAULT_HELP;
+ }
+
+ @Override
+ public String getName() {
+ return Bundle.CTL_SkipAllBreakpoints();
+ }
+
+ @Override
+ protected String iconResource() {
+ return iconpath;
+ }
+}
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqToggleActionAddToEditorToolbar[http://wiki.netbeans.org/DevFaqToggleActionAddToEditorToolbar] ,
+that was last modified by NetBeans user Markiewb
+on 2016-06-02T21:50:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTopManager.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTopManager.asciidoc
new file mode 100644
index 0000000..e010e38
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTopManager.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTopManager
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Where is `TopManager`? I'm trying to do the examples from the O'Reilly book
+
+The O'Reilly book is old (written between 2001 and 2002) - the chapters on architectural background will still work, but many of the examples won't.
+
+The generation of NB it was written for is from before Lookup (see link:DevFaqLookup.html[DevFaqLookup]) was in use. `TopManager` was a class with a bunch of static methods for getting service objects.
+It is now gone.
+
+For pretty much everything available via `TopManager`, simply take the class you were looking for and try `SomeClass.getDefault()` - that's typically the modern way to do this sort of thing. `TopManager` caused a tangle of interdependencies between different APIs that it was very desirable to remove.
+
+If you were calling `TopManager.getDefault().getPlaces().nodes().projectDesktop()` in a NetBeans 3.x based application, there is no direct equivalent in NB 4.0 and later. Rather, there is a rich set of project-related APIs which can be used for various purposes. As a rule, there is no 1-to-1 conversion from the above idiom to NB 4.0+; the affected O'Reilly examples would need to be rewritten to make sense today.
+
+<hr/>
+Applies to: NetBeans 4.0+
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTopManager[http://wiki.netbeans.org/DevFaqTopManager] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:02:29Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTrackGlobalSelection.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTrackGlobalSelection.asciidoc
new file mode 100644
index 0000000..72d2d22
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTrackGlobalSelection.asciidoc
@@ -0,0 +1,71 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTrackGlobalSelection
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I need to write some code that tracks the global selection. What should I do?
+
+If you are writing an action, consider using one of the
+link:DevFaqActionContextSensitive.html[context sensitive action classes in the apis].
+
+For other types of code, use `Utilities.actionsGlobalContext()`. This is a link:DevFaqLookup.html[Lookup ] which shows the contents of whatever link:DevFaqWindowsTopComponent.html[TopComponent] has focus. When component A has focus, the Lookup returned by `Utilities.actionsGlobalContext()` contains whatever A.getLookup() contains. When the user sends focus to component B, the contents change - and events are fired if you are listening for changes.
+
+Think of `Utilities.actionsGlobalContext()` as watching a news program on television. If there is something exciting happening in Lichtenstein, you do not have to go to Lichtenstein to learn about it - the people in the studio show you their reporter in Lichtenstein. Similarly, if you want to know what the user has selected, with `Utilities.actionsGlobalContext()` you do not have to pay attention to which component has focus, or even the fact that there is a component! You can just tune to the sports channel (well, in NetBeans, more likely, the DataObject channel) and get all the news about what is happening. Or, to use another metaphor, you are looking down one end of a hose. The platform takes care of moving the other end of the hose around so that you are always looking at the place where the user is working.
+
+In practice, `Utilities.actionsGlobalContext()` returns a link:DevFaqLookup.html[Lookup ] which proxies the Lookup of the active (focused) link:DevFaqWindowsTopComponent.html[TopComponent]'s Lookup (which, if it is an link:DevFaqExplorerViews.html[explorer view], is proxying the Lookup(s) of whatever Node(s) are selected). Say that we are interested in what is happening with - whether the user has selected - objects of the type `SomeApiClass`:
+
+[source,java]
+----
+
+//You must hold a reference to your Lookup.Result as long as you are interested
+//in changes in it, or it will be garbage collected and you will stop getting
+//notifications
+Lookup.Result res = Utilities.actionsGlobalContext().lookupResult (SomeApiClass.class);
+res.addLookupListener (new LookupListener() {
+ public void resultChanged (LookupEvent evt) {
+ Collection c = ((Lookup.Result) evt.getSource()).allInstances();
+ //do something with the collection of 0 or more instances - the collection has changed
+ }
+});
+
+----
+
+The nice thing about this approach is that, unless your code specifically cares about Nodes, you don't need to depend on the Nodes API.
+
+The idea behind this is that every "logical window" in NetBeans has its own Lookup, whose contents represent the "selection" in that window (or whatever services it wants to expose). `Utilities.actionsGlobalContext()` is a single point of entry - you don't have to track which window currently has focus - it is a Lookup which proxies the Lookup of whatever window does have focus. When the focused window changes, the Lookup returned by `Utilities.actionsGlobalContext()` will fire the appropriate changes. So, for example, an Action can be written to be sensitive to a particular object type; it does not need any code that relates to tracking window focus or similar.
+
+*Please note*: Generally, keep a hard reference on the Lookup.Result (or make a closure on it with some final keyword and a reference from the anonymous listener). Because if you don't -- the garbage collector might kick in quite soon and your listener won't be called.
+Source: link:http://emilian-bold.blogspot.com/2006/11/netbeans-platform-lookupresult-garbage.html[Lookup.Result garbage collection trick]
+
+See also: link:DevFaqAddGlobalContext.html[How to Add Content to the Global Context]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTrackGlobalSelection[http://wiki.netbeans.org/DevFaqTrackGlobalSelection] ,
+that was last modified by NetBeans user Bdschubert
+on 2012-11-21T17:33:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTrackingExplorerSelections.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTrackingExplorerSelections.asciidoc
new file mode 100644
index 0000000..4d0dadc
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTrackingExplorerSelections.asciidoc
@@ -0,0 +1,62 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTrackingExplorerSelections
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How should I keep track of what the current nodeselection in the Explorer window is? Should I use the `ExplorerManager` ?
+
+You can use the `ExplorerManager` if you created the explorer window, or you can programmatically get a reference to it. If you can somehow find a class implementing `ExplorerManager.Provider` then you can get the Explorer manager. This provider might in fact be a `TopComponent` in the `TopComponent.Registry`, if for example it was actually a `ExplorerPanel`.
+
+But this is bad style - for example, if someone wrote a `TopComponent` that included a component implementing `ExplorerManager.Provider`, but as a subcomponent, and manually managed the node selection, this trick would fail.
+
+Rather, if you know which top component you care about, you can just call `TopComponent.getActivatedNodes()` and this will work correctly even for non-Explorer components with a node selection, such as Editor panes open on Java sources.
+
+Better still is to be agnostic about which top component should be providing the activated nodes, and just listen to changes in the `TopComponent.Registry.PROP''ACTIVATED''NODES` (or `TopComponent.Registry.PROP_CURRENT_NODES` as appropriate).
+
+But best of all is not to have to ever directly pay attention to
+the node selection. If you only need to know the node selection in
+order to make some user action enabled or not, you should simply
+extend `NodeAction`;
+this class does all the dirty work for you of listening to changes
+in the node selection and updating its state automatically.
+
+If you just want to write some code that is sensitive to the global selection (not an action), you probably want to use link:DevFaqTrackGlobalSelection.html[Utilities.actionsGlobalContext()].
+
+==== Multiple nodes selection - gotcha
+
+If you allow multiple nodes to be selected you also have to keep in mind that certain other Netbeans components may only operate on single nodes.
+
+One example is the link:http://www.netbeans.org/download/dev/javadoc/org-netbeans-spi-navigator/overview-summary.html[Navigator]. Let's suppose you have a navigator window associated with your selected node. What you will notice is that while your multiple selection is in focus, your link:DevFaqTrackGlobalSelection.html[code for acquiring] the selected nodes returns all the selected nodes. If the focus is then switched to the Navigator window, only one node is retrieved, all that while the multiple selection is still there, in the un-focused window.
+
+The reason is because along with the focus change, the (single) node represented by the Navigator and stored in its lookup becomes the global selection which your retrieval code will then grab.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTrackingExplorerSelections[http://wiki.netbeans.org/DevFaqTrackingExplorerSelections] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:02:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTroubleshootClassNotFound.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTroubleshootClassNotFound.asciidoc
new file mode 100644
index 0000000..fb968e4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTroubleshootClassNotFound.asciidoc
@@ -0,0 +1,69 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTroubleshootClassNotFound
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I got a `ClassNotFoundException` or `NoClassDefFoundError`. How can I fix it?
+
+The most likely explanation is that you have a problem in your dependencies.
+In order for a class in one module to reference a class/interface defined in another module,
+the following must be true:
+
+1. The class/interface being referenced must be visible to the code using it, according to the normal Java visibility rules. This typically means that the class must be public, since package-private access across modules is impossible.
+2. The package containing the class/interface must be _exported_ (marked as providing an API visible to other modules). To "export" package, right click project, select Properties -> API Versioning and choose either public or friend export type.
+3. The module containing the code which uses this class/interface must declare a dependency on the module which provides it.
+
+These rules are pretty straightforward and it is easy in most cases to verify that dependencies are set up correctly.
+If you receive a `ClassNotFoundException` or `NoClassDefFoundError` at runtime, the stack trace will generally lead you to the problem.
+
+However, there are some cases where you will receive a `ClassNotFoundException` or `NoClassDefFoundError` at runtime,
+but finding which modules need to declare dependencies on one another is more difficult because the stacktrace does not directly identify the code involved.
+This occurs most frequently when you have library modules
+(composed of JAR files which were compiled outside of the platform).
+Although the dependencies were satisfied (by setting the classpath as needed) when the libraries were compiled,
+the developer may not have correctly set these dependencies in the platform application which uses them.
+
+In this case, you can often locate the problem by rebuilding the suite
+and paying close attention to the output generated by the `verify-class-linkage` task.
+For example:
+
+[source,java]
+----
+
+verify-class-linkage: Warning: a.SomeImplementation cannot access b.publicapi.SomeInterface
+----
+
+This tells us that the module which provides `SomeImplementation` needs to declare a dependency on the module which provides `SomeInterface`.
+
+For more background, see .
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTroubleshootClassNotFound[http://wiki.netbeans.org/DevFaqTroubleshootClassNotFound] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:02:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTroubleshootMissingItemsInZippedSources.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTroubleshootMissingItemsInZippedSources.asciidoc
new file mode 100644
index 0000000..041889c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTroubleshootMissingItemsInZippedSources.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTroubleshootMissingItemsInZippedSources
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I find files missing from the source ZIP file
+
+If you've downloaded and unpacked the ZIP file containing NetBeans sources but find that it seems incomplete, try using another application to unpack the ZIP file. It seems that the popular WinZip application cannot properly handle this file.
+
+The link:http://www.7-zip.org/[7-Zip application] is free, open source and is known to correctly handle the NetBeans ZIP sources.
+
+link:http://www.info-zip.org/[Info-ZIP] is a free command-line unzip utility for Windows and OS/2 which has been around for more than a decade.
+
+Alternatively, you could write a simple Ant script to use the `unzip` task for decompressing the archive, or use a ported version of a Unix unzip utility for Windows.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTroubleshootMissingItemsInZippedSources[http://wiki.netbeans.org/DevFaqTroubleshootMissingItemsInZippedSources] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T02:31:21Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTutorialsAPI.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTutorialsAPI.asciidoc
new file mode 100644
index 0000000..531561f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTutorialsAPI.asciidoc
@@ -0,0 +1,99 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTutorialsAPI
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Tutorial index
+
+* link:http://bits.netbeans.org/dev/javadoc/index.html[NetBeans Platform API starting point]
+* link:http://bits.netbeans.org/dev/javadoc/usecases.html[How to use certain NetBeans APIs] includes introductions to:
+* Actions
+* Ant-Based Project Support
+* Ant integration module
+* Autoupdate Services
+* Classfile Reader
+* Command Line Parsing
+* Common Palette
+* Database Explorer
+* Datasystems
+* Debugger Core
+* Debugger Core UI
+* Debugger JPDA
+* Dialogs
+* Diff module
+* Editor Braces Matching
+* Editor Code Completion
+* Editor Code Folding
+* Editor Code Templates
+* Editor Error Stripe
+* Editor Guarded Sections
+* Editor Indentation
+* Editor Library
+* Editor module
+* Editor Settings
+* Editor Utilities
+* File Systems
+* General Queries
+* I/O APIs
+* J2EE DD
+* Java EE Metadata
+* Java EE Server Registry
+* Java Platform
+* Java Project Support
+* Java SE Projects
+* Java Support
+* JUnit Tests
+* Lexer module
+* Look&Feel Customization
+* Master Filesystem
+* MIME Lookup
+* Module System
+* MultiView Windows
+* Navigator
+* Options Dialog
+* Progress
+* Project API
+* Project UI
+* Refactoring
+* Search API
+* Settings Options
+* Tab Control
+* Task List
+* TreeTableView model
+* UI Gestures Collector
+* UI Handler Library
+* Utilities
+* Visual Library
+* Web
+* Window System
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTutorialsAPI[http://wiki.netbeans.org/DevFaqTutorialsAPI] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:03:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTutorialsDebugging.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTutorialsDebugging.asciidoc
new file mode 100644
index 0000000..494f5ac
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTutorialsDebugging.asciidoc
@@ -0,0 +1,66 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTutorialsDebugging
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Debugging modules
+
+Once your module is installed all error messages are sent to your `(NetBeans user directory)/var/log/messages.log`; use that for watching what's going on.
+
+You can use `java.util.logging.Logger` (or `org.openide.util.Exceptions`) to report exceptions and informational messages to the log file.
+
+You can debug your own module from within NetBeans just like you would any other project. However, if you want to step into NetBeans code then you need to download the NetBeans source.
+You do not need to build it;
+just tell NetBeans where your NetBeans source code lives using *Tools > NetBeans Platform Manager > Sources*.
+
+If you still have strange problems stepping into NetBeans code, try the following:
+
+* Open the NetBeans project that contains the code you are trying to access - for example, if you are stepping into the editor, open the NetBeans editor project.
+* Now run the debugger again then open the debugger sources window (*Window > Debugging > Sources*) and ensure all the checkboxes are ticked.
+* Now there is no reason why NetBeans debugging should fail!
+
+To launch NetBeans in debug mode manually:
+
+[source,java]
+----
+
+netbeans/bin/netbeans -J-Xdebug -J-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5858
+----
+
+then use *Run > Attach Debugger* and then choose Connector = SocketAttach, port = 5858 and timeout = 5000 and press OK.
+
+_Note: if you run the debugged NetBeans instance on the same machine as your development IDE, do not forget to add _'--userdir xxx'_ parameter to the debugged instance's command line. Otherwise the debugged process might try to reuse the default userdir, which is most probably already taken up by the development IDE. The debugged NetBeans instance then terminates right after start with very undescriptive message or no messages at all._
+
+<hr/>
+Applies to: NetBeans 6.5+
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTutorialsDebugging[http://wiki.netbeans.org/DevFaqTutorialsDebugging] ,
+that was last modified by NetBeans user Jachym Vojtek
+on 2013-07-31T06:52:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTutorialsIndex.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTutorialsIndex.asciidoc
new file mode 100644
index 0000000..3724de3
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTutorialsIndex.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTutorialsIndex
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Tutorial index
+
+An index of tutorials for developing NetBeans modules can be found on the link:http://www.netbeans.org/kb/trails/platform.html[http://www.netbeans.org/kb/trails/platform.html] site.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTutorialsIndex[http://wiki.netbeans.org/DevFaqTutorialsIndex] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:03:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeDeduction.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeDeduction.asciidoc
new file mode 100644
index 0000000..71db240
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeDeduction.asciidoc
@@ -0,0 +1,104 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTweakRegistryByCodeDeduction
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I remove a menu item or toolbar button from an application's GUI?
+
+* If you want to remove the action from a toolbar, then remove entries like:
+[source,xml]
+----
+
+<folder name="Toolbars">
+ <folder name="Build">
+ <file name="org-nvarun-tat-SayCheez.shadow">
+ <attr name="originalFile"
+ stringvalue="Actions/Tools/org-nvarun-tat-SayCheez.instance"/>
+ <attr name="position" intvalue="325"/>
+ </file>
+ </folder>
+</folder>
+
+----
+
+* If you want to remove either one of the _separators_, or even both of them, then delete the entries looking like:
+[source,xml]
+----
+
+<file name="org-nvarun-tat-separatorAfter.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ <attr name="position" intvalue="175"/>
+</file>
+<file name="org-nvarun-tat-separatorBefore.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ <attr name="position" intvalue="125"/>
+</file>
+
+----
+
+* If you want to remove the action from a menu, and retain it only on the toolbar, then remove entries like:
+[source,xml]
+----
+
+<folder name="Menu">
+ <folder name="Tools">
+ <file name="org-nvarun-tat-SayCheez.shadow">
+ <attr name="originalFile"
+ stringvalue="Actions/Tools/org-nvarun-tat-SayCheez.instance"/>
+ <attr name="position" intvalue="150"/>
+ </file>
+ <file name="org-nvarun-tat-separatorAfter.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ <attr name="position" intvalue="175"/>
+ </file>
+ <file name="org-nvarun-tat-separatorBefore.instance">
+ <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/>
+ <attr name="position" intvalue="125"/>
+ </file>
+ </folder>
+</folder>
+
+----
+
+* If you want to remove an item from a module over which you have no control, such as a NetBeans Platform module, use the _hidden attribute:
+[source,xml]
+----
+
+<folder name="Toolbars">
+ <folder name="Build">
+ <file name="org-nvarun-tat-SayCheez_hidden"/>
+ </folder>
+</folder>
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTweakRegistryByCodeDeduction[http://wiki.netbeans.org/DevFaqTweakRegistryByCodeDeduction] ,
+that was last modified by NetBeans user Geertjan
+on 2012-01-23T21:45:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeReplacement.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeReplacement.asciidoc
new file mode 100644
index 0000000..7865729
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqTweakRegistryByCodeReplacement.asciidoc
@@ -0,0 +1,116 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqTweakRegistryByCodeReplacement
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I have only shortcut keys for an action?
+
+The *New Action* wizard allows you to uncheck both menu and toolbar placement for your action and only assign a keyboard shortcut. To learn how to do this manually, read on.
+Refer to link:TaT_HackingNetBeansXMLLayerPartOne.html[TaT_HackingNetBeansXMLLayerPartOne] for more details.
+
+==== Trick #1
+
+* Retain the action's basic registration:
+[source,xml]
+----
+
+<folder name="Actions">
+ <folder name="Tools">
+ <file name="org-nvarun-tat-SayCheez.instance"/>
+ </folder>
+</folder>
+
+----
+
+* This registers an action as a *Global Menu Item*:
+[source,xml]
+----
+
+<folder name="Menu">
+ <folder name="Tools">
+ <file name="org-nvarun-tat-SayCheez.shadow">
+ <attr name="originalFile"
+ stringvalue="Actions/Tools/org-nvarun-tat-SayCheez.instance"/>
+ <attr name="position" intvalue="150"/>
+ </file>
+ </folder>
+</folder>
+
+----
+
+* This registers an action as a *Global Toolbar Button*:
+[source,xml]
+----
+
+<folder name="Toolbars">
+ <folder name="Build">
+ <file name="org-nvarun-tat-SayCheez.shadow">
+ <attr name="originalFile"
+ stringvalue="Actions/Tools/org-nvarun-tat-SayCheez.instance"/>
+ <attr name="position" intvalue="325"/>
+ </file>
+ </folder>
+</folder>
+
+----
+
+* To assign a shortcut key, replace either or both of them with something like the following:
+[source,xml]
+----
+
+<folder name="Shortcuts">
+ <file name="O-F3.shadow">
+ <attr name="originalFile"
+ stringvalue="Actions/Tools/org-nvarun-tat-SayCheez.instance"/>
+ </file>
+</folder>
+
+----
+
+==== Trick #2
+
+* In the above example the action has the shortcut key *Alt+F3*, which is represented as `O-F3`. In general, if you have some key combination that uses *Alt* (or the equivalent on Mac OS X), then use `O`. Separate modifiers from the base keycode name with `-`, and append `.shadow` for the filename. *Ctrl* (or its Mac equivalent) is represented by `D`, and *Shift*by `S`. (`C` and `A` represent the literal *Ctrl* and *Alt* keys, but this is less portable.)
+
+==== Tips to Remember
+
+1. Following are some keycode equivalents. See Javadoc for `KeyEvent` for the full list:
+* *A* to *Z* (as is), *F1* to *F12* (as is), *0* to *9* (as is)
+* */* as `SLASH`, *\* as `BACK_SLASH`
+* *;* as `SEMI_COLON`
+* *.* as `PERIOD`
+* *?* as `QUOTE`
+
+See also link:DevFaqKeybindings.html[DevFaqKeybindings].
+
+(Reposted from link:http://netbeans.dzone.com/tips/play-with-xml-layer[this entry on NetBeans Zone].)
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqTweakRegistryByCodeReplacement[http://wiki.netbeans.org/DevFaqTweakRegistryByCodeReplacement] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:39:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUIGestures.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUIGestures.asciidoc
new file mode 100644
index 0000000..c963b3a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUIGestures.asciidoc
@@ -0,0 +1,53 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUIGestures
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== DevFaqUIGestures
+
+A perfect tool to get you know users of your application. link:UIGesturesCollector.html[Read more...].
+
+== How should the LogRecords be named
+
+Use link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/logging.html[structured logging] e.g. use just a machine name for a log record's message and keep its localized version in a Bundle. Set the logger name to be below the namespace {org.netbeans.ui} in some meaningful subpackage.
+
+The statistic on the server shall then recognize the logger name as well as the message.
+
+== How to verify that my "agent" is logging correctly?
+
+Make sure the interactive gestures collector is installed. Make "Memory" toolbar visible. Execute the action that does the logging. Invoke the icon in the "memory" toolbar and "View Data". Use the combo box to scroll to the right message - which anyway should be somewhere at the bottom of the displayed file.
+
+== How to find out existing logger
+
+They are listed at link:UIGesturesCollector.html[UIGesturesCollector].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUIGestures[http://wiki.netbeans.org/DevFaqUIGestures] ,
+that was last modified by NetBeans user Dsimonek
+on 2009-12-03T16:04:18Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUIResponsiveness.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUIResponsiveness.asciidoc
new file mode 100644
index 0000000..682abea
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUIResponsiveness.asciidoc
@@ -0,0 +1,48 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUIResponsiveness
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I am developing a NetBeans module. What performance criteria should it satisfy?
+
+All NetBeans modules should behave responsibly with regard to performance. They must not affect startup time negatively, they must not increase memory footprint significantly, and they must be responsive at all times.
+
+* *startup* - module initialization should be as lazy as possible, not to increase startup time
+* *memory footprint* - heap space allocated by module's data structures should be freed as soon as not needed; excessive caching of data is not good
+* *UI responsiveness* - a module's actions, menus and windows should satisfy the UI responsiveness guidelines as stated in link:UI_Responsiveness.html[UI_Responsiveness]
+
+---
+Applies to: NetBeans 6.5 and above
+
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUIResponsiveness[http://wiki.netbeans.org/DevFaqUIResponsiveness] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T20:16:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUiDefaultsPropsNotFound.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUiDefaultsPropsNotFound.asciidoc
new file mode 100644
index 0000000..16c2821
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUiDefaultsPropsNotFound.asciidoc
@@ -0,0 +1,73 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUiDefaultsPropsNotFound
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why can't I load properties using UIDefaults?
+
+You may encounter this problem while porting a Swing application to the NetBeans platform or when using a third-party library like SwingX. While the following code works in a standalone Swing application, it does not load the property in a platform-based application:
+
+[source,java]
+----
+
+UIManager.getDefaults().addResourceBundle("com.example.foo.sample");
+myLabel.setText(UIManager.getString("greeting"));
+----
+
+This fails in the platform because of link:http://bugs.sun.com/view_bug.do?bug_id=4834404[JDK bug #4834404].
+Although the best solution is to replace the original code to load properties in a way that uses the correct class loader,
+that may not be possible when using a third-party library.
+In these cases, your module can work around the problem by using code similar to this:
+
+[source,java]
+----
+
+UIDefaults def = UIManager.getDefaults();
+ResourceBundle bundle = ResourceBundle.getBundle("com.example.foo.sample");
+Enumeration<String> e = bundle.getKeys();
+while (e.hasMoreElements()) {
+ String key = e.nextElement();
+ def.put(key, bundle.getString(key));
+}
+----
+
+Yet another alternative is to ensure the resource bundles are available to the startup classloader.
+You can do this by placing the JAR containing the resource bundles
+in the `lib` subdirectory of your `platform` cluster,
+although this workaround has not been tested.
+
+Note: An (untested) possible workaround is to first call UIManager.put ("ClassLoader", Lookup.getDefault().lookup(ClassLoader.class)).
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUiDefaultsPropsNotFound[http://wiki.netbeans.org/DevFaqUiDefaultsPropsNotFound] ,
+that was last modified by NetBeans user Jpirek
+on 2011-11-28T08:19:13Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUnexpectedExceptionDialog.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUnexpectedExceptionDialog.asciidoc
new file mode 100644
index 0000000..26bc5b8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUnexpectedExceptionDialog.asciidoc
@@ -0,0 +1,54 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUnexpectedExceptionDialog
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I suppress the Unexpected Exception dialog?
+
+If your code generates an uncaught exception at runtime or uses `Logger.log(Level l, String s, Throwable t)` with level => 900 (`Level.WARNING`), NetBeans will display a dialog box which can show the details of that exception to the user.
+This is a welcome alternative to simply crashing the application,
+and provided you have written solid code,
+your user should never see this dialog anyway.
+
+But it is impossible to handle every possible exception or error,
+and some developers might wish to simply suppress this dialog
+so that the application neither crashes nor alerts the user that an uncaught exception/error was thrown.
+You can do this by link:DevFaqPlatformRuntimeProperties.html[setting a system property at runtime]
+named `netbeans.exception.report.min.level`.
+The exact value of this property will depend on certain factors such as whether or not assertions are enabled,
+but using a very high value such as `99999` should prevent the dialog from ever being shown automatically.
+
+The above on its own doesn't suppress the exception dialog entirely - the dialog will still be shown if the user clicks on the error icon. To suppress that too, set `netbeans.exception.alert.min.level` to a high value as well (i.e. `99999`). This means your users will not even know there was a problem, and will have no opportunity to find out (or report it) unless they scan their log file.
+
+See link:http://forums.netbeans.org/ptopic16746.html[http://forums.netbeans.org/ptopic16746.html] for details on how to set properties within NetBeans and in final applications.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUnexpectedExceptionDialog[http://wiki.netbeans.org/DevFaqUnexpectedExceptionDialog] ,
+that was last modified by NetBeans user Jglick
+on 2011-08-29T14:59:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUriVsUrl.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUriVsUrl.asciidoc
new file mode 100644
index 0000000..31db8e9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUriVsUrl.asciidoc
@@ -0,0 +1,110 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUriVsUrl
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== URIs and URLs
+
+*Q:* What is the difference?
+
+*A:* A URL is a kind of URI. URNs such as
+`urn:oasis:foo` are URIs but not URLs.
+
+*Q:* Should I use `java.net.URI` or `java.net.URL`?
+
+*A:* Whichever is more convenient. `URL`s must use a registered
+URL protocol and cannot handle URNs; there is slightly more overhead
+in making a URL than a URI, but not much. `URI` provides better methods
+for relativizing and canonicalizing URLs as well as other operations
+on the syntactic structure. To directly load content you need to use a
+URL. `URI` seems to have difficulty with the `jar` protocol.
+
+*Q:* Can I interconvert `URI`s and `URL`s?
+
+*A:* Yes, use `uri.toURL()` and
+`URI.create(url.toExternalForm())`.
+
+*Q:* Can I interconvert `File`s and `URI`s?
+
+*A:* Easily. Use `file.toURI()`. In the other
+direction, use `new File(uri)`.
+
+For `URL`s, go through `URI`. _Never_ use
+`file.toURL()`; it does not handle unusual characters
+correctly.
+
+_Careful_ with file URLs/URIs denoting directories. NetBeans
+APIs generally expect these to end in a slash
+(`/`). However `file.toURI()` will not end in a
+slash if the file does not currently exist! Be sure to check if the
+URI ends in a slash and add one if not, if you in fact know that the
+`File` is intended to represent a directory.
+
+*Q:* Can I interconvert `FileObject`s and URLs?
+
+*A:* Use `fileObject.getURL()`, or
+`URLMapper` methods for more control over the kind of
+returned protocol; in the other direction, use
+`URLMapper.findFileObject(url)`.
+
+For URIs, go through URL.
+
+*Q:* How do `jar` URLs work?
+
+*A:* Unlike e.g. `URLClassLoader`, in the NetBeans
+APIs `file:/tmp/foo.jar` refers to the raw byte contents of
+`foo.jar`. To refer to the root entry of the JAR (e.g. for
+use as a classpath entry) you _must_ use
+`jar:file:/tmp/foo.jar!/`. `FileUtil` has
+methods (`getArchiveFile`, `getArchiveRoot`, and
+`isArchiveFile`) to help you convert between these
+representations.
+
+*Q:* Which URL protocols are used in NetBeans?
+
+*A:* Several, including some custom protocols:
+
+* `file` - for representing files on disk.
+* `jar` - for representing entries inside JARs and ZIPs, including the root directory entry.
+* `nbres` - a resource loaded from a NetBeans module (or technically the cross-module class loader), e.g. `nbres:/org/netbeans/modules/foo/resources/foo.dtd` may load the same thing as `jar:file:/opt/netbeans/ide4/modules/org-netbeans-modules-foo.jar!/org/netbeans/modules/foo/resources/foo.dtd`.
+* `nbresloc` - same, but transparently localized and branded according to the usual conventions, e.g. `nbresloc:/org/netbeans/modules/foo/resources/foo.html` may actually load the same thing as `nbres:/org/netbeans/modules/foo/resources/foo''nb''ja.html`.
+* `nbdocs` - same as `nbresloc` but also searches in `docs/` subfolders of installation directories, e.g. `nbdocs:/org/netbeans/modules/usersguide/ide.css` may work like `file:/opt/netbeans/ide4/docs/org/netbeans/modules/usersguide/ide.css`.
+* `nbinst` - loads installation files using `InstalledFileLocator` in installation directories, e.g. `nbinst:///modules/ext/some-lib.jar` may load the same thing as `file:/opt/netbeans/ide4/modules/ext/some-lib.jar`.
+* `nbfs` - refers to a file object. As of NetBeans 4.0 there are no user-mounted filesystems so this is only useful to refer to file objects in the system filesystem (XML layers). For example, `nbfs:/SystemFileSystem/Templates/Other/html.html` refers to an HTML file templates installed in the IDE.
+
+Also note that, unlike `java.net.URL`, `URI.equals()` does not make a network connection to determine equality. Never put URLs into a HashSet or similar equality-testing collection for this reason.
+
+--
+
+Applies to: NetBeans 4.0, 4.1, 5.0, 5.5, 6.0, 6.1, 6.5, 6.7
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUriVsUrl[http://wiki.netbeans.org/DevFaqUriVsUrl] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T05:45:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUseNativeInstaller.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUseNativeInstaller.asciidoc
new file mode 100644
index 0000000..bdc9009
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUseNativeInstaller.asciidoc
@@ -0,0 +1,219 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUseNativeInstaller
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I run the installer for something else during module installation?
+
+Sometimes you are distributing some software with your module which has its own installer, or some other similar code which needs to be run once to get everything needed installed on the user's system. If you are distributing some software (which perhaps you did not write), and it has its own installer, it is
+less work to just run its installer to be sure it is set up correctly, than to have your module do everything which that installer does too (and possibly get something wrong).
+
+link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/overview-summary.html[Autoupdate Services] primary handles NetBeans plugins based on link:DevFaqWhatIsNbm.html[NBM] packaging.
+
+In addition, Autoupdate Services offers the possibility to install/uninstall components which are not in NBM format. This possibility has been designed to support such use-cases - for example, to install an application Servers such as link:http://glassfish.dev.java.net[GlassFish] by running its own installer.
+
+Using a native installer ensures that, if there are any problems with the way the software gets installed, it is a problem with the native installer, not your code.
+
+To enable such possibility, Autoupdate Services API provides:
+
+* An SPI for providing such components
+* A custom installer can be assigned to the component which performs installation particular component into NetBeans
+* The ability to register that link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/UpdateProvider.html[special provider] among other of providers - a common Update Center
+
+==== How to setup a Update Provider providing custom components?
+
+Implement interface link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/UpdateProvider.html[UpdateProvider] to make a provider for your component that has its own installer. This provider has to:
+
+* Determine if the component is already installed on the target system.
+* If so, it should be able to tell which version, so the system knows if the bundled version is older, newer or the same version
+* Offer a component which is available to be installed into system,
+* Assign a specific *installer* which can install available components,
+* assign a specific *uninstaller* which can uninstall such component if is already installed
+* Register the application (i.e. store a path to the installed copy of the application) so that, at runtime, code that needs to use the custom-installed software can find it
+
+==== A code snippet showing that provider
+
+[source,java]
+----
+
+public class FooNativeComponentProvider implements org.netbeans.spi.autoupdate.UpdateProvider {...}
+----
+
+It has simple methods describing the provider, like this:
+
+[source,java]
+----
+
+ public String getName () {
+ return "Foo Update Provider";
+ }
+
+ public String getDisplayName () {
+ return getName ();
+ }
+
+ public String getDescription () {
+ return "Providing components with custom installers";
+ }
+
+ public CATEGORY getCategory () {
+ return CATEGORY.STANDARD;
+ }
+----
+
+The essential method *`getUpdateItems`* will return link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/UpdateItem.html[UpdateItems] which matches these components. It has to return an `UpdateItem` both for installed component and for available component what has not been installed yet.
+
+[source,java]
+----
+
+ public Map<String, UpdateItem> getUpdateItems () throws IOException {
+ Map<String, UpdateItem> res = new HashMap<String, UpdateItem> ();
+
+
+ // 1. provide already installed version
+
+ // get installed version
+ String installed = NbPreferences.forModule (FooNativeComponentProvider.class).get (FOO_CODE_NAME, null);
+
+ // some foo-native-runtime is installed
+ if (installed != null) {
+ res.put (FOO_CODE_NAME + installed, getInstalledUpdateItem (installed));
+ }
+
+ // 2. provide also version available to install
+
+ // for this example: If none version hasn't been installed yet then provider the version 3.0
+ if (installed == null) {
+ res.put (FOO_CODE_NAME + "_3.0", getAvailableUpdateItem ("3.0"));
+
+ // if the version 3.0 is installed then provide newer version 3.1
+ } else if ("3.0".equals (installed)) {
+ res.put (FOO_CODE_NAME + "_3.1", getAvailableUpdateItem ("3.1"));
+ }
+
+ return res;
+ }
+----
+
+There are two factory methods *`getInstalledUpdateItem`* and *`getAvailableUpdateItem`*. Both are using SPI link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/UpdateItem.html#createNativeComponent(java.lang.String,%20java.lang.String,%20java.lang.String,%20java.util.Set,%20java.lang.String,%20java.lang.String,%20java.lang.Boolean,%20java.lang.Boolean,%20java.lang.String,%20org.netbeans.spi.autoupdate.CustomInstaller,%20org.netbeans.spi.autoupdate.UpdateLicense)[UpdateItem.create(Installed)NativeComponent]
+
+Add an `UpdateItem` matching available component first. The provider has to specify a name, display name, download size and so forth.
+
+The most important parts are link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/CustomInstaller.html[CustomInstaller] and link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-autoupdate-services/org/netbeans/spi/autoupdate/CustomUninstaller.html[CustomUninstaller]. For example:
+
+[source,java]
+----
+
+ private static UpdateItem getAvailableUpdateItem (String specificationVersion) {
+ String displayName = "Foo Runtime " + specificationVersion;
+ String description = "Foo Runtime " + specificationVersion + " with native installer";
+ String downloadSize = "2815";
+ CustomInstaller ci = FooInstaller.getInstaller ();
+ assert ci != null;
+ UpdateLicense license = UpdateLicense.createUpdateLicense ("none-license", "no-license");
+ UpdateItem item = UpdateItem.createNativeComponent (
+ FOO_CODE_NAME,
+ specificationVersion,
+ downloadSize,
+ null, // dependencies
+ displayName,
+ description,
+ false, false, "my-cluster",
+ ci,
+ license);
+ return item;
+ }
+----
+
+Now, for an already-installed copy of the software:
+
+[source,java]
+----
+
+ private static UpdateItem getInstalledUpdateItem (String specificationVersion) {
+ String displayName = "Foo Runtime " + specificationVersion;
+ String description = "Foo Runtime " + specificationVersion + " with own installer";
+ CustomUninstaller cu = FooUninstaller.getUninstaller ();
+ assert cu != null;
+ UpdateItem item = UpdateItem.createInstalledNativeComponent (
+ FOO_CODE_NAME,
+ specificationVersion,
+ null, // dependencies
+ displayName,
+ description,
+ cu);
+ return item;
+ }
+----
+
+So, what does a custom installer look like? It it quite simple, look on
+
+[source,java]
+----
+
+public class FooInstaller implements org.netbeans.spi.autoupdate.CustomInstaller {
+ /** This code will be called back while installing the corresponding native component
+ * from Plugin Manager Install Wizard.
+ */
+ public boolean install (String codeName, String specificationVersion, ProgressHandle handle) throws OperationException {
+ // CustomInstaller has to start `org.netbeans.api.progress.ProgressHandle` !!!
+ handle.start ();
+
+ // a custom code which invokes installation of native component actually
+ .......
+ }
+}
+----
+
+==== How to register UpdateProvider in my application?
+
+Using link:DevFaqModulesGeneral.html[META-INF/services] or (in NetBeans 6.9) the `@ServiceProvider` annotation (see link:https://blogs.oracle.com/geertjan/entry/meta_inf_services_vs_layer[Geertjan's blog for more info]):
+
+1. Make a `META-INF/services` folder in sources of your NetBeans project where the provider is,
+2. Make a file `org.netbeans.spi.autoupdate.UpdateProvider` in this folder,
+3. Type name of class where `UpdateProvider` implemented, i.e. org.netbeans.modules.fooupdateprovider.FooNativeComponentProvider
+
+And , that's it, the NetBeans Lookup system will read it and includes that provider among other providers registered in NetBeans application.
+
+==== A sample project having this UpdateProvider
+
+* Sources of `Foo Native Component Provider`: link:Media:fooupdateprovider_FaqDevComponentWithCustomInstaller.zip.html[fooupdateprovider_FaqDevComponentWithCustomInstaller.zip]
+* Binary NBM to playing with: link:Media:org-netbeans-modules-fooupdateprovider_FaqDevComponentWithCustomInstaller.nbm.html[org-netbeans-modules-fooupdateprovider_FaqDevComponentWithCustomInstaller.nbm]
+
+==== Important Note
+
+Don't apply this Update Provider earlier than NetBeans 6.5 release will be out. There were several problem which had to be fixed in NetBeans 6.5. Use link:http://www.netbeans.org/downloads/index.html[NetBeans 6.5] or some of recent link:http://bits.netbeans.org/dev/nightly/latest/[Development builds] rather than previous releases 6.1 or 6.0!
+
+-
+Do not hesitate to contact me on mailto:jrechtacek@netbeans.org if you have any question.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUseNativeInstaller[http://wiki.netbeans.org/DevFaqUseNativeInstaller] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:12:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUseSounds.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUseSounds.asciidoc
new file mode 100644
index 0000000..1e40532
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUseSounds.asciidoc
@@ -0,0 +1,214 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUseSounds
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+This is quite straight forward. This is code from a module in SodBeans but its so simple that it is easier just to copy and paste the code.
+
+Add a dependency on
+Create your module and add a file named SoundPlayer with this contents:
+
+[source,java]
+----
+
+package <your package>;
+
+import java.io.File;
+import org.openide.modules.InstalledFileLocator;
+
+/**
+ *
+ * @author Andreas Stefik, with code borrowed from the web
+ */
+public class SoundPlayer {
+
+ private static String soundFileRoot = "sound";
+ private static String codeNameBase = "<code name base>";
+ private static File root = null;
+ private static SoundPlayer player = null;
+
+ /**
+ * @return the soundFileRoot
+ */
+ public static String getSoundFileRoot() {
+ return soundFileRoot;
+ }
+
+ /**
+ * @param aSoundFileRoot the soundFileRoot to set
+ */
+ public static void setSoundFileRoot(String aSoundFileRoot) {
+ soundFileRoot = aSoundFileRoot;
+ }
+
+ /**
+ * @return the codeNameBase
+ */
+ public static String getCodeNameBase() {
+ return codeNameBase;
+ }
+
+ /**
+ * @param aCodeNameBase the codeNameBase to set
+ */
+ public static void setCodeNameBase(String aCodeNameBase) {
+ codeNameBase = aCodeNameBase;
+ }
+
+ private SoundPlayer() {
+ File file = InstalledFileLocator.getDefault().locate(
+ soundFileRoot, codeNameBase, false);
+ root = file;
+ }
+
+ public static synchronized SoundPlayer instance() {
+ root = InstalledFileLocator.getDefault().locate(
+ soundFileRoot, codeNameBase, false);
+ if (player == null) {
+ player = new SoundPlayer();
+ }
+ return player;
+ }
+
+ public void play(String name) {
+ ThreadedSound sound = new ThreadedSound();
+ File file = new File(root.getAbsolutePath() + "/" + name);
+ String path = file.getAbsolutePath();
+ sound.setSoundFile(path);
+ Thread thread = new Thread(sound);
+ thread.start();
+ }
+}
+
+----
+
+Create your module and add a file named ThreadedSound with this contents:
+
+[source,java]
+----
+
+package <your package>;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import javax.sound.sampled.*;
+
+/**
+ *
+ * @author Andreas Stefik
+ */
+public class ThreadedSound implements Runnable {
+
+ private final int BUFFER_SIZE = 128000;
+ private AudioInputStream audioStream;
+ private AudioFormat audioFormat;
+ private SourceDataLine sourceLine;
+ private String soundFile = "";
+
+ @Override
+ public void run() {
+ play();
+ }
+
+ private void play() {
+ try {
+ File path = new File(getSoundFile());
+ audioStream = AudioSystem.getAudioInputStream(path);
+
+ audioFormat = audioStream.getFormat();
+
+ DataLine.Info info = new DataLine.Info(SourceDataLine.class, audioFormat);
+ try {
+ sourceLine = (SourceDataLine) AudioSystem.getLine(info);
+ sourceLine.open(audioFormat);
+ } catch (LineUnavailableException ex) {
+ Logger.getLogger(ThreadedSound.class.getName()).log(Level.SEVERE, null, ex);
+ } catch (Exception ex) {
+ Logger.getLogger(SoundPlayer.class.getName()).log(Level.SEVERE, null, ex);
+ }
+
+
+ sourceLine.start();
+
+ int nBytesRead = 0;
+ byte[] abData = new byte[BUFFER_SIZE];
+ while (nBytesRead != -1) {
+ try {
+ nBytesRead = audioStream.read(abData, 0, abData.length);
+ } catch (IOException ex) {
+ Logger.getLogger(ThreadedSound.class.getName()).log(Level.SEVERE, null, ex);
+ }
+ if (nBytesRead >= 0) {
+ sourceLine.write(abData, 0, nBytesRead);
+ }
+ }
+
+ sourceLine.drain();
+ sourceLine.close();
+
+ } catch (UnsupportedAudioFileException ex) {
+ Logger.getLogger(ThreadedSound.class.getName()).log(Level.SEVERE, null, ex);
+ } catch (IOException ex) {
+ Logger.getLogger(ThreadedSound.class.getName()).log(Level.SEVERE, null, ex);
+ }
+ }
+
+ /**
+ * @return the soundFile
+ */
+ public String getSoundFile() {
+ return soundFile;
+ }
+
+ /**
+ * @param soundFile the soundFile to set
+ */
+ public void setSoundFile(String soundFile) {
+ this.soundFile = soundFile;
+ }
+}
+
+----
+
+To use it just place the sound file in the appropriate folder and use:
+
+[source,java]
+----
+
+SoundPlayer.instance().play("<file name>");
+----
+
+To make your application talk, see link:DevFaqMakeItTalk.html[DevFaqMakeItTalk]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUseSounds[http://wiki.netbeans.org/DevFaqUseSounds] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2011-09-19T21:46:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUserDir.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUserDir.asciidoc
new file mode 100644
index 0000000..1e9f6dd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUserDir.asciidoc
@@ -0,0 +1,76 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUserDir
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the user directory, what is in it, and why do I need one?
+
+The userdir is a directory passed to NetBeans on startup by the launch script.
+You can specify it on the command line, e.g.:
+
+[source,java]
+----
+
+--userdir /tmp/some/folder/that/need/not/exist/yet
+----
+
+It contains configuration data that allows NetBeans to restore its state after shutdown;
+it also contains log files and other miscellaneous artifacts of running NetBeans.
+The `config/` subfolder of the userdir
+is where changes made at runtime to the system filesystem (link:DevFaqSystemFilesystem.html[DevFaqSystemFilesystem])
+are written.
+
+Some new modules installed by Plugin Manager will also be installed here, as if it were a "cluster" directory (such as `platform` or similar in a NetBeans IDE or Platform installation). NBMs which specify a particular cluster name will not be placed in the user directory, however.
+
+It is expected that applications built on the NetBeans platform
+will provide a custom launch script which will specify the userdir
+such that it does not overlap with any other platform-based application.
+This is done for you if you use the stock launchers created by "suite" projects in the IDE.
+
+Only one running copy of NetBeans may use a single userdir at a time;
+during startup, the platform checks a lock file and if it is present,
+tries to contact the running instance via a socket,
+to determine if the lock file is stale or not.
+If it does not make contact, it will display a warning
+and ask the user if startup should continue.
+This same protocol also supports link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-sendopts/overview-summary.html[command-line options].
+
+You can find the path to the userdir at runtime if you need to,
+using the system property `netbeans.user`.
+Most modules should not do this;
+use `Places.getUserDirectory` to find the userdir or use `FileUtil.getConfigFile`
+to work with the `config/` subdirectory.
+
+<hr/>
+Applies to: NetBeans 6.7 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUserDir[http://wiki.netbeans.org/DevFaqUserDir] ,
+that was last modified by NetBeans user Frederic.deniger
+on 2012-11-01T17:21:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUsingSimpletests.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUsingSimpletests.asciidoc
new file mode 100644
index 0000000..20a5e9c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUsingSimpletests.asciidoc
@@ -0,0 +1,101 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUsingSimpletests
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+During development of the 6.5 series, an effort was made to improve testing by inherent support for tests in NetBeans build scripts (also known as the _build harness_). Therefore, unit and functional tests for platform applications are now supported _out of the box_ in NetBeans 6.5 and later. This effort is sometimes called "simpletests" because it greatly simplifies the work necessary to do such tests on your application. link:FitnessTestsWithoutX.html[More information about simpletests] can be found in the Wiki.
+
+==== NbModuleSuite
+
+Right link:API.html[API] for starting the test inside link:apidesign:NetBeans_Runtime_Container.html[NetBeans Runtime Container] is provided in form of link:http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-nbjunit/org/netbeans/junit/NbModuleSuite.html[NbModuleSuite]. Add *suite* method into your test class to fully emulate link:NetBeans.html[NetBeans] environment:
+
+[source,java]
+----
+
+ public static Test suite() {
+ return NbModuleSuite.create(YourTest.class);
+ }
+----
+
+==== JUnit Version
+
+NetBeans 6.5 now supports JUnit 4.x, via the `JUnit 4` module in the `platform` cluster. If you're not familiar with the difference, this link:http://www.ociweb.com/jnb/jnbAug2007.html[helpful article explains the changes from JUnit 3 and JUnit 4]. Put simply, the main difference from a user's point of view is is one of syntax and style. The tests you've already written against 3.x will continue to run under 4.x. And although you could continue writing new tests using the 3.x syntax if you wanted, it's much easier to have NetBeans generate the test stubs for you (Tools -> Create JUnit Tests or `Ctrl+Shift+U`). Starting with NetBeans 6.5, any new tests will be generated using the JUnit 4.x style.
+
+==== Code Coverage
+
+See link:CodeCoverage.html[Code Coverage].
+
+==== Setting up functional tests for a Platform Application
+
+The testing libraries are included as modules in the build harness, so you will need to include the harness cluster in your application before you can support tests. This is easily done through the IDE:
+
+* Right click your suite's node in the project view
+* Choose "Properties"
+* Click "Libraries" on the left
+* Check the "harness" box and add the entire harness cluster.
+* Now click the platform cluster (was platform<number> for 6.8 and older releases)
+* Check the boxes against the MultiView Windows and Visual Library API.
+
+Now you must set up the structure under your module:
+
+* Go to the 'file' view, and expand your modules node
+* In the test folder, create a folder named 'qa-functional'. Underneate that, create the folder src.
+* Under the test dir you should now have two folders, unit and qa-functional. Under each of those should be an src folder.
+* Restart the IDE, there should now be two new Nodes in that Module?s Project Tab: Functional Test Packages and Functional Test Libraries
+* Right-click the Functional Test Libraries ?> Add Functional Test Dependencies, then add jemmy, nbjunit, jellytools platform, jellytools and junit4
+
+It should now be possible to run a class that extends JellyTestCase, and for the IDE to display this correctly.
+
+Support for functional tests on Maven-based NetBeans applications should be present from 7.0, with the resolution of link:http://netbeans.org/bugzilla/show_bug.cgi?id=190992[http://netbeans.org/bugzilla/show_bug.cgi?id=190992] For more information, see link:http://netbeans.dzone.com/nb-mvn-functional-tests[http://netbeans.dzone.com/nb-mvn-functional-tests]
+
+==== TODO
+
+* Describe how to set up a new unit test from scratch
+* Describe how to set up a new functional test from scratch
+* Describe adding support for external testing libraries (e.g. FIT, TestNG or marathon)
+* Describe how to set up additional test types (e.g. performance)
+* Describe how to configure suite `build.xml` to remove `harness` from ZIP distribution
+* Describe how to run tests under automated build using Hudson
+
+==== NOTES
+
+MockLookup and other link:http://wiki.netbeans.org/UsefulTestClassesInModules[classes mentioned on the Useful Test Classes in Modules] are not available in the platform.
+
+* You can add additional libraries needed for unit tests by setting the `test.unit.cp.extra` property (e.g. in the module's project.properties file) to point to those libraries. It does not matter where these libraries (JAR files) reside, and you can refer to them using a hardcoded path (BAD) or via a relative path -- even using `$suite.dir` as a starting point in case they're used by multiple modules in the suite. In the latter case, you can define the test.unit.cp.extra property in the suite's platform.properties (NOT project.properties) file. Be aware that this may limit your ability to define additional things at the individual module level, so it might be better to define a standard suite-wide property like `standard.unit.test.libs` to point to things used throughout the suite, then have individual modules define `test.unit.cp.extra` to include this plus potentially some other things. Items defined in the `test.unit.cp.extra` property are used at both compile time and runti
me, it seems.
+* The `test.qa-functional.cp.extra` property works the same way for functional tests.
+* There is a property `extra.test.libs.dir` tersely described in the harness README that makes it sound like a great way to define a place for extra testing libraries that will be picked up automatically during tests, but I could not get it to work. Or at least things in that directory were not found at compile time.
+
+==== Converting Tests for Applications Which Previously Used XTest
+
+Essentially, you need only remove the XTest build and configuration files from your modules and replace them with a few lines of code in your tests' `suite()` method. More information is available in the link:http://wiki.netbeans.org/XTestReplacementCookBook[XTest Replacement Cookbook]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUsingSimpletests[http://wiki.netbeans.org/DevFaqUsingSimpletests] ,
+that was last modified by NetBeans user Stophi
+on 2012-02-14T17:58:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqUsingSubmenus.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqUsingSubmenus.asciidoc
new file mode 100644
index 0000000..606c10b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqUsingSubmenus.asciidoc
@@ -0,0 +1,49 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqUsingSubmenus
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I add submenus to context or main menus, instead of single menu items?
+
+Yes, any place where the APIs expect to have an item
+installed into a context or main menu, you can provide a submenu
+instead.
+
+Provide a dummy `Action` (it can be a do-nothing subclass of `javax.swing.AbstractAction`), or in some cases the class need not even be an `Action` at all. For context menus, implement the interface `link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.Popup.html[Presenter.Popup]` on your `Action`, and have it return a `JMenu` from `getPopupPresenter()`.
+
+Similarly, you can implement other subinterfaces of `link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.html[Presenter]` to provide a different component to display in toolbars or the main menu.
+
+*Note about using alternate components in the main menu:* If you want your action to work properly on Mac OS, you probably don't want to return anything other than a `JMenu` or `JMenuItem` from `getMenuPresenter()` if you implement link:http://www.netbeans.org/download/dev/javadoc/org-openide-util/org/openide/util/actions/Presenter.Menu.html[Presenter.Menu]. In general, Swing allows you to treat menu popups as generic Swing containers you can put what you like into. This is not true at all of the Mac OS screen menu bar - it expects normal menu items, and will not handle unusual contents for menus.
+
+If you just return a `JMenu` from `getPopupPresenter` or `getMenuPresenter` it will always be displayed, though you can conditionally disable it. If you wish to sometimes hide (not just disable) the submenu, make it implement link:http://www.netbeans.org/download/dev/javadoc/org-openide-awt/org/openide/awt/DynamicMenuContent.html[DynamicMenuContent] and you can make the submenu appear or disappear whenever you like (or even provide more than one menu item / submenu).
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqUsingSubmenus[http://wiki.netbeans.org/DevFaqUsingSubmenus] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:04:48Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqVersionNumber.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqVersionNumber.asciidoc
new file mode 100644
index 0000000..950ec6c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqVersionNumber.asciidoc
@@ -0,0 +1,106 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqVersionNumber
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I set the version number?
+
+There are two ways to set the version number shown in the Help... About dialog.
+
+* The easy way is to set the system property `netbeans.buildnumber` to some value in your application.
+* The harder way is to put this key/value `currentVersion=My Product 1.2.3` into the file named `"branding/modules/org-netbeans-core.jar/org/netbeans/core/ui/Bundle.properties"` below your suite, then rebuild and run.
+* In NB 6.5 and later is the file location different: `"branding/core/core.jar/org/netbeans/core/startup/Bundle.properties"`
+
+=== How do I set the version number automatically in maven-based applications?
+
+Within your branding-module use Maven placeholders in Bundle.properties and within the pom.xml filter the bundle by the maven-resources-plugin.
+
+*Note:* Some of the files below are ignored by default in version control by Netbeans so you might need to add them to preserve the changes.
+
+src/main/nbm-branding/core/core.jar/org/netbeans/core/startup/Bundle.properties:
+
+[source,java]
+----
+
+currentVersion=My app ${project.version}
+LBL_splash_window_title=Starting My app ${project.version}
+----
+
+src/main/nbm-branding/modules/org-netbeans-core-windows.jar/org/netbeans/core/windows/view/ui/Bundle.properties:
+
+[source,java]
+----
+
+CTL_MainWindow_Title=My app ${project.version}
+CTL_MainWindow_Title_No_Project=My app ${project.version}
+----
+
+src/main/nbm-branding/modules/org-netbeans-core.jar/org/netbeans/core/ui/Bundle.properties:
+
+[source,java]
+----
+
+LBL_ProductInformation=My app ${project.version}
+----
+
+pom.xml:
+
+[source,xml]
+----
+
+ <build>
+ <resources>
+ <resource>
+ <directory>${basedir}/src/main/nbm-branding</directory>
+ <!-- f.e. allow replacing ${project.version} in all property files below src/main/nbm-branding -->
+ <includes>
+ <include>**/*.properties</include>
+ </includes>
+ <filtering>true</filtering>
+ <targetPath>${basedir}/target/filtered-nbm-branding</targetPath>
+ </resource>
+ </resources>
+ <plugins>
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>nbm-maven-plugin</artifactId>
+ <configuration>
+ <!-- use previously filtered branding sources -->
+ <brandingSources>${basedir}/target/filtered-nbm-branding</brandingSources>
+ </configuration>
+ </plugin>
+ <!-- ... -->
+ </plugins>
+ </build>
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqVersionNumber[http://wiki.netbeans.org/DevFaqVersionNumber] ,
+that was last modified by NetBeans user Javydreamercsw
+on 2017-02-01T14:34:50Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqViewSaveTTVColumns.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqViewSaveTTVColumns.asciidoc
new file mode 100644
index 0000000..481d2d6
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqViewSaveTTVColumns.asciidoc
@@ -0,0 +1,144 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqViewSaveTTVColumns
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Saving Column Attributes of a TreeTableView
+
+Assuming you are embedding a `TreeTableView` (TTV) inside a `TopComponent`, you can override the `readExternal(ObjectInput)` and `writeExternal(ObjectOutput)` methods for preserving the attributes of the columns in your TTV (e.g. the column ordering, sorted-ness, sorting order, visibility, and width).
+
+Start by keeping a reference to the `Node.Property` array used to define the columns of the TTV, since there is no way to get those properties from the TTV (i.e. there is no `getProperties()` method). The examples below will refer to this `Node.Property` array as "columns".
+
+In order to get and set the column widths of the tree-table, we need to subclass `TreeTableView` and provide a `getTable()` method that returns the `treeTable` protected field of the `TreeTableView` class. In the examples below, this reference will be referred to as `treeTable` for brevity.
+
+First let us save the column attributes to the serialized `TopComponent` via the `writeExternal()` method.
+
+[source,java]
+----
+
+ public void writeExternal(ObjectOutput out) throws IOException {
+ super.writeExternal(out);
+ out.writeInt(columns.length);
+ for (int ii = 0; ii < columns.length; ii++) {
+ Boolean b = (Boolean) columns[Ii].getValue("InvisibleInTreeTableView");
+ if (b == null) {
+ b = Boolean.FALSE;
+ }
+ out.writeBoolean(b.booleanValue());
+ Integer i = (Integer) columns[Ii].getValue("OrderNumberTTV");
+ if (i == null) {
+ i = new Integer(ii);
+ }
+ out.writeInt(i.intValue());
+ b = (Boolean) columns[Ii].getValue("SortingColumnTTV");
+ if (b == null) {
+ b = Boolean.FALSE;
+ }
+ out.writeBoolean(b.booleanValue());
+ b = (Boolean) columns[Ii].getValue("DescendingOrderTTV");
+ if (b == null) {
+ b = Boolean.FALSE;
+ }
+ out.writeBoolean(b.booleanValue());
+ }
+ try {
+ TableColumnModel tcm = treeTable.getColumnModel();
+ int count = tcm.getColumnCount();
+ for (int index = 0; index < count; index++) {
+ TableColumn tc = tcm.getColumn(index);
+ out.writeInt(tc.getWidth());
+ }
+ } catch (IOException ioe) {
+ ErrorManager.getDefault().notify(ErrorManager.WARNING, ioe);
+ }
+ }
+
+----
+
+Next, we see how to deserialize the column attributes.
+
+[source,java]
+----
+
+ public void readExternal(ObjectInput in)
+ throws IOException, ClassNotFoundException {
+ super.readExternal(in);
+ try {
+ int count = in.readInt();
+ for (int ii = 0; ii < count; ii++) {
+ boolean b = in.readBoolean();
+ columns[Ii].setValue("InvisibleInTreeTableView", Boolean.valueOf(b));
+ int i = in.readInt();
+ columns[Ii].setValue("OrderNumberTTV", Integer.valueOf(i));
+ b = in.readBoolean();
+ columns[Ii].setValue("SortingColumnTTV", Boolean.valueOf(b));
+ b = in.readBoolean();
+ columns[Ii].setValue("DescendingOrderTTV", Boolean.valueOf(b));
+ }
+ } catch (Exception e) {
+ // Could be reading an old instance which is missing data.
+ // In any case, ignore this as there is no use in reporting it.
+ }
+ nodeView.setProperties(columns);
+
+ // Read the column widths from the stream immediately and save them
+ // to a final array for the Runnable below to access them.
+ TableColumnModel tcm = treeTable.getColumnModel();
+ int count = tcm.getColumnCount();
+ final int[[ | ]] widths = new int[Count];
+ try {
+ for (int index = 0; index < count; index++) {
+ widths[Index] = in.readInt();
+ }
+ } catch (IOException ioe) {
+ // Could be reading an old instance which is missing data.
+ // In any case, ignore this as there is no use in reporting it
+ // (and return immediately so as not to invoke the runnable).
+ return;
+ }
+
+ // Changing Swing widgets must be done on the AWT event thread.
+ EventQueue.invokeLater(new Runnable() {
+ public void run() {
+ // TreeTableView prohibits moving the tree
+ // column, so it is always offset zero.
+ setTreePreferredWidth(widths[0]);
+ for (int index = 1; index < widths.length; index++) {
+ setTableColumnPreferredWidth(index - 1, widths[Index]);
+ }
+ }
+ });
+ }
+
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqViewSaveTTVColumns[http://wiki.netbeans.org/DevFaqViewSaveTTVColumns] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T19:14:04Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWaysToRegisterInDefaultLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWaysToRegisterInDefaultLookup.asciidoc
new file mode 100644
index 0000000..a30761f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWaysToRegisterInDefaultLookup.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWaysToRegisterInDefaultLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Which Way Should I Use To Register an Object in the Default Lookup?
+
+There are two ways to put something in the link:DevFaqLookupDefault.html[default Lookup]:
+
+|===
+|What |When to Use It |How
+
+|Use the `@ServiceProvider` annotation |Most of the time, unless you are building with Maven. This annotation relies on NetBeans' build infrastructure to generate flat files in `META-INF/services` described below, at compile time. |Annotate your file with `@ServiceProvider(service=Something.class)`
+
+|Put an `.instance` file in your module layer in `Services/Hidden` |Rarely - useful if you are making services available dynamically on the fly, for example when link:DevFaqDynamicSystemFilesystem.html[dynamically changing layer contents], or when link:DevFaqFileAttributes.html[specialized registration metadata] or factory methods are needed |Declare a link:DevFaqInstanceDataObject.html[.instance file], a link:DevFaqDotSettingsFiles.html[.settings file] or similar, or a link:DevFaqDotShadowFiles.html[.shadow file] in your module's link:DevFaqModulesLayerFile.html[layer.xml file]
+|===
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWaysToRegisterInDefaultLookup[http://wiki.netbeans.org/DevFaqWaysToRegisterInDefaultLookup] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:28:44Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWeakListener.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWeakListener.asciidoc
new file mode 100644
index 0000000..0b657d7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWeakListener.asciidoc
@@ -0,0 +1,59 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWeakListener
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== What is a WeakListener
+
+When you attach a listener to another object, via, for example, an `addPropertyChangeListener()` method, that other object now holds a _reference_ to that listener.
+
+In Java, any object that is referenced by another object which is still in use (i.e. referenced by something else that is still alive, and so forth) cannot be garbage collected. One of the most frequent sources of memory leaks in Swing applications is attaching a listener to some long-lived object and never detaching the listener. The entire object graph of the listener and anything it references is held in memory, whether it is needed or not, until the object being listened to is finally garbage collected.
+
+Since listeners are often implemented as inner (non-static) classes of some other object, and an inner class keeps a reference to the object that created it, the outer object instance is kept in memory too.
+
+`link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/WeakListeners.html[WeakListeners]` is a factory class which wraps your event listener in another one, but it only _weakly_ (using `java.lang.ref.WeakReference`) references your actual listener. That means that, even though you are listening for changes, that will not block your listener from being garbage collected if nothing _else_ still references it.
+
+There is one caveat to using WeakListeners - if you do something like this:
+
+[source,java]
+----
+
+someObject.addPropertyChangeListener(WeakListeners.propertyChange(new PropertyChangeListener() {
+ public void propertyChange(PropertyChangeEvent evt) {
+ ...
+ }
+}, someObject);
+----
+
+in fact you _are not listening_ on someObject for any amount of time - the anonymous PropertyChangeListener you created will be instantly garbage-collected. So keep a reference to your listener when using WeakListeners.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWeakListener[http://wiki.netbeans.org/DevFaqWeakListener] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T06:12:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWeakListenerWhen.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWeakListenerWhen.asciidoc
new file mode 100644
index 0000000..994a0ae
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWeakListenerWhen.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWeakListenerWhen
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== When should I use a WeakListener
+
+You should use a link:DevFaqWeakListener.html[WeakListener] any time you are adding a listener to an object, but there is no code - and possibly no opportunity - to explicitly remove it.
+
+If the thing you are listening to does have some kind of observable life-cycle, it is preferable to explicitly add and detach listeners.
+
+But in the case that you are adding a listener which is never explicitly removed, it is good form to use `link:http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/WeakListeners.html[WeakListeners]`
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWeakListenerWhen[http://wiki.netbeans.org/DevFaqWeakListenerWhen] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-01-24T06:12:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhatIsACluster.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhatIsACluster.asciidoc
new file mode 100644
index 0000000..a48f634
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhatIsACluster.asciidoc
@@ -0,0 +1,158 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhatIsACluster
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a Cluster?
+
+A cluster is a directory on disk. A cluster contains link:DevFaqWhatIsAModule.html[modules]. If you are writing a small NetBeans-based application, you probably do not need to be too concerned about clusters, although you may encounter the concept if you need to bundle additional files (native executables, for example) with a module. Clusters become important if you are writing an extensible application (or multiple applications) of your own, where you are sharing some common modules between multiple applications.
+
+The NetBeans launcher is passed a list of _cluster directories_ on startup (see `$NB_HOME/etc/netbeans.clusters` in the IDE - the names in this file are relative paths from the IDE install directory - but they could also be absolute paths on disk). The launcher looks for the modules (JAR files) which it should load in those "cluster directories". A NetBeans-based application typically consists of, at a minimum, the `platform` cluster and at least one application-specific cluster which contains modules that implement the business logic of that application.
+
+_Cluster directories are not necessarily all located under the same parent directory. They just happen to be in a typical NetBeans IDE install._
+
+The NetBeans platform expects cluster directories to have a certain minimal structure:
+
+* There will be a `modules/` subdirectory containing module JAR files
+* There will be a `config/Modules/` subdirectory containing XML files that describe if/when each module should be enabled
+* There will be an `update_tracking/` subdirectory which contains metadata that allows the module system to determine if another version of each module is newer than, older than, or the same as the one in this cluster, using dates and checksums
+
+A cluster may contain additional files and folders as needed. For example, it is common for modules which bundle 3rd-party libraries to include those JAR files in `modules/ext/`. A cluster can contain whatever other files a module needs at runtime - for example, a module that installs a mobile phone emulator would probably include the native emulator executable.
+
+To include additional files in your cluster, simply create a directory `release/` underneath your module's project directory (_not_ the `src/` directory for your module, but its parent folder - the one that _is_ your module project). Anything under `$PROJECT/release/` will be copied into your cluster by the build process. To find the file at runtime, use link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/InstalledFileLocator.html[InstalledFileLocator], e.g.
+
+[source,java]
+----
+
+File emulatorBinary = InstalledFileLocator.getDefault().locate(
+ "phone/bin/emulator.exe", "com.foo.my.module.code.name", false);
+----
+
+==== Suites vs. Clusters
+
+The _result of_ compiling a module suite is typically a cluster. A cluster is something the runtime understands; a suite is a a project you develop. For more information see link:DevFaqSuitesVsClusters.html[the suite-versus-cluster FAQ].
+
+==== Why Have Clusters?
+
+Here's the history of clusters:
+
+* Originally, NetBeans didn't have "clusters"—there was just $NB_HOME/modules/, a bunch of JAR files, and some XML files saying what was enabled and what was not. You looked up the installation directory using `System.getProperty("netbeans.home")`
+* Modules are libraries - like any other library or DLL or `.so` used by applications - and it is normal for multiple applications to use the same copy of some library
+* Sun had a number of NetBeans-based applications. So might anyone creating a link:http://platform.netbeans.org[NetBeans Platform-based application]. The platform is the same for all of them; so are some other parts depending on what modules those applications use.
+* Some operating systems will _not allow_ you to distribute native OS packages that will clutter up a user's disk with extra copies of files the user already has. The guidelines for Solaris, Debian, Ubuntu and other operating systems, all request or require that, if a library already exists on the target machine, you should use that library in-place, not install your own copy of it. If we wanted Ubuntu and Debian users to be able to type `apt get netbeans`, we needed to solve this problem for the NetBeans IDE and other NetBeans-based applications.
+* The platform, and other parts of NetBeans therefore should be able to be shared among multiple applications and used by them at the same time.
+* Therefore, a NetBeans-based application should not assume that all of its parts ("clusters" of modules which interdepend) are underneath the same directory on disk—the platform might be in one directory, while the Java modules are someplace else entirely.
+* Before this, a typical way to find a file underneath a NetBeans install was new File(System.getProperty("netbeans.home")) to get the NB install directory; then you could try to find a file somewhere under that directory.
+* If there is not necessarily an "install directory" at all, then you need something like link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/InstalledFileLocator.html[InstalledFileLocator], which knows about the cluster directories being used in the running application, and can look in all of them. That is much cleaner than you having to write the code to figure out where all of those directories are and look in each one.
+
+In short, while it is typical for all of the parts of an application to be under a common parent directory, that is neither required nor guaranteed.
+
+==== What Does A Cluster Look Like?
+
+Here is the structure of the (comparatively small - it contains only one module) `ergonomics` cluster in a NetBeans 6.9 development build.
+
+<ul>
+
+[source,xml]
+----
+
+ <li>`*ergonomics/* <font color="gray"><i>The cluster directory</i></font>`
+ <ul>
+ <li>`.lastModified <font color="gray"><i>An empty file used as a timestamp so NetBeans can cache information about the cluster for performance, but know if its cache is out-of-date</i></font>`</li>
+ <li>`*config/* <font color="gray"><i>Contains metadata about module state</i></font>`
+ <ul>
+ <li>`*Modules/* <font color="gray"><i>Contains files which tell NetBeans some things about the module, mostly relating to if/when it should be enabled</i></font>`
+ <ul>
+ <li>`org-netbeans-modules-ide-ergonomics.xml <font color="gray"><i>Metadata about the Ergonomics module, whose code-name is org.netbeans.modules.ide.ergonomics</i></font>`</li>
+ </ul></li>
+ </ul></li>
+ <li>`*modules/* <font color="gray"><i>Directory that contains the actual (multiple) module JAR files and any 3rd-party libraries they include</i></font>`
+ <ul>
+ <li>`org-netbeans-modules-ide-ergonomics.jar <font color="gray"><i>This is the actual JAR file of the Ergonomics module's classes</i></font>`</li>
+ </ul></li>
+ <li>`*update_tracking/* <font color="gray"><i>Contains metadata about the module which is needed by Tools > Plugins</i></font>`
+ <ul>
+ <li>`org-netbeans-modules-ide-ergonomics.xml <font color="gray"><i> Contains installation date, version and CRC checksums of module JAR and enablement data</i></font>`</li>
+ </ul></li>
+ </ul></li>
+----
+
+</ul>
+
+In a larger cluster, all of the child directories described above would contain one file for each module (i.e. module JAR file, etc.).
+
+===== Metadata
+
+The metadata in `$CLUSTER/config/Modules/$MODULE.xml` is fairly simple and straightforward - it enables the NetBeans module-system to determine when a module should be loaded:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC "-//NetBeans//DTD Module Status 1.0//EN"
+ "link:http://www.netbeans.org/dtds/module-status-1_0.dtd">[http://www.netbeans.org/dtds/module-status-1_0.dtd&quot;&gt];
+<module name="org.netbeans.modules.ide.ergonomics">
+ <param name="autoload">false</param>
+ <param name="eager">false</param>
+ <param name="enabled">true</param>
+ <param name="jar">modules/org-netbeans-modules-ide-ergonomics.jar</param>
+ <param name="reloadable">false</param>
+</module>
+----
+
+Similarly, the metadata in `$CLUSTER/update_tracking/$MODULE.xml` contains data about the module generated when it is installed:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<module codename="org.netbeans.modules.ide.ergonomics">
+ <module_version install_time="1266357743218" last="true"
+ origin="installer" specification_version="1.7">
+ <file crc="3871934416"
+ name="config/Modules/org-netbeans-modules-ide-ergonomics.xml"/>
+ <file crc="1925067367"
+ name="modules/org-netbeans-modules-ide-ergonomics.jar"/>
+ </module_version>
+</module>
+----
+
+This data allows the *Tools > Plugins* updater functionality to determine if the version of the module on an update server is a newer version than the copy which the user has installed, so that it can decide if it should offer an update. More importantly, since this is done with checksums, it can do this check without sending data about what is on the user's machine to a remote server, users privacy is maintained.
+
+==== Clusters and Compatibility
+
+A _cluster_ is a compatibility unit and has a version. It is set of modules that is developed by the same group of people, built and released at one time.
+
+Most of the reasoning that lead to creation of the concept can be found in:
+link:http://platform.netbeans.org/articles/installation.html[Installation Structure]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhatIsACluster[http://wiki.netbeans.org/DevFaqWhatIsACluster] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T19:56:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhatIsAModule.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhatIsAModule.asciidoc
new file mode 100644
index 0000000..d9e4b26
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhatIsAModule.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhatIsAModule
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a module?
+
+NetBeans is a _modular_ application. That means it is composed of pieces, which are discovered at runtime. Some of those pieces may even be downloaded and installed or uninstalled at runtime.
+
+A module is a library. It is a Java JAR (Java ARchive) file which contains some classes.
+
+NetBeans is a Java application. It has a very small core runtime which knows how to find the modules that make up the application (the launcher passes a list of directories - these are commonly called link:DevFaqWhatIsACluster.html[clusters] - which contain module JAR files and some XML metadata about them).
+
+All real functionality of the NetBeans IDE or any NetBeans-based application is implemented as modules.
+
+A module JAR contains some additional entries in its META-INF/MANIFEST.MF file, which tell NetBeans about the module - its name, its version, etc.
+
+One distinction about NetBeans modules, as opposed to just working with JAR files on your classpath is that the NetBeans runtime link:DevFaqModuleDependencies.html[enforces dependency management] between modules - to call code in another module from yours, your module must _declare a dependency_ on the other module.
+
+Another significant distinction is that a module can specify which (if any) packages it makes visible to modules that depend on it - so it is possible to have Java packages in a module's JAR file which are visible only to other classes within that JAR file. That, in effect, extends Java's class visibility-scoping rules (public, protected, private, package-private) to include _public only within this JAR file_.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhatIsAModule[http://wiki.netbeans.org/DevFaqWhatIsAModule] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-12T20:09:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhatIsANode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhatIsANode.asciidoc
new file mode 100644
index 0000000..001449a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhatIsANode.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhatIsANode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a Node?
+
+Nodes are presentation objects. They have actions, properties and localized display names - they are the place where the architecture meets the human. Nodes typically wrap some model object and provide human-readable names, icons, etc. They are at the heart of a lot of NetBeans selection and user interface systems.
+
+Nodes are a generic tree structure. A common use for them is to display link:DevFaqDataObject.html[DataObject ]s to the user - to represent the user's files visually. Each node has a Children object that can supply a list of child nodes. Nodes are not visual components, and they do not subclass TreeNode from the JDK - they are more related to the JavaBeans specification, subclassing `java.beans.FeatureDescriptor`.
+
+Nodes are displayed in _explorer views_. The Explorer API provides a number of Swing components which take a Node and can display that node and its children - in trees, lists, tree tables, etc. The property sheet is also an Explorer view - Nodes have properties, which are key-value pairs with localized names.
+
+Generally Nodes should _represent_ not _be_ the objects the user is interacting with - if you are putting huge amounts of logic in your Node class, you're probably doing something wrong.
+
+Nodes form the basis of global selection in NetBeans - each link:DevFaqWindowsTopComponent.html[component in a tab in the ui ] has an "activated Node". The system globally tracks what component has focus, and each component typically offers some node as the currently selected node (which can change when the user clicks, etc.).
+
+A Node has a link:DevFaqLookup.html[Lookup ] which you can ask for objects your code is actually interested in. You never get the selected node and then cast it to some specific Node subclass and do things to that; the real model objects should be available from the Node's Lookup. This helps to future-proof your code - you can have another module provide the same objects your client code is interested in from _its` Node's lookup, and the client code never has to change - it's just looking for any Node that has what it needs._
+
+Read about link:DevFaqNodeSubclass.html[how to implement your own Nodes ]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhatIsANode[http://wiki.netbeans.org/DevFaqWhatIsANode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:05:15Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhatIsNbm.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhatIsNbm.asciidoc
new file mode 100644
index 0000000..e1346ed
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhatIsNbm.asciidoc
@@ -0,0 +1,132 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhatIsNbm
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is an NBM?
+
+An NBM file is a NetBeans module packaged for delivery via the web.
+The principal differences between it and a module JAR are:
+
+* It is compressed
+* It can contain more than one JAR file - modules can package any libraries or other files they use into their NBM
+* It contains metadata NetBeans will use to display information about it in the update center, such as the manifest contents, the license, etc.
+* NBMs may be signed for security purposes
+
+NBM files are just ZIP files with a special extension,
+which use the JDK's mechanism for signing JARs.
+Unless you're doing something unusual, you will not need to worry about the contents of NBMs -
+just let the standard Ant task for NBM creation take care of it for you.
+For those interested in gory details, read on.
+
+==== Structure of an NBM
+
+Below is an example of the contents of one -
+this is from the `hexedit_integration` module in `contrib`,
+which packages up an external library as well:
+
+`Info/info.xml`:Metadata - this file is generated by the standard NBM build target, so if you use NetBeans support for creating modules, you should not need to do anything special to create it. This info is used by the IDE to figure out if a module the user is installing is newer or older, than an existing one, whether or not its dependencies can be satisfied, etc. `META-INF/MANIFEST.MF`:The manifest - usually nothing of interest here, it is just generated because NBMs are created the same way that JARs are. May point to a signature for the NBM.`netbeans/....`:Contents to be unpacked to some cluster in the NetBeans installation (or the user directory).`netbeans/config/Modules/org-netbeans-modules-hexeditor.xml`:The module XML file used at runtime to discover modules. Indicates whether the module is autoload, etc.`netbeans/modules/org-netbeans-modules-hexeditor.jar`:The actual module JAR.`netbeans/modules/ext/hexedit.jar`:A library this module uses and includes.
+
+Since NetBeans 6.9 NBM files now supports pack200 compression and all jar files in NBMs becomes compressed and have ".pack.gz" appended to the name e.g. modules/org-netbeans-modules-hexeditor.jar.pack.gz.
+
+For more info about pack200 usage see link:DevFaqNBMPack200.html[DevFaqNBMPack200].
+
+==== Runtime module XML metadata
+
+The `org-netbeans-modules-hexeditor.xml` runtime metadata file looks like this:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC "-//NetBeans//DTD Module Status 1.0//EN"
+ "http://www.netbeans.org/dtds/module-status-1_0.dtd">
+<module name="org.netbeans.modules.hexeditor">
+ <param name="autoload">false</param>
+ <param name="eager">false</param>
+ <param name="enabled">true</param>
+ <param name="jar">modules/org-netbeans-modules-hexeditor.jar</param>
+ <param name="release">1</param>
+
+ <param name="reloadable">false</param>
+
+ <param name="specversion">1.0</param>
+
+</module>
+
+
+----
+
+==== Module installation metadata - Info.xml
+
+The `Info/Info.xml` file that NetBeans uses to figure out if it _can_ install a module,
+dependencies, etc. looks like this
+(it also contains the license that the user will agree to to install the module from the update center):
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC "-//NetBeans//DTD Autoupdate Module Info 2.3//EN"
+ "http://www.netbeans.org/dtds/autoupdate-info-2_3.dtd">
+<module codenamebase="org.netbeans.modules.hexeditor"
+ homepage="http://contrib.netbeans.org/"
+ distribution="http://...../org-netbeans-modules-hexeditor.nbm"
+ license="standard-nbm-license.txt"
+ downloadsize="0"
+ needsrestart="false"
+ moduleauthor=""
+ releasedate="2005/08/29"
+>
+ <manifest OpenIDE-Module="org.netbeans.modules.hexeditor/1"
+ OpenIDE-Module-Display-Category="Infrastructure"
+ OpenIDE-Module-Implementation-Version="050829"
+ OpenIDE-Module-Long-Description="Sample module hexeditor providing HexEdit"
+ OpenIDE-Module-Module-Dependencies="org.openide.filesystems > 6.2, ..."
+ OpenIDE-Module-Name="hexeditor"
+ OpenIDE-Module-Requires="org.openide.modules.ModuleFormat1"
+ OpenIDE-Module-Short-Description="Sample hexeditor module"
+ OpenIDE-Module-Specification-Version="1.0"
+ />
+ <license name="standard-nbm-license.txt"><![CDATA[
+ Sun Public License Notice
+....
+]]></license>
+</module>
+
+----
+
+<hr/>
+
+Applies to: NetBeans 6.5 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhatIsNbm[http://wiki.netbeans.org/DevFaqWhatIsNbm] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-16T08:13:22Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhenLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhenLookup.asciidoc
new file mode 100644
index 0000000..e0fb6b1
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhenLookup.asciidoc
@@ -0,0 +1,104 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhenLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== When should I use Lookup in my own APIs?
+
+For most things in NetBeans coding, you will want to write normal Java code - if you need an object of a particular type, just call it.
+
+When you need to use any of the following patterns, Lookup can be helpful:
+
+=== System-level-decoupling
+
+You provide some interface. Some other module will actually implement the interface. You want modules to be able to use your API, without caring who implements it, just that some implementation is there. Example: The status line.
+
+[source,java]
+----
+
+StatusDisplayer.getDefault()
+
+----
+
+returns some implementation of StatusDisplayer. In NetBeans typically it is provided by the window system. But I once wrote an implementation that would instead hide the status bar and instead show the message in a translucent popup that appears over the main window. That would not have been possible if all code that wanted to display status messages was tied at compile-time to the implementation class provided by the window system.
+
+=== Designing an API for a not-well-defined problem space
+
+An example of this is Project.getLookup(). In the case of projects, when that API was designed, the only things that could be known for sure about a project were that:
+
+* A project is a directory
+* For any file, there will be zero or one projects that own that file
+
+Designing a Project API that would provide for everything C/C++, Ruby, Java, DocBook, HTML, Web, J2EE, J2ME, etc. projects (this had been tried) would end up with something bloated and filled with functionality that any random client would never use - a very noisy, hard-to-use API. Since in that case the requirements were not and could not be known, the lookup pattern made it possible to create an API and let clients define additional APIs (like ClassPathProvider for Java projects, which would make no sense in a DocBook project), and provide client access to them through the project's Lookup.
+Granular decoupling
+
+The uses of Lookup in Node and TopComponent: Here, you have some API type. You make it available in the Lookup of files of a certain type. You don't necessarily know all the ways your UI will change in the future. Other modules want to add actions (to popup menus, toolbars, whatever) that can operate on your type. Those actions should be enabled whenever the selection contains one (or more) of your object. By writing actions sensitive to your type in the global selection lookup (Utilities.actionsGlobalContext()), no rewrite of those actions is required if, at some point, you write a new window component that shows, say, virtual files or some random tree of objects that contain your type.
+
+=== Mutable Capabilities
+
+You are designing an API for an object whose capabilities are actually mutable. Listening for a particular type in a Lookup is much less code, and much clearer, than defining a bunch of event types, listener classes and addThisListener(), addThatListener(). Example: In the Java Card modules, there is a class Card. A Card has a lookup. Now a card might be a physical device plugged into your computer. Or it might be a virtual card definition used by an emulator for testing. A virtual card has capabilities like Stop, Start and Resume. When you call StartCapability.start(), the StartCapability disappears from the Card's lookup and a StopCapability appears. But if it is a physical card, Start and Stop make no sense whatsoever - so for a real card they are not there. Other capabilities, such as PortProvider, which will tell you what TCP ports to use to send code to, attach a debugger to, etc., are present for both virtual cards and some real cards, if HTTP is the mechanism to deploy code
to them - but other cards may have you run a native executable to deploy code and use no ports. So PortProvider is another optional capability.
+
+Note that you can add typing to Lookup-based APIs if you find it useful or it makes your API easier (with Find Usages or Javadoc) to use. In org.netbeans.modules.javacard.spi.Card, in fact, there is
+
+[source,java]
+----
+
+public <T extends ICardCapability> T getCapability(Class<T> type);
+
+----
+
+which delegates to Lookup but guarantees the return value is a subtype of something you can search on. I don't recommend that for all situations (part of the birth of Lookup was that Node.getCookie() returned something that implemented the marker interface Node.Cookie, and for things that wanted lookup-like functionality but had no connection to Nodes whatsoever, it made no sense to make them drag around a JAR with the Nodes API just for a marker interface). But in restricted situations, it can make an API more usable.
+
+=== Composable Objects
+
+Some NetBeans-based applications use Lookup as a mechanism to allow modules to plug in _aspects_ that are applied to existing objects. For example, say you write an extensible Node whose display name is implemented as
+
+[source,java]
+----
+
+public String getDisplayName() {
+ return getLookup().lookup(Displayable.class).getDisplayName();
+}
+
+----
+
+Some other module can then contribute (most likely via a link:DevFaqModulesLayerFile.html[layer file] and Lookups.forPath()) a Displayable for that object. This is a rather extreme form of extensibility and can be hard to debug, but if you need it, Lookup can be used for that.
+
+=== Conclusion
+
+These cover most of the typical cases. If you're not doing something like these examples - if using Lookup adds complexity to your code without adding needed flexibility or future-proofing - then it's the wrong tool for the job.
+
+For a more detailed discussion, which this FAQ entry was assembled from, see link:http://netbeans.org/projects/platform/lists/dev/archive/2010-01/message/315[this thread on the dev@platform mailing list]
+
+See also: link:DevFaqWhenToUseWhatRegistrationMethod.html[When To Use Various Declarative Registration Mechanisms]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhenLookup[http://wiki.netbeans.org/DevFaqWhenLookup] ,
+that was last modified by NetBeans user Jtulach
+on 2010-07-24T20:18:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhenToUseWhatRegistrationMethod.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhenToUseWhatRegistrationMethod.asciidoc
new file mode 100644
index 0000000..4c5e0bd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhenToUseWhatRegistrationMethod.asciidoc
@@ -0,0 +1,123 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhenToUseWhatRegistrationMethod
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== When do I use which registration method?
+
+As described in link:DevFaqModulesGeneral.html[DevFaqModulesGeneral], there are several different declarative registration mechanisms:
+
+* Use the `@ServiceProvider` annotation (or one of the link:DevFaqWaysToRegisterInDefaultLookup.html[other registration mechanisms]) to register objects in the link:DevFaqLookupDefault.html[default Lookup]
+* Add files to folders in the link:DevFaqSystemFilesystem.html[system filesystem]
+* Run some code on startup by implementing `link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/ModuleInstall.html\[ModuleInstall]` and declaring your `ModuleInstall` subclass in your module's `manifest.mf`
+
+If you are implementing some API from another module, that module should tell you what to do. If it tells you something should be in the link:DevFaqLookupDefault.html[default lookup], that means to use [link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html[http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/ServiceProvider.html] `@ServiceProvider`] (see caveats in link:DevFaqWaysToRegisterInDefaultLookup.html[DevFaqWaysToRegisterInDefaultLookup]).
+
+==== Deciding On A Registration Mechanism For Clients Of Your Module
+
+If you are defining an link:DevFaqApiSpi.html[SPI] in your module, and other modules will implement it and provide their own classes, provide a declarative (plain text, no code) way to register them.
+
+Define interfaces or abstract classes, and document where subclasses can be registered (typically the link:DevFaqLookupDefault.html[default Lookup] or some folder in the link:DevFaqSystemFilesystem.html[system filesystem]).
+
+Starting with NetBeans 6.7, you can link:DeclarativeRegistrationUsingAnnotations.html[provide annotations] which other modules can use to register their objects - so registration is declarative, but it is visible in the Java source file.
+
+If you can possibly avoid it, don't require your module (or modules that implement your link:DevFaqApiSpi.html[SPI]) to run code on startup to link:DevFaqModulesDeclarativeVsProgrammatic.html[programmatically register] their functionality. That slows startup time and does not scale.
+
+Below are typical registration mechanisms and patterns, and when each is useful:
+
+|===
+|What |When to Use It |How |Examples
+
+|Define a singleton service class (there should be only one) that should be global to the application |You are defining a service, but another module will provide an implementation of that service |<ul><li>Define your service-provider class. Typically in NetBeans it will have a static method `getDefault()` which tries to find an instance of itself in the default Lookup, and if that fails, returns some sort of non-null mock implementation (which may not really do anything, but is useful in unit test that call code which calls your module)</li><li>Document that it should be registered in the default Lookup and that it is expected to be a singleton.</li><li>Define and document a unique string token which modules can "provide" if they provide an implementation of your API - for example `com.mymodule.MyService` (it can be any string)</li><li>Modify your module's `manifest.mf` file to use that token as follows:<ul><li>*If you provide no implementation of your service, but one is needed a
t runtime for proper functioning* add the line
+`OpenIDE-Module-Requires: com.mymodule.MyService`
+ to the manifest. If no module is present which _provides_ this token, your module will not be loaded on startup - the user will be offered an option of exiting or disabling your module.</li><li>*If you do provide some mock implementation of your service which is available in the case no other module is providing one* then add the line
+`OpenIDE-Module-Recommends: com.mymodule.MyService`
+ to the manifest. Your module will be loaded, no matter what. If no other module _provides_ this token, a warning will be logged.</li></ul></li><li>Document that modules which implement your service should include `OpenIDE-Module-Provides: com.mymodule.MyService` in their manifest(s). |<ul><li>The link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/overview-summary.html[UI Utilities API] defines `link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/StatusDisplayer.html[StatusDisplayer]`. You can call `StatusDisplayer.getDefault().setStatusText("Hello world")` to change the text in the status bar of the main window.
+ But the UI Utilities API does not provide the subclass of `StatusDisplayer` which is being called.
+ In fact, the module `core.windows`, which is responsible for creating NetBeans' main window _injects_ its own subclass into the default lookup, and that is what actually changes the status bar you see on the screen. It is that subclass which you are actually calling when you set the main window's status text. But your module only depends on the API, not the windowing system. Your code doesn't have to care whose subclass of `StatusDisplayer` it is calling. If a new version is created that displays status, say, in a translucent fading popup window, your code will work perfectly with that as well, without any changes or recompiling.</li><li>The link:http://bits.netbeans.org/dev/javadoc/org-openide-io/overview-summary.html[IO API] provides a way to write to the output window. In fact, there are two different output window implementations available for NetBeans - the default one, and a terminal emulator. The I/O API does not care which one is present, but it recommends that one sho
uld be, and provides a mock implementation that writes to `System.out` if none is present.</li></ul>
+
+|Define an interface or abstract class and look for multiple instances of it in the link:DevFaqLookupDefault.html[default Lookup] and do something with those objects |The objects modules will register is are implementations/subclasses of a simple interface or class. Your module only needs to find all such registered objects and use them. Your module will need all of them at the same time. |<ul><li>Define an interface or class for others to implement.</li> <li> Document that there can be multiple ones registered and that they should be registered in the link:DevFaqLookupDefault.html[default Lookup].</li> <li>In _your_ module, use `Lookup.getDefault().lookup(MyClass.class).allInstances()` to find all registered instances.</li></ul> |`link:http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/StatusLineElementProvider.html[StatusLineElementProvider]` allows modules to contribute components to the status bar in the main window. All components are needed in order to sho
w the status bar.
+
+|Define an interface or abstract class, and document your strategy for locating these objects in folders in the link:DevFaqModulesLayerFile.html[system filesystem] |The objects modules will register is are implementations/subclasses of a simple interface or class, *but* not all objects are needed at any given time. At any time, some may be needed, based on what the user is doing (for example, the MIME type of the file the user is editing - MIME types map easily to folder paths, e.g. `Editors/text/x-java/`). |<ul><li>Figure out from context what folder to look in</li><li>Use `link:http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/lookup/Lookups.html#forPath(java.lang.String)[Lookups.forPath("path/to/folder").lookupAll(MyType.class)]` to find all registered objects of your type.</li><li>Describe the lookup strategy in the documentation of your link:DevFaqApiSpi.html[SPI].</li></ul> |If you want to add an action to the popup menu that appears when you right-
click in the text editor for a `.java` file, but not other kinds of files, you [[DevFaqRegisterObjectsViaInstanceOrSettingsFiles| register an instance of `javax.swing.Action`]] in the system filesystem (via your module's link:DevFaqModulesLayerFile.html[layer file]) folder `Editors/text/x-java/Actions`. If the user never actually opens a Java file and right-clicks the editor, your Action will never be created, nor its class loaded.
+
+|Define a single folder in the link:DevFaqModulesLayerFile.html[system filesystem] where objects should be registered, and optionally a factory method which will create the object. |<ol><li>Other modules are not really registering their own subclasses, they are registering files. You want to read the files and create the objects in your code.</li><li>Other modules are registering objects; however, there is useful metadata that can be used without ever creating the object.</li><li>Other modules are registering objects. Creating those objects requires additional metadata which can be specified declaratively using link:DevFaqFileAttributes.html[file attributes]</li></ol> |<ul><li>Define a static, public factory method which takes a `Map`.</li><li>Document that all registered files should list this factory method as their `instanceCreate` attribute (e.g. `<attr name="instanceCreate" methodvalue="com.XClass.factoryMethod" />`.</li><li>Find registered objects using
`Lookups.forPath("path/to/my/folder")`).</li></ul> |Examples for the cases defined under _When To Use It_: <ol><li>The `simple.project.templates` module defines a spec for using `.properties` files to list everything that should be created when the user wants a new project. It does not need a special file type or object instances - it will read the file and make the object it needs.</li><li>The Services tab in the IDE allows objects to be registered, which are shown as nodes in its UI. The icon and localized display name of these nodes can be declaratively specified as file attributes, so no classes need to be loaded until the first time the user selects one of these nodes.</li><li>As mentioned in 1., `simple.project.templates` defines a spec for describing a project template inside a regular `.properties` file. The `javacard.project` module reads defines several template files. But ''it also needs to know what "flavor" of project (applet, web, library, etc.) each file defines
, so that it will ask the user the right questions in the New Project Wizard. It defines an additional file attribute to indicate what "flavor" of project a template represents.</li></ol>
+|===
+
+==== Why Declarative Registration and Lazy Loading Is Important
+
+For best performance and scalability, avoid actually instantiating the objects other modules register until the first time your code needs to call them. Avoid programmatic registration mechanisms, and delay instantiating declaratively registered objects until they really need to be used. This is for several reasons:
+
+* Object take up memory. Your application will use less memory and be faster if you do not create objects that you do not _know_ you will call.
+* Java class loading happens the first time a class is needed, and loading one class can trigger loading many others. It means file I/O happens, blocking whatever thread first needs to load the class.
+* If you create objects only when your code really is going to call them, class loading and object creation still happens, but it happens in small chunks of time as things are needed, rather than causing long pauses
+
+If there will potentially be a large number of subclasses of your interface, try to find a way to divide them into context-appropriate categories and use folders in the system filesystem to partition contexts.
+
+==== Why Declarative Icon and Display Name Registration Is Particularly Important
+
+Many pieces of user interface in NetBeans — almost any tree view — is a view of a folder on disk, or a folder in the system filesystem. The Services tab is such a view; the Projects tab composes several such views; the left and right sides of the first pages of the New File and New Project wizards are such views.
+
+The need to simply show an icon and a name should not ever be the trigger for loading hundreds or even thousands of classes (bear in mind that loading your class may mean loading many other classes — and the link:http://www.securingjava.com/chapter-two/chapter-two-6.html[Java Bytecode Verifier] may trigger loading many more classes than you expect).
+
+You can handle this very simply with `.instance` files:
+
+[source,xml]
+----
+
+<filesystem>
+ <folder name="UI">
+ <folder name="Runtime">
+ <file name="MyNode.instance">
+ <attr name="instanceClass" stringvalue=
+ "org.netbeans.modules.stuff.MyNode"/>
+ <attr name="iconBase" stringvalue=
+ "org/netbeans/modules/stuff/root.png"/>
+ <attr name="displayName" bundlevalue=
+ "org.netbeans.modules.stuff.Bundle#MyNode"/>
+ <attr name="position" intvalue="152"/>
+ </file>
+ </folder>
+ </folder>
+</filesystem>
+----
+
+and in your resource bundle file, define
+
+[source,java]
+----
+
+MyNode=My Node
+----
+
+This was a serious problem in older versions of the NetBeans IDE - for example, opening the Options dialog (which used to be a tree of Nodes and a property sheet - modules that had settings provided their own Node, and you changed settings by changing properties) - simply trying to paint it for the first time originally triggered loading, literally, thousands of classes from many different JAR files.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhenToUseWhatRegistrationMethod[http://wiki.netbeans.org/DevFaqWhenToUseWhatRegistrationMethod] ,
+that was last modified by NetBeans user Jglick
+on 2010-06-14T22:27:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWhenUseWrapperModule.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWhenUseWrapperModule.asciidoc
new file mode 100644
index 0000000..b962532
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWhenUseWrapperModule.asciidoc
@@ -0,0 +1,74 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWhenUseWrapperModule
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== When should I use a library wrapper module and when should I just package the library into my module?
+
+The New Module Wizard offers easy support for creating a wrapper module:
+*File > New Project > NetBeans Modules > Library Wrapper Module* and since NetBeans 6.8 it is similarly easy to either edit Library Wrapper Module after it has been created or package library directly to your module via *Project Properties > Libraries > Wrapped JARs*.
+
+Before NB 6.8 it was more convenient to create Library Wrapper module due to existence of the wizard, but not Project Properties UI. This biased the answer to this question, but generally there's no harm in using a library wrapper module.
+
+Note that a library wrapper module can wrap more than one external JAR -
+you do not need to create one for each library.
+But it is a good idea to create a separate wrapper for each JAR
+if they come from different projects and might conceivably be used independently.
+
+The general algorithm for making an optimal decision about when to use a wrapper module is this:
+
+* If the library is from some third-party source, and your module is just using it, then
+* If it is something very esoteric and your module will be the _only_ module in an installation of NetBeans (or your NetBeans-based app) ever using it
+* You are writing only one module that will use the library, _or_ you want to declare the packages contained in your library in the public packages of your module
+* If you will never want deliver an update of that library by itself, without delivering an update of your module
+* Then you probably just want to package the library directly into your module, as in link:DevFaqModuleDependencies.html[DevFaqModuleDependencies]
+* If you wrote the library you want to use
+* You might just want to add the appropriate `OpenIDE-Module-*` entries directly to its manifest and make it a module that way. Remember to list the packages your module will need to export.
+* Else, you probably want to read link:DevFaqWrapperModules.html[DevFaqWrapperModules]
+
+There is a very slight performance penalty to using a wrapper module -
+it's one more JAR to open and read from, and one extra layer of indirection for the classloader.
+_That is not a reason to avoid using a wrapper module if that's what you need_ -
+it really is slight.
+In a very large application such as the NetBeans IDE,
+such considerations are more important because there are more JARs, more classloaders,
+and hence more overhead already.
+
+If you are developing the library yourself, but decide you want to keep the library project separate from any NB module project, you can do so.
+See link:DevFaqWrapperModules.html[Using a wrapper module for an existing project]
+for information and various methods to hook them up for
+development.
+
+<hr/>
+Applies to: NetBeans 6.8 and above
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWhenUseWrapperModule[http://wiki.netbeans.org/DevFaqWhenUseWrapperModule] ,
+that was last modified by NetBeans user Rmichalsky
+on 2009-12-02T15:00:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsAndDialogs.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsAndDialogs.asciidoc
new file mode 100644
index 0000000..31f7836
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsAndDialogs.asciidoc
@@ -0,0 +1,84 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsAndDialogs
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Windows & dialogs
+
+=== Can I just open up my own frames and dialogs?
+
+* Yes, you could; but please instead use the standard windowing system to do these sorts of things. Then you will properly handle docking, separated floating windows, context help, various keyboard shortcuts, and many other things contributing to the IDE's appearance and functionality.
+
+* The Window System API describes the general steps you should use to open up new function windows, if you need such a thing. Specifically, you should use `TopComponent`s for such purposes.
+
+* You can also use `DialogDisplayer.notify(NotifyDescriptor)` to show dialogs that interact well with the IDE's window system, and have a number of bits of prebuilt UI. You can use various standard subclasses of `NotifyDescriptor` to represent simple messages; exceptions; general-purpose dialogs with content panels; or even multi-stage wizards.
+
+=== What are the steps to create a simple Wizard?
+
+__Easiest way is to use File -> New File wizard, Module Development category and Wizard item, which will generate all needed boilerplate
+code for you. Essentially what wizard does is described below:__
+
+==== Create Panels:
+
+You should start with creating a set (at least one) on WizardDescriptor.Panel objects (see link:http://performance.netbeans.org/howto/dialogs/wizard-panels.html[Wizard Panel Performance Guide] for more information about the best way to create a panel).
+
+==== Create WizardDescriptor
+
+Use the panels to tell the a WizardDescriptor instance the sequence of panels it should display.
+This you can do either directly by `WizardDescriptor wd = WizardDescriptor(wizardPanelArray)`
+Or you can create a `WizardDescriptor.Iterator` with these panels, which gives you more control over the sequencing.
+
+==== Set Properties
+
+Set certain properties on the WizardDescriptor which can influence the appearence of the wizard. If you like to add a help pane for example you call:
+`wd.putProperty("WizardPanel_autoWizardStyle",Boolean.TRUE);
+wd.putProperty("WizardPanel_helpDisplayed",Boolean.TRUE);`
+
+This will display a help html file which has to be defined on each panel by setting a `clientProperty` in the JComponent superclass of the *panel* that is the wizard content. In this case it would look like:
+
+`putClientProperty("WizardPanel_helpURL",new URL("link:http://path/to/help/html/file/panelHelp.html[http://path/to/help/html/file/panelHelp.html]"));`
+
+==== Show Wizard
+
+Finally you set the Wizard to screen using the `DialogDisplayer`
+
+[source,java]
+----
+
+Dialog d = DialogDisplayer.getDefault().createDialog(wd);
+
+ d.setVisible(true);
+
+ d.toFront();
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsAndDialogs[http://wiki.netbeans.org/DevFaqWindowsAndDialogs] ,
+that was last modified by NetBeans user Saubrecht
+on 2009-12-07T10:43:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsComponentHowTo.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsComponentHowTo.asciidoc
new file mode 100644
index 0000000..25ae2f7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsComponentHowTo.asciidoc
@@ -0,0 +1,61 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsComponentHowTo
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I want to show my own component(s) in the main window - where do I start?
+
+Use File -> New File wizard, Module Development category and Window Component item. It will generate all necessary background code for you and open GUI Builder to design UI of your own component.
+
+==== But what is behind the scenes, created by wizard?
+
+* Subclass of link:DevFaqWindowsTopComponent.html[TopComponent] is created. Design it just as you would a JPanel.
+* Simple subclass of `javax.swing.AbstractAction` in created and link:DevFaqActionAddMenuBar.html[added to main menu]. It's implemented it to open your component like follows:
+[source,java]
+----
+
+public class MyAction extends AbstractAction {
+ public MyAction() {
+ putValue (Action.NAME, "Open My Component");
+ }
+
+ public void actionPerformed(ActionEvent ae) {
+ new MyComponent().open();
+ }
+}
+----
+
+* Declarative XML descriptions of component are created following link:DevFaqWindowsWstcrefAndFriends.html[declarative XML API] principles.
+
+TopComponents are part of the link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[Windows API].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsComponentHowTo[http://wiki.netbeans.org/DevFaqWindowsComponentHowTo] ,
+that was last modified by NetBeans user Marciowb
+on 2011-07-28T10:00:41Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsGeneral.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsGeneral.asciidoc
new file mode 100644
index 0000000..a12b192
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsGeneral.asciidoc
@@ -0,0 +1,57 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsGeneral
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the Window System?
+
+The windowing system is what creates the main application window, and makes it
+possible to open components in the UI. The API for the windowing system is in the package
+`org.openide.windows`. The implementation of the windowing system is in the module
+`org.netbeans.core.windows` (core.windows in Mercurial repository, was core/windows in CVS).
+
+The window system defines link:DevFaqWindowsMode.html[Mode]s which are places in the main window
+occupied by tabbed containers. link:DevFaqWindowsTopComponents.html[TopComponent]s are GUI
+components (instances or subclasses of `org.openide.windows.TopComponent` which
+can be put into these tabbed containers.
+
+There is a link:DevFaqModulesDeclarativeVsProgrammatic.html[programmatic API] for creating/opening
+TopComponents - this is useful for testing components under development - just create an Action which
+calls `new MyTopComponent().open()` to quickly try out GUI components.
+
+However, the main API modules use the link:DevFaqWindowsWstcrefAndFriends.html[declarative XML Window System API] to install their components, for the following reasons:
+
+* Scalability: Components do not need to be created/deserialized unless they really need to be opened
+* Singletonization: You wouldn't want to have 5 Projects tabs in the IDE. Using the XML API correctly, you can easily refer to the singleton instance of your component once it's instantiated (almost) for free.
+* Persistence: The window system associates components with unique IDs; to properly persist your component across sessions, you need to use the XML APIs
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsGeneral[http://wiki.netbeans.org/DevFaqWindowsGeneral] ,
+that was last modified by NetBeans user Cvdenzen
+on 2012-02-16T12:52:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsInternals.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsInternals.asciidoc
new file mode 100644
index 0000000..848117e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsInternals.asciidoc
@@ -0,0 +1,206 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsInternals
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== NetBeans Window System - what happens during startup
+
+Below is a blow-by-blow account of what actually goes on during NetBeans startup, put together by, well, reading the code. It's here as much for the author's edification (if you read through it and document it, you understand it) as yours.
+
+=== The three and a half models model
+
+The NetBeans window system is extremely defensively coded - one of the main goals of rewriting it for 3.6 was robustness in the face of components that throw exceptions, do evil things to other components, and so forth. The way the robustness of the current system is achieved is by very cleanly separating the model of how the UI should be, the model of how the UI actually is and the AWT component hierarchy, which is a model of sorts itself, but cannot be relied upon, because in an extensible application any component may do something evil. On top of this is the persistence model.
+
+UIs are hierarchical, with components inside containers inside other containers - so each model we'll describe is hierarchical to represent this. TopComponents (panels in tabbed container) get a little special handling because
+there's a potential one-to-many relationship between TC's and tabbed containers (an implication of winsys v1, where
+one component could live in more than one docking Mode (tabbed container) per workspace).
+
+So, the models (names made up for the purpose of this document):
+
+* *The Persistent Model* - `org.netbeans.core.windows.persistence` - these classes are really record types - classes with public fields that contain data read out of persisted XML describing the window system and written back to it. These classes are instantiated at de-persistence and persistence time, and read and written, but are not used at runtime - they just provide the stored state of the system, and are used to construct the initial model of the window system at runtim
+* *The Runtime State Model* - this is the model of how the window system and all its components are *supposed* to be, based on persisted state and any changes made by calling methods (i.e. the user maximizes or closes a component) at runtime
+* *The Runtime View Model* - this is another set of model objects - `org.netbeans.core.windows.view` , each of which represents (and can manipulate) a UI component. Each model object has a corresponding Accessor object which isa layer of indirection that connects it to the actual Component it models.
+* *Snapshots* (this is the 1/2 model) - a snapshot is an object that immutably captures the state of the Runtime State Model at a particular moment in time. When a change has happened, a request to update the UI is enqueued. When that request runs, it synchronizes the UI model with the state described in the snapshot (what's open, what's closed, what's maximized, splitter positions, etc...)
+
+Reading the source to the window system can be a little complicated, because there are multiple models of the same thing all being synchronized, and just about everything follows a chain of single-method-call methods back to `Central` or `WindowManagerImpl`. Hence this document.
+
+In its essence, though it's simple: all changes in the window system simply mean synchronizing the two runtime models. It's only the number of classes that requires that make it look complex.
+
+=== The Window System Startup Sequence
+
+Loading the window system is a distinct phase in NetBeans startup. A set of model objects representing the window manager (data like SDI vs. MDI, frame size/location/state), its Modes (docking containers - bounds, contents), and references to `TopComponent`s by ID (not the components themselves, but unique String ids for them).
+
+Once all this is done, we'll have a set of model objects representing all the persisted data. Note that these model objects are _not_ the ones used by the model of the window system at runtime, there are different classes for that.
+
+Here's the load sequence:
+
+`WindowSystemImpl`
+
+* copy all TopComponent settings files aggressively to the userdir (BUG? Probably needed this for the 3.5 project system, probably don't now)
+* checks its on the dispatch thread, and calls PersistenceHandler.getDefault().load()
+* that calls PersistenceManager.getDefault().loadWindowSystem()
+* that gets an XML parser
+* the parser creates a WindowManagerConfig from data it finds in XML files. A `WindowManagerConfig` just has a lot of public fields from parsed data, that refers to other similar objects
+* `ModeConfig` - information about a docking container, placement, contents
+* `TcRefConfig` - references to a TopComponent by ID, no component there yet
+* `GroupConfig` - Refers to a Group of TopComponents (like form editor + its palettes)
+* `TcGroupConfig` - Reference to a TopComponent by a GroupConfig
+* `InternalConfig` - Just notes what version of the window system saved the date we loaded
+
+Now we're back out in `PersistenceManager`. We:
+
+* Build a set of `TopComponent` ID's in use (if a new component opens and it wants the same ID as an existing one, we append an integer to the ID string)
+* Start listening on the folder for changes (i.e. a new module is installed and it has a persisted component that should be opened)
+* Clear the reference to the parser
+* Return the `WindowManagerConfig` to `PersistenceHandler`
+
+Now we have a model for the contents of the window system as it was persisted...
+
+Back in `PersistenceHandler.load()` now, we build the runtime model of the window system (note that except for deserializing `TopComponent`s, we're not creating any components yet, we're just creating model objects that will be represented by GUI components in the UI):
+
+* Misc: get the large/small preferred toolbar icon size and store that on the WindowManagerImpl
+* Get the list of TopComponent ids found in deserializing the window system
+* Iterate the IDs
+* for each, deserialize the TopComponent in question
+* Set the "recent view list" on the WindowManager with the array of deserialized TopComponents. This is used for ordering the components visited when the user Ctrl-Tabs between TopComponents
+* Iterate all of the ModeConfigs
+* for each, create a ModeImpl (note this is a model object, not a tabbed container)
+* if the mode was active at shutdown last time, remember that fact in a local variable
+* if the mode was persisted as maximized, remember that fact in a local variable
+* Iterate all of the ModeImpls created
+* initialize each one from the ModeConfig it was created for
+* iterate all TcRefConfigs in the ModeConfig, extract some persisted data about the "previous mode" the TopComponent was in, and pass that data to the window system - this is so that sliding windows know where they should land if the user presses the "pin" button to put them in a tabbed container
+* set the id of the selected TopComponent on the ModeImpl
+* Iterate all the GroupConfigs loaded
+* For each group, create a TcGroup object
+* Add a mapping from GroupConfig.name to the tcGroup to a map held by PersistenceHandler (BUG? Why should this data be kept here? Nothing else keeps data *in* PersistenceManager - it means it can't be collected - or I'm not seeing/understanding how it's used)
+* Iterate all the TcGroupConfigs (BUG: bad name - these are wrappers for TopComponent IDs)
+* For each TcGroupConfig (PersistenceHanponent reference), add the ID into the list of IDs in the TcGroup
+* Check the boolean open flag for the TcGroupConfig. If true, it's a component that, when opened, should open the entire group
+* Check the boolean flag whether the TopComponent was closed explicitly by the user. If true, when the group of components are all opened, leave that one closed
+* Check the boolean flag whether the TopComponent was reopened explicitly by the user, and if so, ignore the result of the closed flag - add it to the list of ids that should open
+* Add the TcGroup we created to the list held by the window manager
+
+Note the group handling code is a little different than the rest in terms of the way it's modelled - this should probably be corrected - it appears that for some reason, PersistenceHandler holds the data for that, there is no corresponding model object for TC's in a group (not necessarily bad, but inconsistent), and the data is passed to the window manager before its initialized (harmless, but odd). On the other hand, it's less complicated.
+
+We're not done yet.
+
+* Next is a hotfix for issues link:http://www.netbeans.org/issues/show_bug.cgi?id=37188[37188] and link:http://www.netbeans.org/issues/show_bug.cgi?id=40237[40237] (which like all good hotfixes, was never replaced by a proper fix) - this calls componentShowing() on the component before it's even in the AWT hierarchy
+* Set the active (focused) Mode in the window manager from the field we saved earlier (BUG: this code seems to run earlier than it should, and the comment refers to the NetBeans 3.x project system, which persisted the entire window system out and loaded a new one in
+* Set the maximized mode, if any, in the window manager from the field we saved earlier
+* Compute the main window sizes for MDI and SDI mode, based on persisted data and current screen size, and set it on the window manager
+* Compute the editor area bounds and set it on the window manager
+* Set the id of the toolbar configuration that's active, based on persisted data
+
+We now have a singleton instance of `WindowManagerImpl`, with its model fully initialized from persisted data (or a semi-sane default if de-persisting failed). It will be available from `WindowManager.getDefault();`
+
+=== Showing/creating the UI
+
+The next phase happens when setVisible(true) is called on the window system. A thing to know here if you read the code is that all requests to do anything in the window system are funneled through one class called `Central` (yes, Central is the _God Object_ anti-pattern). So pretty much any method that you look at in the model objects will call back through a method in Central, sometimes to itself, sometimes to some other object.
+
+So...
+
+* `WindowManager.show()`:
+* asserts we're on the EDT
+* installs the global KeyEventDispatcher on Swing's KeyboardFocusManager to handle action bindings
+* calls WindowManagerImpl.getInstance().setVisible(true) - that in turn checks that its a state change and calls
+* Central.setVisible(true) which calls `DefaultModel.setVisible(true)` (this just stores the boolean value in a field)
+* calls `ViewRequestor.scheduleRequest()` - enqueues a runnable that will set the window system's visibility property to true, which
+* * has a special check if it's a visibility change request, and if so tries to run it immediately if on the EDT (semi-BUG: it will always be the EDT, unless the assertion is turned off)
+
+Now we're into the runtime behavior of the window system - this system of enqueuing requests is how code that will change window system state operates: A change is made to the model of the expected state of the window system, and the requested change is encoded in an object that will be processed in a subsequent event on the EQ. ViewRequestor keeps a list of all pending changes, and coalesces changes to the same value. When the request is processed, the state of the UI (open components, positions, splitter positions, everything) as described by the model is composed into a "snapshot", which is then used to set the necessary parameters on the UI components.
+
+But right now, we're still just showing the window system, period. Here's what happens:
+
+* `ViewRequestor.processRequest()` gets called when the request runs. It gets the array of all pending requests and clears the queue
+* It iterates the `ViewRequests` that are enqueued
+* For each, create a `ViewEvent` and add it to a list of events to be processed
+* and passes that to `ViewRequestor.dispatchRequest`, which
+* passes them to `DefaultView.changeGUI()`. View is an interface representing the UI state of the entire window system. It's another set of model objects, this time modelling the state of the component. For each model object (`ViewElement`, `ModeContainer`, `ModeView` are interfaces the winsys implements elsewhere...), there is also an "accessor" object, which is what actually talks to the UI component.
+
+`DefaultView.changeGUI` is what will actually modify the UI. A `ViewEvent` is pretty much like a PropertyChangeEvent, with an old value and a new value, but with an integer type instead of a property name. What it does:
+
+* Diff the last known showing set of `TopComponent`s and find any newly shown TC's and call `componentShowing()` on them
+* Iterate all the `ViewEvents` and see if any one is a visibility change for the entire window system (BUG? There is already special handling to dispatch such requests ahead of the queue - this seems to duplicate the work). (BUG: Interestingly, this is the real source of the componentShowing() called twice bug that has the hotfix mentioned above - if the order of operations is switched here, that hack can be deleted. Note if the request is a visibility change request, method returns after calling WindowSystemVisibilityChanged()).
+* Iterate all the ViewEvents passed:
+* for each, check the type, and for each type, cast the new value and old value to the proper types, and
+* call a setter on the UI-view-model object that in turn should call something on the actual UI component
+
+But we're getting ahead of ourselves here - as you may have noticed above, if it's a window system visibility request, we actually exit before we've gotten to iterating all the `ViewEvent`s the second time, to change component state and so forth.
+
+I should mention `ViewHierarchy` here - it's not a very exciting class, but it's the root model for the UI model objects, so when you have one of those `Accessor` objects for a `Mode` or a component in a mode, it's where you get the corresponding model object whose setters will actually call the real UI component.
+
+So let's go back to where we call `windowSystemVisibilityChanged()`. What that does:
+
+* First, we call `hierarchy.getMainWindow()` (now we're actually touching GUI - the main window is a `JFrame` subclass, `MainWindow` - so this is the first time we're really creating components, except for the `TopComponent`s we deserialized. What that does:
+* set the icon
+* add a `WindowListener` that will call `LifecycleManager.exit()` on `WindowClosing`, and close menus if the window is deactivated
+* set the menu bar (this calls a whole bunch of code that generates the menu from folders of actions in the system filesystem - we won't cover it here)
+* install the toolbar panel
+* Install the statusbar (and check the special constant for putting it in the menubar for screen real estate freaks)
+* Install a `JPanel` at `BorderLayout.CENTER`, called `desktopPanel`, which our window system will live in in MDI mode
+* Install a hack listener on `MenuSelectionManager` to focus the main window if a menu is activated - this is SDI mode specific - you can invoke a menu by mnemonic but then the keyboard doesn't work unless you send focus to the main window - see link:http://www.netbeans.org/issues/show_bug.cgi?id=38810[issue #38810]
+
+Now we're back out in `DefaultView.windowSystemVisibilityChanged()`. What we do now:
+
+* Set the toolbar configuration - this should actually cause the toolbars to be instantiated (there can be multiple toolbar configurations - it's how the debugger changes the set of visible toolbars when you start it)
+* Next, we go back to `MainWindow` by calling `hierarchy.getMainWindow().prepareWindow()`. What that does:
+* Calls back to `WindowManagerImpl` and gets the main window bounds (different calls for MDI and SDI). We stored this value there when we loaded the window system data, from `WindowManagerConfig`
+* If not empty, set those bounds on the main window
+* (BUG: there's a bunch of weird consecutive log statements here that should be deleted)
+* Next we call `hierarchy.setSplitModesVisible()`, which gets the root split pane of the split desktop layout, and recursively calls `setVisible(true)` on it and all its tabbed containers and `TopComponent`s
+* Next we get the bitmask frame state we should have and call `Frame.setExtendedState()` with it on the main window
+* Now we set the maximized `Mode`, if any, that we stored when de-persisting
+* Then we call `hierarchy.updateDesktop()`. This takes the root split pane and adds it to the "desktop" `JPanel` inside the main window
+* Now we run some code to show all the frames for SDI mode windows, if any
+* Next we set up the editor area, using a dummy panel in TDI mode if there are no open editors
+* Update frame states for SDI windows, if any (BUG?: shouldn't we do this before calling show() on them all? Harmless since `show()` is asynchronous, but I'm not sure all AWT impls have to make it asynch) MKLEINT: On some (maybe all) platforms setting of frames states before it's shown has no effect. In other words, you cannot open an initially maximized frame. You need to show it and maximize then.
+* Set the main window title - using `WindowSystemAccessor.getProjectName()`
+* If the main window is maximized, run a hack that fakes the user resizing the window to its current size, passing that into the model (which will generate a synchronization `ViewRequest` and update splitters, etc. to proportional relative sizes)
+* Get the activated mode, and tell it it's activated (meaning focus should be sent to the `TopComponent` that should have focus, and `componentActivated()` will be called, etc.
+* InvokeLater adding listeners to the main window for resize and mode changes (invokeLater it so that when the frame state changes that we called to initialize the frame state on startup don't get processed as the user resizing the window and cause a storm of window system updates just because frame state changes in AWT are processed asynchronously - so we want to start listening only after things have settled down - see issues link:http://www.netbeans.org/issues/show_bug.cgi?id=39238[39238] andlink:http://www.netbeans.org/issues/show_bug.cgi?id=37369[37369] (the fix for 37369 caused 39238)
+
+MKLEINT: again this is a hacky workaround to the fact that one cannot prepare a maximized version of the frame before it's shown.
+
+At this point we've got our main window up and ready to go.
+
+Obvious questions for those unfamiliar with the winsys:
+
+Q: So where do all the tabbed containers and split panes come from? You didn't mention those.
+
+A: The actual implementations of `ViewElement` (things that own `ViewEvent`s), like `org.netbeans.core.windows.view.ModeView` actually create the UI components they talk to in their constructors
+
+Q: Why are `TopComponents` treated so differently and what's this reference stuff in the de-persisting process?
+
+A: In the pre-3.5 window system, a component could be open in more than one tabbed container at the same time. What??? It is because of workspaces, which we got rid of. A workspace was a switchable window system configuration or set of windows. The interface is still there, but there is only ever one workspace in the post 3.5 winsys. So any given Mode, for legacy reasons, is not sole owner of a `TopComponent`, it just has a handle for one.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsInternals[http://wiki.netbeans.org/DevFaqWindowsInternals] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:05:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsMatisse.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsMatisse.asciidoc
new file mode 100644
index 0000000..5951512
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsMatisse.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsMatisse
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I use Matisse/GroupLayout (new form editor/layout manager in 5.0) in my window system components?
+
+When you create a new window system component (link:DevFaqWindowsTopComponent.html[TopComponent]) using the template wizard in NB 5.0 or greater, the default layout manager is `GroupLayout` (the new, super-easy-to-design-with layout manager in NB 5.0). So you do not need to do anything special. Your module will have a declared dependency on the corresponding library module which is in the NB Platform as of 5.0.
+
+`GroupLayout` is included in JDK 6; as long as JDK 5 needs to be supported (until JDK 8 is released at a minimum), NetBeans will use the library version rather than the JDK 6 version.
+
+---
+
+Applies to: NetBeans 5.0, 5.5, 6.x
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsMatisse[http://wiki.netbeans.org/DevFaqWindowsMatisse] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:05:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsMaximizeViaCode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsMaximizeViaCode.asciidoc
new file mode 100644
index 0000000..9832f9b
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsMaximizeViaCode.asciidoc
@@ -0,0 +1,68 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsMaximizeViaCode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to maximize a TopComponent?
+
+Example: How to open the output window in maximized state?
+
+[source,java]
+----
+
+//----open/focus the TC "OutputWindow"
+TopComponent tc = WindowManager.getDefault().findTopComponent("output");
+if (!tc.isOpened()){ tc.open();}
+tc.requestActive();
+
+//----invoke the maximize action on the previously focused TC
+//new way >=7.2
+Action action=org.openide.awt.Actions.forID("Window", "org.netbeans.core.windows.actions.MaximizeWindowAction");
+//OLD way <7.2
+//Action action = FileUtil.getConfigObject("Actions/Window/org-netbeans-core-windows-actions-MaximizeWindowAction.instance", Action.class);
+
+action.actionPerformed(null);
+----
+
+"But it's a hack, not a pretty API:) "
+
+PS: For minimize use
+
+[source,java]
+----
+
+ Action action=org.openide.awt.Actions.forID("Window", "org.netbeans.core.windows.actions.MinimizeWindowAction");
+----
+
+Taken from platform-dev mailing list
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsMaximizeViaCode[http://wiki.netbeans.org/DevFaqWindowsMaximizeViaCode] ,
+that was last modified by NetBeans user Markiewb
+on 2013-06-08T07:58:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsMode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsMode.asciidoc
new file mode 100644
index 0000000..ef8be45
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsMode.asciidoc
@@ -0,0 +1,81 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsMode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a Mode in the Windowing System?
+
+"Mode" refers to "docking mode". A Mode is a place in a main window, a place between splitters. Separate "floating" window is also backed by Mode. Mode is usually visually represented by a tabbed container. Programmatically it is represented by the class `org.openide.windows.Mode`
+
+Think of a `Mode` as synonymous with a one of the tabbed containers you see in the IDE's main window. The name "Mode" is historical, and a bit unfortunate. When you hear "Mode," think tabbed container and you'll be fine.
+
+*A Mode is _not_ a GUI component*. There is no legitimate programmatic way to fetch the component that represents a Mode on-screen, and the windowing system makes no guarantees about what that component is.
+
+Modes can contain one or more link:DevFaqWindowsTopComponent.html[TopComponent]s. They may be visible or non-visible at any given time.
+
+The link:DevFaqCustomWindowMode.html[DevFaqCustomWindowMode] page has a visual representation of the available modes, and link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html] has details about the contents of wstcref and settings files.
+
+=== Pre-Defined Modes
+
+NetBeans defines six modes in core.ui:
+
+* topSlidingSide
+* rightSlidingSide
+* leftSlidingSide
+* bottomSlidingSide
+* explorer
+* properties
+
+NetBeans defines additional modes in other places:
+
+* commonpalette
+* output
+* navigator
+* editor
+* CssPreviewTCWsmode
+
+=== Docking a TopComponent into a Mode
+
+To dock a TopComponent into the 'editor' mode:
+
+[source,java]
+----
+
+Mode myMode = WindowManager.getDefault().findMode("editor");
+TopComponent myTopComponent = WindowManager.getDefault().findTopComponent("MyTopComponent");
+myMode.dockInto(myTopComponent);
+----
+
+''The ID string of the TopComponent can usually be found in that TopComponent's Java file where it gets registered using annotations, or in the layer.xml.
+''
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsMode[http://wiki.netbeans.org/DevFaqWindowsMode] ,
+that was last modified by NetBeans user Maehem
+on 2012-11-13T01:09:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsNoActionsOnToolbars.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsNoActionsOnToolbars.asciidoc
new file mode 100644
index 0000000..e8bcfbb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsNoActionsOnToolbars.asciidoc
@@ -0,0 +1,156 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsNoActionsOnToolbars
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== I want to disable the popup menu on the toolbars in the main window. How do I do that?
+
+There is no canonical (or pretty) way to do this, but there is a hack you can do - it works in NetBeans 5.0, 5.5 and 6.x (and probably earlier versions but this wasn't tested).
+
+Create the following `link:DevFaqModulesStartupActions.html[ModuleInstall]` class (remember to add a reference to it in the module manifest, e.g.
+
+[source,java]
+----
+
+OpenIDE-Module-Install: org/netbeans/modules/toolbarthing/Installer.class
+----
+
+If you are using 5.0's update 1 of module development support or later, you can just use New File > NetBeans Plug-In Modules > Module Installer):
+
+[source,java]
+----
+
+package org.netbeans.modules.toolbarthing;
+import java.awt.Component;
+import java.awt.Container;
+import java.awt.EventQueue;
+import java.awt.event.MouseListener;
+import java.util.ArrayList;
+import java.util.List;
+import javax.swing.JFrame;
+import javax.swing.JToolBar;
+import org.openide.modules.ModuleInstall;
+import org.openide.windows.WindowManager;
+public class Installer extends ModuleInstall implements Runnable {
+
+ public void restored() {
+ WindowManager.getDefault().invokeWhenUIReady(this);
+ }
+
+ public void run() {
+ JToolBar[] tb = findToolbars();
+ for (int i = 0; i < tb.length; i++) {
+ processToolbar (tb[I]);
+ }
+ }
+
+ private JToolBar[] findToolbars() {
+ List l = new ArrayList();
+ JFrame jf = (JFrame) WindowManager.getDefault().getMainWindow();
+ findToolbars (jf.getContentPane(), l);
+ JToolBar[[ | ]] tb = (JToolBar[[ | ]]) l.toArray(new JToolBar[L.size()]);
+ return tb;
+ }
+
+ private void findToolbars(Component c, List l) {
+ if (c instanceof JToolBar) {
+ l.add(c);
+ } else if (c instanceof Container) {
+ Component[] cc = ((Container) c).getComponents();
+ for (int i=0; i < cc.length; i++) {
+ findToolbars(cc[I], l);
+ }
+ }
+ }
+
+ private void processToolbar (JToolBar bar) {
+ MouseListener[] ml = bar.getMouseListeners();
+ for (int i = 0; i < ml.length; i++) {
+ if (ml[I].getClass().getName().indexOf("PopupListener") >= 0) {
+ bar.removeMouseListener (ml[I]);
+ }
+ }
+ }
+}
+----
+
+The above doesn't seems to work in 6.9.1. This is another similar module installer hack to achieve this:
+
+[source,java]
+----
+
+public class Installer extends ModuleInstall
+{
+
+ public void restored()
+ {
+ removeToolbarPopupMenu();
+ }
+
+ private void removeToolbarPopupMenu()
+ {
+ WindowManager.getDefault().invokeWhenUIReady(
+ new Runnable()
+ {
+ @Override
+ public void run()
+ {
+ removeAllPopupListeners(ToolbarPool.getDefault());
+ }
+ });
+ }
+
+ private static void removeAllPopupListeners(Component c)
+ {
+ if(c instanceof Container)
+ {
+ for(Component c2 : ((Container)c).getComponents())
+ {
+ for(MouseListener l : c2.getMouseListeners())
+ {
+ if(l.getClass().getName().contains("PopupListener"))
+ {
+ c2.removeMouseListener(l);
+ // Uncomment to obtain a similar console output
+ // Removing: org.openide.awt.ToolbarPool$PopupListener@1535ac from javax.swing.JPanel[...]
+ // Removing: org.openide.awt.ToolbarPool$PopupListener@1535ac from org.openide.awt.Toolbar[File,...]
+ //System.out.println("Removing: " + l + " from " + c2);
+ }
+ }
+ findToolbars(c2);
+ }
+ }
+ }
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsNoActionsOnToolbars[http://wiki.netbeans.org/DevFaqWindowsNoActionsOnToolbars] ,
+that was last modified by NetBeans user Adayth
+on 2011-06-15T11:23:36Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenInMode.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenInMode.asciidoc
new file mode 100644
index 0000000..afea393
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenInMode.asciidoc
@@ -0,0 +1,58 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsOpenInMode
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== My TopComponent always opens in the editor area, but I want it to open in the same place as XYZ?
+
+By default, `TopComponent.open()` opens all components in the central editor area of the
+main window. Overriding this is simple:
+
+[source,java]
+----
+
+public MyTopComponent extends TopComponent {
+ public void open() {
+ Mode m = WindowManager.getDefault().findMode ("output");
+ if (m != null) {
+ m.dockInto(this);
+ }
+ super.open();
+ }
+}
+----
+
+You need to know the ID of the link:DevFaqWindowsMode.html[Mode ] you want to put the component in. Common IDs are "output" for the bottom of the screen, and "explorer" for the left side. For other Modes, you may need to find a module that puts something there and read its layer files, or link:DevFaqFilesystemSee.html[browse] the link:DevFaqSystemFilesystem.html[System Filesystem].
+
+Eventually you will probably want to specify what mode to dock your component into using the link:DevFaqWindowsXmlApi.html[XML API for installing components], but the above technique works for simple modules, testing, etc.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsOpenInMode[http://wiki.netbeans.org/DevFaqWindowsOpenInMode] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:06:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenTopComponents.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenTopComponents.asciidoc
new file mode 100644
index 0000000..db5868e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsOpenTopComponents.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsOpenTopComponents
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Which TopComponents are open?
+
+If you need to know which TopComponents are opened use the following:
+
+[source,java]
+----
+
+for (TopComponent tc : TopComponent.getRegistry().getOpened()) {
+ //Code here
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsOpenTopComponents[http://wiki.netbeans.org/DevFaqWindowsOpenTopComponents] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:38:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponent.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponent.asciidoc
new file mode 100644
index 0000000..f03dfab
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponent.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsTopComponent
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a TopComponent in the Window System?
+
+[link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html[http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html] `org.openide.windows.TopComponent`] is a `JComponent` subclass which knows how to work with
+the NetBeans window system. If you want to add components to the main window, typically you will subclass TopComponent, using it the same way you would a `JPanel`.
+
+TopComponents live inside link:DevFaqWindowsMode.html[Mode]s - docking containers.
+
+TopComponents can have various states:
+
+* *open/closed* - When a TopComponent is _open_, a tab exists somewhere in the main window or UI for it
+* *visible/invisible* - When a TopComponent is _visible_, it is the selected tab in its link:DevFaqWindowsMode.html[Mode]
+* *active/inactive* - When a TopComponent is _active_, it or a child component of it has keyboard focus, and it is currently the global link:DevFaqTrackGlobalSelection.html[selection context]
+
+Each `TopComponent` has a `link:DevFaqLookup.html[Lookup]` and one or more `link:DevFaqWhatIsANode.html[activated Node]`s. These define the link:DevFaqTrackGlobalSelection.html[selection context] for the window system, which determines what actions (menu items, toolbar buttons, etc.) are enabled, and in some cases, what they will do or operate on if invoked.
+
+`TopComponent`s are part of the link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[Windows API].
+
+TopComponents that were already open may be deserialized and reopened on restart. The template that NetBeans 5.0 provides includes code for this - it is actually using saved using the Externalizable interface. Whether or not it is saved is determined by what you return from `getPersistenceType()`.
+
+For information on how and when these are reconstructed on startup, see the link:DevFaqWindowsInternals.html[gory details of the window system on startup].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsTopComponent[http://wiki.netbeans.org/DevFaqWindowsTopComponent] ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-25T16:18:58Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponentLookup.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponentLookup.asciidoc
new file mode 100644
index 0000000..8e698cd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsTopComponentLookup.asciidoc
@@ -0,0 +1,45 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsTopComponentLookup
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why does `TopComponent` have a `getLookup()` method? What is it for?
+
+The windowing system is what manages link:DevFaqTrackGlobalSelection.html[global selection]. In olden times, selection meant the activated link:DevFaqWhatIsANode.html[Node].
+
+In modern NetBeans, the global selection is really whatever objects are in the focused `link:DevFaqWindowsTopComponent.html[TopComponent]`'s link:DevFaqLookup.html[Lookup]. It so happens that most standard TopComponents display `link:DevFaqWhatIsANode.html[Node]`s - so for most `TopComponent`s, the component's `Lookup` is just proxying the `Lookup` of the selected Node.
+
+Rather than thinking of the selection as some specific object or Node, it is more useful to think of it as a grab bag of stuff provided by whatever component happens to have focus. If you use `link:DevFaqTrackGlobalSelection.html[Utilities.actionsGlobalContext()]`, you do not have to track all the different grab-bags of stuff provided by different components - you can get one grab bag of stuff which whose content will simply change (notifying you in the process) when focus moves to a different component.
+
+So the `TopComponent`'s `Lookup` is a way to provide your particular grab bag of stuff - it can be the lookup of a `Node` if you want, or it can be/contain whatever else or in addition you'd like to put there.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsTopComponentLookup[http://wiki.netbeans.org/DevFaqWindowsTopComponentLookup] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:06:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsWstcrefAndFriends.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsWstcrefAndFriends.asciidoc
new file mode 100644
index 0000000..a252e1e
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsWstcrefAndFriends.asciidoc
@@ -0,0 +1,51 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsWstcrefAndFriends
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What are the various window system file formats like `.wstcref` and how do I use them?
+
+The window system on screen is composed of tabbed areas called "modes" (originally this was intended as "docking mode" as in the way a component is docked into the main window - yes, it's a lousy name). These correspond to the class org.openide.windows.Mode. In the link:DevFaqSystemFilesystem.html[system filesystem], each Mode is represented by a folder.
+
+At least in theory, a link:DevFaqWindowsTopComponent.html[TopComponent] can exist in more than one link:DevFaqWindowsMode.html[Mode], so there is a one-to-many relationship. The pre-NetBeans 3.6 windowing system had a concept of "workspaces", and a Mode could be opened on multiple workspaces. So instead of putting TopComponents (as represented by the .settings files) into the folders directly, you put those link:DevFaqDotSettingsFiles.html[settings files] into the `Windows2Local/Components` folder. And you put a Window System Top Component Reference - or .wstcrf - lovely to pronounce - in the mode folder. It's like a symbolic link, pointing to the link:DevFaqDotSettingsFiles.html[.settings] file in the `Windows2Local/Components` folder via its ID. That way, one `TopComponent` could be linked to by several `Mode`s.
+
+`Mode`s have configuration data too, such as the constraints for where in the main window they should appear - what side, what TopComponent should be selected etc. So for each `Mode` defined in `Windows2/Modes`, there is also a `.wsmode` file that contains that information.
+
+The system filesystem is read-write - so changed information (for example, the user dragged a tab to a different `Mode` or opened or closed it) is saved to the user's settings directory, transparently. On a restart, the saved information will be read in and restored.
+
+So what happens is, if the user changes the position of windows, the selected tab, the splitter positions, etc., then new versions of the `.settings`, `.wsmode` or `.wstcref` files will be saved in the userdir in order to restore the state on restart to how the user had configured it.
+
+One handy way to generate all of those files, rather than doing it by hand, is to just create an action in your module that will open your `TopComponent`. Run it on a clean userdir, open your TopComponent, and put it where you want it to appear. Shut down. Go into your link:DevFaqUserDir.html[user dir], and copy the files the IDE persisted into your module. Edit to taste, add references in your module's layer file (any module that opens a component is a good example - try core/navigation) and voila.
+
+You may want to look at the link:DevFaqSampleCode.html[samples] - there are example modules that use all of the declarative window system APIs and file formats.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsWstcrefAndFriends[http://wiki.netbeans.org/DevFaqWindowsWstcrefAndFriends] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:06:37Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWindowsXmlApi.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWindowsXmlApi.asciidoc
new file mode 100644
index 0000000..8e4e892
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWindowsXmlApi.asciidoc
@@ -0,0 +1,63 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWindowsXmlApi
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How does the declarative XML API for the window system work?
+
+The API is not hard, just a bit baroque.
+
+On startup, the window system needs to know some things to
+construct the main window, and possibly restore the state it was in before shutdown:
+
+* The window system needs know what components it will be displaying
+* It needs to know where to display individual components
+* And it has a way to define places where components can be displayed, and needs to know what places have been defined
+
+It would be a disaster for performance if all possible components in the system had
+to be instantiated/deserialized during startup just to figure out if they actually
+need to be on screen. The XML definitions for window system components allow
+a module to completely declaratively provide all the information described above.
+
+There are three main file types to be concerned with - these are put in the link:DevFaqSystemFilesystem.html[System Filesystem ]
+by declaring them in your module's link:DevFaqModulesLayerFile.html[layer file]:
+
+* *`link:DevFaqDotSettingsFiles.html[.settings files]`* - representing link:DevFaqWindowsTopComponent.html[TopComponent]s that will be on screen - these go in `Windows2/Components`
+* *`link:DevFaqWindowsMode.html[.wsmode files]`* - representing link:DevFaqWindowsMode.html[docking modes] - places where TopComponents can be put - think of them as tabbed containers - these go in `Windows2/Modes`. For each Mode, you will also create a folder in `Windows2/Modes` where the `.wstcref` files that indicate what components are present can go TopComponents can live (essentially tabbed containers)
+* *`link:DevFaqWindowsWstcrefAndFriends.html[.wstcrf files]`* - a pseudo symbolic-link that contains some configuration data and points to the appropriate .settings file via its ID - put these in the folder you created in `Windows2/Modes`
+
+See also:
+
+* link:DevFaqWindowsWstcrefAndFriends.html[How to use .wstcrf and other files]
+* link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[The Window System API]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWindowsXmlApi[http://wiki.netbeans.org/DevFaqWindowsXmlApi] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:06:42Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWizardChangeLabelsOfDefaultButtons.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWizardChangeLabelsOfDefaultButtons.asciidoc
new file mode 100644
index 0000000..f52cf59
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWizardChangeLabelsOfDefaultButtons.asciidoc
@@ -0,0 +1,44 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWizardChangeLabelsOfDefaultButtons
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Customize the text of default buttons in wizard dialog
+
+Need to customize the button text of the default buttons of a wizard (Finish, Cancel, etc.)?
+
+* Workaround: easiest option would be to setText() on the button returned from getOptions()
+* link:https://netbeans.org/bugzilla/show_bug.cgi?id=229765[https://netbeans.org/bugzilla/show_bug.cgi?id=229765]
+
+See posts from mailing list link:http://forums.netbeans.org/topic55192.html[http://forums.netbeans.org/topic55192.html]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWizardChangeLabelsOfDefaultButtons[http://wiki.netbeans.org/DevFaqWizardChangeLabelsOfDefaultButtons] ,
+that was last modified by NetBeans user Markiewb
+on 2013-05-16T18:17:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWizardPanelError.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWizardPanelError.asciidoc
new file mode 100644
index 0000000..9dd298c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWizardPanelError.asciidoc
@@ -0,0 +1,56 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWizardPanelError
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== Q: How do I show that a user has filled an invalid input into my wizard?
+
+A: Set the `WizardPanel_errorMessage` property in the WizardPanel instance that is related to the displayed panel.
+
+Example:
+
+`wizardDescriptor.putProperty("WizardPanel_errorMessage", NbBundle.getMessage(MyPanel1.class, "key"));`
+
+*_Note_*: Since WizardDescritor, spec.version 7.8 (i.e.since link:http://www.netbeans.org/downloads/index.html[NetBeans 6.5 Platform])
+
+* you can use `WizardDescriptor.PROP_ERROR_MESSAGE` instead of "WizardPanel_errorMessage".
+* beside `WizardDescriptor.PROP_ERROR_MESSAGE` you can also use `WizardDescriptor.PROP_WARNING_MESSAGE` for warning messages or `WizardDescriptor.PROP_INFO_MESSAGE` for information messages.
+* All kind of messages will be badged with appropriate icons: error image:Error.gif[], warning image:Warning.gif[], info image:info.png[]
+* To clean the message just call `wizardDescriptor.putProperty(WizardDescriptor.PROP_ERROR_MESSAGE, null);`
+
+You can obtain the instance of `WizardDescriptor` in the `WizardDescriptor.Panel.readSettings` as `settings` parameter method.
+
+== Update in NetBeans 6.8
+
+Two new methods in `NotifyDescriptor` were added to allow API client to create link:http://bits.nbextras.org/dev/javadoc/org-openide-dialogs/org/openide/NotificationLineSupport.html[NotificationLineSupport] which allow handling error/warning/info messages in dialogs. If a dialog descriptor creates this support, `DialogDisplayer` allocates necessary space at the bottom of dialog where API clients can set info/warning/error messages with appropriate icons.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWizardPanelError[http://wiki.netbeans.org/DevFaqWizardPanelError] ,
+that was last modified by NetBeans user Jrechtacek
+on 2009-12-15T14:23:16Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevFaqWrapperModules.asciidoc b/wiki-convert/wiki-asciidoc/DevFaqWrapperModules.asciidoc
new file mode 100644
index 0000000..ffbfe23
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevFaqWrapperModules.asciidoc
@@ -0,0 +1,217 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevFaqWrapperModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is a library wrapper module and how do I use it?
+
+If your module uses some external library,
+you will probably use a wrapper module to make classes from that library available to your module at runtime.
+
+A wrapper module is a module that contains no code;
+really the only significant thing about it is its manifest, which does two significant things,
+in addition to the standard module unique ID/version/etc.:
+
+* Has a `Class-Path` entry for one or more JARs, conventionally in the subdirectory `ext/` of the directory where the module is.
+* Declares `OpenIDE-Module-Public-Packages` followed by a list of the packages from the library that other modules should be able to use.
+
+You can use *File > New Project > NetBeans Modules > Library Wrapper Module* to make a library wrapper.
+
+So a wrapper module acts as a proxy to turn a library into a NB module.
+Since you can't modify the NetBeans classpath directly (link:DevFaqNetBeansClasspath.html[DevFaqNetBeansClasspath]),
+nor would you want to,
+this is the way you let your code use third-party libraries.
+It serves the same function that running with `java -cp` or setting `CLASSPATH`
+would do in a smaller Java application.
+
+There are other options for packaging libraries described in link:DevFaqWhenUseWrapperModule.html[DevFaqWhenUseWrapperModule].
+
+If the above was confusing, read link:DevFaqModuleDependencies.html[DevFaqModuleDependencies].
+
+=== Using a wrapper module for an existing project
+
+If you are developing the library yourself, but decide you want to
+keep the library project separate from any NB module project, you can
+do so. Just make a plain Java project for the library and build it;
+and also create a library wrapper module from its JAR output. Here are
+two ways to hook them up. The first modifies the project so that when
+the project is built, it copies the jar to the wrapper module. The
+second modifies the wrapper module so that the wrapper cleans, builds
+and picks up the jar.
+
+=== Method 1
+
+To hook them up (since the library wrapper module wizard just
+copies the JAR you select), you can make the plain Java SE project
+build into the wrapper. Say your Java SE project is in
+e.g.`/src/suite/libs/foo` and your NBM wrapper is in
+`/src/suite/foo-wrapper`; just edit
+`/src/suite/libs/foo/nbproject/project.properties` to specify e.g.:
+
+[source,java]
+----
+
+dist.jar=../../foo-wrapper/release/modules/ext/foo.jar
+----
+
+Now you can just build the Java SE project and it will update the
+wrapper's JAR file. Also code completion on anything that compiles
+against the foo library should "see" sources in
+`/src/suite/libs/foo/src` (so long as the Java SE project is open).
+
+=== Method 2
+
+Here's how to have the wrapper module build/clean the Java SE project
+and then pick
+up the JAR from the Java SE project's original location. This method provides
+source association (even if the Java SE project is not open!). You
+modify a few things in the wrapper project
+
+1. `project.xml`
+adjust the `<class-path-extension>`
+2. `project.properties`
+ specify `extra.module.files`
+3. remove the wrapper's release directory
+4. `build.xml`
+ to override the `release` target
+
+The following example demonstrates these steps.
+`harness/README` gives the details.
+See also , which would make it easier.
+
+==== Example using method 2: Having the wrapper module clean and build the project
+
+With these changes to a wrapper module, build/clean on the
+wrapper, or on the module suite that contains the wrapper, also does
+build/clean on the project.
+
+For this example, `my-wrapper` is a library wrapper module for the JAR file
+produced by the regular Java project called `my-project`.
+`my-project` and `my-wrapper` are in the same directory; this only
+affects relative path specifications and is not a general requirement.
+This example was created on NetBeans 5.5. If you have jars from
+multiple projects in a wrapper, then this example is extended by using
+`<antsub>` instead of `<ant>` and a `FileSet` in the `release`
+target's `<copy>` task.
+
+_Only the `my-wrapper` project needs modification._
+
+==== First
+
+In `my-wrapper/nbproject/project.xml`, change
+`<class-path-extension>`'s `<binary-origin>` to
+reference the jar created by `my-project`. This change gives
+code completion with Javadoc and Go to Source when referencing
+`my-project`.
+
+[source,xml]
+----
+
+<binary-origin>../my-project/dist/my-project.jar</binary-origin>
+----
+
+''Make sure a `../src` directory (relative to the JAR location) containing the corresponding sources of the
+library exists if you want Go to Source functionality to work.''
+
+==== Second
+
+In `my-wrapper/nbproject/project.properties` specify where
+`my-project`'s JAR file is installed in the suite's cluster. This
+puts `my-project.jar` in the wrapper's NBM; it is needed since the
+wrapper's release directory is no longer used as a staging area.
+
+[source,java]
+----
+
+extra.module.files=modules/ext/my-project.jar
+----
+
+==== Third
+
+Delete the directory `my-wrapper/release`. The original JAR file was
+copied here when the wrapper was created.
+_It will interfere if it is left around._
+
+==== Fourth
+
+In `my-wrapper/build.xml` add the following. Customize the first
+two properties' `value=` to specify your project's relative location and JAR.
+The `release` target is replaced; now it builds `my-project` then
+copies the JAR to the suite's cluster. The clean target
+first cleans as usual, then cleans `my-project`.
+
+[source,xml]
+----
+
+<property name="original.project.dir" value="../my-project"/>
+<property name="original.project.jar"
+ value="${original.project.dir}/dist/my-project.jar"/>
+
+<target name="release">
+ <echo message="Building ${original.project.dir}"/>
+ <ant dir="${original.project.dir}" usenativebasedir="true"
+ target="jar" inheritall="false" inheritrefs="false"/>
+ <echo message="Done building ${original.project.dir}"/>
+
+ <copy todir="${cluster}/modules/ext"
+ file="${original.project.jar}"/>
+</target>
+
+
+<target name="clean" depends="projectized-common.clean">
+ <echo message="Cleaning ${original.project.dir}"/>
+ <ant dir="${original.project.dir}" usenativebasedir="true"
+ target="clean" inheritall="false" inheritrefs="false"/>
+ <echo message="Done cleaning ${original.project.dir}"/>
+</target>
+----
+
+=== How do I include native libraries (`*.so` or `*.dll`) in my library wrapper module?
+
+Some libraries come with a native counterpart.
+The current Library Wrapper wizard doesn't cater to this.
+As per the JNI section in link:http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html#jni[this document],
+you simply need to create a `lib` directory under `<my-wrapper>/release/modules`
+(which gets created by the wizard),
+alongside the `ext` directory mentioned earlier in this document.
+This directory is where you place your native libraries.
+
+=== How do I include more that one jar in my library wrapper module?
+
+With the library wrapper creation wizard it's possible to choose more than one jar (use the CTRL key to select more than one file in the file dialog). Or enter absolute file paths divided by the path separator (e.g. ; for windows systems) into the (very small) file input field.
+
+To add later more, use the project's properties dialog.
+
+<hr/>
+Applies to: NetBeans 6.8 and later
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevFaqWrapperModules[http://wiki.netbeans.org/DevFaqWrapperModules] ,
+that was last modified by NetBeans user Mwisnicki
+on 2010-11-29T15:53:52Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevInstallerAddVersioningInfo.asciidoc b/wiki-convert/wiki-asciidoc/DevInstallerAddVersioningInfo.asciidoc
new file mode 100644
index 0000000..68badfe
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevInstallerAddVersioningInfo.asciidoc
@@ -0,0 +1,97 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevInstallerAddVersioningInfo
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== How to add versioning information to be shown in "Installed Programs" (Windows-only)?
+
+Question from mailing list: _"How to add version information into windows control panel for NetBeans platform applications? When the installer ran then it only added "Installed On" information for my application."_
+
+=== Solution
+
+What you are asking about is the information shown in MS Windows Control Panel --> Installed Programs (at least that's how you find it on Win7). First thing to realize is that Windows treats this pretty much as display info. It serves no other purpose than to be displayed in that window. It is up to the software publisher how many of these properties he wants to define. You can find a list of these properties here:
+
+link:http://msdn.microsoft.com/en-us/library/aa372105%28v=vs.85%29.aspx[http://msdn.microsoft.com/en-us/library/aa372105%28v=vs.85%29.aspx]
+
+You'll find that even official MS applications, like MS Word, only uses a subset of these properties. The most important ones, IMO, is "DisplayVersion" and "Publisher". Again, remember that this is nothing but text strings. Windows doesn't use them for anything. The one you ask about is "DisplayVersion".
+
+Ok, so how can NBI support this? As these "properties" are nothing but Windows Registry keys you could set them in a native script. However NBI actually has support for this. All you need to do is override your ConfigurationLogic.java file and more specifically override the getAdditionalSystemIntegrationInfo() method to include the Registry keys you want.
+
+Here's what I do:
+
+[source,java]
+----
+
+/**
+* Add additional properties that are specific to the platform. Currently
+* only used for Windows. These properties will be displayed in the Windows
+* Control Panel --> Installed Programs. Some of these will be displayed in
+* the window's table (like "Publisher" and "DisplayVersion") while others
+
+* (like "URLInfoAbout") are only displayed when a line in the table is
+* highlighted. However the user can customize what columns to show in the
+* table by right-clicking on any of the columns.
+*
+* NBI will take whatever you put in the Map below and set it as Windows
+* Registry keys so you need to know the name of the appropriate Windows
+* Registry key. Here's a list:
+* http://msdn.microsoft.com/en-us/library/aa372105%28v=vs.85%29.aspx
+*
+* Beware that many of these keys are pretty much unused by software
+* publishers, even Microsoft itself. Concentrate on "DisplayVersion" and
+* "Publisher".
+*
+* @return
+*/
+@Override
+public Map<String, Object> getAdditionalSystemIntegrationInfo() {
+
+ Map<String, Object> map = super.getAdditionalSystemIntegrationInfo();
+
+ if (SystemUtils.isWindows()) {
+ map.put("DisplayVersion", getString("CL.winsystem.display.version"));
+ map.put("Publisher", "Montana Wonder Systems Inc");
+ map.put("URLInfoAbout", "http://www.montanawondersys.com");
+ map.put("URLUpdateInfo", "http://www.montanawondersys.com");
+ }
+ return map;
+}
+
+----
+
+With this NBI will take care of setting the Registry Keys.
+
+How you actually override the ConfigurationLogic.java file depends if you're using Ant or Maven. You should be able to figure it out with some Googling.
+
+Provided in the platform-dev mailing list by Peter Hansson
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevInstallerAddVersioningInfo[http://wiki.netbeans.org/DevInstallerAddVersioningInfo] ,
+that was last modified by NetBeans user Markiewb
+on 2014-12-28T20:56:56Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/DevRunningTestsPlatformApp.asciidoc b/wiki-convert/wiki-asciidoc/DevRunningTestsPlatformApp.asciidoc
new file mode 100644
index 0000000..d1f82cd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/DevRunningTestsPlatformApp.asciidoc
@@ -0,0 +1,64 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= DevRunningTestsPlatformApp
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Running Tests on a Platform Application
+
+The following article describes some of the ways you can run tests (whether unit or functional) on a NetBeans Platform application.
+
+===== What is a unit test versus a functional test?
+
+_Unit test_ is a test on a method not on the overall functionality of a tool or application. Example of unit test if testing of a method than should return always positive integer. _Functional test_ is testing the overall encryption algorithm that uses that method.
+
+==== From the NetBeans IDE
+
+* You can run a single test from the IDE by right-clicking the test's node within the project explorer and choosing 'Test' from the context menu. If you have the test source file (or the class which corresponds to the test case) open in the editor, you can run it by pressing Ctrl+F6 or its equivalent for your operating system.
+* You can run all tests within a single module by right-clicking the module in the project explorer and choosing 'Test' from the context menu. The default shortcut for this on Windows and most Unix systems is Alt+F6.
+* You can run all tests for the entire application by right-clicking the suite node in the project explorer and choosing 'Test All' from the context menu.
+
+==== From the Command Line Using Ant
+
+* You can run a single unit test by by typing `ant test-unit -Dtest.class=com.tomwheeler.example.MyTestClass` in the module's directory (where `com.tomwheeler.example.MyTestClass` is the name of the unit test class you want to execute). You can add additional JVM arguments by specifying them in the `test.run.args` system property, but be sure to quote them as appropriate for your operating system.
+* You can run a single functional (GUI) test from the command line by typing `ant test-qa-functional -Dtest.class=com.tomwheeler.example.MyTestClass` in the module's directory. As with unit tests, you can specify additional JVM arguments using the `test.run.args` system property.
+* You can run all unit tests for a module by running the `ant test` command from the module's directory.
+* You can run all unit tests for the entire suite by running the `ant test` command from the suite directory.
+
+==== Unit Test Code Coverage
+
+The NetBeans Platform has inherently supported unit test code coverage (using Cobertura) since version 6.7. To generate a report which measures unit test code coverage for a single module, type `ant display-coverage-report` from that module's directory. Likewise, you can generate a report which measures unit test code coverage for all unit tests in the entire suite by typing `ant display-coverage-report` from the suite's directory. See also link:CodeCoverage.html[Code Coverage].
+
+==== Debugging Unit Tests From the Command Line
+
+Debugging tests from using the NetBeans IDE should be pretty straightforward, but if you want to debug a unit test from the command line (i.e. because you want to attach the debugger in a different IDE), then you simply need to run the test from the command line as described above but specify `-Dtest.run.args="-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"`. The test will compile and start to run, but will pause execution until you attach the debugger on port 5005.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/DevRunningTestsPlatformApp[http://wiki.netbeans.org/DevRunningTestsPlatformApp] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:19:35Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqBlanketJCAForEmployees.asciidoc b/wiki-convert/wiki-asciidoc/FaqBlanketJCAForEmployees.asciidoc
new file mode 100644
index 0000000..0027e43
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqBlanketJCAForEmployees.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqBlanketJCAForEmployees
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can my company sign a blanket CA for all its employees?
+
+Yes, a company can sign a blanket CA that will apply to all its employees. In that case, a person authorized to sign document on behalf of your company (usually a VP or higher) must sign the OCA, indicating his or her title. Please contact the Oracle project lead before submitting a company-wide OCA. Among other things, we want to understand who from your company will be authorized to make contributions.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqBlanketJCAForEmployees[http://wiki.netbeans.org/FaqBlanketJCAForEmployees] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T14:49:24Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqCAAndRejectedContribution.asciidoc b/wiki-convert/wiki-asciidoc/FaqCAAndRejectedContribution.asciidoc
new file mode 100644
index 0000000..84e04b8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqCAAndRejectedContribution.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqCAAndRejectedContribution
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I tried to make a contribution to netbeans.org and signed a CA, but my contribution was not accepted. What is the result?
+
+The CA is still effective, but that does not affect your ability to exercise ownership rights in your contribution.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqCAAndRejectedContribution[http://wiki.netbeans.org/FaqCAAndRejectedContribution] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T16:28:20Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqCAForEveryContribution.asciidoc b/wiki-convert/wiki-asciidoc/FaqCAForEveryContribution.asciidoc
new file mode 100644
index 0000000..5bd8668
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqCAForEveryContribution.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqCAForEveryContribution
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Do I have to file a CA for every contribution?
+
+No, once you have a CA on file it will cover all your contributions to netbeans.org, and other projects owned or managed by Oracle, going forward. For more information, read link:FaqOtherSunCA.html[another FAQ].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqCAForEveryContribution[http://wiki.netbeans.org/FaqCAForEveryContribution] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T13:22:45Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqCanICancelCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqCanICancelCA.asciidoc
new file mode 100644
index 0000000..8fb9b78
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqCanICancelCA.asciidoc
@@ -0,0 +1,40 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqCanICancelCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Once I have a CA on file, can I change my mind and cancel?
+
+You can stop your participation in a project at any time, but you cannot rescind your assignments or grants with respect to prior contributions. This protects the whole community, allowing Oracle and downstream users of the code base to rely
+on it. Oracle cannot terminate its responsibilities under the OCA either.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqCanICancelCA[http://wiki.netbeans.org/FaqCanICancelCA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T14:27:23Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqCanIFileByEmail.asciidoc b/wiki-convert/wiki-asciidoc/FaqCanIFileByEmail.asciidoc
new file mode 100644
index 0000000..0016bc4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqCanIFileByEmail.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqCanIFileByEmail
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can I file my completed CA by email?
+
+You may send your signed and completed OCA to Oracle by by fax (number available by request), or by scanning your completed form and emailing the image to link:mailto:oracle-ca_us@oracle.com[oracle-ca_us@oracle.com]. Please specify the project you wish to contribute to in the subject of the e-mail.
+
+link:FaqHowDoIFileACA.html[How do I file the CA?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqCanIFileByEmail[http://wiki.netbeans.org/FaqCanIFileByEmail] ,
+that was last modified by NetBeans user Jkovalsky
+on 2012-04-17T09:28:08Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqCompanyOrIndividualCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqCompanyOrIndividualCA.asciidoc
new file mode 100644
index 0000000..bb3bcf4
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqCompanyOrIndividualCA.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqCompanyOrIndividualCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== If my company wants me to contribute changes, who should sign the CA, me or my company?
+
+The individual should sign the CA. If the contribution involves your company's property, then you need to obtain proper approval from your company. netbeans.org assumes that, when necessary, individuals have obtained the necessary permission from their company.
+
+However, if there are many contributors from the same company it is impractical to send individual OCAs for each employee. In such case it's possible to send a link:FaqBlanketJCAForEmployees.html[blanket company OCA].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqCompanyOrIndividualCA[http://wiki.netbeans.org/FaqCompanyOrIndividualCA] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T13:20:11Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqDoINeedACA.asciidoc b/wiki-convert/wiki-asciidoc/FaqDoINeedACA.asciidoc
new file mode 100644
index 0000000..7239483
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqDoINeedACA.asciidoc
@@ -0,0 +1,52 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqDoINeedACA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Do I have to fill out a Contributor Agreement?
+
+Yes, you _must_ fill out a Contributor Agreement, if
+
+* you intend to contribute *source code or other materials including IDE localizations,* regardless of the size of the contribution, which are intended to be _compiled or otherwise integrated with the NetBeans product_.
+
+All contributors to the *NetBeans.org website* _should_ fill out the CA, as it makes it easier to keep track of contributions.
+
+* If you contribute web content to netbeans.org such as *web page translations, tech tips, etc,* which will _not be included in the product itself_, then the NetBeans Terms of use govern and no Contributor Agreement is needed.
+* If you contribute web content to netbeans.org such as *complete articles, presentations, flash demos, etc*, which will _not be included in the product itself_, then we would prefer you to sign the CA agreement. If you don't, the Terms of Use automatically apply.
+
+link:http://oss.oracle.com/oca.pdf[Oracle Contributor Agreement]
+
+link:http://www.netbeans.org/about/legal/terms-of-use.html[Read the Terms of Use]
+
+link:http://www.netbeans.org/community/contribute/web-content.html[Contribute web content -- what and how]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqDoINeedACA[http://wiki.netbeans.org/FaqDoINeedACA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T13:38:34Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqHowDoIFileACA.asciidoc b/wiki-convert/wiki-asciidoc/FaqHowDoIFileACA.asciidoc
new file mode 100644
index 0000000..afb5031
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqHowDoIFileACA.asciidoc
@@ -0,0 +1,55 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqHowDoIFileACA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How do I file a completed CA?
+
+Oracle must have a fax or hard copy of the CA on file before Oracle can accept contributions and update the list of contributors with an accepted CA. You will find a blank form of the CA at: link:http://oss.oracle.com/oca.pdf[http://oss.oracle.com/oca.pdf]. The CA is in .pdf format (on purpose - we need a format not intended for modification).
+
+
+
+1. Print it, mourn the loss of a tree, fill it out and sign it. Please take care to print your details very clearly, including your *postal and email* address. Also don't forget to *check one statement* in the 7th paragraph regarding scope of your CA.
+
+
+
+2. Scan it and email it to link:mailto:oracle-ca_us@oracle.com[oracle-ca_us@oracle.com]
+
+
+
+3. Please check link:http://www.oracle.com/technetwork/goto/oca[list of approved CA signatories] for your name in the days following your submission. If your name does not show up, or shows up incorrectly, please contact link:mailto:jiri.kovalsky@oracle.com[Jiri Kovalsky] - NetBeans Community Manager.
+
+
+
+4. If you have other questions, please consult the link:http://www.oracle.com/technetwork/oca-faq-405384.pdf[General FAQs guide].
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqHowDoIFileACA[http://wiki.netbeans.org/FaqHowDoIFileACA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-10-13T06:39:47Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqIndex.asciidoc b/wiki-convert/wiki-asciidoc/FaqIndex.asciidoc
new file mode 100644
index 0000000..7491152
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqIndex.asciidoc
@@ -0,0 +1,83 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqIndex
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== NetBeans FAQ Index
+
+=== General FAQs and troubleshooting tips
+
+* link:NetBeansUserFAQ.html[NetBeans User FAQ] - Installation, configuration, packs, usage, community.
+
+* link:FaqArchive.html[FAQ Archive] - Questions and answers for NetBeans IDE 5.5 or older
+
+=== FAQs for specific technologies
+
+* link:NetBeansDeveloperFAQ.html[NetBeans Platform Developer FAQ] - NetBeans plugins and rich-client applications
+* link:NetBeansVWPUserFAQ.html[NetBeans Visual Web Pack FAQ] (Web Application Development)
+* link:NetBeansSOAUserFAQ.html[NetBeans SOA FAQ] (Service Oriented Architecture)
+* link:NetBeansUserFAQ#NetBeansCCDevelopmentPack.html[NetBeans C/C++ Pack FAQ]
+* link:NetBeansUserFAQ#NetBeansMobilityPack.html[NetBeans Mobility Pack FAQ] (Java ME)
+* link:RubyFAQ.html[NetBeans Ruby Support FAQ]
+* link:JavaScriptDebuggerFAQ.html[NetBeans JavaScript Debugger FAQ]
+* link:NBIFAQ.html[NetBeans Installer FAQ]
+
+=== System requirements and _Known Issues_ in the Release Notes by Version
+
+==== NetBeans IDE 6
+
+* link:http://www.netbeans.org/community/releases/61/relnotes.html[NetBeans IDE 6.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/60/relnotes.html[NetBeans IDE 6.0.1 Release Notes]
+
+==== NetBeans IDE 5.5.1
+
+* link:http://www.netbeans.org/community/releases/55/1/relnotes.html[NetBeans IDE 5.5.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/1/vwp-release-notes.html#knownissues[NetBeans Visual Web Pack 5.5.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/1/relnotes-mobility.html[NetBeans Mobility Pack for CLDC 5.5.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/1/relnotes-mobilitycdc.html[NetBeans Mobility Pack for CDC 5.5.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/1/cnd-release-notes.html[NetBeans C/C++ Development Pack 5.5.1 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/1/uml-relnotes.html[NetBeans IDE 5.5.1 UML Modeling Release Notes]
+* link:http://profiler.netbeans.org/download/prev/551_relnotes.html[NetBeans IDE 5.5.1 Profiler Release Notes]
+
+==== NetBeans IDE 5.5
+
+* link:http://www.netbeans.org/community/releases/55/relnotes.html#known_issues[NetBeans IDE 5.5 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/entpack_relnotes.html#known_issues[NetBeans Enterprise Pack 5.5 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/vwp-release-notes.html#knownissues[NetBeans Visual Web Pack 5.5 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/relnotes-mobility.html[NetBeans Mobility Pack 5.5 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/cnd-release-notes.html[NetBeans C/C++ Development Pack 5.5 Release Notes]
+* link:http://www.netbeans.org/community/releases/55/uml-relnotes.html[NetBeans IDE 5.5 UML Modeling Release Notes]
+* link:http://profiler.netbeans.org/download/prev/55_relnotes.html[NetBeans IDE 5.5 Profiler Release Notes]
+
+Do you want to know link:HowToAddFAQEntries.html[How To Add FAQ Entries] ?
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqIndex[http://wiki.netbeans.org/FaqIndex] ,
+that was last modified by NetBeans user Pjiricka
+on 2011-12-01T12:32:12Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqJCAAndCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqJCAAndCA.asciidoc
new file mode 100644
index 0000000..8256844
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqJCAAndCA.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqJCAAndCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I've already signed a JCA; do I still have to sign the CA?
+
+If you've already signed a JCA for a contribution to netbeans.org, then you do not have to sign a CA for additional contributions. However, if you intend to contribute to other Oracle open source projects (such as GlassFish, MySQL or OpenJDK) in addition to netbeans.org, then you may wish to sign a new CA, which will cover all such projects.
+
+link:http://oss.oracle.com/oca.pdf[Oracle Contributor Agreement]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqJCAAndCA[http://wiki.netbeans.org/FaqJCAAndCA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T13:56:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqListedOnCopyright.asciidoc b/wiki-convert/wiki-asciidoc/FaqListedOnCopyright.asciidoc
new file mode 100644
index 0000000..bf91382
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqListedOnCopyright.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqListedOnCopyright
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I have a JCA on file and I have made a code contribution to netbeans.org. Can I get listed on the copyright notice?
+
+It is impractical to include the names of all contributors to netbeans.org in the copyright notice. Instead, Oracle includes a list of all contributors to the netbeans.org project among others at: link:http://www.oracle.com/technetwork/goto/oca[http://www.oracle.com/technetwork/goto/oca]. If you are not listed, and should be, please contact link:mailto:jiri.kovalsky@oracle.com[Jiri Kovalsky], NetBeans Community Manager.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqListedOnCopyright[http://wiki.netbeans.org/FaqListedOnCopyright] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T14:41:18Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqOtherSunCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqOtherSunCA.asciidoc
new file mode 100644
index 0000000..e0383f8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqOtherSunCA.asciidoc
@@ -0,0 +1,40 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqOtherSunCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I've already signed a CA for another Oracle project, do I need to sign another one for NetBeans?
+
+No. Once you execute an OCA, it is valid for all Oracle-sponsored projects. One OCA covers all of your contributions to all of these projects. However, before you
+contribute to any Oracle-sponsored project you should contact the Oracle lead for that project. And remember, not all contributions will be used or incorporated into the code for the project.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqOtherSunCA[http://wiki.netbeans.org/FaqOtherSunCA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T13:58:27Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqPluginManagerCustomization.asciidoc b/wiki-convert/wiki-asciidoc/FaqPluginManagerCustomization.asciidoc
new file mode 100644
index 0000000..e90e11a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqPluginManagerCustomization.asciidoc
@@ -0,0 +1,115 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqPluginManagerCustomization
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to customize Plugin Manager?
+
+There are several possibilities to customize behavior of Plugin Manager (*Tools|Plugins*) to show more items or to change its behavior.
+
+*Note:* for NetBeans expert only. Use of these options at your own risk.
+
+==== Show all modules
+
+In default view, Plugin Manager shows all plugins unless specify its visibility flag to `false` (`AutoUpdate-Show-In-Client=false`) - in other words, Plugin Manager filters out most of like service modules as hidden in plugin infrastructure. To make Plugin Manager to be showing all modules being run in your IDE with switch `plugin.manager.modules.only` set to `true` (i.e.`-J-Dplugin.manager.modules.only=true`).
+
+* system property `plugin.manager.modules.only`
+* the default value: `false`
+
+==== Show plugin's code name base
+
+Each NetBeans plugin has own *code name* what should be unique in NetBeans distribution, this code name will not show in plugin's details. To show this code name just run your IDE with switch `plugin.manager.extended.description` set to `true` (i.e.`-J-Dplugin.manager.extended.description=true`)
+
+* system property `plugin.manager.extended.description`
+* the default value: `false`
+
+==== Install all plugins into NetBeans installation directory
+
+How to Plugin Manager chooses a directory where NBM will install?
+
+1. If NetBeans install dir is not writable, install to `userdir`.
+2. If an update, overwrite the existing location, wherever that is.
+3. Otherwise (new module), if a cluster name is specified in NBM (`targetcluster`), put it there (creating the cluster if necessary).
+4. Otherwise (no cluster name specified), if marked `global`, maybe put it into an `extra` cluster
+5. Otherwise (`global` set `false` or unspecified), put it in `userdir`.
+
+If `plugin.manager.install.global` is set to `true` then NBM will go into installation directory for all cases unless the install directory is `read-only`.
+
+* system property `plugin.manager.install.global`
+* the default value: `false`
+
+==== Check for new plugins just after IDE startup
+
+Plugin Manager checks for *updates* of *already installed* plugins right after IDE startup, not for *new plugins*. To force Plugin Manager to check for new plugins as well, just run IDE with a option `-J-Dplugin.manager.check.new.plugins=true`. New plugins will be notified in IDE status line.
+
+* system property `plugin.manager.check.new.plugins`
+* the default value: `false`
+
+==== Check for updates just after IDE startup
+
+As was written above, Plugin Manager is checking for *updates* of *already installed* plugins right after IDE startup. If you would like to suppress it, just run IDE with a option `-J-Dplugin.manager.check.updates=false`.
+
+* system property `plugin.manager.check.updates`
+* the default value: `true`
+
+==== To customize Interval of Automatically Check for Updates (*_since NB6.1_*)
+
+Use a launcher option `plugin.manager.check.interval` with possible values: `EVERY_STARTUP`, `EVERY_DAY`,
+`EVERY_WEEK`, `EVERY_2WEEKS`, `EVERY_MONTH` or `NEVER` or also it's possible set the interval in minutes, like this `-J-Dplugin.manager.check.interval=60` - to check it every hour.
+This option can force default value for Plugin Manager, i.e. if your
+application is launched with `-J-Dplugin.manager.check.interval=EVERY_STARTUP` (or with modified in `etc/netbeans.conf`),
+content of all subscribed Update Centers will be checked on every startup. If an user changes the check interval in _Plugin Manager | Settings tab_ then future Autoupdate invocations will read user's values regardless the `plugin.manager.check.interval`, as usual.
+
+* system property `plugin.manager.check.interval`
+* the default value: `EVERY_WEEK`
+
+==== To give precedence to dedicated module while updating (*_since NB6.1_*)
+
+If Plugin Manager does install all available updates, it's possible to determinate set of modules which must be handled in exclusive mode before others. For example, update of Plugin Manager plugin should be installed as the first, in preference of common plugins because its update might be important for handling update of rest of plugins. In that case, Plugin Manager will notify users about availability of update Plugin Manager only (swallows down updates of rest) and when Plugin Manager is up-to-date, it will handle update of other plugins.
+
+* system property `plugin.manager.first.class.modules`
+* the default value: `org.netbeans.modules.autoupdate.services, org.netbeans.modules.autoupdate.ui`
+
+==== To make Autoupdate/Plugin Manager high verbose in console
+
+Just use a common logging capability for force Autoupdate/Plugin Manager to be running in high verbose mode, like this `-J-Dorg.netbeans.modules.autoupdate.level=FINEST`, you also can specify the scope for logging in more detail (`-J-Dorg.netbeans.modules.autoupdate.ui.actions.AutoupdateSettings.level=FINE`). Do not forget to switch on logging into console `-J-Dnetbeans.logger.console=true`.
+
+-
+
+Applies to: NetBeans 6.0 or newer
+
+Platforms: All
+
+-
+Do not hesitate to contact me on link:mailto:jrechtacek@netbeans.org[jrechtacek@netbeans.org] if you have any question.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqPluginManagerCustomization[http://wiki.netbeans.org/FaqPluginManagerCustomization] ,
+that was last modified by NetBeans user Matteodg
+on 2010-08-06T16:17:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqRunSameTargetOnAllModules.asciidoc b/wiki-convert/wiki-asciidoc/FaqRunSameTargetOnAllModules.asciidoc
new file mode 100644
index 0000000..9f88401
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqRunSameTargetOnAllModules.asciidoc
@@ -0,0 +1,53 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqRunSameTargetOnAllModules
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How can I launch an Ant Task on all modules of my suite?
+
+I needed to launch the fix-dependencies target on all the modules of my suite, but doing manually is very boring. So I added this target into my suite build.xml that runs the target in each module
+
+[source,xml]
+----
+
+<target name="fix-dependencies" depends="-init">
+ <subant target="fix-dependencies" buildpath="${modules.sorted}" inheritrefs="false" inheritall="false"/>
+</target>
+----
+
+You can change the code so it works with any target.
+
+--
+Applies to: NetBeans IDE 6.5 and newer
+Platforms: All
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqRunSameTargetOnAllModules[http://wiki.netbeans.org/FaqRunSameTargetOnAllModules] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-16T20:06:19Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqWhatIsCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqWhatIsCA.asciidoc
new file mode 100644
index 0000000..924732c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqWhatIsCA.asciidoc
@@ -0,0 +1,47 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqWhatIsCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== What is the Contributor Agreement ("CA")?
+
+The CA is an innovative vehicle used by Oracle for copyright assignment on contributions to its open source projects. The Oracle Contributor Agreement (OCA) applies to contributions to any product or project owned or managed by Oracle, including projects on link:http://netbeans.org/projects[netbeans.org].
+
+The OCA defines various types of contribution, covers its copyrights, patents and enumerates acceptable licenses. Specifically, with the OCA, if the contribution embodies a patent which the Contributor owns, then by signing the OCA the Contributor gives Oracle and all other recipients a license to use that patent.
+
+* Download the link:http://oss.oracle.com/oca.pdf[Oracle Contributor Agreement]
+
+* See also: link:http://www.oracle.com/technetwork/oca-faq-405384.pdf[Oracle Contributor Agreement FAQ]
+
+* List of link:https://netbeans.org/about/legal/approved-contributors.html[approved contributors]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqWhatIsCA[http://wiki.netbeans.org/FaqWhatIsCA] ,
+that was last modified by NetBeans user Jtulach
+on 2014-02-08T04:35:18Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqWhichVersionCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqWhichVersionCA.asciidoc
new file mode 100644
index 0000000..3f27cb9
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqWhichVersionCA.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqWhichVersionCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== I already signed a recent version of the CA, do I need to sign the newest version?
+
+We encourage all contributors to sign the new Oracle Contributor Agreement 1.7.1 which contains the latest language updates. However signing it again is not absolutely required, if you already signed the previous version.
+
+link:FaqHowDoIFileACA.html[How do I file a Contributor Agreement?]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqWhichVersionCA[http://wiki.netbeans.org/FaqWhichVersionCA] ,
+that was last modified by NetBeans user Skygo
+on 2013-12-17T22:07:43Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/FaqWhyTheCA.asciidoc b/wiki-convert/wiki-asciidoc/FaqWhyTheCA.asciidoc
new file mode 100644
index 0000000..7543bbd
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/FaqWhyTheCA.asciidoc
@@ -0,0 +1,43 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= FaqWhyTheCA
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Why does NetBeans request a CA?
+
+Oracle asks that you share the copyright on your contributions the first time you contribute code to netbeans.org, so that Oracle can protect the NetBeans code base and also allow consideration of alternative licensing models under a unified copyright for the netbeans.org code base.
+
+Most importantly, having joint ownership of copyright allows Oracle to offer commercial, binary distributions of the NetBeans project. Without this ability, it would not be possible for Oracle to open its technologies, nor feasible to continue to invest in them as a business and employ developers working on the code.
+
+See policy statement for more details at link:http://www.oracle.com/technetwork/oca-faq-405384.pdf[http://www.oracle.com/technetwork/oca-faq-405384.pdf]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/FaqWhyTheCA[http://wiki.netbeans.org/FaqWhyTheCA] ,
+that was last modified by NetBeans user Jkovalsky
+on 2011-12-12T14:38:30Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/HowToAddFAQEntries.asciidoc b/wiki-convert/wiki-asciidoc/HowToAddFAQEntries.asciidoc
new file mode 100644
index 0000000..ce20ad7
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/HowToAddFAQEntries.asciidoc
@@ -0,0 +1,119 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= HowToAddFAQEntries
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+1. link:#How_to_add.2Fcreate_a_FAQ_entry[How to add/create a FAQ entry]
+1. link:#Logging_on[Logging on]
+2. link:#Adding_a_Question[Adding a Question]
+3. link:#Adding_the_Answer[Adding the Answer]
+4. link:#What_To_Do_About_Long_Lines_of_Text[What To Do About Long Lines of Text]
+5. link:#Tip:_Formatting[Tip: Formatting]
+6. link:#Apache_Migration_Information[Apache Migration Information]
+
+== How to add/create a FAQ entry
+
+==== Logging on
+
+1. When you are here for the first time ever, link:https://netbeans.org/people/new[create your NetBeans account] and link:mailto:NETBEANS-WEBTEAM_WW@oracle.com?Subject=Wiki%20editing%20rights[send us a request for Wiki editing rights] specifying your NetBeans account.
+2. Once you hear back from us link:http://netbeans.org/people/signup[login to netbeans.org] again.
+3. Go to the FAQ site index (click "User FAQ" in the left column).
+4. Click on the ?edit page? tab to go to the edit window. This window can look a little scary at first, but don't worry, you don't have to change that much to get an entry added to the FAQ. Note: *Please do not delete existing content on this page.* Just *add your question* as follows:
+
+==== Adding a Question
+
+1. Scroll down to the section where you want to enter your FAQ item. A section starts with either a single `!` or a double `!!`.
+2. Once you have reached the section you want, add another line below that looks just like this, but contains the *question* that you want to add.
+[source,java]
+----
+
+* [[FaqTweedleDeeDumRefactoring|How can I refactor a tweedledeedum?]]
+----
+
+How do you read this line?
+
+* The star at the beginning places a bullet at the beginning of the list item. It must be followed by a space.
+* The first part in the double-brackets ("FaqTweedleDeeDumRefactoring" or "FaqHowToAsk") is the page name. It must be a wiki word: A wiki word should be CamelCase and be something short and descriptive. Look at other entries to get an idea. Good wiki words look like "HowToAsk", "HowToConfigure" or "WhatIsTheUpdateCenter", etc. It ends in a square bracket.
+* For user-FAQ entries, all user-faq entries should start with "Faq", as in "FaqHowToAsk".
+* Names of all _plugin-developer_ FAQ items should start with "DevFaq", as in "DevFaqLookup". This keeps the FAQs organized and searchable and allows the link:http://deadlock.netbeans.org/hudson/job/faqsuck/lastSuccessfulBuild/artifact/other/faqsuck/build/faq.html[giant developer FAQ page] to be built.
+* In the middle there is a `|` between the question and the page title as a separator.
+* The second part is the question. It starts with a square bracket.
+* Note that the `link:_.html[ ]` braces make the entire thing a link to the actual answer page.
+
+
+3. Click the Save button to save the page (or click Cancel to discard your changes).
+
+==== Adding the Answer
+
+1. Now you are back to view mode of the FAQ index page. Scroll down and find your question as one of the bullet items in the list - It will be red. Click on your new (red) link.
+
+2. This will bring you to another edit window for the *answer page*. You can use the code below as a template for starting out your answer page, and fill in your own question (the same that you just entered into the FAQ index!) and answer.
+
+[source,java]
+----
+
+====How can I refactor a tweedledeedum?====
+Problem: Everytime I try to refactor a tweedledeedum, it starts burning.
+
+Solution: You have to paint the tweedledeedum green first.
+----
+
+
+3. Finally, add information at the bottom of the FAQ that tells what version of NetBeans and what OS platform the FAQ works with. Just add the versions and platforms that you know are right. If "See also:" information is useful, add it here also.
+
+[source,java]
+----
+
+--
+Applies to: NetBeans IDE 6.0 and 6.1
+Platforms: All
+See also: [[NetBeansUserFAQ| How can I refactor two tweedledeedums?]]
+----
+
+
+4. That's it. Click Save to save the page when you are done editing the answer.
+
+==== What To Do About Long Lines of Text
+
+If your FAQ entry includes `<pre>` tags (or you use the wiki convention of putting a space at the beginning of a line to do the same thing), _avoid long lines of text_. The FAQs are built every night into a link:http://deadlock.netbeans.org/hudson/job/faqsuck/lastSuccessfulBuild/artifact/other/faqsuck/build/faq.html[giant HTML page]. To keep it possible to print the entire FAQ on normal paper, please break up lines longer than 80 characters, or use ``` tags instead of `<pre>` (and make sure there are some whitespace characters in long lines) so that they can be formatted reasonably.
+
+If your example does not have any lines > 80 characters, `<pre>` tags are fine.
+
+==== Tip: Formatting
+
+You can click on the Help tab (right beside the Edit tab) at any time to get help on *formatting* of the text. You won't lose your changes when switching between the help tab and the edit tab, so don't worry about that.
+
+Now, start adding those FAQs!!
+
+Source: link:http://blogs.sun.com/LongLiveThePepper/entry/adding_items_to_the_vwp[JB's Blog]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/HowToAddFAQEntries[http://wiki.netbeans.org/HowToAddFAQEntries] ,
+that was last modified by NetBeans user Jkovalsky
+on 2015-08-28T15:47:14Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/HowToEnableDisableMenusFromCommandLine.asciidoc b/wiki-convert/wiki-asciidoc/HowToEnableDisableMenusFromCommandLine.asciidoc
new file mode 100644
index 0000000..0dc72f0
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/HowToEnableDisableMenusFromCommandLine.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= HowToEnableDisableMenusFromCommandLine
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Can something that the user sets on the command line determine whether a menu item is enabled?
+
+link:http://blogs.oracle.com/geertjan/entry/parsing_the_command_line_to[Info on this here.]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/HowToEnableDisableMenusFromCommandLine[http://wiki.netbeans.org/HowToEnableDisableMenusFromCommandLine] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2011-12-27T16:33:28Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/HowToEnableDisableModulesFromCommandLine.asciidoc b/wiki-convert/wiki-asciidoc/HowToEnableDisableModulesFromCommandLine.asciidoc
new file mode 100644
index 0000000..648a2cb
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/HowToEnableDisableModulesFromCommandLine.asciidoc
@@ -0,0 +1,39 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= HowToEnableDisableModulesFromCommandLine
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Same as the above, but this time for enabling/disabling modules?
+
+link:http://blogs.oracle.com/geertjan/entry/parsing_the_command_line_to1[Info on this here.]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/HowToEnableDisableModulesFromCommandLine[http://wiki.netbeans.org/HowToEnableDisableModulesFromCommandLine] ,
+that was last modified by NetBeans user Anebuzelsky
+on 2011-12-27T16:33:57Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/HowToParseTheCommandLine.asciidoc b/wiki-convert/wiki-asciidoc/HowToParseTheCommandLine.asciidoc
new file mode 100644
index 0000000..48ae97f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/HowToParseTheCommandLine.asciidoc
@@ -0,0 +1,35 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= HowToParseTheCommandLine
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/[http://wiki.netbeans.org/] ,
+that was last modified by NetBeans user
+on .
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE.asciidoc b/wiki-convert/wiki-asciidoc/HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE.asciidoc
new file mode 100644
index 0000000..dd3e133
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE.asciidoc
@@ -0,0 +1,41 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How to pass command line arguments to a NetBeans Platform application when run inside the IDE
+
+Open "nbproject/project.properties" and add there:
+
+run.args.extra=-arg1 --argument2
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE[http://wiki.netbeans.org/HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE] ,
+that was last modified by NetBeans user Admin
+on 2009-11-06T18:21:32Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/InputDialog.png b/wiki-convert/wiki-asciidoc/InputDialog.png
new file mode 100644
index 0000000..87463c3
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/InputDialog.png differ
diff --git a/wiki-convert/wiki-asciidoc/JavaHT_GetAllMembers.asciidoc b/wiki-convert/wiki-asciidoc/JavaHT_GetAllMembers.asciidoc
new file mode 100644
index 0000000..f8f1469
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/JavaHT_GetAllMembers.asciidoc
@@ -0,0 +1,92 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= JavaHT_GetAllMembers
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+==== How do I Get All Methods/Fields/Constructors of a Class?
+
+* First, you need to be in a Javac context, see link:JavaHT_GetIntoJavacContext.html[previous section] for more information.
+* Then, you need to find `javax.lang.model.element.TypeElement` you want to analyze. See `com.sun.source.tree.Trees.getElement(TreePath)` and `javax.lang.model.util.Elements.getTypeElement(String)`. You can get `Trees` and `Elements` from `org.netbeans.api.java.source.CompilationInfo`.
+* Finally, use `Element.getEnclosedElements()` to find out the elements enclosed by the class - for classes, this returns all members (methods, fields and inner classes) of the class. You can then use `ElementFilter` to filter out specific kind of member: methods, constructors, fields and inner classes.
+
+Example:
+
+[source,java]
+----
+
+protected void performAction(Node[] activatedNodes) {
+ DataObject dataObject = (DataObject) activatedNodes[0].getLookup().lookup(DataObject.class);
+ JavaSource js = JavaSource.forFileObject(dataObject.getPrimaryFile());
+
+ try {
+ js.runUserActionTask(new Task<CompilationController>() {
+ public void run(CompilationController parameter) throws IOException {
+ parameter.toPhase(Phase.ELEMENTS_RESOLVED);
+ new MemberVisitor(parameter).scan(parameter.getCompilationUnit(), null);
+ }
+ }, true);
+ }
+ catch (IOException e) {
+ Logger.getLogger("global").log(Level.SEVERE, e.getMessage(), e);
+ }
+}
+
+private static class MemberVisitor extends TreePathScanner<Void, Void> {
+
+ private CompilationInfo info;
+
+ public MemberVisitor(CompilationInfo info) {
+ this.info = info;
+ }
+
+ @Override
+ public Void visitClass(ClassTree t, Void v) {
+ Element el = info.getTrees().getElement(getCurrentPath());
+
+
+ if (el == null) {
+ System.err.println("Cannot resolve class!");
+ }
+ else {
+ TypeElement te = (TypeElement) el;
+ System.err.println("Resolved class: " + te.getQualifiedName().toString());
+ //XXX: only as an example, uses toString on element, which should be used only for debugging
+ System.err.println("enclosed methods: " + ElementFilter.methodsIn(te.getEnclosedElements()));
+ System.err.println("enclosed types: " + ElementFilter.typesIn(te.getEnclosedElements()));
+ }
+ return null;
+ }
+
+}
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/JavaHT[http://wiki.netbeans.org/JavaHT] GetAllMembers ,
+that was last modified by NetBeans user Javydreamercsw
+on 2012-07-10T14:37:39Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/JavaHT_Modification.asciidoc b/wiki-convert/wiki-asciidoc/JavaHT_Modification.asciidoc
new file mode 100644
index 0000000..681588c
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/JavaHT_Modification.asciidoc
@@ -0,0 +1,99 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= JavaHT_Modification
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== How can I programmatically modify a Java source file?
+
+Most modifications are done through the API. Direct document changes are not recommended. Editing source through the API has many advantages, for instance it respects formatting settings.
+
+This part will show you typical steps to make a modification to your source. There can be found different usecases, but this is the most common:
+
+* Find the JavaSource you want to work with,
+* create a task that contains code for source modification,
+* post the task to the JavaSource and commit the changes at the end.
+
+TODO: link to example, describe what the example does.
+
+==== Find the JavaSource
+
+There are more ways to do it. For our demonstration, we use a straightforward solution, often used in tests. We omit the details of getting fileObject and we expect successful behaviour of called methods.
+
+[source,java]
+----
+
+ File tutorialFile = getFile(getSourceDir(), "/org/netbeans/test/codegen/Tutorial1.java");
+ JavaSource tutorialSource = JavaSource.forFileObject(FileUtil.toFileObject(tutorialFile));
+----
+
+The JavaSource represents the file `Tutorial1.java` in package `org.netbeans.test.codegen`.
+
+==== Create a 'modify' task
+
+`Task` is a parameterized interface with type parameter `WorkingCopy`. This type is requested in the next step. This next code snippet shows how to create an anonymous `Task`:
+
+[source,java]
+----
+
+ Task task = new Task<WorkingCopy>() {
+ ...
+ }
+----
+
+The interface contains run method that contains code for modifying our javaSource.
+
+[source,java]
+----
+
+ Task task = new Task<WorkingCopy>() {
+
+ public void run(WorkingCopy workingCopy) throws Exception {
+ ... our modification code
+ }
+
+ };
+----
+
+The run method contains all staff describing modification and we will dive in to the details later.
+
+==== Post the task to process and commit the changes
+
+Because we want to modify the source, we have to use runModificationTask (see its javadoc). At the end, we have to commit changes to propagate all the work to the source file - our `Tutorial1.java` file. This can fail, so ensure you correctly handle exceptions. The method `runModificationTask()` returns the modification result. This class contains all the prepared changes which haven't been propagated yet. This is good especially when someone wants to review the details of modification and decide about propagating changes to the source on the basis of `result`. For our demonstration, we will omit it. When `result` is collected, we have to call the `commit()` method to propagate the changes to the source code:
+
+[source,java]
+----
+
+ ModificationResult result = tutorialSource.runModificationTask(task);
+ result.commit();
+----
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/JavaHT[http://wiki.netbeans.org/JavaHT] Modification ,
+that was last modified by NetBeans user Tboudreau
+on 2010-02-25T16:24:21Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/Java_DevelopersGuide.asciidoc b/wiki-convert/wiki-asciidoc/Java_DevelopersGuide.asciidoc
new file mode 100644
index 0000000..b7e776a
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/Java_DevelopersGuide.asciidoc
@@ -0,0 +1,97 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= Java_DevelopersGuide
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= Java Infrastructure Developer's guide (AKA Concepts & HowTos)
+
+== Concepts
+
+link:JavaHT_Overview.html[Overview]
+
+link:JavaHT_JavacPhases.html[The Javac phases]
+
+link:JavaHT_TreesElementsTypesTokens.html[Trees, Elements, Types and Tokens ]
+
+link:JavaHT_Conversions_TreesElementsTypes.html[Conversions between trees and elements and types...]
+
+link:JavaHT_IDEIntegration.html[Integration with the IDE]
+
+link:JavaHT_GettingToJavacInfromation.html[Getting to the javac information = writting a java infrastructure task]
+
+link:JavaHT_RegisteringRunningTasks.html[Registering/running tasks]
+
+link:JavaHT_ElementHandle.html[The ElementHandle]
+
+link:JavaHT_TreePathHandle.html[The TreePathHandle]
+
+link:JavaHT_ComparingTreesElements.html[Comparing Trees and Elements]
+
+link:JavaHT_SourceFilesVsClassFiles.html[Source files vs. Class Files]
+
+link:JavaHT_ClassFilesVsSignatureFiles.html[Class Files vs. Signature Files]
+
+== How Tos
+
+link:JavaHT_SetupModule.html[How to setup a module which uses the Java related APIs]
+
+link:JavaHT_GetIntoJavacContext.html[How do I Get into the Javac Context for a File?]
+
+link:JavaHT_GetAllMembers.html[How do I Get All Methods/Fields/Constructors of a Class?]
+
+link:JavaHT_Modification.html[How do I do modification to a source file?]
+
+link:JavaHT_TreeMaker.html[How to work with TreeMaker]
+
+link:JavaHT_TreeMakerQA.html[TreeMaker difficulties, Questions & Answers]
+
+link:JavaHT_FindUsagesOfClass.html[How do I Find All Usages of a Class?]
+
+link:JavaHT_GetElementFromFQN.html[How do I get an ElementHandle if all I have is the Project and the class name?]
+
+link:JavaHT_GetLibrariesForModule.html[How do I get a list of libraries/dependencies of a project?]
+
+link:JavaHT_GetSourceLocationOfWrappedJar.html[How do I get the source location of a wrapped jar?]
+
+link:JavaHT_GetPackagesOfAJar.html[How do I get the packages contained in a jar/library/dependency?]
+
+== Tutorials
+
+link:http://platform.netbeans.org/tutorials/nbm-copyfqn.html[http://platform.netbeans.org/tutorials/nbm-copyfqn.html]
+
+link:http://platform.netbeans.org/tutorials/nbm-code-generator.html[http://platform.netbeans.org/tutorials/nbm-code-generator.html]
+
+link:http://platform.netbeans.org/tutorials/nbm-java-hint.html[http://platform.netbeans.org/tutorials/nbm-java-hint.html]
+
+link:http://netbeans.org/projects/platform/sources/platform-content/content/trunk/tutorials/60/nbm-whichelement.html?raw=true[http://netbeans.org/projects/platform/sources/platform-content/content/trunk/tutorials/60/nbm-whichelement.html?raw=true]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/Java[http://wiki.netbeans.org/Java] DevelopersGuide ,
+that was last modified by NetBeans user Markiewb
+on 2015-01-29T21:05:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/NetBeansCertifiedEngineerCourse.asciidoc b/wiki-convert/wiki-asciidoc/NetBeansCertifiedEngineerCourse.asciidoc
new file mode 100644
index 0000000..f8634e8
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/NetBeansCertifiedEngineerCourse.asciidoc
@@ -0,0 +1,66 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= NetBeansCertifiedEngineerCourse
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== NetBeans Certified Engineer Course
+
+This is a wiki page for link:http://edu.netbeans.org/courses/nbplatform-certified-training/[NetBeans Certified Engineer Course], read more at
+link:http://edu.netbeans.org/courses/nbplatform-certified-training/[our main website].
+
+=== Exercises/Assignments
+
+* link:NetBeansCertifiedEngineerExercises.html[NetBeansCertifiedEngineerExercises]
+* link:http://wiki.netbeans.org/wiki/view/NetBeansDeveloperFAQ/RCP60Tutorials[Link to Tutorials You Can Write]
+* link:Http://wiki.netbeans.org/wiki/view/Java_HintsFest.html[Link to Hints You Can Provide ]
+
+=== Papers
+
+* link:Http://www.netbeans.org/books/rcp.html.html[Rich Client Programming ]
+* link:Http://platform.netbeans.org.html[NetBeans Platform ]
+
+=== Slides from the Training on the First Day
+
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-outline_NetBeansCertifiedEngineerCourse.odp[ Presentation 1: NetBeans Platform] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-outline_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/first-application_NetBeansCertifiedEngineerCourse.odp[ Presentation 2: A First NetBeans Platform Application] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/first-application_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-lookup_NetBeansCertifiedEngineerCourse.odp[ Presentation 3: Dependency and Injection in Modular Systems] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-lookup_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/systemfs_NetBeansCertifiedEngineerCourse.odp[ Presentation 4: An Introduction to the System FileSystem] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/systemfs_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-javabeans_NetBeansCertifiedEngineerCourse.odp[ Presentation 5: NetBeans JavaBeans] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-javabeans_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+
+=== Slides from the Training on the Second Day
+
+* link:NbpLoaders.odp.html[Presentation 1: NetBeans ~ OS/2 ] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-loaders_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/window-system_NetBeansCertifiedEngineerCourse.odp[ Presentation 2: An Introduction to the Window System] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/window-system_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:NbpContribute.odp.html[Presentation 3: Contributing to Open Source Projects ] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/nbp-contribute_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+* link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/ideas-for-modules_NetBeansCertifiedEngineerCourse.odp[ Presentation 4: Ideas for Modules] (link:http://wiki.netbeans.org/wiki/attach/NetBeansCertifiedEngineerCourse/ideas-for-modules_NetBeansCertifiedEngineerCourse.pdf[ PDF Version])
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/NetBeansCertifiedEngineerCourse[http://wiki.netbeans.org/NetBeansCertifiedEngineerCourse] ,
+that was last modified by NetBeans user Geertjan
+on 2010-06-14T08:52:40Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/NetBeansDeveloperTestFAQ.asciidoc b/wiki-convert/wiki-asciidoc/NetBeansDeveloperTestFAQ.asciidoc
new file mode 100644
index 0000000..463d993
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/NetBeansDeveloperTestFAQ.asciidoc
@@ -0,0 +1,103 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= NetBeansDeveloperTestFAQ
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== NetBeans Developer Test FAQ
+
+=== Abstract
+
+Contains info how to develop tests for NetBeans plugin.
+
+=== Starting to writing tests for NetBeans
+
+* link:FirstTests.html[First tests]
+* link:UnitVersusQaFunctionalTests.html[Unit versus qa-functional tests]
+* link:ModuleDependenciesForTests.html[Module dependencies for tests]
+* link:DebuggingTests.html[Debugging tests]
+
+=== NetBeans Testing Infrastructure
+
+* link:DevFaqUsingSimpletests.html[How do I test platform-based application?]
+* link:TestDistribution.html[Test distribution] (NOTE: applies to 6.1 and earlier)
+* link:CodeCoverage.html[Code coverage] (NOTE: updated for NB 6.7)
+
+=== Test patterns
+
+* link:http://openide.netbeans.org/tutorial/test-patterns.html[Test Patterns In Java] - very useful for testing NetBeans
+
+=== Test API
+
+link:UsefulTestClassesInModules.html[Useful test classes in modules]
+
+=== Frequently used patterns
+
+* link:InitializationOfDefaultLookup.html[Initialization of default Lookup]
+* link:LayerInitialization.html[Layer initialization]
+* link:UsingFileSystems,Masterfs.html[Using FileSystems, Masterfs]
+
+=== Testing NetBeans Projects
+
+* link:ClasspathAndQueriesTesting.html[Classpath and queries testing]
+* link:TestingThingsThatUseFileObjectDataObjectDataFolder.html[Testing things that use FileObjects]
+* link:DevFaqTestDataObject.html[Writing Tests for DataObjects and DataLoaders]
+* link:ExecutingAntScriptsInTests.html[Executing ant scripts in tests]
+* link:DevFaqTestUnitTestFailsNoSuchMethodError.html[How to fix NoSuchMethodError in com/sun/tools/javac/ when running unit tests]
+
+=== Test Editor
+
+* link:CodeCompletionProvider.html[Code completion provider]
+* link:Lexer.html[Lexer]
+
+=== Testing new Java infrastructure
+
+* link:Java_DevelopersGuide.html[Java Developers Guide] - introduction to new java infrastructure
+* TODO
+
+=== Testing J2EE
+
+* TODO
+
+=== Performance tests
+
+* TODO
+
+=== UI Tests
+
+* link:FirstUITests.html[First UI tests]
+* link:VisualLibraryAndUITests.html[VisualLibraryAndUITests]
+* link:JemmyAndJellytools.html[Jemmy and Jellytools]
+
+===Wr
+requires.nb.javac=true
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/NetBeansDeveloperTestFAQ[http://wiki.netbeans.org/NetBeansDeveloperTestFAQ] ,
+that was last modified by NetBeans user Markiewb
+on 2012-10-10T14:25:26Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/OkDialog.png b/wiki-convert/wiki-asciidoc/OkDialog.png
new file mode 100644
index 0000000..8175d46
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/OkDialog.png differ
diff --git a/wiki-convert/wiki-asciidoc/ProjectVersioning.asciidoc b/wiki-convert/wiki-asciidoc/ProjectVersioning.asciidoc
new file mode 100644
index 0000000..b0c8975
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/ProjectVersioning.asciidoc
@@ -0,0 +1,290 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= ProjectVersioning
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Project Version Control Tutorial
+
+The paper describes how to write own project types, nodes and topcomponents that support version control actions.
+It applies to NetBeans 5.0 CVS support.
+
+There is sibling link:VersioningSystemIntegration.html[Versioning System Integration] describing version control system integration providers development.
+
+=== Typical Requirements
+
+* Show context version control actions in project explorer
+* Put project under version control
+* Get latest version from repository
+* Inspect local changes
+* Commit local changes into repository
+* Search history
+
+* Badge logical node icon and name
+* Mark modified and conflicting files by icon
+* Enhance name by revision information
+
+=== Typical Solution
+
+==== Version Control Action Context
+
+All version control actions take working context from selected nodes. The context is taken from Node's lookup. The lookup is searched for:
+
+* Project
+* Sources.TYPE_GENERIC
+* NonRecursiveFolder
+* FileObject
+* DataObject
+
+The link:VersionActionContext.html[VersionActionContext] algorithm is in link:http://javacvs.netbeans.org/source/browse/javacvs/cvsmodule/src/org/netbeans/modules/versioning/system/cvss/util/Utils.java?rev=1.41[org.netbeans.versioning.cvss.util.Util] class `getCurrentContext(), addFileObjects()` and `addProjectFiles()` methods.
+
+Sample:
+
+[source,java]
+----
+
+public class UMLNode extends AbtractNode {
+ private final FileObject fileObject;
+ public UMLNode(UMLModel.Element model) {
+ super(Lookups.singleton(model.getFileObject())); // HERE
+ this.fileObject = model.getFileObject();
+ attachStatusListener(); // see bellow
+ }
+----
+
+It means that version control actions (e.g. in main menu) are enabled on any node that has properly populated lookup. Actions depends on version control system e.g. for CVS:
+
+* Import into repository (for unversioned)
+* Show changes
+* Update
+* Diff
+* Commit
+* Ignore
+* Search History
+* Tag
+* Switch to branch
+* Merge with branch
+* ...
+
+Note that the version control actions are smart enough to distinguish whether project is under version control or not and they appear respectively.
+
+*What if Action is not Enabled?*
+
+If client code does not access disk using `FileObject`
+(i.e. uses `java.io.File` instead) then actions are
+incorrecly enabled because in such case an internal status
+cache misses modifications events and reports original
+status.
+
+The client code should be rewritten to `FileObject` usage. In
+some cases helps `FileUtil.toFileObject(file).refresh()`.
+
+==== Presenting Version Control Actions in Popup Menu
+
+There is `org.openide.actions.FileSystemAction` framework action that presents version control actions.
+
+It means that any node that returns this action from popup menu construction code receives version control actions submenu.
+
+Sample getActions() code:
+
+[source,java]
+----
+
+ // still in UMLNode class
+ public Action[] getActions(boolean context) {
+ ArrayList<Action> actions = new ArrayList<Action>();
+ actions.add(SystemAction.get(OpenAction.class));
+ actions.add(SystemAction.get(RenameAction.class));
+ actions.add(SystemAction.get(FileSystemAction.class)); // HERE
+ actions.add(SystemAction.get(PropertiesAction.class));
+ return actions.toArray(new Action[0]);
+ }
+----
+
+Project nodes use special case registration that is specific for them
+(it allows version control support module to show actions that make sense
+on projects only such as _Update with Dependencies_ and
+_Import Project into Repository_).
+Your project nodes must honor contract link:http://javacvs.netbeans.org/nonav/issues/show_bug.cgi?id=57874[#57874].
+
+Sample getAction() code for Nodes representing project:
+
+[source,java]
+----
+
+ public Action[] getActions(boolean context) {
+ ArrayList<Action> actions = new ArrayList<Action>();
+ actions.add(SystemAction.get(OpenAction.class));
+ actions.add(SystemAction.get(RenameAction.class));
+
+ // honor 57874 contact
+ try {
+ Repository repository = Repository.getDefault();
+ FileSystem sfs = repository.getDefaultFileSystem();
+ FileObject fo = sfs.findResource("Projects/Actions"); // NOI18N
+ if (fo != null) {
+ DataObject dobj = DataObject.find(fo);
+ FolderLookup actionRegistry = new FolderLookup((DataFolder)dobj);
+ Lookup.Template query = new Lookup.Template(Object.class);
+ Lookup lookup = actionRegistry.getLookup();
+ Iterator it = lookup.lookup(query).allInstances().iterator();
+ if (it.hasNext()) {
+ actions.add(null);
+ }
+ while (it.hasNext()) {
+ Object next = it.next();
+ if (next instanceof Action) {
+ actions.add(next);
+ } else if (next instanceof JSeparator) {
+ actions.add(null);
+ }
+ }
+ }
+ } catch (DataObjectNotFoundException ex) {
+ // data folder for exiting fileobject expected
+ ErrorManager.getDefault().notify(ex);
+ }
+ actions.add(SystemAction.get(PropertiesAction.class));
+ return actions.toArray(new Action[0]);
+ }
+----
+
+==== Annotating Logical Nodes
+
+Any explorer node that represents a (set of) file(s) can use `FileSystem.getStatus().annotateName(...)` annotation support to annotate icon, display name and HTML display name and then listen on changes using `org.openide.filesystems.FileStatusListener`.
+Note that for HTML annotations you have to cast to `FileSystem.HtmlStatus`.
+
+Sample code for a node supporting annotations (or subclass DataNode):
+
+[source,java]
+----
+
+ // still in UMLNode class
+
+ public String getDisplayName () {
+ String s = super.getDisplayName ();
+
+ try {
+ s = fileObject().getFileSystem().getStatus()
+ .annotateName(s, Collections.singleton(fileObject));
+ } catch (FileStateInvalidException e) {
+ // no fs, do nothing
+ }
+
+ return s;
+ }
+
+ public String getHtmlDisplayName() {
+ try {
+ FileSystem.Status stat = fileObject.getFileSystem().getStatus();
+ if (stat instanceof FileSystem.HtmlStatus) {
+ FileSystem.HtmlStatus hstat = (FileSystem.HtmlStatus) stat;
+
+ String result = hstat.annotateNameHtml (
+ super.getDisplayName(), Collections.singleton(fileObject));
+
+ //Make sure the super string was really modified
+ if (!super.getDisplayName().equals(result)) {
+ return result;
+ }
+
+ // TODO attach status listener at the FileSystem
+ // and on change refire PROP_DISPLAY_NAME
+
+ }
+ } catch (FileStateInvalidException e) {
+ //do nothing and fall through
+ }
+ return super.getHtmlDisplayName();
+ }
+
+ public java.awt.Image getIcon (int type) {
+ java.awt.Image img = super.getIcon (type);
+
+ try {
+ img = model.getFileObject().getFileSystem().getStatus()
+ .annotateIcon(img, type, Collections.singleton(fileObject));
+ } catch (FileStateInvalidException e) {
+ // no fs, do nothing
+ }
+
+ return img;
+ }
+
+ public java.awt.Image getOpenedIcon (int type) {
+ java.awt.Image img = super.getIcon (type);
+
+ try {
+ img = model.getFileObject().getFileSystem().getStatus()
+ .annotateIcon(img, type, Collections.singleton(fileObject));
+ } catch (FileStateInvalidException e) {
+ // no fs, do nothing
+ }
+
+ return img;
+ }
+
+ private void attachStatusListener() {
+ FileSystem fs = fileObject.getFileSystem();
+ FileStatusListener l = FileUtil.weakFileStatusListener(new FileStatusListener() {
+ public void annotationChanged (FileStatusEvent ev) {
+ if (ev.hasChanged(fileObject)) {
+ if (ev.isNameChange()) {
+ fireDisplayNameChange(null, null);
+ }
+ if (ev.isIconChange()) {
+ fireIconChange();
+ }
+ }
+ }
+ }, fs);
+ fs.addFileStatusListener(l);
+ }
+}
+----
+
+==== The Annotating Pattern
+
+Filesystem annotation mechanism, mentioned above, can be used for setting HTML names to any visual element that can render HTML:
+
+* `new JLabel( htmlName )`
+* `TopComponent.setHtmlDisplayName( htmlName )`
+* `JComboBox.setRenderer( ... )`
+* `Node`
+* and others
+
+=== Summary
+
+The developer implementing new `org.openide.nodes.Node` subclass can easily add support for executing and presenting version control actions; and can use the filesystem status annotation mechanism to alter icon and display name.
+
+Since 5.0 there is no API that directly supports version control operations execution.
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/ProjectVersioning[http://wiki.netbeans.org/ProjectVersioning] ,
+that was last modified by NetBeans user Newacct
+on 2011-11-25T00:42:33Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/TestingThingsThatUseFileObjectDataObjectDataFolder.asciidoc b/wiki-convert/wiki-asciidoc/TestingThingsThatUseFileObjectDataObjectDataFolder.asciidoc
new file mode 100644
index 0000000..e46289f
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/TestingThingsThatUseFileObjectDataObjectDataFolder.asciidoc
@@ -0,0 +1,71 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= TestingThingsThatUseFileObjectDataObjectDataFolder
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Testing Things That Use FileObject/DataObject/DataFolder
+
+If your unit tests use `FileObject` (including `DataObject` or `DataFolder`), then you may be suprised that `FileUtil.toFileObject(java.util.File)` returns `null`. This is because the MasterFS filesystem implementation is what maps `FileObject`s to your local disk and it needs to be on the classpath when tests are run.
+
+See link:UsingFileSystemsMasterfs.html[UsingFileSystemsMasterfs] for more info on how to fix this.
+
+If for some reason you prefer not to use MasterFS, you can create a new `LocalFileSystem`, create some files and use that instead of `FileUtil.toFileObject` in your test. For example, in a `NbTestCase` subclass:
+
+[source,java]
+----
+
+FileObject dir;
+public @Override void setUp() throws Exception {
+ super.setUp();
+ clearWorkDir();
+ LocalFileSystem fs = new LocalFileSystem();
+ fs.setRootDirectory(getWorkDir());
+ dir = fs.getRoot();
+}
+----
+
+If your test just needs some simple data in a FileObject or two, you can avoid writing to disk at all as follows:
+
+[source,java]
+----
+
+FileObject dir;
+public @Override void setUp() throws Exception {
+ super.setUp();
+ dir = FileUtil.createMemoryFileSystem().getRoot();
+ //write out data your tests will use to files under dir/ here
+}
+----
+
+If you want to write tests for a `DataObject` or `DataLoader`, you may also want to set the mime type correctly: link:DevFaqTestDataObject.html[DevFaqTestDataObject]
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/TestingThingsThatUseFileObjectDataObjectDataFolder[http://wiki.netbeans.org/TestingThingsThatUseFileObjectDataObjectDataFolder] ,
+that was last modified by NetBeans user Geertjan
+on 2011-05-13T13:08:00Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/TranslateNetbeansModule.asciidoc b/wiki-convert/wiki-asciidoc/TranslateNetbeansModule.asciidoc
new file mode 100644
index 0000000..e0d8081
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/TranslateNetbeansModule.asciidoc
@@ -0,0 +1,128 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= TranslateNetbeansModule
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+== Translate Your NetBeans Module
+
+ABBREVIATIONS USED:
+
+* i18n = internationalization
+* l10n = localization
+* t9n = translation
+
+link:{INSERTTableOfContentsWHERETitle=Summary}.html[{INSERT TableOfContents WHERE title=Summary}]
+
+=== Why translate my module?
+
+Software that is translated or in the native language is more user-friendly than when it is in a foreign language. It is really good if we can have applications translated for all users. More and more users will prefer our applications instead of a foreign language version. This is the same for NetBeans modules. When you have an internationalized (i18n) or localized (l10n) module, more users will consider using your module. Think about that!!
+
+BTW, nobody is fluent in all languages, so, we will need a way to make i18n easy to maintain and redistribute for people that can help with our translations, such as friends and contributors in other countries. This is one of the great things about open-source; you can get help from contributors to test and translate your open-source project. And, it can also help a translation vendor who might work on your commercial project too. In any case, we will need an infrastructure to make this workflow easy for developers and translators.
+
+=== How can I translate my module? What is the easiest way to do this and which tools should I use?
+
+We will provide the steps to promote translation of NetBeans modules. For this approach, we will use link:http://www.omegat.org/omegat/omegat.html[OmegaT] tool. The following steps will describe how you can configure your environment to make localization easier to maintain and redistribute to other translators.
+
+==== Creating a NetBeans Module project
+
+Just create a simple module project, named 'SimpleI18nModule'. For details about NetBeans module development, see:
+
+* link:http://www.netbeans.org/kb/trails/platform.html[NetBeans Modules and Rich-Client Applications Learning Trail]
+* link:http://platform.netbeans.org/tutorials/quickstart-nbm.html[Introduction to NetBeans Module Development]
+
+==== Creating an i18n infrastructure
+
+Once your project is created, you will need to copy the i18n help files. These files are created to help develpers make i18n easier. The new files are:
+
+* `build-i18n_TranslateNetbeansModule.xml`
+* Include the target to make NetBeans create the build and NBM files with i18n files.
+* `i18n_TranslateNetbeansModule.properties`
+* Include per-project specific properties, as paths, to make `build-i18n_TranslateNetbeansModule.xml` useful. See the file comments to details about each property.
+
+You must also change the `build.xml` file too. Import `build-i18n_TranslateNetbeansModule.xml` files instead of `nbproject/build-impl.xml`. The new `build.xml` file is something like this:
+
+[source,xml]
+----
+
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- You may freely edit this file. See harness/README in the NetBeans platform -->
+<!-- for some information on what you could do (e.g. targets to override). -->
+<!-- If you delete this file and reopen the project it will be recreated. -->
+<project name="org.yourorghere.simplei18nmodule" default="netbeans" basedir=".">
+ <description>Builds, tests, and runs the project org.yourorghere.simplei18nmodule.</description>
+ <!--import file="nbproject/build-impl.xml"/-->
+ <import file="build-i18n_TranslateNetbeansModule.xml"/>
+</project>
+----
+
+The structure of your project is now something like this:
+
+image:project-struct_TranslateNetbeansModule.gif[]
+
+Now, the infrastructure for your project is done. You can develop your module as you wish and, when it is time for translation, the new targets from `build-i18n_TranslateNetbeansModule.xml` will be required.
+
+==== Translating the new module
+
+To do the translation, previously stated, you will need the OmegaT Translation Editor. For example, we will use version 1.6.1. You can get started on OmegaT in link:http://translatedfiles.netbeans.org/docs/HOWTOs/How-to-translate-NetBeans-using-OmegaT.html[How to translate NetBeans IDE using OmegaT].
+Before creating new OmegaT project(s), you will use the following structure in your module folder:
+
+image:project-struct-i18n_TranslateNetbeansModule.gif[]
+
+The two highlighted folders are designed for i18n operations. `omegat` folder is designed to maintain the original OmegaT projects. For example, you will need a project for each language you will translate your module into. So, the suggestion is to create a default module, with the English to English language (or <native> to <native> language, assuming that module is created in <native> by default) to make the bases for the specific-language translation modules.
+
+The `translatedfiles` folder will contain the translated files from the OmegaT project; in other words, all `javahelp` and `src` translated files (`target` files). The `omegat` and `translatedfiles` folder can be renamed to any other name, so you just need to update `i18n.basedir` and `translatedfiles.basedir` properties in the `i18n_TranslateNetbeansModule.properties` file. It is not necessary create these folders manually. There is a helper target on `build-i18n_TranslateNetbeansModule.xml` named `i18n-setup-project`, which creates all necessary folders, based on your `i18n_TranslateNetbeansModule.properties` file.
+
+After creating your folder structure, create a new OnegaT project on the `omegat` folder, that will be the translation base project for all languages. Follow the link:http://translatedfiles.netbeans.org/docs/HOWTOs/How-to-translate-NetBeans-using-OmegaT.html[How to translate NetBeans IDE using OmegaT] tutorial to learn about creating your project.
+{{warning|
+If you are using JavaHelp on your module, you will need an additional change to your OmegaT settings.
+Add a new pattern on your File Filters > Text Files:
+
+[source,java]
+----
+
+Source Filename Pattern: *toc.xml
+Source File Encoding: <auto>
+Target File Encoding: UTF-8
+Target Filename Pattern: ${nameOnly}_${targetLocale}.${extension}
+----
+
+}}
+Now, OmegaT will request you to import source files. Just cancel this operation. Now, run the `i18n-update-omegat-source` on the `build-i18n_TranslateNetbeansModule.xml` build file. If your `i18n.default.name` property is correctly defined, your OmegaT project sources will be updated. Now, just copy your default project, and create a new project, e.g omegat-pt_BR (for Brazilian Portuguese translations) or omegat-ja for Japanese, and open it on OmegaT, configure its properties, as target language and so on.
+
+When you finish the translation, just have OmegaT generate your target files and NetBeans rebuild your project. Then run your project to see the results.
+
+==== Contact and support
+
+If you have any problem or need help to translate into any other language, please contact link:mailto:dev@translatedfiles.netbeans.org[dev@translatedfiles.netbeans.org]. If you wish help maintaining the NetBeans IDE and modules in your language, visit us at link:http://translatedfiles.netbeans.org/[http://translatedfiles.netbeans.org/].
+<hr/>
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/TranslateNetbeansModule[http://wiki.netbeans.org/TranslateNetbeansModule] ,
+that was last modified by NetBeans user Admin
+on 2009-11-05T17:04:49Z.
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/YesNoDialog.png b/wiki-convert/wiki-asciidoc/YesNoDialog.png
new file mode 100644
index 0000000..5ee785e
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/YesNoDialog.png differ
diff --git a/wiki-convert/wiki-asciidoc/addplatform_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/addplatform_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..7d08415
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/addplatform_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/addserver_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/addserver_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..f78e661
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/addserver_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/apidesign.asciidoc b/wiki-convert/wiki-asciidoc/apidesign.asciidoc
new file mode 100644
index 0000000..78dd8ef
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/apidesign.asciidoc
@@ -0,0 +1,35 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= apidesign
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+=== Apache Migration Information
+
+The content in this page was kindly donated by Oracle Corp. to the
+Apache Software Foundation.
+
+This page was exported from link:http://wiki.netbeans.org/[http://wiki.netbeans.org/] ,
+that was last modified by NetBeans user
+on .
+
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/createear1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createear1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..5922fb4
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createear1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createear2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createear2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..99bbbd3
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createear2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createmodule_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createmodule_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..547e185
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createmodule_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createsession1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createsession1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..9f09c35
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createsession1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createsession2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createsession2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..889c333
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createsession2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createsession3_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createsession3_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..d2931e1
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createsession3_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createsuite1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createsuite1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..0f82ab4
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createsuite1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createsuite2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createsuite2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..ec4d789
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createsuite2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createwindow1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createwindow1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..4d97d02
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createwindow1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createwindow2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createwindow2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..65ec759
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createwindow2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/createwindow3_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/createwindow3_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..7617b84
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/createwindow3_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/editearbuild1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/editearbuild1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..2f5d2b6
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/editearbuild1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/editearbuild2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/editearbuild2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..0f7c6db
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/editearbuild2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/generateentity1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/generateentity1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..a08966c
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/generateentity1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/generateentity2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/generateentity2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..75da312
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/generateentity2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/generateentity3_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/generateentity3_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..52523be
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/generateentity3_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/index.asciidoc b/wiki-convert/wiki-asciidoc/index.asciidoc
new file mode 100644
index 0000000..c775068
--- /dev/null
+++ b/wiki-convert/wiki-asciidoc/index.asciidoc
@@ -0,0 +1,560 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+
+= index
+:jbake-type: wiki
+:jbake-tags: wiki, devfaq, needsreview
+:jbake-status: published
+
+= Index
+
+== Actions: How to add things to Files, Folders, Menus, Toolbars and more
+
+* link:DevFaqActionAddAnyFolder.html[How do I add an action to any folder?]
+* link:DevFaqActionAddDataObject.html[How do I add an action to my custom node?]
+* link:DevFaqActionAddEditorPopup.html[How do I add an action to the context menu of a specific editor?]
+* link:DevFaqActionAddFileMime.html[How do I add an action to all files of a given mime-type?]
+* link:DevFaqActionAddFolder.html[How do I add an action to a folder?]
+* link:DevFaqActionAddJavaPackage.html[How do I add an action to an Java package?]
+* link:DevFaqActionAddMenuBar.html[How do I add an action to the main menu?]
+* link:DevFaqActionAddProjectOwnTypePopUp.html[How do I add an action to a project popup menu of my own project type?]
+* link:DevFaqActionAddTabPopup.html[How do I add an action to the global popup menu of tabs?]
+* link:DevFaqActionAddToContextMenuOfAllEditors.html[How do I add an action to the context menu of all editors?]
+* link:DevFaqActionAddToEditorToolbar.html[How do I add an action to the toolbar of the editor?]
+* link:DevFaqActionAddToolBar.html[How do I add an action to a toolbar in the main window?]
+* link:DevFaqActionAddTools.html[How do I add an action to the tools menu?]
+* link:DevFaqActionContextSensitive.html[How do I make an action that is automatically enabled/disabled depending on what's selected?]
+* link:DevFaqActionNodePopupSubmenu.html[How do I make my Node have a submenu on its popup menu?]
+* link:DevFaqActionsAddAtRuntime.html[How do I add an action (incl. shortcut) at runtime?]
+* link:DevFaqActionsFolder.html[What is the Actions folder in the system filesystem, and why should I use it?]
+* link:DevFaqAddActionToMembersOrHierarchyView.html[How do I add an action to the context menu of the members or hierarchy view?]
+* link:DevFaqAddGlobalContext.html[How do I add content to the Global Context?]
+* link:DevFaqAddIconToContextMenu.html[How do I add an icon to the context menu?]
+* link:DevFaqAddMacroableAction.html[How do I create an action which can be invoked by a macro?]
+* link:DevFaqChangeMenuItemToolbarAppearanceForAction.html[How do I change the appearance of the menu items and toolbar buttons for my Action]
+* link:DevFaqCheckableActionPreferenceOption.html[How do I make a checkable/toggle-able action that represents a preference option?]
+* link:DevFaqDropdownMenuAddToolbar.html[How do I add a dropdown menu to toolbar?]
+* link:DevFaqDropdownMenuAddToolbarEnabled.html[How do I add a dropdown menu to toolbar that is selectively enabled/disabled?]
+* link:DevFaqFileOpenAction.html[How do I get the Open File item on the File menu into my platform application?]
+* link:DevFaqFindLocationInSourcesFromUi.html[Looking at the UI how do I find a module that implements a menu item]
+* link:DevFaqHideRemoveToolbarMenu.html[How do I hide/remove default toolbar buttons and/or menu items?]
+* link:DevFaqHideShowToolbar.html[How do I hide/show toolbar dynamically?]
+* link:DevFaqHowCreateAnActionObject.html[How can I to create an Action object and attach this action to one or more components on frame without manually editing Generated Code?]
+* link:DevFaqHowOrganizeOrReuseExistingActionsWithAnnotations.html[How can I reuse and/or organise actions only by using annotations (@ActionReferences)?]
+* link:DevFaqHowToDefineTheKeyMapCategoryForAnAction.html[How do I define and localise the keymap category of an action?]
+* link:DevFaqInvokeActionProgrammatically.html[How do I invoke an action programmatically?]
+* link:DevFaqJSeparatorInMainToolbar.html[How can I add a JSeparator to the main toolbar?]
+* link:DevFaqLogActionStartup.html[How do I invoke the IDE-Log upon Startup?]
+* link:DevFaqMainwindowClosingAction.html[How do i change the closing action of the MainWindow?]
+* link:DevFaqRenamingMenuItem.html[Some module in the IDE etc. already has a menu item I like, but I just want to rename it. Can I?]
+* link:DevFaqSwitchingMenusByContext.html[Can I change the contents of a menu according to the selected file in the editor, or hide or show a whole menu?]
+* link:DevFaqToggleActionAddToEditorToolbar.html[How do I add a toggle-able action to the toolbar/main menu?]
+* link:DevFaqTweakRegistryByCodeDeduction.html[How do I remove Menu Item, Toolbar Button from plug-in's XML Layer?]
+* link:DevFaqTweakRegistryByCodeReplacement.html[How do I have only Shortcut Keys for an Action?]
+* link:DevFaqUsingSubmenus.html[Can I install submenus into popups or other menus, instead of a regular action?]
+
+== Application Lifecycle and Hooks
+
+* link:DevFaqAppLifecycleHooks.html[What are some of the hooks in the application's lifecycle I can plug into?]
+
+== Authentication and Authorization in Platform Apps
+
+* link:DevFaqPlatformAppAuthStrategies.html[Other strategies for authentication and authorization]
+
+== Branding your application
+
+* link:BrandingAboutDialog.html[Branding About Dialog]
+* link:BrandingUpdaterSplash.html[Branding Updater Splash]
+* link:DevFaqRemoveStatusBar.html[How do I remove the status bar?]
+* link:DevFaqVersionNumber.html[How do I set the version number?]
+* link:TranslateNetbeansModule.html[Translating a NetBeans Module]
+
+== Command Line Parsing
+
+* link:HowToEnableDisableMenusFromCommandLine.html[Can something that the user sets on the command line determine whether a menu item is enabled?]
+* link:HowToEnableDisableModulesFromCommandLine.html[Same as the above, but this time for enabling/disabling modules?]
+* link:HowToPassCommandLineArgumentsToANetBeansPlatformApplicationWhenRunInsideTheIDE.html[How to pass command line arguments to a NetBeans Platform application when run inside the IDE]
+
+== Configuration: How Modules Install Things
+
+* link:DevFaqDotSettingsFiles.html[What are .settings files?]
+* link:DevFaqDotShadowFiles.html[What are .shadow files?]
+* link:DevFaqDynamicSystemFilesystem.html[Can I dynamically change the contents of the System Filesystem at runtime?]
+* link:DevFaqFilesystemSee.html[How can I see the filesystem?]
+* link:DevFaqInstalledFileLocator.html[Can I bundle some additional files with my module? If so, how can I find those files to use them from my module?]
+* link:DevFaqInstanceDataObject.html[What are .instance files?]
+* link:DevFaqModulesGeneral.html[What are the ways a module can influence the system?]
+* link:DevFaqModulesLayerFile.html[What is an XML layer?]
+* link:DevFaqModulesStartupActions.html[How do I run some code when my module starts/loads/unloads?]
+* link:DevFaqOrderAttributes.html[How do I specify the order for my menu items/toolbar buttons/files in the system filesystem?]
+* link:DevFaqSystemFilesystem.html[What is the system filesystem?]
+* link:DevFaqUserDir.html[What is the user directory, what is in it, and why do I need one?]
+
+== Contributor Agreement
+
+* link:FaqBlanketJCAForEmployees.html[Can my company sign a blanket JCA for all its employees?]
+* link:FaqCAAndRejectedContribution.html[I tried to make a contribution to netbeans.org and signed a CA, but my contribution was not accepted. What is the result?]
+* link:FaqCAForEveryContribution.html[Do I have to file a CA for every contribution?]
+* link:FaqCanICancelCA.html[Once I have a CA on file, can I change my mind and cancel?]
+* link:FaqCanIFileByEmail.html[Can I file my completed CA by e-mail?]
+* link:FaqCompanyOrIndividualCA.html[If my company wants me to contribute changes, who should sign the CA, me or my company?]
+* link:FaqDoINeedACA.html[Do I have to fill out a CA?]
+* link:FaqHowDoIFileACA.html[How do I file a completed CA?]
+* link:FaqJCAAndCA.html[I've already signed a JCA; do I still have to sign the CA?]
+* link:FaqListedOnCopyright.html[I have a CA or JCA on file and I have made a code contribution to netbeans.org. Can I get listed on the copyright notice?]
+* link:FaqOtherSunCA.html[I've already signed a CA for another Oracle project, do I need to sign another one for NetBeans?]
+* link:FaqWhatIsCA.html[What is the Contributor Agreement ("CA")?]
+* link:FaqWhichVersionCA.html[I've already signed a recent version of the CA, do I need to sign the newest version?]
+* link:FaqWhyTheCA.html[Why does NetBeans request a CA?]
+
+== Converting between common data types and finding things
+
+* link:DevFaqDataObjectFileObject.html[How do I get a DataObject for a FileObject?]
+* link:DevFaqDataObjectNode.html[How do I get a DataObject for a Node?]
+* link:DevFaqFileFileObject.html[How do I get a java.io.File for a FileObject?]
+* link:DevFaqFileObjectDataObject.html[How do I get a FileObject for a DataObject?]
+* link:DevFaqFileObjectFile.html[How do I get a FileObject for a File?]
+* link:DevFaqFileVsFileObject.html[FileObjects versus Files]
+* link:DevFaqFindInstance.html[I have a .instance file. How do I get an actual object instance?]
+* link:DevFaqFindSfs.html[How do I get a reference to the system filesystem?]
+* link:DevFaqFolderOfInstances.html[I have a folder full of .instance files. How do I get any/all of the object instances?]
+* link:DevFaqNodeDataObject.html[How do I get a Node for a DataObject?]
+* link:DevFaqUriVsUrl.html[URIs and URLs]
+
+== Creating a Custom Programming Language
+
+* link:DevFaqCustomDebugger.html[How can I create a custom Debugger for my language?]
+* link:DevFaqSyntaxHighlight.html[How do I add syntax highlighting for my language?]
+
+== Deploying Changes through AutoUpdate and using Autoupdate API
+
+* link:DevFaqAutoUpdateAPIJavadoc.html[How can I find Javadoc of Autoupdate API with hints to use it?]
+* link:DevFaqAutoUpdateBranding.html[How can I update the splash screen, title bar and other branding items via AutoUpdate?]
+* link:DevFaqAutoUpdateCheckEveryStartup.html[How to force to check for updates at every startup?]
+* link:DevFaqCustomUpdateCenter.html[How can I use AutoUpdate to deploy updates and new modules for my application?]
+* link:DevFaqHowToChangeUpdateCenterURL.html[How to change the update center URL via code?]
+* link:DevFaqNBMPack200.html[How to deal with pack200 compression in NBM?]
+* link:DevFaqNbmPostInstall.html[How to specify post-install code in NBM?]
+* link:DevFaqUseNativeInstaller.html[How can I run the installer for something else during module installation?]
+* link:FaqPluginManagerCustomization.html[What other documentation is available about AutoUpdate?]
+
+== Deployment using installers / NBI
+
+* link:DevInstallerAddVersioningInfo.html[How to add versioning information to be shown in "Installed Programs" (Windows-only)?]
+
+== Development issues, module basics and classpath issues, and information about RCP/Platform application configuration
+
+* link:DevFaq2SrcPaths.html[How do I have two source directories within one module?]
+* link:DevFaqAnnotationDevelopDebug.html[How do I develop and debug annotations for NetBeans platform apps?]
+* link:DevFaqApiSpi.html[What is an SPI? How is it different from an API?]
+* link:DevFaqAutomaticPlatformDownload.html[How can I have my application compiled in a specific version of the platform?]
+* link:DevFaqClassLoaders.html[What classloaders are created by the module system?]
+* link:DevFaqCustomizeBuild.html[How can I customize the build process?]
+* link:DevFaqDependOnCore.html[There is a class under org.netbeans.core that does what I need. Can I depend on it?]
+* link:DevFaqExternalLibraries.html[How to store external libraries in the NetBeans Hg repository]
+* link:DevFaqHowPackageLibraries.html[I need to package some third party libraries with my module. How do I do that?]
+* link:DevFaqHowToFixDependencies.html[My project.xml lists more dependencies than I really need. How can I fix it?]
+* link:DevFaqHowToReuseModules.html[Can I use modules from update center in my RCP application?]
+* link:DevFaqImplementationDependency.html[What is an implementation dependency and what/how/when should I use one?]
+* link:DevFaqJavaHelp.html[Is there a standard way to provide user documentation (help) for my module?]
+* link:DevFaqMemoryLeaks.html[How can I fix memory leaks?]
+* link:DevFaqMigratingToNewerPlatform.html[Migrating to a newer version of the Platform]
+* link:DevFaqModuleDependencies.html[How do module dependencies/classloading work?]
+* link:DevFaqModulePatching.html[How do I create a patch for a preexisting NetBeans module?]
+* link:DevFaqModuleReload.html[Do I need to restart NetBeans every time to debug new changes?]
+* link:DevFaqNativeLibraries.html[How do I add native libraries?]
+* link:DevFaqNbIdiosyncracies.html[Common calls that should be done slightly differently in NetBeans than standard Swing apps (loading images, localized strings, showing dialogs)]
+* link:DevFaqNbPlatformAndHarnessMixAndMatch.html[I want to use one version of the Platform with another version of the build harness. Can I?]
+* link:DevFaqNetBeansClasspath.html[My module uses some libraries. I've tried setting CLASSPATH but it doesn't work. Help!]
+* link:DevFaqNetBeansFullHack.html[Can I test changes to the IDE without going through the license check and so on?]
+* link:DevFaqNetBeansProjectsDirectory.html[How can I customize the default project directory for my application, replacing "NetBeansProjects"?]
+* link:DevFaqNoClassDefFound.html[My module uses class XYZ from NetBeans' APIs. It compiles, but I get a NoClassDefFoundError at runtime. Why?]
+* link:DevFaqOrphanedNetBeansOrgModules.html[Can I work on just one or two modules from the NetBeans source base by themselves?]
+* link:DevFaqPlatformRuntimeProperties.html[I want to set some flags or CLI arguments for running my NB RCP/Platform based application (such as disable assertions). How do I do that?]
+* link:DevFaqProfiling.html[How can I profile NetBeans?]
+* link:DevFaqRuntimeMemory.html[How to run module with more PermGen and Heap memory?]
+* link:DevFaqSignNbm.html[Can I sign NBMs I create?]
+* link:DevFaqSpecifyJdkVersion.html[My module requires JDK 6 - how do I keep it from being loaded on an older release?]
+* link:DevFaqSuitesVsClusters.html[What is the difference between a suite and a cluster?]
+* link:DevFaqTopManager.html[Where is TopManager? I'm trying to do the examples from the O'Reilly book]
+* link:DevFaqUIResponsiveness.html[I am developing a NetBeans module. What performance criteria should it satisfy?]
+* link:DevFaqUiDefaultsPropsNotFound.html[Why can't I load properties using UIDefaults?]
+* link:DevFaqWeakListener.html[What is a WeakListener?]
+* link:DevFaqWeakListenerWhen.html[When should I use a WeakListener?]
+* link:DevFaqWhatIsACluster.html[What is a module cluster?]
+* link:DevFaqWhatIsNbm.html[What is an "NBM"?]
+* link:DevFaqWhenUseWrapperModule.html[When should I use a library wrapper module and when should I just package the library into my module?]
+* link:DevFaqWrapperModules.html[What is a library wrapper module and how do I use it?]
+* link:FaqRunSameTargetOnAllModules.html[How can I launch an Ant Task on all modules of my suite?]
+
+== Dialogs API
+
+* link:DevFaqDialogControlOKButton.html[How can I control when the OK button is enabled]
+* link:DevFaqDialogsApiIntro.html[What is the Dialogs API and How Do I Use It?]
+
+== Editor and Edited Files
+
+* link:DevFaqEditorCodeCompletionAnyJEditorPane.html[How to add code completion to any JEditorPane]
+* link:DevFaqEditorGetCurrentDocument.html[How can I get the currently open document in the selected editor?]
+* link:DevFaqEditorHowIsMimeLookupComposed.html[How is MimeLookup composed?]
+* link:DevFaqEditorHowToAddCodeTemplates.html[How to add code templates?]
+* link:DevFaqEditorHowToAddDiffView.html[How to use the diff view in my own application/plugin?]
+* link:DevFaqEditorHowToGetMimeTypeFromDocumentOrJTextComponent.html[How to get mime type from Document or JTextComponent?]
+* link:DevFaqEditorHowToReuseEditorHighlighting.html[How to reuse XML syntax highlighting in your own editor]
+* link:DevFaqEditorJEPForMimeType.html[How can I create JEditorPane for a specific document type?]
+* link:DevFaqEditorWhatIsMimeLookup.html[What is MimeLookup?]
+* link:DevFaqEditorWhatIsMimePath.html[What is MimePath?]
+* link:DevFaqFileEditorContextMenuAddition.html[Can I add a menu item to the context menu of the Java source editor?]
+* link:DevFaqFindCaretPositionInEditor.html[How can I get the position of the caret/line in the selected editor?]
+* link:DevFaqGetOpenEditorWindows.html[How can I get a list of open editors/documents?]
+* link:DevFaqI18nFileEncodingQueryObject.html[Project Encoding vs. File Encoding - What are the precedence rules used in NetBeans 6.0?]
+* link:DevFaqListenEditorChanges.html[How can I track what file the user is currently editing?]
+* link:DevFaqModifyOpenFile.html[Is it safe to programmatically modify a file which is open in the editor?]
+* link:DevFaqMultipleProgrammaticEdits.html[I want to make some programmatic changes to the edited file. How can I do it so one Undo undoes it all?]
+* link:DevFaqOpenFileAtLine.html[How can I open a file in the editor at a particular line number and column?]
+* link:DevFaqOpenReadOnly.html[How can I open a file in the editor in read-only mode?]
+* link:DevFaqSyntaxColoring.html[Can I add syntax coloring for my own data object/MIME type?]
+
+== File Management (within the IDE/Application)
+
+* link:DevFaqOpenFile.html[How can I open a file in the IDE programatically?]
+
+== Files and Data Objects
+
+* link:DevFaqDataLoader.html[What is a DataLoader?]
+* link:DevFaqDataObject.html[What is a DataObject?]
+* link:DevFaqDataObjectInItsCookieSet.html[The next button is never enabled when I create my DataObject from a template. Help!]
+* link:DevFaqDataSystemsAddPopupToAllFolders.html[How do I add a menu item to the popup menu of every folder in the system?]
+* link:DevFaqFileAttributes.html[What are file attributes?]
+* link:DevFaqFileChoosers.html[I need to show a file chooser. How can I remember most-recently-used directories?]
+* link:DevFaqFileContextMenuAddition.html[Can I add a menu item to the context menu of every Java source file?]
+* link:DevFaqFileObject.html[What is a FileObject?]
+* link:DevFaqFileObjectInMemory.html[How can I create a FileObject in memory?]
+* link:DevFaqFileRecognition.html[How does NetBeans recognize files?]
+* link:DevFaqFileSystem.html[What is a FileSystem?]
+* link:DevFaqImplementFilesystem.html[I'm having trouble implementing this filesystem....]
+* link:DevFaqListenForChangesInNonExistentFile.html[I want to listen for changes in a file that may not exist or may be deleted and re-created]
+* link:DevFaqListenForOpenEvents.html[How can I be notified when a file is opened?]
+* link:DevFaqListenForSaveEvents.html[How can I be notified when a file is modified and saved?]
+* link:DevFaqListeningForFileChanges.html[I am listening for changes in a folder/file but when there are changes I do not receive an event]
+* link:DevFaqMIMEResolver.html[How can I create declarative MIMEResolver and add new file type?]
+* link:DevFaqNewXMLFileType.html[How do I add support for an XML type with a different extension?]
+
+== Getting Started
+
+* link:DefFaqMapApisToTasks.html[What API do I want to use for x, y or z?]
+* link:DevFaqAccessSourcesUsingMercurial.html[How do I get sources for NetBeans using Mercurial (hg)?]
+* link:DevFaqAccessSourcesWeb.html[How do I get zipped sources for a periodic build?]
+* link:DevFaqBecomingProficient.html[Becoming a proficient module developer]
+* link:DevFaqGeneralPackageNamingConventions.html[Why are some packages org.netbeans.api.something and others are org.netbeans.something.api?]
+* link:DevFaqGeneralWhatIsNetBeansExe.html[What is netbeans.exe, who compiles it and why is it there?]
+* link:DevFaqGeneralWhereIsJavadoc.html[Where can I find Javadoc for the IDE and Platform?]
+* link:DevFaqGeneralWhereIsPlatformHowToBuild.html[Where is the Platform and how can I build it?]
+* link:DevFaqLibrariesModuleDescriptions.html[In the Libraries tab of my application's Project Properties, there sure are a lot of modules listed. What are they for]
+* link:DevFaqNetBeansPlatformManager.html[How do I set up a NetBeans Platform in the IDE?]
+* link:DevFaqSellingModules.html[I have written a module. Can I sell it?]
+* link:DevFaqSourceTreeModuleDescriptions.html[There sure are a lot of modules in the source tree. What are they for]
+* link:DevFaqWhatIsAModule.html[What is a module?]
+
+== Getting support, where to find examples
+
+* link:DevFaqFileBug.html[Filing a bug report]
+* link:DevFaqMoreDocsOnCertainAPIs.html[Where can I find more documentation on certain APIs?]
+* link:DevFaqSampleCode.html[Examples of how to use various APIs]
+* link:NetBeansCertifiedEngineerCourse.html[Can I get training material for the NetBeans Certification course?]
+
+== HTML Browser
+
+* link:DevFaqHowToOpenURL.html[How to open a URL in the internal/default HTML browser?]
+
+== JavaHelp
+
+* link:DevFaqHelpGuidelines.html[JavaHelp integration guide]
+* link:DevFaqIdeWelcome.html[How do I fix problems about 'ide.welcome'?]
+* link:DevFaqJavaHelpForNodeProperties.html[How can I hook up JavaHelp to property sets or individual properties?]
+* link:DevFaqJavaHelpNotDisplayed.html[Why doesn't my JavaHelp content show up?]
+* link:DevFaqJavaHelpOverrideCustom.html[How can I override JavaHelp to display my own custom help or documentation?]
+
+== Key Bindings
+
+* link:DevFaqAddDefaultActionShortcuts.html[How do I add default shortcuts for SystemActions (like cut, paste, etc)?]
+* link:DevFaqAddShortCutForAction.html[How to set the shortcut of an action outside of your own module?]
+* link:DevFaqGetShortCutForAction.html[How to get the shortcut/shortkey of an action at runtime?]
+* link:DevFaqGlobalVsEditorKeybindings.html[What about editor-specific keybindings?]
+* link:DevFaqKeybindings.html[How do key bindings work?]
+* link:DevFaqKeybindingsInUse.html[Which keybindings are already being used?]
+* link:DevFaqLogicalKeybindings.html[Why should I use D- for Ctrl and O- for Alt? I thought C- stood for Ctrl and A- stood for Alt!]
+* link:DevFaqOrderActions.html[I want my action to appear between two existing items/in a specific place in the menu. Can I do that?]
+* link:DevFaqRebindingKeys.html[Binding one key to more than one action]
+
+== Licensing Issues
+
+* link:DevFaqEpl3rdPartySources.html[Where to download sources of EPL third-party components?]
+* link:DevFaqLgpl3rdPartySources.html[Where to download sources of LGPL third-party components?]
+* link:DevFaqLic3rdPartyComponents.html[NetBeans Platform and 3rd party components]
+* link:DevFaqMpl3rdPartySources.html[Where to download sources of MPL third-party components?]
+
+== Logging and Error Handling
+
+* link:DevFaqAddTimestampToLogs.html[How can I add a timestamp to the logs?]
+* link:DevFaqCustomizingUnexpectedExceptionDialog.html[How can I customize the Unexpected Exception dialog?]
+* link:DevFaqLogging.html[Using java.util.logging in NetBeans]
+* link:DevFaqUIGestures.html[UI Logging through Gestures Collector]
+* link:DevFaqUnexpectedExceptionDialog.html[How can I suppress the Unexpected Exception dialog?]
+
+== Look and Design
+
+* link:DevFaqChangeLookAndFeel.html[How can I set the Swing look and feel on startup?]
+* link:DevFaqCustomFontSize.html[I have a custom component. How can I make it respond to --fontsize like the rest of NetBeans?]
+* link:DevFaqImagesForDarkLaf.html[How to provide non-inverted images for dark LookAndFeels like DarkMetal/Darcula?]
+
+== Lookup
+
+* link:DevFaqLookup.html[What is a Lookup?]
+* link:DevFaqLookupContents.html[How can I find out what is in a Lookup]
+* link:DevFaqLookupCookie.html[What is the difference between getCookie(Class), SharedClassObject.findObject(Class) and Lookup.lookup(Class)?]
+* link:DevFaqLookupDefault.html[What is the "default Lookup"?]
+* link:DevFaqLookupEventBus.html[Event Bus in NetBeans]
+* link:DevFaqLookupForDataNode.html[How can I add support for lookups on nodes representing my file type?]
+* link:DevFaqLookupGenerics.html[How do I use Java generics with Lookup?]
+* link:DevFaqLookupHowToOverride.html[How can I override an instance in the Lookup?]
+* link:DevFaqLookupImplement.html[How do I implement my own lookup or proxy another one?]
+* link:DevFaqLookupLazyLoad.html[How do I lazy-load an item in the lookup?]
+* link:DevFaqLookupNonSingleton.html[If there is more than one of a type in a Lookup, which instance will I get?]
+* link:DevFaqLookupPackageNamingAndLookup.html[After adding my class to Lookup I get a "ClassNotFoundException" when trying to look it up, why?]
+* link:DevFaqLookupVsHashmap.html[Why use Lookup - wouldn't a Map be good enough?]
+* link:DevFaqLookupWhere.html[What uses Lookup?]
+* link:DevFaqSysFsLookupRegistration.html[How can I register services into the lookup using the system filesystem?]
+* link:DevFaqWhenLookup.html[When should I use Lookup in my own APIs?]
+
+== Mavenized Builds
+
+* link:DevFaqMavenHowToMigrateFromANT.html[How to convert an ANT-based NetBeans Module to a Maven-based NetBeans Module?]
+* link:DevFaqMavenL10N.html[How can I create localization modules using Maven?]
+* link:DevFaqMavenPlatformRebel.html[Can I use JRebel to speed up development?]
+* link:DevFaqMavenSystemScope.html[Why can't I use system scope for a library wrapper module?]
+
+== Module System
+
+* link:Autoload.html[What is an autoload module?]
+* link:DevFaqChangeRestartSplash.html[How can I change the NetBeans splash screen shown when an installed module requires restart?]
+* link:DevFaqDisableAutoupdate.html[Can I disable Auto Update (for example, while running tests)?]
+* link:DevFaqFixDependencies.html[How fix module dependencies automatically?]
+* link:DevFaqModuleCCE.html[Why am I getting a ClassCastException when the class is clearly of the right type?]
+* link:DevFaqModuleDupePackages.html[Can two or more modules contain the same package?]
+* link:DevFaqModuleLoadUnloadNotification.html[How can code in one module be notified when other modules are loaded or unloaded?]
+* link:DevFaqModuleObfuscation.html[How can I obfuscate a module?]
+* link:DevFaqNonGuiPlatformApp.html[Can I create a console or server (non-GUI) app with the NetBeans Platform?]
+* link:DevFaqSuppressExistingModule.html[I want my module to disable some of the modules that would normally be enabled. Possible?]
+* link:DevFaqTutorialsDebugging.html[How do I debug a module I'm building?]
+
+== NetBeans Developer FAQ
+
+* link:FaqIndex.html[list of other FAQs]
+* link:HowToAddFAQEntries.html[How To Add FAQ Entries]
+
+== Nodes and Explorer
+
+* link:DevFaqAddDoingEvilThingsToForeignNodes.html[I have a reference to an existing Node from some other module. Can I add cookies/properties/children?]
+* link:DevFaqAddingRemovingChildrenDynamically.html[Can I add, remove or reorder children of a node on the fly?]
+* link:DevFaqChangeNodeAppearance.html[How can I change my node's appearance?]
+* link:DevFaqCreateExplorerPanel.html[How do I create a TopComponent (tab in the main window) to show some Nodes?]
+* link:DevFaqCutCopyPaste.html[How do I handle cut, copy and paste?]
+* link:DevFaqExpandAndSelectSpecificNode.html[How do I make a particular node visible in the Explorer, and maybe select it?]
+* link:DevFaqExplorer.html[What is "explorer"?]
+* link:DevFaqExplorerConnectNode.html[How do I show a Node in my explorer view?]
+* link:DevFaqExplorerManager.html[What is an ExplorerManager?]
+* link:DevFaqExplorerViews.html[What is an Explorer View?]
+* link:DevFaqExplorerViewsInMantisse.html[How can I design explorer views in Mantisse GUI editor?]
+* link:DevFaqFilesFromNodes.html[How do I get at the file that a particular node represents?]
+* link:DevFaqGraphicalChoiceView.html[How can I graphically create a ChoiceView?]
+* link:DevFaqNodeChildrenDotLeaf.html[Why do my nodes in the Explorer always have an expand-box by them, even though they have no children?]
+* link:DevFaqNodeDeletionDialog.html[How can I prevent (or override) the node deletion dialog?]
+* link:DevFaqNodeInjectingLookupContents.html[I want to allow other modules to inject objects into my Node's Lookup, or Actions into its actions]
+* link:DevFaqNodePropertyForFiles.html[I have a Node.Property for a file. How can I control the file chooser that is the custom editor?]
+* link:DevFaqNodeSelectAll.html[How can I implement "Select all/Deselect all/Invert selection" features?]
+* link:DevFaqNodeSerialize.html[How to serialize my nodes?]
+* link:DevFaqNodeSubclass.html[I need to create my own Nodes. What should I subclass?]
+* link:DevFaqNodeViewCapability.html[How can I add a "View" capability for data my node represents?]
+* link:DevFaqNodesChildFactory.html[I need to show Nodes for objects that are slow to create. How do I compute Node children on a background thread?]
+* link:DevFaqNodesCustomLookup.html[I need to add to/remove from/customize the content of my Node/DataObject/TopComponent's Lookup. How do I do it?]
+* link:DevFaqNodesDecorating.html[How do I "decorate" nodes that come from another module (i.e. add icons, actions)?]
+* link:DevFaqOutlineViewHorizontalScrolling.html[How can I add horizontal scrolling support to the OutlineView component?]
+* link:DevFaqPropertyEditorHints.html[I have a Node.Property. I want to control its appearance or custom editor somehow. Can I do that without writing my own property editor?]
+* link:DevFaqSortableTTVColumns.html[How can I make sortable columns in a TreeTableView?]
+* link:DevFaqSuppressEditTTVColumns.html[How do I remove the "..." buttons of a TreeTableView?]
+* link:DevFaqTrackGlobalSelection.html[I need to write some code that tracks the global selection. What should I do?]
+* link:DevFaqTrackingExplorerSelections.html[Tracking selections in the Explorer]
+* link:DevFaqViewSaveTTVColumns.html[How do I preserve the column attributes of a TreeTableView?]
+* link:DevFaqWhatIsANode.html[What is a Node?]
+
+== Output Window
+
+* link:DevFaqCustomIOProvider.html[How to implement custom IOProvider?]
+* link:DevFaqInput.html[How to get user input in the Output Window?]
+* link:DevFaqOWColorText.html[How to use color text in Output Window?]
+* link:DevFaqOWTabEmbedding.html[How do I embed output window tab to another component?]
+* link:DevFaqOutputWindow.html[How do I create my own tab in the output window and write to it?]
+* link:DevFaqOutputWindowExternalProcess.html[How do I route the output from an external process to the output window?]
+
+== Printing
+
+* link:DevFaqHowToPrint.html[Help, the Print menu item is disabled!]
+
+== Programmatic access to Java Sources
+
+* link:DevFaqObtainSourcesOfAJavaClass.html[How to obtain a source file for a Java class and open in the editor?]
+* link:DevFaqScanForClasses.html[How can I scan a classpath to find all classes of a particular type?]
+* link:JavaHT_GetAllMembers.html[How do I Get All Methods/Fields/Constructors of a Class?]
+* link:JavaHT_Modification.html[How can I programmatically modify a Java source file?]
+* link:Java_DevelopersGuide.html[Java_DevelopersGuide]
+
+== Project Handling
+
+* link:DevFaqGetNameOfProjectGroup.html[How to get the name of the active project group?]
+* link:DevFaqGetNameOrIconForProject.html[How to get the name or icon of a project?]
+* link:DevFaqGetProjectForFileInEditor.html[How to get the project of the active file in the editor?]
+* link:DevFaqListenForOpeningClosingProject.html[How to listen for projects to be opened/closed?]
+* link:DevFaqOpenProjectProgramatically.html[How can I open a Project programatically?]
+
+== Project Types
+
+* link:DevFaqActionAddProjectCustomizer.html[How to add a new panel to a Project Properties dialog?]
+* link:DevFaqActionAddProjectCustomizerToMultipleTypes.html[How do I register a "ProjectCustomizer" to multiple project types?]
+* link:DevFaqActionAddProjectPopUp.html[How do I add an action to a project popup menu?]
+* link:DevFaqActionAddProjectTypePopUp.html[How do I add an action to a project popup menu of a specific project type?]
+* link:DevFaqActionAllAvailableProjectTypes.html[How determine all available project types?]
+* link:DevFaqAddFileTemplateToNewFileContentMenu.html[How can I define the available File types when the user right-clicks the project folder and chooses "New"?]
+* link:DevFaqIdentifyMain.html[How do I identify the "main project"?]
+* link:DevFaqPossibleToExtend.html[Is it possible to extend an existing project type?]
+
+== Properties and PropertySheet
+
+* link:DevFaqPropertySheetEditors.html[How do I change the default behavior of PropertySheet editors?]
+* link:DevFaqPropertySheetHideDescription.html[How do I hide the description area in property window?]
+* link:DevFaqPropertySheetNodes.html[How do I show my node's properties in the Properties view?]
+* link:DevFaqPropertySheetReadonlyProperty.html[How do I add a readonly property?]
+* link:DevFaqPropertySheetTabs.html[How do I display different groups of properties on buttons in the property sheet the way Matisse does?]
+
+== Running and Writing tests
+
+* link:DevFaqTestDataObject.html[Writing Tests for DataObjects and DataLoaders]
+* link:DevFaqTestUsingSystemFileSystem.html[How do I test something which uses the System Filesystem?]
+* link:DevFaqUsingSimpletests.html[Using NbModuleSuite & friends]
+* link:DevRunningTestsPlatformApp.html[Running tests on a platform application]
+* link:NetBeansDeveloperTestFAQ.html[NetBeans Developer Test FAQ]
+* link:TestingThingsThatUseFileObjectDataObjectDataFolder.html[Testing things that use FileObjects]
+
+== Settings
+
+* link:DevFaqExportImport.html[How to register options for export/import to module's layer?]
+* link:DevFaqExtendOptionsSearch.html[How can I configure my options panel to be found by global quicksearch or options search?]
+* link:DevFaqExtendOptionsWindow.html[Can I add new panels to the Options window?]
+* link:DevFaqHowToChangeSettingsFromAnExternalModules.html[How do you change the configuration of other modules?]
+* link:DevFaqJavaStartParms.html[How do I change the application's Java start parameters?]
+* link:DevFaqOpenOptionsAtCategory.html[How do you open the option dialog with a preselected category?]
+* link:DevFaqSetPrefs.html[How do I let the user set preferences/options/customization/configuration for my module/application?]
+
+== Tasks and Progressbar
+
+* link:DevFaqExternalExecution.html[How to run/execute an external program?]
+* link:DevFaqTaskLongRunningAsyncTask.html[How to execute a long running task from an action without blocking the GUI?]
+
+== Threading
+
+* link:DevFaqBackgroundThread.html[What is a background thread and why do I need one?]
+* link:DevFaqRequestProcessor.html[When should I use RequestProcessor.getDefault() and when should I create my own RequestProcessor?]
+* link:DevFaqRequestProcessorTask.html[How can I run an operation occasionally on a background thread, but reschedule it if something happens to delay it?]
+* link:DevFaqThreading.html[I need to run some code on a background thread. Can the platform help me?]
+* link:DevFaqThreadingBuiltIn.html[What APIs come with built-in background thread handling?]
+
+== Tutorials and important starting points
+
+* link:DevFaqAnnotationList.html[NetBeans Annotation Cheat Sheet]
+* link:DevFaqApisBasics.html[What are the basic things I should know about NetBeans' architecture to get started creating NetBeans Platform applications?]
+* link:DevFaqTutorialsAPI.html[NetBeans API starting point]
+* link:DevFaqTutorialsIndex.html[Any tutorials out there, please?]
+
+== Using Enterprise Resources from NetBeans module
+
+* link:DevFaqAppClientOnNbPlatformTut.html[Java EE Application Client on top of NetBeans Platform Tutorial]
+* link:DevFaqCallEjbFromNbm.html[How to call EJB from NetBeans module]
+
+== Using Sounds
+
+* link:DevFaqMakeItTalk.html[How to make my application talk?]
+* link:DevFaqUseSounds.html[How to use sounds in my application?]
+
+== Versioning
+
+* link:ProjectVersioning.html[How to add versioning actions like GIT, Mercurial, SVN, CVS to my own nodes?]
+
+== When There Are Multiple Ways To Do Something...
+
+* link:DevFaqModulesDeclarativeVsProgrammatic.html[Installing things declaratively vs. installing things programmatically]
+* link:DevFaqRegisterObjectsViaInstanceOrSettingsFiles.html[Should I register an object in my layer file using .instance or .settings files? What about .shadow files?]
+* link:DevFaqWaysToRegisterInDefaultLookup.html[Which way should I register an object in the default Lookup?]
+* link:DevFaqWhenToUseWhatRegistrationMethod.html[I need to register some object to be found at runtime, or run some code on startup. Which way should I use?]
+
+== When things go wrong: Troubleshooting
+
+* link:DevFaqTroubleshootClassNotFound.html[I've got a class not found error/exception. How can I fix it?]
+* link:DevFaqTroubleshootMissingItemsInZippedSources.html[I find files missing from the source ZIP file]
+
+== Window System
+
+* link:DevFaqCustomWindowMode.html[How to create a custom window mode?]
+* link:DevFaqCustomizeWindowSystem.html[How can I customize the window system via the latest 7.1 techniques/enhancements?]
+* link:DevFaqEditorTopComponent.html[I want to create a TopComponent class to use as an editor, not a singleton]
+* link:DevFaqExecutableIcon.html[How can I change the executable's icon?]
+* link:DevFaqInitialMainWindowSize.html[How do I set the initial size of the main window?]
+* link:DevFaqMainTitle.html[How to change main title contents?]
+* link:DevFaqMixingLightweightHeavyweight.html[How to mix lightweight (Swing) and heavyweight (AWT) components?]
+* link:DevFaqMultipleTopComponentAction.html[I have a non-singleton TopComponent. Can I write actions which show all available instances in the main menu?]
+* link:DevFaqNonSingletonTopComponents.html[How can I change my TopComponent to not be a singleton?]
+* link:DevFaqOverrideDefaultWindowSize.html[How to override the default size of an existing window?]
+* link:DevFaqReplaceWindowSystem.html[How can I replace the Window System?]
+* link:DevFaqWindowsAndDialogs.html[Windows and dialogs]
+* link:DevFaqWindowsComponentHowTo.html[I want to show my own component(s) in the main window - where do I start?]
+* link:DevFaqWindowsGeneral.html[What is the window system]
+* [[DevFaqWindowsInternals|How does the window system _really_ work?]]
+* link:DevFaqWindowsMatisse.html[How do I use Matisse/GroupLayout (new form editor/layout manager in 5.0) in my windowing system components]
+* link:DevFaqWindowsMaximizeViaCode.html[How to maximize a TopComponent?]
+* link:DevFaqWindowsMode.html[What are Modes?]
+* link:DevFaqWindowsNoActionsOnToolbars.html[I want to disable the popup menu on the toolbars in the main window. How do I do that?]
+* link:DevFaqWindowsOpenInMode.html[My TopComponent always opens in the editor area, but I want it to open in the same place as XYZ]
+* link:DevFaqWindowsOpenTopComponents.html[Which TopComponents are open?]
+* link:DevFaqWindowsTopComponent.html[What are TopComponents?]
+* link:DevFaqWindowsTopComponentLookup.html[Why does TopComponent have a getLookup() method? What is it for?]
+* link:DevFaqWindowsWstcrefAndFriends.html[How do I use .wstcrf/.wsmode/.settings files to install my module's components in the window system?]
+* link:DevFaqWindowsXmlApi.html[How does the XML API for installing window system components work?]
+
+== Wizards and Templates
+
+* link:DevFaqMakeGroupTemplate.html[How do I make a file template which actually creates a set of files at once?]
+* link:DevFaqOpenFilesAfterProjectCreation.html[How to open files in editor after project creation?]
+* link:DevFaqTemplatesInNonIdeApp.html[I am creating a non-IDE application. How do I enable/control templates?]
+* link:DevFaqWizardChangeLabelsOfDefaultButtons.html[How to customize the button text of default buttons of a wizard (Finish, Cancel, etc.)?]
+* link:DevFaqWizardPanelError.html[How do I show that a user has filled an invalid input into my wizard?]
+
+== XML Multiview API
+
+* link:DevFaqMultiViewChangeTabInCode.html[How to change selected tab of Multiview?]
+
+*NOTE:* This document was automatically converted to the AsciiDoc format on 2018-01-10, and needs to be reviewed.
diff --git a/wiki-convert/wiki-asciidoc/modifyappclient1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/modifyappclient1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..ac7168c
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/modifyappclient1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/modifyappclient2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/modifyappclient2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..05790ef
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/modifyappclient2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/modifyappclient3_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/modifyappclient3_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..be39d20
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/modifyappclient3_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/modifyappclient4_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/modifyappclient4_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..e7d544b
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/modifyappclient4_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/projects_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/projects_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..3ab5eb6
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/projects_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/reuse-modules-1_DevFaqHowToReuseModules.png b/wiki-convert/wiki-asciidoc/reuse-modules-1_DevFaqHowToReuseModules.png
new file mode 100644
index 0000000..e0fc99d
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/reuse-modules-1_DevFaqHowToReuseModules.png differ
diff --git a/wiki-convert/wiki-asciidoc/reuse-modules-2_DevFaqHowToReuseModules.png b/wiki-convert/wiki-asciidoc/reuse-modules-2_DevFaqHowToReuseModules.png
new file mode 100644
index 0000000..e492a62
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/reuse-modules-2_DevFaqHowToReuseModules.png differ
diff --git a/wiki-convert/wiki-asciidoc/runapp_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/runapp_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..f9ac095
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/runapp_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/setupmodule1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/setupmodule1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..086fe8e
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/setupmodule1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/setupmodule2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/setupmodule2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..a8d3057
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/setupmodule2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/setupmodule3_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/setupmodule3_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..65477e4
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/setupmodule3_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/setupsuite1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/setupsuite1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..e5d382a
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/setupsuite1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/setupsuite2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/setupsuite2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..cbfcce7
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/setupsuite2_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/writelogic1_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/writelogic1_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..463836a
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/writelogic1_DevFaqAppClientOnNbPlatformTut.png differ
diff --git a/wiki-convert/wiki-asciidoc/writelogic2_DevFaqAppClientOnNbPlatformTut.png b/wiki-convert/wiki-asciidoc/writelogic2_DevFaqAppClientOnNbPlatformTut.png
new file mode 100644
index 0000000..7d45984
Binary files /dev/null and b/wiki-convert/wiki-asciidoc/writelogic2_DevFaqAppClientOnNbPlatformTut.png differ
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists