o Extended API docs

git-svn-id: https://svn.apache.org/repos/asf/maven/components/trunk@781137 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Benjamin Bentmann 2009-06-02 19:39:12 +00:00
parent 7a2d55b8d1
commit 2b12aab7e1
3 changed files with 9 additions and 4 deletions

View File

@ -25,7 +25,7 @@ import java.util.Properties;
import org.apache.maven.model.profile.ProfileActivationContext;
/**
* Collects settings that control building of effective models.
* Collects settings that control the building of effective models.
*
* @author Benjamin Bentmann
*/
@ -41,7 +41,9 @@ public interface ModelBuildingRequest
boolean istLenientValidation();
/**
* Sets the level of validation to perform on processed models. By default, models are validated in strict mode.
* Sets the level of validation to perform on processed models. For building of projects, strict validation should
* be used to ensure proper building. For the mere retrievel of dependencies during artifact resolution, lenient
* validation should be used to account for models of poor quality. By default, models are validated in strict mode.
*
* @param lenientValidation A flag whether validation should be lenient instead of strict. For building of projects,
* strict validation should be used to ensure proper building. For the mere retrievel of dependencies

View File

@ -31,7 +31,9 @@ public interface InheritanceAssembler
{
/**
* Merges values from the specified parent model into the given child model.
* Merges values from the specified parent model into the given child model. Implementations are expected to keep
* parent and child completely decoupled by injecting deep copies of objects into the child rather than the original
* objects from the parent.
*
* @param child The child model into which to merge the values inherited from the parent, must not be
* <code>null</code>.

View File

@ -32,7 +32,8 @@ public interface ProfileInjector
{
/**
* Merges values from the specified profile into the given model.
* Merges values from the specified profile into the given model. Implementations are expected to keep the profile
* and model completely decoupled by injecting deep copies rather than the original objects from the profile.
*
* @param model The model into which to merge the values defined by the profile, must not be <code>null</code>.
* @param profile The (read-only) profile whose values should be injected, may be <code>null</code>.