Skip to content

Commit e2e4f9c

Browse files
committed
Content on https://www.eclipse.org/m2e/ is heavily outdated #192
Issue: #192 Change-Id: I11d31c3922d996b226ea1ba97a782b145d02a811 Signed-off-by: Victor Rubezhny <vrubezhny@redhat.com>
1 parent 2ecc700 commit e2e4f9c

15 files changed

+225
-26
lines changed

documentation/m2e-development-environment.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,7 @@ <h4 class="headline">Users</h2>
103103
</ul>
104104
<h4 class="headline">Developers</h2>
105105
<ul class="unstyled">
106-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
106+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
107107
</ul>
108108
<h4 class="headline">Extension Developers</h2>
109109
<ul class="unstyled">
@@ -112,6 +112,7 @@ <h4 class="headline">Extension Developers</h2>
112112
</ul>
113113
<h4 class="headline">Release Notes</h2>
114114
<ul class="unstyled">
115+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
115116
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
116117
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
117118
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -245,4 +246,4 @@ <h2><a href="#running-m2eclipse-automated-regression-tests-from-eclipse" name="r
245246
<script src="/m2e/assets/plugins/respond.js"></script>
246247
<![endif]-->
247248
</body>
248-
</html>
249+
</html>

documentation/m2e-documentation.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,7 @@ <h4 class="headline">Extension Developers</h2>
109109
</ul>
110110
<h4 class="headline">Release Notes</h2>
111111
<ul class="unstyled">
112+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
112113
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
113114
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
114115
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -173,4 +174,4 @@ <h1><a href="#introduction" name="introduction">Introduction</a></h1><p><br/> <a
173174
<script src="/m2e/assets/plugins/respond.js"></script>
174175
<![endif]-->
175176
</body>
176-
</html>
177+
</html>

documentation/m2e-execution-not-covered.html

