You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "John Cheng (JIRA)" <ji...@codehaus.org> on 2009/12/03 23:59:55 UTC

[jira] Created: (MNG-4481) Misleading documentation on the schema of profiles.xml

Misleading documentation on the schema of profiles.xml
------------------------------------------------------

                 Key: MNG-4481
                 URL: http://jira.codehaus.org/browse/MNG-4481
             Project: Maven 2
          Issue Type: Bug
    Affects Versions: 2.2.1
            Reporter: John Cheng


The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 

<profiles>
  <profile>...</profile>
</profiles>

However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:

<profilesXml
	xmlns="http://maven.apache.org/PROFILES/1.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
	<profiles>
		<profile>
			<id>dev</id>
			<activation>
				<activeByDefault>true</activeByDefault>
			</activation>
			<properties>
			</properties>
		</profile>
	</profiles>
</profilesXml>

Note that the schema for profilesXml is not documented along with settings.xml and the POM.

http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MNGSITE-102) Misleading documentation on the schema of profiles.xml

Posted by "John Cheng (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MNGSITE-102?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=201290#action_201290 ] 

John Cheng commented on MNGSITE-102:
------------------------------------

Got it. I was not aware of this. I only started to use Maven 3 after I had trouble with profiles.xml in Maven 2.

Having gone through this myself, my feeling is that if Maven 2 can output a message about profiles.xml going away in 3.0, it can save users quite a bit of headache. 

As far as the documentation for Maven 2, it'd still be nice to have it updated, again, to save users a bit of headache if they decided they need to use profiles.xml.

> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNGSITE-102
>                 URL: http://jira.codehaus.org/browse/MNGSITE-102
>             Project: Maven 2 Project Web Site
>          Issue Type: Improvement
>            Reporter: John Cheng
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> <profiles>
>   <profile>...</profile>
> </profiles>
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> <profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MNGSITE-102) Misleading documentation on the schema of profiles.xml

Posted by "Benjamin Bentmann (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MNGSITE-102?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=200582#action_200582 ] 

Benjamin Bentmann commented on MNGSITE-102:
-------------------------------------------

Note that Maven 3.0 doesn't support/parse profiles.xml, so you can put anything in there without Maven complaining.

> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNGSITE-102
>                 URL: http://jira.codehaus.org/browse/MNGSITE-102
>             Project: Maven 2 Project Web Site
>          Issue Type: Improvement
>            Reporter: John Cheng
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> <profiles>
>   <profile>...</profile>
> </profiles>
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> <profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Closed: (MNGSITE-102) Misleading documentation on the schema of profiles.xml

Posted by "Herve Boutemy (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MNGSITE-102?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Herve Boutemy closed MNGSITE-102.
---------------------------------

    Resolution: Fixed
      Assignee: Herve Boutemy

documentation improved in [r992666|http://svn.apache.org/viewvc?rev=992666&view=rev]: added links to descriptors reference (settings.xml and profiles.xml) and a note about profiles.xml being deprecated in Maven 3
I created MNG-4796 to have a warning in Maven 2 and 3 when this {{profiles.xml}} file is detected


> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNGSITE-102
>                 URL: http://jira.codehaus.org/browse/MNGSITE-102
>             Project: Maven 2 Project Web Site
>          Issue Type: Improvement
>            Reporter: John Cheng
>            Assignee: Herve Boutemy
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> {code:xml}<profiles>
>   <profile>...</profile>
> </profiles>{code}
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> {code:xml}<profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>{code}
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Updated: (MNGSITE-102) Misleading documentation on the schema of profiles.xml

Posted by "Herve Boutemy (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MNGSITE-102?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Herve Boutemy updated MNGSITE-102:
----------------------------------

    Description: 
The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 

{code:xml}<profiles>
  <profile>...</profile>
</profiles>{code}

However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:

{code:xml}<profilesXml
	xmlns="http://maven.apache.org/PROFILES/1.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
	<profiles>
		<profile>
			<id>dev</id>
			<activation>
				<activeByDefault>true</activeByDefault>
			</activation>
			<properties>
			</properties>
		</profile>
	</profiles>
</profilesXml>{code}

Note that the schema for profilesXml is not documented along with settings.xml and the POM.

http://maven.apache.org/general.html

  was:
The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 

<profiles>
  <profile>...</profile>
</profiles>

However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:

<profilesXml
	xmlns="http://maven.apache.org/PROFILES/1.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
	<profiles>
		<profile>
			<id>dev</id>
			<activation>
				<activeByDefault>true</activeByDefault>
			</activation>
			<properties>
			</properties>
		</profile>
	</profiles>
</profilesXml>

Note that the schema for profilesXml is not documented along with settings.xml and the POM.

http://maven.apache.org/general.html


> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNGSITE-102
>                 URL: http://jira.codehaus.org/browse/MNGSITE-102
>             Project: Maven 2 Project Web Site
>          Issue Type: Improvement
>            Reporter: John Cheng
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> {code:xml}<profiles>
>   <profile>...</profile>
> </profiles>{code}
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> {code:xml}<profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>{code}
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Moved: (MNGSITE-102) Misleading documentation on the schema of profiles.xml

Posted by "Benjamin Bentmann (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MNGSITE-102?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Benjamin Bentmann moved MNG-4481 to MNGSITE-102:
------------------------------------------------

           Complexity:   (was: Intermediate)
    Affects Version/s:     (was: 2.2.1)
           Issue Type: Improvement  (was: Bug)
                  Key: MNGSITE-102  (was: MNG-4481)
              Project: Maven 2 Project Web Site  (was: Maven 2)

> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNGSITE-102
>                 URL: http://jira.codehaus.org/browse/MNGSITE-102
>             Project: Maven 2 Project Web Site
>          Issue Type: Improvement
>            Reporter: John Cheng
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> <profiles>
>   <profile>...</profile>
> </profiles>
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> <profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MNG-4481) Misleading documentation on the schema of profiles.xml

Posted by "John Cheng (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MNG-4481?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=200529#action_200529 ] 

John Cheng commented on MNG-4481:
---------------------------------

I just tested this against Apache Maven 3.0-alpha-5 (r883378; 2009-11-23 07:53:41-0800), and it accepted profiles.xml with both formats without problems. 


> Misleading documentation on the schema of profiles.xml
> ------------------------------------------------------
>
>                 Key: MNG-4481
>                 URL: http://jira.codehaus.org/browse/MNG-4481
>             Project: Maven 2
>          Issue Type: Bug
>    Affects Versions: 2.2.1
>            Reporter: John Cheng
>
> The documentation at http://maven.apache.org/guides/introduction/introduction-to-profiles.html seems to indicate that the schema for profiles.xml is 
> <profiles>
>   <profile>...</profile>
> </profiles>
> However, it seems that now a root element of <profilesXml>...</profilesXml> is required. A sample working profiles.xml file looks like:
> <profilesXml
> 	xmlns="http://maven.apache.org/PROFILES/1.0.0"
> 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
> 	xsi:schemaLocation="http://maven.apache.org/PROFILES/1.0.0 http://maven.apache.org/xsd/profiles-1.0.0.xsd">
> 	<profiles>
> 		<profile>
> 			<id>dev</id>
> 			<activation>
> 				<activeByDefault>true</activeByDefault>
> 			</activation>
> 			<properties>
> 			</properties>
> 		</profile>
> 	</profiles>
> </profilesXml>
> Note that the schema for profilesXml is not documented along with settings.xml and the POM.
> http://maven.apache.org/general.html

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira