Author: irooskov(a)redhat.com
Date: 2012-01-22 22:43:51 -0500 (Sun, 22 Jan 2012)
New Revision: 38022
Added:
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_01.png
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_02.png
trunk/maven/docs/maven_reference_guide/en-US/maven_profile_selection.xml
Modified:
trunk/maven/docs/maven_reference_guide/en-US/Book_Info.xml
trunk/maven/docs/maven_reference_guide/en-US/Maven_Integration_Guide.xml
trunk/maven/docs/maven_reference_guide/en-US/master.xml
Log:
updated with additional information concerning profile selection
Modified: trunk/maven/docs/maven_reference_guide/en-US/Book_Info.xml
===================================================================
--- trunk/maven/docs/maven_reference_guide/en-US/Book_Info.xml 2012-01-23 02:52:00 UTC
(rev 38021)
+++ trunk/maven/docs/maven_reference_guide/en-US/Book_Info.xml 2012-01-23 03:43:51 UTC
(rev 38022)
@@ -13,7 +13,7 @@
<edition>5.0.0</edition>
- <pubsnumber>3</pubsnumber>
+ <pubsnumber>4</pubsnumber>
<abstract>
<para>
Modified: trunk/maven/docs/maven_reference_guide/en-US/Maven_Integration_Guide.xml
===================================================================
--- trunk/maven/docs/maven_reference_guide/en-US/Maven_Integration_Guide.xml 2012-01-23
02:52:00 UTC (rev 38021)
+++ trunk/maven/docs/maven_reference_guide/en-US/Maven_Integration_Guide.xml 2012-01-23
03:43:51 UTC (rev 38022)
@@ -6,6 +6,7 @@
<xi:include href="Preface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="tasks.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="maven_profile_selection.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="references.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="links.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
Added:
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_01.png
===================================================================
(Binary files differ)
Property changes on:
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_01.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_02.png
===================================================================
(Binary files differ)
Property changes on:
trunk/maven/docs/maven_reference_guide/en-US/images/maven_profile_selection/maven_profile_selection_02.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Modified: trunk/maven/docs/maven_reference_guide/en-US/master.xml
===================================================================
--- trunk/maven/docs/maven_reference_guide/en-US/master.xml 2012-01-23 02:52:00 UTC (rev
38021)
+++ trunk/maven/docs/maven_reference_guide/en-US/master.xml 2012-01-23 03:43:51 UTC (rev
38022)
@@ -5,6 +5,7 @@
[<!ENTITY introduction SYSTEM "introduction.xml">
<!ENTITY tasks SYSTEM "tasks.xml">
+<!ENTITY profile_selection SYSTEM "maven_profile_selection.xml">
<!ENTITY references SYSTEM "references.xml">
<!ENTITY links SYSTEM "links.xml">
@@ -59,6 +60,7 @@
<toc/>
&introduction;
&tasks;
+ &profile_selection;
&references;
&links;
</book>
Added: trunk/maven/docs/maven_reference_guide/en-US/maven_profile_selection.xml
===================================================================
--- trunk/maven/docs/maven_reference_guide/en-US/maven_profile_selection.xml
(rev 0)
+++ trunk/maven/docs/maven_reference_guide/en-US/maven_profile_selection.xml 2012-01-23
03:43:51 UTC (rev 38022)
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="maven_profile_selection">
+ <title>Maven Profile Selection</title>
+ <para>
+ The <guilabel>Maven Profile selection</guilabel> interface allows for easy
profile selection changes for any Maven project. The interface can be opened by selecting
a Maven project in the <guilabel>Project Explorer</guilabel> and either
pressing
<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>P</keycap></keycombo>
or right-clicking and navigating to
<menuchoice><guimenuitem>Maven</guimenuitem><guimenuitem>Select
Maven Profiles</guimenuitem></menuchoice>.
+ </para>
+ <figure id="maven_profile_selection_01">
+ <title>Maven profile selection screen</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/maven_profile_selection/maven_profile_selection_01.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Maven profile selection screen.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ From the <guilabel>Maven Profile selection</guilabel> screen you are able
to <guibutton>Activate</guibutton> and
<guibutton>Deactivate</guibutton> profiles for the selected project. All
available proviles for the selected project, will be displayed in the
<guilabel>Available profiles</guilabel> section. The profiles available to a
project are inferred from those defined within the projects
<filename>pom.xml</filename> file, the projects parent hierarchy and the
content of maven user and global <filename>settings.xml</filename> files.
+ </para>
+ <para>
+ The <guilabel>Source</guilabel> column in the <guilabel>Available
profiles</guilabel> section indicates where the profiles is defined. An undefined
source means the profile is present in the Maven property page of the project, but there
is no available definition.
+ </para>
+ <para>
+ If you have selected multiple projects for <guilabel>Maven Profile
selection</guilabel>, only the commonly available profiles will be displayed in the
<guilabel>Available profiles</guilabel> section. Common profiles are those
defined in the <filename>settings.xml</filename> files or profiles having the
same ID in the <filename>pom.xml</filename> file of all selected projects.
+ </para>
+ <note>
+ <para>
+ Changes made to common profiles, when having selected multiple projects, will not
impact profiles unique to a project.
+ </para>
+ </note>
+</chapter>