+4-3
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ <h4 class="headline">Users</h2>
100100
</ul>
101101
<h4 class="headline">Developers</h2>
102102
<ul class="unstyled">
103-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
103+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
104104
</ul>
105105
<h4 class="headline">Extension Developers</h2>
106106
<ul class="unstyled">
@@ -109,6 +109,7 @@ <h4 class="headline">Extension Developers</h2>
109109
</ul>
110110
<h4 class="headline">Release Notes</h2>
111111
<ul class="unstyled">
112+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
112113
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
113114
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
114115
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -197,7 +198,7 @@ <h3><a href="#background" name="background">Background</a></h3><p>M2Eclipse 0.12
197198
<li><p>Installed M2Eclipse extensions (in no particular order)</p></li>
198199
<li><p>M2Eclipse 1.1+ lifecycle mapping metadata provided by maven plugin (see below)</p></li>
199200
<li><p>Default lifecycle mapping metadata shipped with M2Eclipse</p></li>
200-
</ol><p>M2Eclipse uses the first applicable mapping found.</p><h3><a href="#lifecycle-mapping-metadata-provided-by-maven-plugin" name="lifecycle-mapping-metadata-provided-by-maven-plugin">Lifecycle mapping metadata provided by maven plugin</a></h3><p>Starting with m2e 1.1, maven plugin developers are able to provide lifecycle mapping metadata as part of the plugin itself. If present, such mapping metadata will be automatically used by m2e, thus eliminating the need for plugin specific project configurator and/or lifecycle mapping metadata in pom.xml.</p><p>[M2E compatible maven plugins](M2E compatible maven plugins &ldquo;wikilink&rdquo;) wiki page provides more information about developing m2e-compatible maven plugins that do not require external build lifecycle mapping configuration.</p><h3><a href="#eclipse-workspace-lifecycle-mapping-metadata" name="eclipse-workspace-lifecycle-mapping-metadata">Eclipse workspace lifecycle mapping metadata</a></h3><p>Starting with M2Eclipse 1.2, it is now possible to configure lifecycle mapping metadata in m2e workspace preferences. Plugin goals can be ignored at workspace level using new quick-fix, which is available both from <code>pom.xml</code> editor and from Problems view. It is also possible to edit lifecycle mapping xml file directly. The file can be opened from Preferences-&gt;Maven-&gt;LifecycleMappings.</p><h2><a href="#viewing-effective-lifecycle-mapping" name="viewing-effective-lifecycle-mapping">Viewing Effective Lifecycle Mapping</a></h2><p>Starting with M2Eclipse 1.1, it is now possible to see effective lifecycle mapping in Maven-&gt;LifecycleMapping project properties.</p><p><img src="/assets/img/m2e-project-properties-lifecyclemapping.png" alt="Lifecycle""/></p><h2><a href="#help-improve-m2eclipse-maven-plugin-coverage" name="help-improve-m2eclipse-maven-plugin-coverage">Help Improve M2Eclipse Maven Plugin Coverage</a></h2><p>First and foremost, you need to understand the desired behaviour. In most cases this should be limited to IDE usecase, i.e. editing sources and running tests, and not the complete Maven build, so plugin goals that publish build results to a remote repository can be ignored without any adverse side effects, while java source code generation most likely is necessary.</p><p>If the desired behaviour is applicable to other Maven projects using the plugin goal, we strongly recommend documenting your findings in m2e <a href="https://bugs.eclipse.org/bugs/">bugzilla</a>. Please use &ldquo;[mojo] plugin-artifact-id:goal support&rdquo; bugzilla summary and make sure to <a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=m2e&content=mojo">search for existing records</a>. When submitting new request, please provide standalone example project and detailed description of desired behaviour when the project is imported in Eclipse workspace. This will allow other users and interested developers to track popularity of various Maven plugins and schedule implementation work accordingly.</p><p><a href="/documentation/m2e-extension-development.html">M2E Extension Development</a> has pointers how to develop M2Eclipse extensions.</p><h2><a href="#common-problems" name="common-problems">Common Problems</a></h2><p>Some Maven plugins are recognized as problematic and will produce error markers with a text similar to: <em>maven-dependency-plugin (goals &ldquo;copy-dependencies&rdquo;,&ldquo;unpack&rdquo;) is not supported by M2Eclipse</em></p><p>In version 1.0 there is no quick fix available for this but it is possible to define a lifecycle mapping for the plugin as well (as shown in <em>ignore plugin goal</em> above). Which removes the error marker.</p><h2>Eclipse 4.2 Adds Default Mapping</h2><p>If you are using Eclipse 4.2 and have troubles with mapping and won&rsquo;t put mess into yours pom.xml create new file lifecycle-mapping-metadata.xml configure it in <strong>Windows -&gt; Preferences -&gt; Maven -&gt; Lifecycle mapping</strong> . (don&rsquo;t forget press <em>Reload workspace lifecycle mappings metadata</em> after each change of this file!).</p><p>If you have multiple Eclipse workspaces and/or work in a team, it is easy to get workspace-level configuration out-of-sync. This is unlikely to cause any confusion for &lt;ignore /&gt; mappings, but for &lt;execute /&gt; and &lt;configurator /&gt; mappings configuration in pom.xml or maven-plugin is strongly recommended.</p><p>Here is example based on eclipse/plugins/org.eclipse.m2e.lifecyclemapping.defaults_1.2.0.20120903-1050.jar/lifecycle-mapping-metadata.xml</p>
201+
</ol><p>M2Eclipse uses the first applicable mapping found.</p><h3><a href="#lifecycle-mapping-metadata-provided-by-maven-plugin" name="lifecycle-mapping-metadata-provided-by-maven-plugin">Lifecycle mapping metadata provided by maven plugin</a></h3><p>Starting with m2e 1.1, maven plugin developers are able to provide lifecycle mapping metadata as part of the plugin itself. If present, such mapping metadata will be automatically used by m2e, thus eliminating the need for plugin specific project configurator and/or lifecycle mapping metadata in pom.xml.</p><p>[M2E compatible maven plugins](M2E compatible maven plugins &ldquo;wikilink&rdquo;) wiki page provides more information about developing m2e-compatible maven plugins that do not require external build lifecycle mapping configuration.</p><h3><a href="#eclipse-workspace-lifecycle-mapping-metadata" name="eclipse-workspace-lifecycle-mapping-metadata">Eclipse workspace lifecycle mapping metadata</a></h3><p>Starting with M2Eclipse 1.2, it is now possible to configure lifecycle mapping metadata in m2e workspace preferences. Plugin goals can be ignored at workspace level using new quick-fix, which is available both from <code>pom.xml</code> editor and from Problems view. It is also possible to edit lifecycle mapping xml file directly. The file can be opened from Preferences-&gt;Maven-&gt;LifecycleMappings.</p><h2><a href="#viewing-effective-lifecycle-mapping" name="viewing-effective-lifecycle-mapping">Viewing Effective Lifecycle Mapping</a></h2><p>Starting with M2Eclipse 1.1, it is now possible to see effective lifecycle mapping in Maven-&gt;LifecycleMapping project properties.</p><p><img src="/m2e/assets/img/m2e-project-properties-lifecyclemapping.png" alt="Lifecycle""/></p><h2><a href="#help-improve-m2eclipse-maven-plugin-coverage" name="help-improve-m2eclipse-maven-plugin-coverage">Help Improve M2Eclipse Maven Plugin Coverage</a></h2><p>First and foremost, you need to understand the desired behaviour. In most cases this should be limited to IDE usecase, i.e. editing sources and running tests, and not the complete Maven build, so plugin goals that publish build results to a remote repository can be ignored without any adverse side effects, while java source code generation most likely is necessary.</p><p>If the desired behaviour is applicable to other Maven projects using the plugin goal, we strongly recommend documenting your findings in m2e <a href="https://bugs.eclipse.org/bugs/">bugzilla</a>. Please use &ldquo;[mojo] plugin-artifact-id:goal support&rdquo; bugzilla summary and make sure to <a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=m2e&content=mojo">search for existing records</a>. When submitting new request, please provide standalone example project and detailed description of desired behaviour when the project is imported in Eclipse workspace. This will allow other users and interested developers to track popularity of various Maven plugins and schedule implementation work accordingly.</p><p><a href="/documentation/m2e-extension-development.html">M2E Extension Development</a> has pointers how to develop M2Eclipse extensions.</p><h2><a href="#common-problems" name="common-problems">Common Problems</a></h2><p>Some Maven plugins are recognized as problematic and will produce error markers with a text similar to: <em>maven-dependency-plugin (goals &ldquo;copy-dependencies&rdquo;,&ldquo;unpack&rdquo;) is not supported by M2Eclipse</em></p><p>In version 1.0 there is no quick fix available for this but it is possible to define a lifecycle mapping for the plugin as well (as shown in <em>ignore plugin goal</em> above). Which removes the error marker.</p><h2>Eclipse 4.2 Adds Default Mapping</h2><p>If you are using Eclipse 4.2 and have troubles with mapping and won&rsquo;t put mess into yours pom.xml create new file lifecycle-mapping-metadata.xml configure it in <strong>Windows -&gt; Preferences -&gt; Maven -&gt; Lifecycle mapping</strong> . (don&rsquo;t forget press <em>Reload workspace lifecycle mappings metadata</em> after each change of this file!).</p><p>If you have multiple Eclipse workspaces and/or work in a team, it is easy to get workspace-level configuration out-of-sync. This is unlikely to cause any confusion for &lt;ignore /&gt; mappings, but for &lt;execute /&gt; and &lt;configurator /&gt; mappings configuration in pom.xml or maven-plugin is strongly recommended.</p><p>Here is example based on eclipse/plugins/org.eclipse.m2e.lifecyclemapping.defaults_1.2.0.20120903-1050.jar/lifecycle-mapping-metadata.xml</p>
201202
<pre class="prettyprint linenums">
202203
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
203204
&lt;lifecycleMappingMetadata&gt;
@@ -330,4 +331,4 @@ <h3><a href="#background" name="background">Background</a></h3><p>M2Eclipse 0.12
330331
<script src="/m2e/assets/plugins/respond.js"></script>
331332
<![endif]-->
332333
</body>
333-
</html>
334+
</html>

