[ 
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 misleading 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 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?


> 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
>             Fix For: waiting-for-feedback
>
>
> 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 misleading 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