Merge pull request #4397 from ebarboni/fixapi100doc
attemp to fix javadoc for release100
diff --git a/java/maven/arch.xml b/java/maven/arch.xml
index b4169e7..5846bc5 100644
--- a/java/maven/arch.xml
+++ b/java/maven/arch.xml
@@ -265,7 +265,7 @@
One can define following code in nbactions.xml file to start
a process during goal execution and attach a debugger to it
once the execution is over. Here is an example using
- <a onclick="target='_blank'" href="https://github.com/simpligility/android-maven-plugin/pull/584">enhancement</a>
+ <a href="https://github.com/simpligility/android-maven-plugin/pull/584">enhancement</a>
in the Maven Android plugin:
</p>
<pre>
diff --git a/nbbuild/antsrc/org/netbeans/nbbuild/CheckLinks.java b/nbbuild/antsrc/org/netbeans/nbbuild/CheckLinks.java
index d0bbc40..4f55bbf 100644
--- a/nbbuild/antsrc/org/netbeans/nbbuild/CheckLinks.java
+++ b/nbbuild/antsrc/org/netbeans/nbbuild/CheckLinks.java
@@ -132,7 +132,7 @@
JUnitReportWriter.writeReport(this, null, report, Collections.singletonMap("testBrokenLinks", testMessage));
}
- private static Pattern hrefOrAnchor = Pattern.compile("<(a|img|link)(\\s+shape=\"rect\")?(?:\\s+rel=\"stylesheet\")?\\s+(href|name|src)=\"([^\"#]*)(#[^\"]+)?\"(\\s+shape=\"rect\")?(?:\\s+type=\"text/css\")?\\s*/?>", Pattern.CASE_INSENSITIVE);
+ private static Pattern hrefOrAnchor = Pattern.compile("<(a|img|link|h3)(\\s+shape=\"rect\")?(?:\\s+rel=\"stylesheet\")?\\s+(href|name|id|src)=\"([^\"#]*)(#[^\"]+)?\"(\\s+shape=\"rect\")?(?:\\s+type=\"text/css\")?\\s*/?>", Pattern.CASE_INSENSITIVE);
private static Pattern lineBreak = Pattern.compile("^", Pattern.MULTILINE);
/**
@@ -459,7 +459,7 @@
while (m.find()) {
// Get the stuff involved:
String type = m.group(3);
- if (type.equalsIgnoreCase("name")) {
+ if (type.equalsIgnoreCase("name") || (type.equalsIgnoreCase("id") && !unescape(m.group(4)).startsWith("#"))) {
// We have an anchor, therefore refs to it are valid.
String name = unescape(m.group(4));
if (names.add(name)) {
diff --git a/nbbuild/build.properties b/nbbuild/build.properties
index 2761bd9..b517027 100644
--- a/nbbuild/build.properties
+++ b/nbbuild/build.properties
@@ -152,7 +152,14 @@
print,\
extexecution,\
lib.uihandler,\
- uihandler
+ uihandler,\
+ openide.options,\
+ editor,\
+ editor.lib,\
+ editor.indent,\
+ editor.indent.support,\
+ editor.bracesmatching,\
+ editor.util
#FIXME: changes for retouche merge:
# editor/codetemplates,\
diff --git a/platform/api.htmlui/apichanges.xml b/platform/api.htmlui/apichanges.xml
index 268aabb..6f9f0f1 100644
--- a/platform/api.htmlui/apichanges.xml
+++ b/platform/api.htmlui/apichanges.xml
@@ -57,7 +57,7 @@
<compatibility addition="yes" binary="compatible" source="compatible"/>
<description>
<p>
- The <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">
+ The <a href="https://bits.netbeans.org/html+java/dev">
HTML UI API for Java
</a>
revision 1.1 supports technolgy identifiers. Now they can
@@ -78,7 +78,7 @@
<compatibility addition="yes" binary="compatible" source="compatible"/>
<description>
<p>
- The <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">
+ The <a href="https://bits.netbeans.org/html+java/dev">
HTML UI API for Java
</a>
and NetBeans has been included
diff --git a/platform/api.htmlui/arch.xml b/platform/api.htmlui/arch.xml
index 344e06a..06bd506 100644
--- a/platform/api.htmlui/arch.xml
+++ b/platform/api.htmlui/arch.xml
@@ -35,7 +35,7 @@
<p>
<api name="HTMLUI" category="official" group="java" type="export">
NetBeans Platform specific bindings over
- standard <a href="http://bits.netbeans.org/html+java/" onclick="target='_blank'">HTML for Java</a> API.
+ standard <a href="https://bits.netbeans.org/html+java/dev/" >HTML for Java</a> API.
</api>
</p>
</answer>
@@ -58,7 +58,7 @@
in NetBeans Platform. To achieve that it provides specific annotatations
like <a href="@TOP@/org/netbeans/api/htmlui/OpenHTMLRegistration.html">@OpenHTMLRegistration</a>,
but otherwise it builds on the same usecases as the
- <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">HTML for Java</a> API.
+ <a href="https://bits.netbeans.org/html+java/dev/">HTML for Java</a> API.
</p>
<usecase id="window" name="Portable HTML based Window">
<a name="use-window"></a>
@@ -110,7 +110,7 @@
<answer id="arch-what">
<p>
NetBeans Platform specific bindings over
- standard <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">HTML for Java</a> API.
+ standard <a href="https://bits.netbeans.org/html+java/dev/">HTML for Java</a> API.
</p>
</answer>
@@ -337,11 +337,11 @@
<p>
The HTML for Java & NetBeans API is a classical NetBeans module. However
it depends on other modules provided by the
- <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">HTML for Java</a>
+ <a href="https://bits.netbeans.org/html+java/dev/">HTML for Java</a>
project and those are OSGi bundles. As such, when one decides to use this
module, one needs to turn on an OSGi container inside of the NetBeans Platform.
- It can be either <a onclick="target='_blank'" href="http://felix.apache.org">Felix</a> or
- NetBeans version of <a onclick="target='_blank'" href="http://wiki.apidesign.org/wiki/Netbinox">Equinox</a>.
+ It can be either <a href="http://felix.apache.org">Felix</a> or
+ NetBeans version of <a href="http://wiki.apidesign.org/wiki/Netbinox">Equinox</a>.
</p>
</answer>
diff --git a/platform/api.templates/apichanges.xml b/platform/api.templates/apichanges.xml
index 448b78e..47393f6 100644
--- a/platform/api.templates/apichanges.xml
+++ b/platform/api.templates/apichanges.xml
@@ -87,7 +87,7 @@
<compatibility addition="yes" binary="compatible" source="compatible"/>
<description>
<p>
- The <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">
+ The <a href="https://bits.netbeans.org/html+java/dev">
HTML UI API for Java
</a>
revision 1.1 supports technolgy identifiers. Now they can
diff --git a/platform/api.templates/arch.xml b/platform/api.templates/arch.xml
index 25d0e3a..c5d93a0 100644
--- a/platform/api.templates/arch.xml
+++ b/platform/api.templates/arch.xml
@@ -339,8 +339,8 @@
way to rewrite the <a href="#html-and-js">HTML and JavaScript sample</a>
to <b>Java</b>
(and possibly run it in a plugin-less browser via
- <a onclick="target='_blank'" href="http://bck2brwsr.apidesign.org">bck2brwsr VM</a>). Keep the
- same HTML, <a onclick="target='_blank'" href="http://freemarker.org/">Freemarker</a>, etc.
+ <a href="http://bck2brwsr.apidesign.org">bck2brwsr VM</a>). Keep the
+ same HTML, <a href="http://freemarker.org/">Freemarker</a>, etc.
files - just instead of encoding the logic in JavaScript use Java:
</p>
<pre>
@@ -374,9 +374,9 @@
</pre>
<p>
The return value of the annotated method is now an
- <a onclick="target='_blank'" href="http://bits.netbeans.org/html+java/">HTML/Java</a>
+ <a href="https://bits.netbeans.org/html+java/dev">HTML/Java</a>
model class which can naturally represent the essential
- <a onclick="target='_blank'" href="http://knockoutjs.com">Knockout.js</a> objects
+ <a href="http://knockoutjs.com">Knockout.js</a> objects
in Java.
</p>
</usecase>
diff --git a/platform/openide.awt/arch.xml b/platform/openide.awt/arch.xml
index 393f547..4ed3cde 100644
--- a/platform/openide.awt/arch.xml
+++ b/platform/openide.awt/arch.xml
@@ -111,14 +111,14 @@
-->
<answer id="arch-usecases">
<p>
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the concepts of NetBeans action system and related UI elements,
together with code samples, see chapter 5,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
</p>
</answer>
diff --git a/platform/openide.awt/src/org/openide/awt/awt/ActionState.java b/platform/openide.awt/src/org/openide/awt/ActionState.java
similarity index 100%
rename from platform/openide.awt/src/org/openide/awt/awt/ActionState.java
rename to platform/openide.awt/src/org/openide/awt/ActionState.java
diff --git a/platform/openide.awt/src/org/openide/awt/awt/PropertyMonitor.java b/platform/openide.awt/src/org/openide/awt/PropertyMonitor.java
similarity index 100%
rename from platform/openide.awt/src/org/openide/awt/awt/PropertyMonitor.java
rename to platform/openide.awt/src/org/openide/awt/PropertyMonitor.java
diff --git a/platform/openide.awt/src/org/openide/awt/awt/StatefulAction.java b/platform/openide.awt/src/org/openide/awt/StatefulAction.java
similarity index 100%
rename from platform/openide.awt/src/org/openide/awt/awt/StatefulAction.java
rename to platform/openide.awt/src/org/openide/awt/StatefulAction.java
diff --git a/platform/openide.explorer/arch.xml b/platform/openide.explorer/arch.xml
index c3baad4..6fae6fe 100644
--- a/platform/openide.explorer/arch.xml
+++ b/platform/openide.explorer/arch.xml
@@ -67,14 +67,14 @@
<answer id="arch-usecases">
<p>
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the concepts related to <a href="@org-openide-nodes@/overview-summary.html">nodes</a> and explorers,
together with code samples, see chapter 7,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
</p>
</answer>
diff --git a/platform/openide.filesystems/arch.xml b/platform/openide.filesystems/arch.xml
index 2907d75..ca07ec8 100644
--- a/platform/openide.filesystems/arch.xml
+++ b/platform/openide.filesystems/arch.xml
@@ -857,14 +857,14 @@
-->
<answer id="arch-usecases">
<p>
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the filesystem concepts, related topics,
together with code samples, see chapter 3,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
Many of the usecases are described at the
<a href="@TOP@/org/openide/filesystems/doc-files/api.html">overall documentation</a>,
diff --git a/platform/openide.modules/arch.xml b/platform/openide.modules/arch.xml
index e7d7991..2a7cf9f 100644
--- a/platform/openide.modules/arch.xml
+++ b/platform/openide.modules/arch.xml
@@ -48,14 +48,14 @@
</answer>
<answer id="arch-usecases">
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the concepts,
together with code samples, see chapter 2,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
Gory technical details are explained on <a href="@TOP@/org/openide/modules/doc-files/api.html">
diff --git a/platform/openide.modules/src/org/openide/modules/ConstructorDelegate.java b/platform/openide.modules/src/org/openide/modules/ConstructorDelegate.java
index 2dca461..a058949 100644
--- a/platform/openide.modules/src/org/openide/modules/ConstructorDelegate.java
+++ b/platform/openide.modules/src/org/openide/modules/ConstructorDelegate.java
@@ -99,7 +99,7 @@
* order specified by the invoked constructor signature.
* Each item is a zero-based parameter position in the static creation method signature.
* Order and type of the referenced parameters must match the target constructor signature.
- * @return
+ * @return array of positions
*/
public int[] delegateParams() default -1;
}
diff --git a/platform/openide.modules/src/org/openide/modules/Places.java b/platform/openide.modules/src/org/openide/modules/Places.java
index 6b58d3b..1ecf8bf 100644
--- a/platform/openide.modules/src/org/openide/modules/Places.java
+++ b/platform/openide.modules/src/org/openide/modules/Places.java
@@ -45,7 +45,7 @@
* This may be used to persist valuable files for which the system filesystem
* ({@code FileUtil.getConfigFile}) is inappropriate due its being virtual.
* Each module is responsible for using sufficiently unique filenames within this directory.
- * The system property {@link #USER_DIR_PROP} is used for compatibility.
+ * The system property #USER_DIR_PROP is used for compatibility.
* @return a directory location (need not yet exist), or null if unconfigured
*/
public static synchronized /*@CheckForNull*/ File getUserDirectory() {
@@ -116,7 +116,8 @@
/** Constructor for those who believe to know
* where {@link #getCacheDirectory} or
* {@link #getUserDirectory()} is. Register your subclass via
- * {@link ServiceProvider} annotation.
+ * <a href="@org-openide-util-lookup@/org/openide/util/ServiceProvider.html">
+ * {@code @ServiceProvider}</a>@ServiceProvider annotation.
*/
protected Places() {
}
diff --git a/platform/openide.nodes/arch.xml b/platform/openide.nodes/arch.xml
index 74201c5..a68e5b7 100644
--- a/platform/openide.nodes/arch.xml
+++ b/platform/openide.nodes/arch.xml
@@ -55,14 +55,14 @@
<answer id="arch-usecases">
<p>
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the concepts related to nodes and <a href="@org-openide-explorer@/overview-summary.html">explorers</a>,
together with code samples, see chapter 7,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
</p>
</answer>
diff --git a/platform/openide.util.lookup/arch.xml b/platform/openide.util.lookup/arch.xml
index 6e50e72..f9b0a9c 100644
--- a/platform/openide.util.lookup/arch.xml
+++ b/platform/openide.util.lookup/arch.xml
@@ -64,7 +64,7 @@
<answer id="arch-usecases">
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
@@ -74,7 +74,7 @@
<a href="@TOP@/org/openide/util/Lookup.html">javadoc</a>.
For details on this topic,
together with code samples, see chapter 4,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
In addition to that here is
a list of frequently asked or interesting questions slowly expanding as
diff --git a/platform/openide.windows/arch.xml b/platform/openide.windows/arch.xml
index a9e3045..2fb8647 100644
--- a/platform/openide.windows/arch.xml
+++ b/platform/openide.windows/arch.xml
@@ -96,14 +96,14 @@
<answer id="arch-usecases">
<p>
- <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">
+ <a href="https://leanpub.com/nbp4beginners">
<img src="http://wiki.apidesign.org/images/0/03/NetBeansPlatformForBeginners.jpg"
style="float: right"
width="60" height="70" alt="Cover of NetBeans Platform for Beginners book"/>
</a>
For general overview of the concepts,
together with code samples, see chapter 6,
- of <a onclick="target='_blank'" href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
+ of <a href="https://leanpub.com/nbp4beginners">NetBeans Platform for Beginners</a>
by Jason Wexbridge and Walter Nyland.
</p>