documentation/m2e-extension-development.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ <h4 class="headline">Users</h2>
100100
</ul>
101101
<h4 class="headline">Developers</h2>
102102
<ul class="unstyled">
103-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
103+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
104104
</ul>
105105
<h4 class="headline">Extension Developers</h2>
106106
<ul class="unstyled">
@@ -109,6 +109,7 @@ <h4 class="headline">Extension Developers</h2>
109109
</ul>
110110
<h4 class="headline">Release Notes</h2>
111111
<ul class="unstyled">
112+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
112113
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
113114
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
114115
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -409,4 +410,4 @@ <h1><a href="#setting-up-eclipse-ide" name="setting-up-eclipse-ide">Setting up E
409410
<script src="/m2e/assets/plugins/respond.js"></script>
410411
<![endif]-->
411412
</body>
412-
</html>
413+
</html>

documentation/m2e-faq.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ <h4 class="headline">Users</h2>
100100
</ul>
101101
<h4 class="headline">Developers</h2>
102102
<ul class="unstyled">
103-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
103+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
104104
</ul>
105105
<h4 class="headline">Extension Developers</h2>
106106
<ul class="unstyled">
@@ -109,6 +109,7 @@ <h4 class="headline">Extension Developers</h2>
109109
</ul>
110110
<h4 class="headline">Release Notes</h2>
111111
<ul class="unstyled">
112+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
112113
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
113114
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
114115
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -242,4 +243,4 @@ <h1>FAQ (we know this needs to be updated)</h1><h2><a href="#unable-to-locate-th
242243
<script src="/m2e/assets/plugins/respond.js"></script>
243244
<![endif]-->
244245
</body>
245-
</html>
246+
</html>

