You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by be...@apache.org on 2009/07/25 14:03:42 UTC
svn commit: r797757 - in /maven/site/trunk/src/site/apt: embedder.apt
guides/mini/guide-embedding-m2.apt
Author: bentmann
Date: Sat Jul 25 12:03:41 2009
New Revision: 797757
URL: http://svn.apache.org/viewvc?rev=797757&view=rev
Log:
o Fixed generation failures due to unresolvable code snippets
Modified:
maven/site/trunk/src/site/apt/embedder.apt
maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt
Modified: maven/site/trunk/src/site/apt/embedder.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/embedder.apt?rev=797757&r1=797756&r2=797757&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/embedder.apt (original)
+++ maven/site/trunk/src/site/apt/embedder.apt Sat Jul 25 12:03:41 2009
@@ -6,6 +6,9 @@
26 February 2007
------
+~~ TODO: This duplicates guides/mini/guide-embedding-m2.apt
+~~ TODO: Update once embedder is refactored
+
The Maven Embedder
The Maven Embedder is used by the Maven CLI, by IDE integration projects like {{{http://mevenide.codehaus.org}Mevenide}}
@@ -15,7 +18,7 @@
A Simple Example
-%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
A Note on Configuring Settings
@@ -39,7 +42,7 @@
they are used. If you want your embedded use of Maven to mimic the behavior of the Maven CLI insofar as settings use
then use the following code:
-%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
Also note that the user and global settings are merged, and the user settings are dominant.
@@ -50,5 +53,5 @@
purpose use of Plexus. So if you use this method then you use it at your peril. You can access the Plexus Container
using the following:
-%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt?rev=797757&r1=797756&r2=797757&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt Sat Jul 25 12:03:41 2009
@@ -6,6 +6,9 @@
26 February 2007
------
+~~ TODO: This duplicates embedder.apt
+~~ TODO: Update once embedder is refactored
+
The Maven Embedder
The Maven Embedder is used by the Maven CLI, by IDE integration projects like {{{http://mevenide.codehaus.org}Mevenide}}
@@ -15,7 +18,7 @@
A Simple Example
-%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
A Note on Configuring Settings
@@ -39,7 +42,7 @@
they are used. If you want your embedded use of Maven to mimic the behavior of the Maven CLI insofar as settings use
then use the following code:
-%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
Also note that the user and global settings are merged, and the user settings are dominant.
@@ -50,5 +53,5 @@
purpose use of Plexus. So if you use this method then you use it at your peril. You can access the Plexus Container
using the following:
-%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
+%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java}
Re: svn commit: r797757 - in /maven/site/trunk/src/site/apt: embedder.apt guides/mini/guide-embedding-m2.apt
Posted by Jason van Zyl <jv...@sonatype.com>.
Maybe it might be better for me to just remove this as in m2eclipse
the direct use of the components made it much easier for Igor to get
the required functionality. I believe Milos did much the same. So I
think some sort of facade might be useful but I wasn't very close with
the current form of the embedder. So this documentation is more
misleading then anything right now.
On 25-Jul-09, at 8:03 AM, bentmann@apache.org wrote:
> Author: bentmann
> Date: Sat Jul 25 12:03:41 2009
> New Revision: 797757
>
> URL: http://svn.apache.org/viewvc?rev=797757&view=rev
> Log:
> o Fixed generation failures due to unresolvable code snippets
>
> Modified:
> maven/site/trunk/src/site/apt/embedder.apt
> maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt
>
> Modified: maven/site/trunk/src/site/apt/embedder.apt
> URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/embedder.apt?rev=797757&r1=797756&r2=797757&view=diff
> =
> =
> =
> =
> =
> =
> =
> =
> ======================================================================
> --- maven/site/trunk/src/site/apt/embedder.apt (original)
> +++ maven/site/trunk/src/site/apt/embedder.apt Sat Jul 25 12:03:41
> 2009
> @@ -6,6 +6,9 @@
> 26 February 2007
> ------
>
> +~~ TODO: This duplicates guides/mini/guide-embedding-m2.apt
> +~~ TODO: Update once embedder is refactored
> +
> The Maven Embedder
>
> The Maven Embedder is used by the Maven CLI, by IDE integration
> projects like {{{http://mevenide.codehaus.org}Mevenide}}
> @@ -15,7 +18,7 @@
>
> A Simple Example
>
> -%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
> A Note on Configuring Settings
>
> @@ -39,7 +42,7 @@
> they are used. If you want your embedded use of Maven to mimic the
> behavior of the Maven CLI insofar as settings use
> then use the following code:
>
> -%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
> Also note that the user and global settings are merged, and the
> user settings are dominant.
>
> @@ -50,5 +53,5 @@
> purpose use of Plexus. So if you use this method then you use it
> at your peril. You can access the Plexus Container
> using the following:
>
> -%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
>
> Modified: maven/site/trunk/src/site/apt/guides/mini/guide-embedding-
> m2.apt
> URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt?rev=797757&r1=797756&r2=797757&view=diff
> =
> =
> =
> =
> =
> =
> =
> =
> ======================================================================
> --- maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt
> (original)
> +++ maven/site/trunk/src/site/apt/guides/mini/guide-embedding-m2.apt
> Sat Jul 25 12:03:41 2009
> @@ -6,6 +6,9 @@
> 26 February 2007
> ------
>
> +~~ TODO: This duplicates embedder.apt
> +~~ TODO: Update once embedder is refactored
> +
> The Maven Embedder
>
> The Maven Embedder is used by the Maven CLI, by IDE integration
> projects like {{{http://mevenide.codehaus.org}Mevenide}}
> @@ -15,7 +18,7 @@
>
> A Simple Example
>
> -%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=simple-embedder-example|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
> A Note on Configuring Settings
>
> @@ -39,7 +42,7 @@
> they are used. If you want your embedded use of Maven to mimic the
> behavior of the Maven CLI insofar as settings use
> then use the following code:
>
> -%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=mimic-cli|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
> Also note that the user and global settings are merged, and the
> user settings are dominant.
>
> @@ -50,5 +53,5 @@
> purpose use of Plexus. So if you use this method then you use it
> at your peril. You can access the Plexus Container
> using the following:
>
> -%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
> +%{snippet|id=plexus-container|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-3.0-alpha-2/maven-embedder/src/test/java/org/apache/maven/embedder/MavenEmbedderExampleTest.java
> }
>
>
>
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder, Apache Maven
http://twitter.com/jvanzyl
http://twitter.com/SonatypeNexus
http://twitter.com/SonatypeM2E
----------------------------------------------------------
People develop abstractions by generalizing from concrete examples.
Every attempt to determine the correct abstraction on paper without
actually developing a running system is doomed to failure. No one
is that smart. A framework is a resuable design, so you develop it by
looking at the things it is supposed to be a design of. The more
examples
you look at, the more general your framework will be.
-- Ralph Johnson & Don Roberts, Patterns for Evolving Frameworks
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org