[ 
https://issues.apache.org/jira/browse/MNG-5821?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Arthur Bauer updated MNG-5821:
------------------------------
    Description: 
The documentation of the element parent.relativePath in the XSD file seems to 
be wrong or outdated. It says: 
"Maven looks for the parent pom first in the reactor of currently building 
projects, then in this location on the filesystem, then the local repository, 
and lastly in the remote repo." 

(Source: http://maven.apache.org/xsd/maven-4.0.0.xsd)

But the actual documentation of maven says
"Maven looks for the parent POM first in this location on the filesystem, then 
the local repository, and lastly in the remote repo."

(Source: 
http://maven.apache.org/ref/3.0.3/maven-model/apidocs/org/apache/maven/model/Parent.html#getRelativePath%28%29)

I have tested it on my local and I have seen the behavior as described in the 
second source, i.e. maven does not look for the parent pom in the reactor of 
currently building projects first.

So this is pretty misleading. It is even more true for us, as we are reading 
the documentation directly from eclipse, which loads it from the XSD file.
Could you please correct the XSD documentation?

  was:
The documentation of the element parent.relativePath seems to be wrong or 
outdated. It says: 
"Maven looks for the parent pom first in the reactor of currently building 
projects, then in this location on the filesystem, then the local repository, 
and lastly in the remote repo." 

(Source: http://maven.apache.org/xsd/maven-4.0.0.xsd)

But the actual documentation of maven says
"Maven looks for the parent POM first in this location on the filesystem, then 
the local repository, and lastly in the remote repo."

(Source: 
http://maven.apache.org/ref/3.0.3/maven-model/apidocs/org/apache/maven/model/Parent.html#getRelativePath%28%29)

I have tested it on my local and I have seen the behavior as described in the 
second source, i.e. maven does not look for the parent pom in the reactor of 
currently building projects first.

So this is pretty misleading. It is even more true for us, as we are reading 
the documentation directly from eclipse, which loads it from the XSD file.
Could you please correct the XSD documentation?


> Documentation of the element parent.relativePath wrong in XSD
> -------------------------------------------------------------
>
>                 Key: MNG-5821
>                 URL: https://issues.apache.org/jira/browse/MNG-5821
>             Project: Maven
>          Issue Type: Documentation
>            Reporter: Arthur Bauer
>
> The documentation of the element parent.relativePath in the XSD file seems to 
> be wrong or outdated. It says: 
> "Maven looks for the parent pom first in the reactor of currently building 
> projects, then in this location on the filesystem, then the local repository, 
> and lastly in the remote repo." 
> (Source: http://maven.apache.org/xsd/maven-4.0.0.xsd)
> But the actual documentation of maven says
> "Maven looks for the parent POM first in this location on the filesystem, 
> then the local repository, and lastly in the remote repo."
> (Source: 
> http://maven.apache.org/ref/3.0.3/maven-model/apidocs/org/apache/maven/model/Parent.html#getRelativePath%28%29)
> I have tested it on my local and I have seen the behavior as described in the 
> second source, i.e. maven does not look for the parent pom in the reactor of 
> currently building projects first.
> So this is pretty misleading. It is even more true for us, as we are reading 
> the documentation directly from eclipse, which loads it from the XSD file.
> Could you please correct the XSD documentation?



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to