summaryrefslogtreecommitdiff
path: root/src/site
diff options
context:
space:
mode:
Diffstat (limited to 'src/site')
-rw-r--r--src/site/apt/compatibility.apt32
-rw-r--r--src/site/site.xml2
2 files changed, 34 insertions, 0 deletions
diff --git a/src/site/apt/compatibility.apt b/src/site/apt/compatibility.apt
new file mode 100644
index 0000000..ce25282
--- /dev/null
+++ b/src/site/apt/compatibility.apt
@@ -0,0 +1,32 @@
+ ---
+Maven NAR Plugin
+ ---
+ ---
+Mark Donszelmann
+ ---
+
+Compatibility
+
+ For most of the NAR plugin we try to keep things backwards compatible. Versions 1.x were
+made for Maven 1 and therefore we are not compatible with those.
+
+ In the NAR Plugin 2.x series we had to introduce some backward incompatibilites and other changes.
+Below a (rather incomplete) list.
+
+* Version 2.1.x
+
+ * The internal layout of the nar files (.nar extension) is stable. No changes were made.
+
+ * The layout of the files under target and under the unpacked directory has changed. For more
+information see NarLayout21 (version 2.1.x and up) and NarLayout20 (version 2.0.x).
+
+ * The dependency in 2.0 used to be without a <type> specified. You now need to specify <type>nar</type>
+as this is more in line with the standard of maven. It also allows the NAR plugin to find dependencies
+locally in a multi-module build.
+
+ * The main artifact is a jar file, where the NAR plugin attaches a -noarch nar file and some
+platform specific nar files. When installed and or deployed the main jar file is renamed to a nar file,
+hence the dependecy type change from jar to nar.
+
+ []
+
diff --git a/src/site/site.xml b/src/site/site.xml
index 7e98cd5..918522f 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -44,6 +44,8 @@ under the License.
<item name="FAQ" href="faq.html"/>
<item name="AOL Properties" href="aol.html"/>
<item name="Examples" href="examples.html"/>
+ <item name="Archetypes" href="archetypes.html"/>
+ <item name="Compatibility" href="compatibility.html"/>
</menu>
<menu name="Developer Info">