You are viewing a plain text version of this content. The canonical link for it is here.
Posted to npanday-commits@incubator.apache.org by br...@apache.org on 2014/07/02 08:44:26 UTC

svn commit: r1607294 [7/11] - in /incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT: ./ css/ developers/ developers/design/ guide/ guide/advanced/ guide/devinfra/ guide/installation/ guide/reference/ guide/vs/

Modified: incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/executeGoals.html
URL: http://svn.apache.org/viewvc/incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/executeGoals.html?rev=1607294&r1=1607293&r2=1607294&view=diff
==============================================================================
--- incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/executeGoals.html (original)
+++ incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/executeGoals.html Wed Jul  2 08:44:25 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Feb 10, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 2 Jul 2014 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,16 +10,16 @@
       @import url("../../css/site.css");
     </style>
     <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20120210" />
+    <meta name="Date-Revision-yyyymmdd" content="20140702" />
     <meta http-equiv="Content-Language" content="en" />
         
-  </head>
+        </head>
   <body class="composite">
     <div id="banner">
-                  <a href="../../" id="bannerLeft">
-                                                <img src="../.././images/NPanday.png" alt="NPanday" />
+                                      <a href="../../../../" id="bannerLeft">
+                                                <img src="../../images/NPanday.png" alt="NPanday" />
                 </a>
-                        <a href="../../../" id="bannerRight">
+                                            <a href="../../../../../" id="bannerRight">
                                                 <img src="../../../../../images/apache-incubator-logo.png" alt="Apache Software Foundation Incubator" />
                 </a>
             <div class="clear">
@@ -28,15 +28,17 @@
     </div>
     <div id="breadcrumbs">
             
-                
+                    
                 <div class="xleft">
                                   <a href="../../../../" title="NPanday Home">NPanday Home</a>
-                &gt;
-                              <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
-                  </div>
+        &gt;
+                          <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
+        &gt;
+    Executing Maven Goals
+      </div>
             <div class="xright">        
-                
-                 <span id="publishDate">Last Published: 10 Feb 2012</span>
+                    
+                 <span id="publishDate">Last Published: 2 Jul 2014</span>
               &nbsp;| <span id="projectVersion">Version: 1.5.0-incubating-SNAPSHOT</span>
             </div>
       <div class="clear">
@@ -46,7 +48,7 @@
     <div id="leftColumn">
       <div id="navcolumn">
              
-                
+                    
                                 <h5>General</h5>
                   <ul>
                   <li class="none">
@@ -68,46 +70,52 @@
                        <h5>Using NPanday</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/index.html" title="Guides overview">Guides overview</a>
+                          <a href="../../guide/index.html" title="Guides overview">Guides overview</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/installation/index.html" title="Installation">Installation</a>
+                          <a href="../../guide/installation/index.html" title="Installation">Installation</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/vs/index.html" title="Visual Studio Add-in">Visual Studio Add-in</a>
+                          <a href="../../guide/vs/index.html" title="Visual Studio Add-in">Visual Studio Add-in</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
+                          <a href="../../guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
             </li>
                   <li class="none">
-                          <a href="../.././plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
+                          <a href="../../plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
             </li>
           </ul>
                        <h5>Beyond Building</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
+                          <a href="../../guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
+                          <a href="../../guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
             </li>
           </ul>
                        <h5>Get Involved</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././developers/index.html" title="Developer's Guide">Developer's Guide</a>
+                          <a href="../../developers/index.html" title="Developer's Guide">Developer's Guide</a>
             </li>
                   <li class="none">
-                          <a href="../.././issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+                          <a href="../../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
             </li>
                   <li class="none">
-                          <a href="../.././mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+                          <a href="../../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
             </li>
           </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
                        <h5>Resources</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
+                          <a href="../../npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
             </li>
                   <li class="none">
                           <a href="http://maven.apache.org/" class="externalLink" title="Apache Maven">Apache Maven</a>
@@ -117,65 +125,125 @@
         <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
       </a>
                    
