You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Arthur Bauer (JIRA)" <ji...@apache.org> on 2015/07/27 14:50:05 UTC

[jira] [Updated] (MNG-5821) Documentation of the element parent.relativePath wrong in XSD

     [ 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)