From 30fe737999a56599a019def396ea8c2aefa44743 Mon Sep 17 00:00:00 2001
From: Herve Boutemy <hboutemy@apache.org>
Date: Mon, 14 May 2012 20:38:09 +0000
Subject: [PATCH] improved javadoc

git-svn-id: https://svn.apache.org/repos/asf/maven/plugin-tools/trunk@1338388 13f79535-47bb-0310-9956-ffa450edef68
---
 .../plugins/annotations/DependencyScope.java  | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/DependencyScope.java b/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/DependencyScope.java
index 791909c..eec77c2 100644
--- a/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/DependencyScope.java
+++ b/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/DependencyScope.java
@@ -22,15 +22,39 @@ package org.apache.maven.plugins.annotations;
 import org.apache.maven.artifact.Artifact;
 
 /**
+ * Dependencies resolution scopes available before
+ * <a href="/ref/current/maven-core/apidocs/org/apache/maven/lifecycle/internal/MojoExecutor.html">mojo execution</a>.
+ *
  * @author Hervé Boutemy
  * @since 3.0
  */
 public enum DependencyScope
 {
+    /**
+     * <code>compile</code> resolution scope
+     * = <code>compile</code> + <code>system</code> + <code>provided</code> dependencies
+     */
     COMPILE( Artifact.SCOPE_COMPILE ),
+    /**
+     * <code>compile+runtime</code> resolution scope (Maven 3 only)
+     * = <code>compile</code> + <code>system</code> + <code>provided</code> + <code>runtime</code> dependencies
+     */
     COMPILE_PLUS_RUNTIME( Artifact.SCOPE_COMPILE_PLUS_RUNTIME ),
+    /**
+     * <code>runtime</code> resolution scope
+     * = <code>compile</code> + <code>runtime</code> dependencies
+     */
     RUNTIME( Artifact.SCOPE_RUNTIME ),
-    SCOPE_RUNTIME_PLUS_SYSTEM( Artifact.SCOPE_RUNTIME_PLUS_SYSTEM ),
+    /**
+     * <code>runtime+system</code> resolution scope (Maven 3 only)
+     * = <code>compile</code> + <code>system</code> + <code>runtime</code> dependencies
+     */
+    RUNTIME_PLUS_SYSTEM( Artifact.SCOPE_RUNTIME_PLUS_SYSTEM ),
+    /**
+     * <code>test</code> resolution scope
+     * = <code>compile</code> + <code>system</code> + <code>provided</code> + <code>runtime</code> + <code>test</code>
+     * dependencies
+     */
     TEST( Artifact.SCOPE_TEST );
 
     private final String id;