documentation/m2e-making-maven-plugins-compat.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ <h4 class="headline">Users</h2>
100100
</ul>
101101
<h4 class="headline">Developers</h2>
102102
<ul class="unstyled">
103-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
103+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
104104
</ul>
105105
<h4 class="headline">Extension Developers</h2>
106106
<ul class="unstyled">
@@ -109,6 +109,7 @@ <h4 class="headline">Extension Developers</h2>
109109
</ul>
110110
<h4 class="headline">Release Notes</h2>
111111
<ul class="unstyled">
112+
<li><a href="/m2e/documentation/release-notes-116.html">M2Eclipse 1.16</a></li>
112113
<li><a href="/m2e/documentation/release-notes-19.html">M2Eclipse 1.9</a></li>
113114
<li><a href="/m2e/documentation/release-notes-18.html">M2Eclipse 1.8</a></li>
114115
<li><a href="/m2e/documentation/release-notes-17.html">M2Eclipse 1.7</a></li>
@@ -274,4 +275,4 @@ <h3><a href="#overview" name="overview">Overview</a></h3><p>Starting with m2e 1.
274275
<script src="/m2e/assets/plugins/respond.js"></script>
275276
<![endif]-->
276277
</body>
277-
</html>
278+
</html>

documentation/m2e-making-maven-plugins-m2e-compat.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ <h4 class="headline">Users</h2>
9595
</ul>
9696
<h4 class="headline">Developers</h2>
9797
<ul class="unstyled">
98-
<li><a href="/m2e/documentation/m2e-development-environment.html">Developement Environment Setup</a></li>
98+
<li><a href="https://github.com/eclipse-m2e/m2e-core/blob/master/CONTRIBUTING.md">Development Environment Setup</a></li>
9999
</ul>
100100
<h4 class="headline">Extension Developers</h2>
101101
<ul class="unstyled">
@@ -398,4 +398,4 @@ <h1><a href="#setting-up-eclipse-ide" name="setting-up-eclipse-ide">Setting up E
398398
<script src="/m2e/assets/plugins/respond.js"></script>
399399
<![endif]-->
400400
</body>
401-
</html>
401+
</html>

0 commit comments

Comments
 (0)