-                
+                    
             </div>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Executing Maven Goals<a name="Executing_Maven_Goals"></a></h2><p>As we learned in t
 he quick-start tutorial, it is possible to run Maven goals from within Visual Studio using NPanday. This section explores the concept of the build lifecycle in more detail.</p><div class="section"><h3>Compile<a name="Compile"></a></h3><p>In the Solution Explorer, right-click on the name of the project you want to compile, then select <tt>Current NPanday Project &gt; Build</tt> to build the selected project. Or, <tt>All NPanday Projects &gt; Build</tt> to build the parent and its sub-projects.</p><p><i>Note:</i> In some circumstances, Maven is currently unable to build (compile) without installing the project first. As a workaround, execute <tt>All NPanday Projects &gt; Install</tt> first before <tt>All NPanday Projects &gt; Build [compile]</tt>.</p><p>For projects with dependencies from remote repositories, the build might fail. As a workaround, re-import the project then, execute the build goal (<tt>Current&#160;NPanday&#160;Project&#160;&gt;&#160;Build</tt> or <tt>All&#160;NPanday
 &#160;Projects&#160;&gt;&#160;Build</tt>).</p><p>For projects with web references, a dialog box is prompted for updating the Web Services Description Language (<tt>wsdl</tt>). Click Yes to continue with the update, or, No to skip updating.</p><img src="../../images/vs/webservice_update.jpg" alt="" /><p>The NPanday .NET Build Tool performs the compile on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</p><p>You can also execute the normal Visual Studio build on your projects. To invoke Maven to perform <tt>build</tt>/<tt>install</tt>/<tt>test</tt>/<tt>clean</tt>, you must select the option from the All NPanday Projects or Current NPanday Project sub-menu.</p><p>When compiling a web application project, the NPanday .NET Build Tool performs an extra step by calling the <tt>Aspnet_compiler</tt> to validate the ASP section of the project. Th
 e Build Tool performs this step right after calling the CSharp compiler and Visual Basic compiler.</p></div><div class="section"><h3>Test<a name="Test"></a></h3><p>To use the NPanday .NET Build Tool to test a Project:</p><ol style="list-style-type: decimal"><li>From the Solution Explorer, right-click on the name of the project you want to test, then select <tt>Current NPanday Project &gt; Test</tt> to perform the test to the selected project. Or, <tt>All NPanday Projects &gt; Test</tt> to perform the test to the parent project and its sub-projects.</li><li>The NPanday .NET Build Tool performs the tests on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</li></ol><p><b>Note</b>: When the test goal output result is not refreshed for C# test project, the project should be reimported, and the value of the test should also be changed. Then, p
 erform <tt>Current&#160;Project:&#160;Test</tt> (or, <tt>All NPanday Projects &gt; Test</tt>).</p></div><div class="section"><h3>Install<a name="Install"></a></h3><p>From the Solution Explorer, right-click on the name of the project you want to build, then select Current NPanday Project &gt; Install to install the selected project. Or, All NPanday Projects &gt; Install to install the parent project and its sub-projects.</p><p>The NPanday .NET Build Tool installs the artifacts into your local repository. For web projects with POM as packaging, the <tt>target</tt> directory is not created and only the parent <tt>pom.xml</tt> is put in the local repository which is the default behavior.</p><p>For web application projects, the project zip file is produced during this phase, specifically during the <tt>package</tt> phase.</p><p>Corresponding information is sent to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to d
 isplay all the text.</p><p>Next, verify the artifacts were placed into the local repository under the following path: <tt>C:\Documents and Settings\[user_home]\.m2\repository\groupId\artifactId</tt></p><p>Finally, verify that <tt>C:\Documents and Settings\[user_home]\.m2\npanday-settings.xml</tt> is also created.</p><p>The contents of npanday-settings.xml looks similar to the following:</p><div class="source"><pre>  &lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
-  &lt;npandaySettings xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot;&gt;
-    &lt;operatingSystem&gt;
-      Microsoft Windows NT 5.1.2600 Service Pack 2
-    &lt;/operatingSystem&gt;
-    &lt;defaultSetup&gt;
-      &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
-      &lt;vendorVersion&gt;2.0.50727&lt;/vendorVersion&gt;
-      &lt;frameworkVersion&gt;2.0.50727&lt;/frameworkVersion&gt;
-    &lt;/defaultSetup&gt;
-    &lt;vendors&gt;
-      &lt;vendor&gt;
-        &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
-        &lt;vendorVersion&gt;1.1.4322&lt;/vendorVersion&gt;
-        &lt;frameworks&gt;
-          &lt;framework&gt;
-          &lt;frameworkVersion&gt;1.1.4322&lt;/frameworkVersion&gt;
-            &lt;installRoot&gt;
-              C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322
-            &lt;/installRoot&gt;
-          &lt;/framework&gt;
-        &lt;/frameworks&gt;
-      &lt;/vendor&gt;
-      &lt;vendor&gt;
-        &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
-        &lt;vendorVersion&gt;2.0.50727&lt;/vendorVersion&gt;
-        &lt;frameworks&gt;
-          &lt;framework&gt;
-          &lt;frameworkVersion&gt;2.0.50727&lt;/frameworkVersion&gt;
-            &lt;installRoot&gt;
-              C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
-            &lt;/installRoot&gt;
-            &lt;sdkInstallRoot&gt;
-              C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\
-            &lt;/sdkInstallRoot&gt;
-          &lt;/framework&gt;
-        &lt;/frameworks&gt;
-      &lt;/vendor&gt;
-    &lt;/vendors&gt;
-  &lt;/npandaySettings&gt;</pre></div></div><div class="section"><h3>Clean<a name="Clean"></a></h3><p>To use the NPanday .NET Build Tool to clean a project (removes the <tt>target\ </tt> directory containing the files that were generated at build-time from the project's working directory):</p><ol style="list-style-type: decimal"><li>From the Solution Explorer, right-click on the name of the project you want to clean, then select Current NPanday Project &gt; Clean to clean the selected project. Or, All NPanday Projects &gt; Clean to perform the clean goal to the parent project and its sub-projects.</li><li>The NPanday .NET Build Tool performs the clean on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</li></ol></div><div class="section"><h3>NPanday's Maven Phase Algorithm<a name="NPandays_Maven_Phase_Algorithm"></a></h3><p>Algorithm tha
 t differs the Visual Studio Execution from Console Command.</p><ol style="list-style-type: decimal"><li>All Project - Is triggered when the user right click in the solution explorer and select <tt>All NPanday Projects &gt; Build</tt> or <tt>All NPanday Projects &gt; Clean</tt> or <tt>All NPanday Projects &gt; Test</tt> or All NPanday Projects &gt; Install&gt;&gt;&gt;<ol style="list-style-type: upper-alpha"><li>Save All Documents that are open in Visual Studio.</li><li>Retrieve the solution that is open in Visual Studio.</li><li>Loop through all the projects in the solution.</li><li>Check if it has a Web Reference, if it has it will update the Web Reference.</li><li>Execute the pom.xml of the solution may it be Build/Clean/Test/Install.</li></ol></li><li>Current Project - Is Triggered when the user right click in the solution explorer and select <tt>Current NPanday Project &gt; Build</tt> or <tt>Current NPanday Project &gt; Clean</tt> or <tt>Current NPanday Project &gt; Test</tt> or 
 <tt>Current NPanday Project &gt; Install</tt><ol style="list-style-type: upper-alpha"><li>Save All Documents that are open in Visual Studio.</li><li>Retrieve CURRENT pom.xml and CURRENT project.<ol style="list-style-type: lower-alpha"><li>If pom.xml does not exist, set errorMsg to &quot;Pom Not Found&quot; Error.</li><li>If the packaging in the pom.xml is &quot;pom&quot;, set errorMsg to &quot;Pom may not be Project's Pom&quot; Error.</li></ol></li><li>Check if it has a Web Reference, if it has it will update the Web Reference.</li><li>Execute the pom.xml of the solution may it be Build/Clean/Test/Install.</li></ol></li></ol></div><div class="section"><h3>Summary<a name="Summary"></a></h3><p>Continue on to <a href="./assemblyKey.html"> Setting Assembly Keys</a>, or return to the <a href="./index.html"> index</a>.</p></div></div>
+        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section">
+<h2>Executing Maven Goals<a name="Executing_Maven_Goals"></a></h2>
+<p>As we learned in the quick-start tutorial, it is possible to run Maven goals from within Visual Studio using NPanday. This section explores the concept of the build lifecycle in more detail.</p>
+<div class="section">
+<h3>Compile<a name="Compile"></a></h3>
+<p>In the Solution Explorer, right-click on the name of the project you want to compile, then select <tt>Current NPanday Project &gt; Build</tt> to build the selected project. Or, <tt>All NPanday Projects &gt; Build</tt> to build the parent and its sub-projects.</p>
+<p><i>Note:</i> In some circumstances, Maven is currently unable to build (compile) without installing the project first. As a workaround, execute <tt>All NPanday Projects &gt; Install</tt> first before <tt>All NPanday Projects &gt; Build [compile]</tt>.</p>
+<p>For projects with dependencies from remote repositories, the build might fail. As a workaround, re-import the project then, execute the build goal (<tt>Current&#160;NPanday&#160;Project&#160;&gt;&#160;Build</tt> or <tt>All&#160;NPanday&#160;Projects&#160;&gt;&#160;Build</tt>).</p>
+<p>For projects with web references, a dialog box is prompted for updating the Web Services Description Language (<tt>wsdl</tt>). Click Yes to continue with the update, or, No to skip updating.</p><img src="../../images/vs/webservice_update.jpg" alt="" />
+<p>The NPanday .NET Build Tool performs the compile on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</p>
+<p>You can also execute the normal Visual Studio build on your projects. To invoke Maven to perform <tt>build</tt>/<tt>install</tt>/<tt>test</tt>/<tt>clean</tt>, you must select the option from the All NPanday Projects or Current NPanday Project sub-menu.</p>
+<p>When compiling a web application project, the NPanday .NET Build Tool performs an extra step by calling the <tt>Aspnet_compiler</tt> to validate the ASP section of the project. The Build Tool performs this step right after calling the CSharp compiler and Visual Basic compiler.</p></div>
+<div class="section">
+<h3>Test<a name="Test"></a></h3>
+<p>To use the NPanday .NET Build Tool to test a Project:</p>
+<ol style="list-style-type: decimal">
+<li>From the Solution Explorer, right-click on the name of the project you want to test, then select <tt>Current NPanday Project &gt; Test</tt> to perform the test to the selected project. Or, <tt>All NPanday Projects &gt; Test</tt> to perform the test to the parent project and its sub-projects.</li>
+<li>The NPanday .NET Build Tool performs the tests on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</li></ol>
+<p><b>Note</b>: When the test goal output result is not refreshed for C# test project, the project should be reimported, and the value of the test should also be changed. Then, perform <tt>Current&#160;Project:&#160;Test</tt> (or, <tt>All NPanday Projects &gt; Test</tt>).</p></div>
+<div class="section">
+<h3>Install<a name="Install"></a></h3>
+<p>From the Solution Explorer, right-click on the name of the project you want to build, then select Current NPanday Project &gt; Install to install the selected project. Or, All NPanday Projects &gt; Install to install the parent project and its sub-projects.</p>
+<p>The NPanday .NET Build Tool installs the artifacts into your local repository. For web projects with POM as packaging, the <tt>target</tt> directory is not created and only the parent <tt>pom.xml</tt> is put in the local repository which is the default behavior.</p>
+<p>For web application projects, the project zip file is produced during this phase, specifically during the <tt>package</tt> phase.</p>
+<p>Corresponding information is sent to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</p>
+<p>Next, verify the artifacts were placed into the local repository under the following path: <tt>C:\Documents and Settings\[user_home]\.m2\repository\groupId\artifactId</tt></p>
+<p>Finally, verify that <tt>C:\Documents and Settings\[user_home]\.m2\npanday-settings.xml</tt> is also created.</p>
+<p>The contents of npanday-settings.xml looks similar to the following:</p>
+<div class="source">
+<pre>  &lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
+  &lt;npandaySettings xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot;&gt;
+    &lt;operatingSystem&gt;
+      Microsoft Windows NT 5.1.2600 Service Pack 2
+    &lt;/operatingSystem&gt;
+    &lt;defaultSetup&gt;
+      &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
+      &lt;vendorVersion&gt;2.0.50727&lt;/vendorVersion&gt;
+      &lt;frameworkVersion&gt;2.0.50727&lt;/frameworkVersion&gt;
+    &lt;/defaultSetup&gt;
+    &lt;vendors&gt;
+      &lt;vendor&gt;
+        &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
+        &lt;vendorVersion&gt;1.1.4322&lt;/vendorVersion&gt;
+        &lt;frameworks&gt;
+          &lt;framework&gt;
+          &lt;frameworkVersion&gt;1.1.4322&lt;/frameworkVersion&gt;
+            &lt;installRoot&gt;
+              C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322
+            &lt;/installRoot&gt;
+          &lt;/framework&gt;
+        &lt;/frameworks&gt;
+      &lt;/vendor&gt;
+      &lt;vendor&gt;
+        &lt;vendorName&gt;MICROSOFT&lt;/vendorName&gt;
+        &lt;vendorVersion&gt;2.0.50727&lt;/vendorVersion&gt;
+        &lt;frameworks&gt;
+          &lt;framework&gt;
+          &lt;frameworkVersion&gt;2.0.50727&lt;/frameworkVersion&gt;
+            &lt;installRoot&gt;
+              C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
+            &lt;/installRoot&gt;
+            &lt;sdkInstallRoot&gt;
+              C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\
+            &lt;/sdkInstallRoot&gt;
+          &lt;/framework&gt;
+        &lt;/frameworks&gt;
+      &lt;/vendor&gt;
+    &lt;/vendors&gt;
+  &lt;/npandaySettings&gt;
+</pre></div></div>
+<div class="section">
+<h3>Clean<a name="Clean"></a></h3>
+<p>To use the NPanday .NET Build Tool to clean a project (removes the <tt>target\ </tt> directory containing the files that were generated at build-time from the project's working directory):</p>
+<ol style="list-style-type: decimal">
+<li>From the Solution Explorer, right-click on the name of the project you want to clean, then select Current NPanday Project &gt; Clean to clean the selected project. Or, All NPanday Projects &gt; Clean to perform the clean goal to the parent project and its sub-projects.</li>
+<li>The NPanday .NET Build Tool performs the clean on the project and sends corresponding information to the Output window (including a message saying the build was successful). You can scroll up and down in the output window to display all the text.</li></ol></div>
+<div class="section">
+<h3>NPanday's Maven Phase Algorithm<a name="NPandays_Maven_Phase_Algorithm"></a></h3>
+<p>Algorithm that differs the Visual Studio Execution from Console Command.</p>
+<ol style="list-style-type: decimal">
+<li>All Project - Is triggered when the user right click in the solution explorer and select <tt>All NPanday Projects &gt; Build</tt> or <tt>All NPanday Projects &gt; Clean</tt> or <tt>All NPanday Projects &gt; Test</tt> or All NPanday Projects &gt; Install&gt;&gt;&gt;
+<ol style="list-style-type: upper-alpha">
+<li>Save All Documents that are open in Visual Studio.</li>
+<li>Retrieve the solution that is open in Visual Studio.</li>
+<li>Loop through all the projects in the solution.</li>
+<li>Check if it has a Web Reference, if it has it will update the Web Reference.</li>
+<li>Execute the pom.xml of the solution may it be Build/Clean/Test/Install.</li></ol></li>
+<li>Current Project - Is Triggered when the user right click in the solution explorer and select <tt>Current NPanday Project &gt; Build</tt> or <tt>Current NPanday Project &gt; Clean</tt> or <tt>Current NPanday Project &gt; Test</tt> or <tt>Current NPanday Project &gt; Install</tt>
+<ol style="list-style-type: upper-alpha">
+<li>Save All Documents that are open in Visual Studio.</li>
+<li>Retrieve CURRENT pom.xml and CURRENT project.
+<ol style="list-style-type: lower-alpha">
+<li>If pom.xml does not exist, set errorMsg to &quot;Pom Not Found&quot; Error.</li>
+<li>If the packaging in the pom.xml is &quot;pom&quot;, set errorMsg to &quot;Pom may not be Project's Pom&quot; Error.</li></ol></li>
+<li>Check if it has a Web Reference, if it has it will update the Web Reference.</li>
+<li>Execute the pom.xml of the solution may it be Build/Clean/Test/Install.</li></ol></li></ol></div>
+<div class="section">
+<h3>Summary<a name="Summary"></a></h3>
+<p>Continue on to <a href="./assemblyKey.html"> Setting Assembly Keys</a>, or return to the <a href="./index.html"> index</a>.</p></div></div>
       </div>
     </div>
     <div class="clear">
       <hr/>
     </div>
     <div id="footer">
-      <div class="xright">Copyright &#169;                    2012
+      <div class="xright">
+              Copyright &#169;                    2014
                         <a href="http://www.apache.org/">The Apache Software Foundation</a>.
             All Rights Reserved.      
-                
-      </div>
+                    
+                  </div>
       <div class="clear">
         <hr/>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/importing.html
URL: http://svn.apache.org/viewvc/incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/importing.html?rev=1607294&r1=1607293&r2=1607294&view=diff
==============================================================================
--- incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/importing.html (original)
+++ incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/importing.html Wed Jul  2 08:44:25 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Feb 10, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 2 Jul 2014 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,16 +10,16 @@
       @import url("../../css/site.css");
     </style>
     <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20120210" />
+    <meta name="Date-Revision-yyyymmdd" content="20140702" />
     <meta http-equiv="Content-Language" content="en" />
         
-  </head>
+        </head>
   <body class="composite">
     <div id="banner">
-                  <a href="../../" id="bannerLeft">
-                                                <img src="../.././images/NPanday.png" alt="NPanday" />
+                                      <a href="../../../../" id="bannerLeft">
+                                                <img src="../../images/NPanday.png" alt="NPanday" />
                 </a>
-                        <a href="../../../" id="bannerRight">
+                                            <a href="../../../../../" id="bannerRight">
                                                 <img src="../../../../../images/apache-incubator-logo.png" alt="Apache Software Foundation Incubator" />
                 </a>
             <div class="clear">
@@ -28,15 +28,17 @@
     </div>
     <div id="breadcrumbs">
             
-                
+                    
                 <div class="xleft">
                                   <a href="../../../../" title="NPanday Home">NPanday Home</a>
-                &gt;
-                              <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
-                  </div>
+        &gt;
+                          <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
+        &gt;
+    Importing Projects
+      </div>
             <div class="xright">        
-                
-                 <span id="publishDate">Last Published: 10 Feb 2012</span>
+                    
+                 <span id="publishDate">Last Published: 2 Jul 2014</span>
               &nbsp;| <span id="projectVersion">Version: 1.5.0-incubating-SNAPSHOT</span>
             </div>
       <div class="clear">
@@ -46,7 +48,7 @@
     <div id="leftColumn">
       <div id="navcolumn">
              
-                
+                    
                                 <h5>General</h5>
                   <ul>
                   <li class="none">
@@ -68,46 +70,52 @@
                        <h5>Using NPanday</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/index.html" title="Guides overview">Guides overview</a>
+                          <a href="../../guide/index.html" title="Guides overview">Guides overview</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/installation/index.html" title="Installation">Installation</a>
+                          <a href="../../guide/installation/index.html" title="Installation">Installation</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/vs/index.html" title="Visual Studio Add-in">Visual Studio Add-in</a>
+                          <a href="../../guide/vs/index.html" title="Visual Studio Add-in">Visual Studio Add-in</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
+                          <a href="../../guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
             </li>
                   <li class="none">
-                          <a href="../.././plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
+                          <a href="../../plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
             </li>
           </ul>
                        <h5>Beyond Building</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
+                          <a href="../../guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
+                          <a href="../../guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
             </li>
           </ul>
                        <h5>Get Involved</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././developers/index.html" title="Developer's Guide">Developer's Guide</a>
+                          <a href="../../developers/index.html" title="Developer's Guide">Developer's Guide</a>
             </li>
                   <li class="none">
-                          <a href="../.././issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+                          <a href="../../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
             </li>
                   <li class="none">
-                          <a href="../.././mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+                          <a href="../../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
             </li>
           </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
                        <h5>Resources</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
+                          <a href="../../npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
             </li>
                   <li class="none">
                           <a href="http://maven.apache.org/" class="externalLink" title="Apache Maven">Apache Maven</a>
@@ -117,56 +125,124 @@
         <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
       </a>
                    
-                
+                    
             </div>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Importing Projects<a name="Importing_Projects"></a></h2><p>This section provides mo
 re details on how on importing a Visual Studio project using the <i>Generate Solution's POM Information...</i> feature works. As we saw in the <a href="./quickstart.html"> Quickstart example</a>, this feature will generate <tt>pom.xml</tt> files from an existing Visual Studio solution file. The generated <tt>pom.xml</tt> file will contain the latest versions of the artifact dependencies used for the project.</p><p><b>Note</b>: ASP.NET MVC should be installed to get the proper behavior when importing projects especially those projects with unsupported project types. See <a href="./importing.html#MVC"> MVC projects</a> for more details.</p><p>To import a project, first select <i>Generate Solution's POM Information...</i> from the project's context menu:</p><img src="../../images/vs/generate-pom.jpg" alt="" /><p>In the pop-up screen, Browse to the directory location of the parent solution file to use.</p><p>The <i>Group ID</i> is generated by default with the format of <tt>[company_id]
 .[solution_name]</tt>.</p><p>The <i>SCM Tag</i> is optional. If you provide a url that is not reachable (e.g: it is authenticated and the credentials are not supplied or incorrect) by the Addin, you will see a warning, but the url will still be added to the parent pom. </p><img src="../../images/vs/import-dialog.jpg" alt="Importing parent solution file" /><p>When you are ready, click <i>Generate POMs</i>.</p><p>Underscores and spaces in the artifact's Group ID are automatically deleted when added to the project's <tt>pom.xml</tt>. The table below shows the conversion of certain values of groupIds.</p><table border="1" class="bodyTable"><tr class="a"><td align="left"><b>Artifact Group Id</b></td><td align="left"><b>Converted Group Id</b></td></tr><tr class="b"><td align="left">The.Project</td><td align="left">The.Project</td></tr><tr class="a"><td align="left">the.project</td><td align="left">the.project</td></tr><tr class="b"><td align="left">the project</td><td align="left">TheProj
 ect</td></tr><tr class="a"><td align="left">the_project</td><td align="left">TheProject</td></tr></table><p>Next, the project unit tests window will appear. If you have modules that are for unit tests only, select them and click OK.</p><img src="../../images/vs/unit-tests.JPG" alt="Project unit tests list" /><p><tt>pom.xml</tt> files will be generated for all the projects that are included in the solution file, including the parent project and its sub-projects, if there are any.</p><p><b>Note</b>: The Units Tests window is not displayed when importing unsupported project types. Hence, an unsupported project type warning is displayed. For multi-module projects with supported and/or unsupported project types, the supported projects are included in the parent POM while for the unsupported project types, these are not included in the parent POM, and a warning is displayed.</p><p>For projects with web references, the <tt>pom.xml</tt> generated will contain <tt>maven-wsdl-plugin</tt> conf
 iguration similar to the following:</p><div class="source"><pre>  &lt;plugin&gt;
-    &lt;groupId&gt;org.apache.npanday.plugins&lt;/groupId&gt;
-    &lt;artifactId&gt;maven-wsdl-plugin&lt;/artifactId&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;executions&gt;
-      &lt;execution&gt;
-        &lt;goals&gt;
-          &lt;goal&gt;wsdl&lt;/goal&gt;
-        &lt;/goals&gt;
-      &lt;/execution&gt;
-    &lt;/executions&gt;
-    &lt;configuration&gt;
-      &lt;webreferences&gt;
-        &lt;webreference&gt;
-          &lt;namespace&gt;AnotherWebService&lt;/namespace&gt;
-          &lt;path&gt;Web References/AnotherWebService/AnotherWS.wsdl&lt;/path&gt;
-          &lt;output&gt;Web References/AnotherWebService/&lt;/output&gt;
-        &lt;/webreference&gt;
-      &lt;/webreferences&gt;
-    &lt;/configuration&gt;
-  &lt;/plugin&gt;</pre></div><p>The wsdl goal is the one responsible for building and creating webservice proxy classes. And, all the web references used in the project are listed inside the <tt> &lt;webreferences&gt; </tt> tag. For more instructions on adding, renaming, and deleting web references, refer to <a href="./webReferences.html"> Web References</a> section of this guide.</p><p>Other project types will generate corresponding plugins needed to build that type of project (for example, the compile plugin, aspx plugin, or msbuild plugin).</p><div class="section"><h3>Importing Projects with Resource Files<a name="Importing_Projects_with_Resource_Files"></a></h3><p>If the project you are importing includes a resource file, the <tt>maven-resgen</tt> plugin is added to <tt>pom.xml</tt> during import.</p><p>In the plugin's configuration, you can find the list of resource (<tt>resx</tt>) files with corresponding names. By default, <tt>RootNamespace</tt> is the assembly name and <tt>R
 ootNamespace.Filename</tt> is the filename of the <tt>resx</tt> files.</p><p>To ensure that the plugin works, the following are required:</p><ul><li>The classname and the filename of the item that contains the resx files must have the same name. Example: <tt>&quot;public class frmMaestroName&quot; = frmMaestroName.resx = frmMaestroName.cs</tt><p><b>Note</b>: Changing the codefile(.cs/.vb) automatically updates the resource(resx) file. In some instances, however, this does not hold true.</p></li><li>The namespace of the project should be equal to the DefaultNamespace of the project assembly. To check the default name,<ul><li>Right-click on the project and select Properties. This displays a project property window.</li><li>Select the Application tab.</li><li>In the DefaultNamespace field, you will find <tt>RootNamespace</tt>.</li></ul></li></ul><p>Once the above requirements are met, the importer automatically does the work and there is no need to edit <tt>pom.xml</tt>.</p><p>Removing
  the configuration part of the <tt>maven-resgen</tt> plugin allows the plugin to locate all the resx files and compile them as <tt>ArtifactId.Filename</tt>. If you set the namespace as the artifactId, you do not need to list all the resx files in the <tt>pom.xml</tt>.</p><p><b>Note</b>: This feature does not support cultured esx files such as <tt>eu-US</tt>, <tt>it</tt>, <tt>jp</tt>, <tt>de</tt>, <tt>eu-UK</tt>, and even custom culture.</p></div><div class="section"><h3>Importing WPF/WCF Projects with XAML files<a name="Importing_WPFWCF_Projects_with_XAML_files"></a></h3><p>If the project you are Importing is a WPF/WCF project and it contains a XAML file the MSBuildPlugin will be automatically added into that project's pom file.</p><div class="source"><pre>  &lt;plugin&gt;
-    &lt;groupId&gt;org.apache.npanday.plugins&lt;/groupId&gt;
-    &lt;artifactId&gt;NPanday.Plugin.Msbuild.JavaBinding&lt;/artifactId&gt;
-    &lt;executions&gt;
-      &lt;execution&gt;
-        &lt;goals&gt;
-          &lt;goal&gt;compile&lt;/goal&gt;
-        &lt;/goals&gt;
-      &lt;/execution&gt;
-    &lt;/executions&gt;
-  &lt;/plugin&gt;</pre></div><p>This will generate the needed *.g.cs/*.g.vb files that are needed for those XAML files. </p><p><b>Note:</b> The user would encounter double dependency errors, if the project was created with 3.0 .NET framework. We suggest that you change your framework to 3.5 and then delete the references that are already included as defaults in NPanday. This will then allow your project to run successfully.</p></div><div class="section"><h3>Importing ASP.NET <a name="MVC">MVC</a> Projects<a name="Importing_ASP.NET_MVC_Projects"></a></h3><p>As of NPanday 1.1, MVC projects are not support for import as Maven projects from the Visual Studio Add-in. However, in some situations they may be incorrectly imported as a normal C# or VB project.</p><p>To avoid this problem, make sure you have installed ASP.NET MVC Release Candidate 2 which can be obtained from <a class="externalLink" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=ee4b2e97-8a72-449a-82d2-2f720d4
 21031&amp;displaylang=en">http://www.microsoft.com/downloads/details.aspx?FamilyID=ee4b2e97-8a72-449a-82d2-2f720d421031&amp;displaylang=en</a>.</p><p>This must be installed to skip the unsupported project types and be able to get the correct project type GUID.</p></div><div class="section"><h3>Summary<a name="Summary"></a></h3><p>This section has described how to import a project, and the nuances of various different supported project types.</p><p>You can now read on about <a href="./executeGoals.html"> executing Maven goals</a>, or go back to the <a href="./index.html"> index</a>.</p></div></div>
+        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section">
+<h2>Importing Projects<a name="Importing_Projects"></a></h2>
+<p>This section provides more details on how on importing a Visual Studio project using the <i>Generate Solution's POM Information...</i> feature works. As we saw in the <a href="./quickstart.html"> Quickstart example</a>, this feature will generate <tt>pom.xml</tt> files from an existing Visual Studio solution file. The generated <tt>pom.xml</tt> file will contain the latest versions of the artifact dependencies used for the project.</p>
+<p><b>Note</b>: ASP.NET MVC should be installed to get the proper behavior when importing projects especially those projects with unsupported project types. See <a href="./importing.html#MVC"> MVC projects</a> for more details.</p>
+<p>To import a project, first select <i>Generate Solution's POM Information...</i> from the project's context menu:</p><img src="../../images/vs/generate-pom.jpg" alt="" />
+<p>In the pop-up screen, Browse to the directory location of the parent solution file to use.</p>
+<p>The <i>Group ID</i> is generated by default with the format of <tt>[company_id].[solution_name]</tt>.</p>
+<p>The <i>SCM Tag</i> is optional. If you provide a url that is not reachable (e.g: it is authenticated and the credentials are not supplied or incorrect) by the Addin, you will see a warning, but the url will still be added to the parent pom. </p><img src="../../images/vs/import-dialog.jpg" alt="Importing parent solution file" />
+<p>When you are ready, click <i>Generate POMs</i>.</p>
+<p>Underscores and spaces in the artifact's Group ID are automatically deleted when added to the project's <tt>pom.xml</tt>. The table below shows the conversion of certain values of groupIds.</p>
+<table border="1" class="bodyTable">
+<tr class="a">
+<td align="left"><b>Artifact Group Id</b></td>
+<td align="left"><b>Converted Group Id</b></td></tr>
+<tr class="b">
+<td align="left">The.Project</td>
+<td align="left">The.Project</td></tr>
+<tr class="a">
+<td align="left">the.project</td>
+<td align="left">the.project</td></tr>
+<tr class="b">
+<td align="left">the project</td>
+<td align="left">TheProject</td></tr>
+<tr class="a">
+<td align="left">the_project</td>
+<td align="left">TheProject</td></tr></table>
+<p>Next, the project unit tests window will appear. If you have modules that are for unit tests only, select them and click OK.</p><img src="../../images/vs/unit-tests.JPG" alt="Project unit tests list" />
+<p><tt>pom.xml</tt> files will be generated for all the projects that are included in the solution file, including the parent project and its sub-projects, if there are any.</p>
+<p><b>Note</b>: The Units Tests window is not displayed when importing unsupported project types. Hence, an unsupported project type warning is displayed. For multi-module projects with supported and/or unsupported project types, the supported projects are included in the parent POM while for the unsupported project types, these are not included in the parent POM, and a warning is displayed.</p>
+<p>For projects with web references, the <tt>pom.xml</tt> generated will contain <tt>maven-wsdl-plugin</tt> configuration similar to the following:</p>
+<div class="source">
+<pre>  &lt;plugin&gt;
+    &lt;groupId&gt;org.apache.npanday.plugins&lt;/groupId&gt;
+    &lt;artifactId&gt;maven-wsdl-plugin&lt;/artifactId&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;executions&gt;
+      &lt;execution&gt;
+        &lt;goals&gt;
+          &lt;goal&gt;wsdl&lt;/goal&gt;
+        &lt;/goals&gt;
+      &lt;/execution&gt;
+    &lt;/executions&gt;
+    &lt;configuration&gt;
+      &lt;webreferences&gt;
+        &lt;webreference&gt;
+          &lt;namespace&gt;AnotherWebService&lt;/namespace&gt;
+          &lt;path&gt;Web References/AnotherWebService/AnotherWS.wsdl&lt;/path&gt;
+          &lt;output&gt;Web References/AnotherWebService/&lt;/output&gt;
+        &lt;/webreference&gt;
+      &lt;/webreferences&gt;
+    &lt;/configuration&gt;
+  &lt;/plugin&gt;
+</pre></div>
+<p>The wsdl goal is the one responsible for building and creating webservice proxy classes. And, all the web references used in the project are listed inside the <tt> &lt;webreferences&gt; </tt> tag. For more instructions on adding, renaming, and deleting web references, refer to <a href="./webReferences.html"> Web References</a> section of this guide.</p>
+<p>Other project types will generate corresponding plugins needed to build that type of project (for example, the compile plugin, aspx plugin, or msbuild plugin).</p>
+<div class="section">
+<h3>Importing Projects with Resource Files<a name="Importing_Projects_with_Resource_Files"></a></h3>
+<p>If the project you are importing includes a resource file, the <tt>maven-resgen</tt> plugin is added to <tt>pom.xml</tt> during import.</p>
+<p>In the plugin's configuration, you can find the list of resource (<tt>resx</tt>) files with corresponding names. By default, <tt>RootNamespace</tt> is the assembly name and <tt>RootNamespace.Filename</tt> is the filename of the <tt>resx</tt> files.</p>
+<p>To ensure that the plugin works, the following are required:</p>
+<ul>
+<li>The classname and the filename of the item that contains the resx files must have the same name. Example: <tt>&quot;public class frmMaestroName&quot; = frmMaestroName.resx = frmMaestroName.cs</tt>
+<p><b>Note</b>: Changing the codefile(.cs/.vb) automatically updates the resource(resx) file. In some instances, however, this does not hold true.</p></li>
+<li>The namespace of the project should be equal to the DefaultNamespace of the project assembly. To check the default name,
+<ul>
+<li>Right-click on the project and select Properties. This displays a project property window.</li>
+<li>Select the Application tab.</li>
+<li>In the DefaultNamespace field, you will find <tt>RootNamespace</tt>.</li></ul></li></ul>
+<p>Once the above requirements are met, the importer automatically does the work and there is no need to edit <tt>pom.xml</tt>.</p>
+<p>Removing the configuration part of the <tt>maven-resgen</tt> plugin allows the plugin to locate all the resx files and compile them as <tt>ArtifactId.Filename</tt>. If you set the namespace as the artifactId, you do not need to list all the resx files in the <tt>pom.xml</tt>.</p>
+<p><b>Note</b>: This feature does not support cultured esx files such as <tt>eu-US</tt>, <tt>it</tt>, <tt>jp</tt>, <tt>de</tt>, <tt>eu-UK</tt>, and even custom culture.</p></div>
+<div class="section">
+<h3>Importing WPF/WCF Projects with XAML files<a name="Importing_WPFWCF_Projects_with_XAML_files"></a></h3>
+<p>If the project you are Importing is a WPF/WCF project and it contains a XAML file the MSBuildPlugin will be automatically added into that project's pom file.</p>
+<div class="source">
+<pre>  &lt;plugin&gt;
+    &lt;groupId&gt;org.apache.npanday.plugins&lt;/groupId&gt;
+    &lt;artifactId&gt;NPanday.Plugin.Msbuild.JavaBinding&lt;/artifactId&gt;
+    &lt;executions&gt;
+      &lt;execution&gt;
+        &lt;goals&gt;
+          &lt;goal&gt;compile&lt;/goal&gt;
+        &lt;/goals&gt;
+      &lt;/execution&gt;
+    &lt;/executions&gt;
+  &lt;/plugin&gt;
+</pre></div>
+<p>This will generate the needed *.g.cs/*.g.vb files that are needed for those XAML files. </p>
+<p><b>Note:</b> The user would encounter double dependency errors, if the project was created with 3.0 .NET framework. We suggest that you change your framework to 3.5 and then delete the references that are already included as defaults in NPanday. This will then allow your project to run successfully.</p></div>
+<div class="section">
+<h3>Importing ASP.NET <a name="MVC">MVC</a> Projects<a name="Importing_ASP.NET_MVC_Projects"></a></h3>
+<p>As of NPanday 1.1, MVC projects are not support for import as Maven projects from the Visual Studio Add-in. However, in some situations they may be incorrectly imported as a normal C# or VB project.</p>
+<p>To avoid this problem, make sure you have installed ASP.NET MVC Release Candidate 2 which can be obtained from <a class="externalLink" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=ee4b2e97-8a72-449a-82d2-2f720d421031&amp;displaylang=en">http://www.microsoft.com/downloads/details.aspx?FamilyID=ee4b2e97-8a72-449a-82d2-2f720d421031&amp;displaylang=en</a>.</p>
+<p>This must be installed to skip the unsupported project types and be able to get the correct project type GUID.</p></div>
+<div class="section">
+<h3>Summary<a name="Summary"></a></h3>
+<p>This section has described how to import a project, and the nuances of various different supported project types.</p>
+<p>You can now read on about <a href="./executeGoals.html"> executing Maven goals</a>, or go back to the <a href="./index.html"> index</a>.</p></div></div>
       </div>
     </div>
     <div class="clear">
       <hr/>
     </div>
     <div id="footer">
-      <div class="xright">Copyright &#169;                    2012
+      <div class="xright">
+              Copyright &#169;                    2014
                         <a href="http://www.apache.org/">The Apache Software Foundation</a>.
             All Rights Reserved.      
-                
-      </div>
+                    
+                  </div>
       <div class="clear">
         <hr/>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/index.html
URL: http://svn.apache.org/viewvc/incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/index.html?rev=1607294&r1=1607293&r2=1607294&view=diff
==============================================================================
--- incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/index.html (original)
+++ incubator/npanday/site-publish/docs/1.5.0-incubating-SNAPSHOT/guide/vs/index.html Wed Jul  2 08:44:25 2014
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Feb 10, 2012 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 2 Jul 2014 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,16 +10,16 @@
       @import url("../../css/site.css");
     </style>
     <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20120210" />
+    <meta name="Date-Revision-yyyymmdd" content="20140702" />
     <meta http-equiv="Content-Language" content="en" />
         
-  </head>
+        </head>
   <body class="composite">
     <div id="banner">
-                  <a href="../../" id="bannerLeft">
-                                                <img src="../.././images/NPanday.png" alt="NPanday" />
+                                      <a href="../../../../" id="bannerLeft">
+                                                <img src="../../images/NPanday.png" alt="NPanday" />
                 </a>
-                        <a href="../../../" id="bannerRight">
+                                            <a href="../../../../../" id="bannerRight">
                                                 <img src="../../../../../images/apache-incubator-logo.png" alt="Apache Software Foundation Incubator" />
                 </a>
             <div class="clear">
@@ -28,15 +28,17 @@
     </div>
     <div id="breadcrumbs">
             
-                
+                    
                 <div class="xleft">
                                   <a href="../../../../" title="NPanday Home">NPanday Home</a>
-                &gt;
-                              <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
-                  </div>
+        &gt;
+                          <a href="../../index.html" title="NPanday 1.5.0-incubating-SNAPSHOT">NPanday 1.5.0-incubating-SNAPSHOT</a>
+        &gt;
+    Using the NPanday Visual Studio Add-in
+      </div>
             <div class="xright">        
-                
-                 <span id="publishDate">Last Published: 10 Feb 2012</span>
+                    
+                 <span id="publishDate">Last Published: 2 Jul 2014</span>
               &nbsp;| <span id="projectVersion">Version: 1.5.0-incubating-SNAPSHOT</span>
             </div>
       <div class="clear">
@@ -46,7 +48,7 @@
     <div id="leftColumn">
       <div id="navcolumn">
              
-                
+                    
                                 <h5>General</h5>
                   <ul>
                   <li class="none">
@@ -68,46 +70,52 @@
                        <h5>Using NPanday</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/index.html" title="Guides overview">Guides overview</a>
+                          <a href="../../guide/index.html" title="Guides overview">Guides overview</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/installation/index.html" title="Installation">Installation</a>
+                          <a href="../../guide/installation/index.html" title="Installation">Installation</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/vs/index.html" title="Visual Studio Add-in">Visual Studio Add-in</a>
-            </li>
+            <strong>Visual Studio Add-in</strong>
+          </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
+                          <a href="../../guide/advanced/index.html" title="Advanced Use without VS Add-in">Advanced Use without VS Add-in</a>
             </li>
                   <li class="none">
-                          <a href="../.././plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
+                          <a href="../../plugins/index.html" title="NPanday Plugin Reference">NPanday Plugin Reference</a>
             </li>
           </ul>
                        <h5>Beyond Building</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
+                          <a href="../../guide/devinfra/index.html" title="Artifact Repositories and Automated Builds">Artifact Repositories and Automated Builds</a>
             </li>
                   <li class="none">
-                          <a href="../.././guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
+                          <a href="../../guide/advanced/releasing.html" title="Release- and Version Management">Release- and Version Management</a>
             </li>
           </ul>
                        <h5>Get Involved</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././developers/index.html" title="Developer's Guide">Developer's Guide</a>
+                          <a href="../../developers/index.html" title="Developer's Guide">Developer's Guide</a>
             </li>
                   <li class="none">
-                          <a href="../.././issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+                          <a href="../../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
             </li>
                   <li class="none">
-                          <a href="../.././mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+                          <a href="../../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
             </li>
           </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                <li class="collapsed">
+                          <a href="../../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+          </ul>
                        <h5>Resources</h5>
                   <ul>
                   <li class="none">
-                          <a href="../.././npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
+                          <a href="../../npanday.pdf" title="Documentation as PDF">Documentation as PDF</a>
             </li>
                   <li class="none">
                           <a href="http://maven.apache.org/" class="externalLink" title="Apache Maven">Apache Maven</a>
@@ -117,26 +125,46 @@
         <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
       </a>
                    
-                
+                    
             </div>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Using the NPanday Visual Studio Add-in<a name="Using_the_NPanday_Visual_Studio_Add-
 in"></a></h2><p>By this point, you should have NPanday successfully installed as shown in the <a href="../installation/index.html"> Installation instructions</a>, and have Visual Studio started with the NPanday Build Tool running.</p><p>This guide will walk you through a basic introduction to the Visual Studio Add-in, how to use it for typical project tasks, and what configuration options are available.</p><p>Finally, we will discuss the use cases where you might need to manipulate the Maven POM directly and other advanced use cases.</p><p>After completing this guide, you may want to read the guide to <a href="../devinfra/index.html"> Using NPanday with your Maven Development Infrastructure</a>.</p><p>If you encounter any problems, don't forget to consult the <a href="../reference/troubleshooting.html"> Troubleshooting guide</a>.</p><div class="section"><h3>Contents<a name="Contents"></a></h3><!-- TODO: add testing? --><ul><li><a href="./quickstart.html"> Quick Start Guide</a> - sta
 rting a new project and making it buildable by Maven</li><li><a href="./references.html"> Working with references</a> - how adding references impacts the project, and how it works with Maven depedencies</li><li><a href="./webReferences.html"> Working with web references</a> - how web references in a web application work with NPanday</li><li><a href="./resyncReferences.html"> Keeping references in sync</a> - how to ensure project files are portable and references are always available</li><li><a href="./importing.html"> Creating Maven POM's from Visual Studio projects</a> - more detail on the import process covered in the quick start guide, including different project types supported</li><li><a href="./executeGoals.html"> Executing Maven Goals</a> - more detail on the integration of the Maven lifecycle with Visual Studio by the NPanday Add-in</li><li><a href="./assemblyKey.html"> Setting the Assembly Key</a> - how to set a strong name on your build using NPanday </li><li><a href="./co
 nfigureRepository.html"> Configuring a Remote Repository</a> - the steps necessary to have a remote repository for downloading Maven artifacts from</li><li><a href="./settings.html"> Maven settings</a> - how to configure an alternate Maven settings file</li><li><a href="../advanced/releasing.html"> Releasing .NET projects with Maven</a> - how to use the Maven release mechanism from the command line</li></ul></div></div>
+        <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements.  See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership.  The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License.  You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied.  See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section">
+<h2>Using the NPanday Visual Studio Add-in<a name="Using_the_NPanday_Visual_Studio_Add-in"></a></h2>
+<p>By this point, you should have NPanday successfully installed as shown in the <a href="../installation/index.html"> Installation instructions</a>, and have Visual Studio started with the NPanday Build Tool running.</p>
+<p>This guide will walk you through a basic introduction to the Visual Studio Add-in, how to use it for typical project tasks, and what configuration options are available.</p>
+<p>Finally, we will discuss the use cases where you might need to manipulate the Maven POM directly and other advanced use cases.</p>
+<p>After completing this guide, you may want to read the guide to <a href="../devinfra/index.html"> Using NPanday with your Maven Development Infrastructure</a>.</p>
+<p>If you encounter any problems, don't forget to consult the <a href="../reference/troubleshooting.html"> Troubleshooting guide</a>.</p>
+<div class="section">
+<h3>Contents<a name="Contents"></a></h3><!-- TODO: add testing? -->
+<ul>
+<li><a href="./quickstart.html"> Quick Start Guide</a> - starting a new project and making it buildable by Maven</li>
+<li><a href="./references.html"> Working with references</a> - how adding references impacts the project, and how it works with Maven depedencies</li>
+<li><a href="./webReferences.html"> Working with web references</a> - how web references in a web application work with NPanday</li>
+<li><a href="./resyncReferences.html"> Keeping references in sync</a> - how to ensure project files are portable and references are always available</li>
+<li><a href="./importing.html"> Creating Maven POM's from Visual Studio projects</a> - more detail on the import process covered in the quick start guide, including different project types supported</li>
+<li><a href="./executeGoals.html"> Executing Maven Goals</a> - more detail on the integration of the Maven lifecycle with Visual Studio by the NPanday Add-in</li>
+<li><a href="./assemblyKey.html"> Setting the Assembly Key</a> - how to set a strong name on your build using NPanday </li>
+<li><a href="./configureRepository.html"> Configuring a Remote Repository</a> - the steps necessary to have a remote repository for downloading Maven artifacts from</li>
+<li><a href="./settings.html"> Maven settings</a> - how to configure an alternate Maven settings file</li>
+<li><a href="../advanced/releasing.html"> Releasing .NET projects with Maven</a> - how to use the Maven release mechanism from the command line</li></ul></div></div>
       </div>
     </div>
     <div class="clear">
       <hr/>
     </div>
     <div id="footer">
-      <div class="xright">Copyright &#169;                    2012
+      <div class="xright">
+              Copyright &#169;                    2014
                         <a href="http://www.apache.org/">The Apache Software Foundation</a>.
             All Rights Reserved.      
-                
-      </div>
+                    
+                  </div>
       <div class="clear">
         <hr/>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file