Modified: websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/examples/using-perforce.html ============================================================================== --- websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/examples/using-perforce.html (original) +++ websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/examples/using-perforce.html Tue Jun 24 19:40:53 2014 @@ -1,323 +1,230 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <title>Maven Changelog plugin - Using Perforce</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - <meta name="author" content="Dennis Lundberg" /> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - -<script type="text/javascript" src="http://www.google-analytics.com/urchin.js";></script> - -<script type="text/javascript">_uacct = "UA-140879-1"; - urchinTracker();</script> - </head> - <body class="composite"> - <div id="banner"> - <a href="../../" id="bannerLeft"> - - <img src="../../../images/apache-maven-project-2.png" alt="" /> - - </a> - <a href="../../" id="bannerRight"> - - <img src="../../../images/maven-logo-2.gif" alt="" /> - - </a> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - - <a href="http://www.apache.org/"; class="externalLink">Apache</a> - > - - <a href="../../../index.html">Maven</a> - > - - <a href="../../index.html">Plugins</a> - > - - <a href="http://maven.apache.org/plugins/maven-changelog-plugin"; class="externalLink">Maven Changelog Plugin</a> - </div> - <div class="xright"> - - - - - - - - Last Published: 2010-05-28 - | Version: 2.2 - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>Overview</h5> - <ul> - - <li class="none"> - <a href="../index.html">Introduction</a> - </li> - - <li class="none"> - <a href="../plugin-info.html">Goals</a> - </li> - - <li class="none"> - <a href="../usage.html">Usage</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - </ul> - <h5>Examples</h5> - <ul> - - <li class="none"> - <a href="../examples/changing-heading-date-format.html">Changing the Heading Date Format</a> - </li> - - <li class="none"> - <a href="../examples/modifying-scm-links.html">Modifying SCM Links</a> - </li> - - <li class="none"> - <a href="../examples/selecting-reports.html">Selecting Reports</a> - </li> - - <li class="none"> - <a href="../examples/configuration-date-type.html">Using Date Type</a> - </li> - - <li class="none"> - <a href="../examples/configuration-range-type.html">Using Range Type</a> - </li> - - <li class="none"> - <a href="../examples/configuration-tag-type.html">Using Tag Type</a> - </li> - - <li class="none"> - <strong>Using Perforce</strong> - </li> - </ul> - <h5>Project Documentation</h5> - <ul> - - - - - - - - - - - - - - - - - - - - - - - - - - <li class="collapsed"> - <a href="../project-info.html">Project Information</a> - </li> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <li class="collapsed"> - <a href="../project-reports.html">Project Reports</a> - </li> - </ul> - <h5>Maven Projects</h5> - <ul> - - <li class="none"> - <a href="../../../ant-tasks/index.html">Ant Tasks</a> - </li> - - <li class="none"> - <a href="../../../doxia/index.html">Doxia</a> - </li> - - <li class="none"> - <a href="../../../jxr/index.html">JXR</a> - </li> - - <li class="none"> - <a href="../../../maven-1.x/index.html">Maven 1.x</a> - </li> - - <li class="none"> - <a href="../../../index.html">Maven 2</a> - </li> - - <li class="none"> - <a href="../../../mercury/index.html">Mercury</a> - </li> - - <li class="none"> - <a href="../../index.html">Plugins</a> - </li> - - <li class="none"> - <a href="../../../scm/index.html">SCM</a> - </li> - - <li class="none"> - <a href="../../../shared/index.html">Shared Components</a> - </li> - - <li class="none"> - <a href="../../../surefire/index.html">Surefire</a> - </li> - - <li class="none"> - <a href="../../../wagon/index.html">Wagon</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2>Using Perforce</h2> -<p>The maven-changelog-plugin uses <a class="externalLink" href="http://maven.apache.org/scm/";>Maven SCM</a> as an underlying layer, when accessing your SCM system. When Maven SCM is working with Perforce it needs a clientspec. This is provided by setting system properties that are then read by Maven SCM.</p> -<p>Configuring this is done in the same way as for the maven-scm-plugin. So if you have a working configuration for maven-scm-plugin, you can just copy those lines over to your maven-changelog-plugin configuration. The following configuration shows an example of what this can look like.</p> -<div class="source"><pre><project> - ... - <reporting> - <plugins> - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-changelog-plugin</artifactId> - <version>2.2</version> - <configuration> - <systemProperties> - <property> - <name>maven.scm.perforce.clientspec.name</name> - <value>your.perforce.clientspec.name</value> - </property> - </systemProperties> - </configuration> - </plugin> - </plugins> - </reporting> - ... -</project> </pre> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2002-2010 - - The Apache Software Foundation - - - - - - - - - - <a href="http://maven.apache.org/privacy-policy.html";>Privacy Policy</a></div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> +<!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 2014-06-24 + | Rendered using Apache Maven Stylus Skin 1.5 +--> +<html xmlns="http://www.w3.org/1999/xhtml";> + <head> + <title>Apache Maven Changelog Plugin - Using Perforce</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta name="author" content="Dennis Lundberg" /> + <meta name="Date-Creation-yyyymmdd" content="20070719" /> + <meta name="Date-Revision-yyyymmdd" content="20140624" /> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + +<script src="http://www.google-analytics.com/urchin.js"; type="text/javascript"></script> + +<script type="text/javascript">_uacct = "UA-140879-1"; + urchinTracker();</script> + </head> + <body class="composite"> + <div id="banner"> + <a href="../../../" id="bannerLeft"> + <img src="../../../images/apache-maven-project-2.png" alt="" /> + </a> + <span id="bannerRight"> + <img src="../../../images/maven-logo-2.gif" alt="" /> + </span> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + + <div class="xleft"> + <a href="http://www.apache.org/"; class="externalLink">Apache</a> + > + <a href="../../../index.html">Maven</a> + > + <a href="../../index.html">Plugins</a> + > + <a href="../">Apache Maven Changelog Plugin</a> + > + Using Perforce + </div> + <div class="xright"> + Last Published: 2014-06-24 + | Version: 2.3 + </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + + <h5>Overview</h5> + <ul> + <li class="none"> + <a href="../index.html">Introduction</a> + </li> + <li class="none"> + <a href="../plugin-info.html">Goals</a> + </li> + <li class="none"> + <a href="../usage.html">Usage</a> + </li> + <li class="none"> + <a href="../faq.html">FAQ</a> + </li> + <li class="none"> + <a href="../changing-scm-impl.html">Change Scm implementation</a> + </li> + <li class="none"> + <a href="http://www.apache.org/licenses/"; class="externalLink">License</a> + </li> + <li class="none"> + <a href="../download.html">Download</a> + </li> + </ul> + <h5>Examples</h5> + <ul> + <li class="none"> + <a href="../examples/changing-heading-date-format.html">Changing the Heading Date Format</a> + </li> + <li class="none"> + <a href="../examples/modifying-scm-links.html">Modifying SCM Links</a> + </li> + <li class="none"> + <a href="../examples/selecting-reports.html">Selecting Reports</a> + </li> + <li class="none"> + <a href="../examples/configuration-date-type.html">Using Date Type</a> + </li> + <li class="none"> + <a href="../examples/configuration-range-type.html">Using Range Type</a> + </li> + <li class="none"> + <a href="../examples/configuration-tag-type.html">Using Tag Type</a> + </li> + <li class="none"> + <strong>Using Perforce</strong> + </li> + </ul> + <h5>Project Documentation</h5> + <ul> + <li class="collapsed"> + <a href="../project-info.html">Project Information</a> + </li> + <li class="collapsed"> + <a href="../project-reports.html">Project Reports</a> + </li> + </ul> + <h5>Maven Projects</h5> + <ul> + <li class="none"> + <a href="../../../ant-tasks/index.html">Ant Tasks</a> + </li> + <li class="none"> + <a href="../../../archetype/index.html">Archetype</a> + </li> + <li class="none"> + <a href="../../../doxia/index.html">Doxia</a> + </li> + <li class="none"> + <a href="../../../jxr/index.html">JXR</a> + </li> + <li class="none"> + <a href="../../../maven-1.x/index.html">Maven 1.x</a> + </li> + <li class="none"> + <a href="../../../index.html">Maven 2 & 3</a> + </li> + <li class="none"> + <a href="../../../pom/index.html">Parent POMs</a> + </li> + <li class="none"> + <a href="../../index.html">Plugins</a> + </li> + <li class="none"> + <a href="../../../plugin-tools/index.html">Plugin Tools</a> + </li> + <li class="none"> + <a href="../../../scm/index.html">SCM</a> + </li> + <li class="none"> + <a href="../../../shared/index.html">Shared Components</a> + </li> + <li class="none"> + <a href="../../../skins/index.html">Skins</a> + </li> + <li class="none"> + <a href="../../../surefire/index.html">Surefire</a> + </li> + <li class="none"> + <a href="../../../wagon/index.html">Wagon</a> + </li> + </ul> + <h5>ASF</h5> + <ul> + <li class="none"> + <a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink">How Apache Works</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/"; class="externalLink">Foundation</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink">Sponsoring Apache</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/thanks.html"; class="externalLink">Thanks</a> + </li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img 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 Perforce<a name="Using_Perforce"></a></h2> +<p>The maven-changelog-plugin uses <a class="externalLink" href="http://maven.apache.org/scm/";>Maven SCM</a> as an underlying layer, when accessing your SCM system. When Maven SCM is working with Perforce it needs a clientspec. This is provided by setting system properties that are then read by Maven SCM.</p> +<p>Configuring this is done in the same way as for the maven-scm-plugin. So if you have a working configuration for maven-scm-plugin, you can just copy those lines over to your maven-changelog-plugin configuration. The following configuration shows an example of what this can look like.</p> +<div class="source"> +<pre><project> + ... + <reporting> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-changelog-plugin</artifactId> + <version>2.3</version> + <configuration> + <systemProperties> + <property> + <name>maven.scm.perforce.clientspec.name</name> + <value>your.perforce.clientspec.name</value> + </property> + </systemProperties> + </configuration> + </plugin> + </plugins> + </reporting> + ... +</project></pre></div></div> + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + © 2002-2014 + The Apache Software Foundation + + - <a href="http://maven.apache.org/privacy-policy.html";>Privacy Policy</a>. + Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation. + </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> \ No newline at end of file
Modified: websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/faq.html ============================================================================== --- websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/faq.html (original) +++ websites/production/maven/content/plugins-archives/maven-changelog-plugin-LATEST/faq.html Tue Jun 24 19:40:53 2014 @@ -1,386 +1,325 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <title>Maven Changelog plugin - Frequently Asked Questions</title> - <style type="text/css" media="all"> - @import url("./css/maven-base.css"); - @import url("./css/maven-theme.css"); - @import url("./css/site.css"); - </style> - <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - -<script type="text/javascript" src="http://www.google-analytics.com/urchin.js";></script> - -<script type="text/javascript">_uacct = "UA-140879-1"; - urchinTracker();</script> - </head> - <body class="composite"> - <div id="banner"> - <a href="../../" id="bannerLeft"> - - <img src="../../images/apache-maven-project-2.png" alt="" /> - - </a> - <a href="../../" id="bannerRight"> - - <img src="../../images/maven-logo-2.gif" alt="" /> - - </a> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - - <a href="http://www.apache.org/"; class="externalLink">Apache</a> - > - - <a href="../../index.html">Maven</a> - > - - <a href="../index.html">Plugins</a> - > - - <a href="http://maven.apache.org/plugins/maven-changelog-plugin"; class="externalLink">Maven Changelog Plugin</a> - </div> - <div class="xright"> - - - - - - - - Last Published: 2010-05-28 - | Version: 2.2 - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>Overview</h5> - <ul> - - <li class="none"> - <a href="index.html">Introduction</a> - </li> - - <li class="none"> - <a href="plugin-info.html">Goals</a> - </li> - - <li class="none"> - <a href="usage.html">Usage</a> - </li> - - <li class="none"> - <strong>FAQ</strong> - </li> - </ul> - <h5>Examples</h5> - <ul> - - <li class="none"> - <a href="examples/changing-heading-date-format.html">Changing the Heading Date Format</a> - </li> - - <li class="none"> - <a href="examples/modifying-scm-links.html">Modifying SCM Links</a> - </li> - - <li class="none"> - <a href="examples/selecting-reports.html">Selecting Reports</a> - </li> - - <li class="none"> - <a href="examples/configuration-date-type.html">Using Date Type</a> - </li> - - <li class="none"> - <a href="examples/configuration-range-type.html">Using Range Type</a> - </li> - - <li class="none"> - <a href="examples/configuration-tag-type.html">Using Tag Type</a> - </li> - - <li class="none"> - <a href="examples/using-perforce.html">Using Perforce</a> - </li> - </ul> - <h5>Project Documentation</h5> - <ul> - - - - - - - - - - - - - - - - - - - - - - - - - - <li class="collapsed"> - <a href="project-info.html">Project Information</a> - </li> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <li class="collapsed"> - <a href="project-reports.html">Project Reports</a> - </li> - </ul> - <h5>Maven Projects</h5> - <ul> - - <li class="none"> - <a href="../../ant-tasks/index.html">Ant Tasks</a> - </li> - - <li class="none"> - <a href="../../doxia/index.html">Doxia</a> - </li> - - <li class="none"> - <a href="../../jxr/index.html">JXR</a> - </li> - - <li class="none"> - <a href="../../maven-1.x/index.html">Maven 1.x</a> - </li> - - <li class="none"> - <a href="../../index.html">Maven 2</a> - </li> - - <li class="none"> - <a href="../../mercury/index.html">Mercury</a> - </li> - - <li class="none"> - <a href="../index.html">Plugins</a> - </li> - - <li class="none"> - <a href="../../scm/index.html">SCM</a> - </li> - - <li class="none"> - <a href="../../shared/index.html">Shared Components</a> - </li> - - <li class="none"> - <a href="../../surefire/index.html">Surefire</a> - </li> - - <li class="none"> - <a href="../../wagon/index.html">Wagon</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="top">Frequently Asked Questions</a></h2> -<ol type="1"><li><a href="#What_is_the_difference_between_the_Changelog_plugin_and_the_Changes_plugin">What is the difference between the Changelog plugin and the Changes plugin?</a></li> -<li><a href="#What_is_Software_Configuration_Management_or_SCM">What is Software Configuration Management or SCM?</a></li> -<li><a href="#Why_do_the_dates_look_weird_in_the_report_when_I_use_the_dateFormat_parameter">Why do the dates look weird in the report when I use the dateFormat parameter?</a></li> -<li><a href="#How_can_I_debug_the_SCM_command">How can I debug the SCM command?</a></li> -<li><a href="#My_changelog_report_is_blank_but_it_shouldnt_be">My changelog report is blank, but it shouldn't be</a></li> -<li><a href="#Where_can_I_find_a_working_configuration_for_this_plugin">Where can I find a working configuration for this plugin?</a></li> -<li><a href="#How_do_I_use_this_plugin_with_Perforce">How do I use this plugin with Perforce?</a></li> -<li><a href="#The_Developer_Activity_report_is_blank_but_the_other_reports_are_fine">The Developer Activity report is blank, but the other reports are fine</a></li> -<li><a href="#I_think_Ive_found_a_bug_in_this_plugin_what_do_I_do">I think I've found a bug in this plugin, what do I do?</a></li> -<li><a href="#Why_do_the_child_modules_of_my_multi_module_project_have_wrong_SCM_URLs">Why do the child modules of my multi module project have wrong SCM URLs?</a></li> -</ol> -</div> -<dl><dt><a name="What_is_the_difference_between_the_Changelog_plugin_and_the_Changes_plugin">What is the difference between the Changelog plugin and the Changes plugin?</a></dt> +<!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 2014-06-24 + | Rendered using Apache Maven Stylus Skin 1.5 +--> +<html xmlns="http://www.w3.org/1999/xhtml";> + <head> + <title>Apache Maven Changelog Plugin - Frequently Asked Questions</title> + <style type="text/css" media="all"> + @import url("./css/maven-base.css"); + @import url("./css/maven-theme.css"); + @import url("./css/site.css"); + </style> + <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> + <meta name="Date-Revision-yyyymmdd" content="20140624" /> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + +<script src="http://www.google-analytics.com/urchin.js"; type="text/javascript"></script> + +<script type="text/javascript">_uacct = "UA-140879-1"; + urchinTracker();</script> + </head> + <body class="composite"> + <div id="banner"> + <a href="../../" id="bannerLeft"> + <img src="../../images/apache-maven-project-2.png" alt="" /> + </a> + <span id="bannerRight"> + <img src="../../images/maven-logo-2.gif" alt="" /> + </span> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + + <div class="xleft"> + <a href="http://www.apache.org/"; class="externalLink">Apache</a> + > + <a href="../../index.html">Maven</a> + > + <a href="../index.html">Plugins</a> + > + <a href="./">Apache Maven Changelog Plugin</a> + > + Frequently Asked Questions + </div> + <div class="xright"> + Last Published: 2014-06-24 + | Version: 2.3 + </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + + <h5>Overview</h5> + <ul> + <li class="none"> + <a href="index.html">Introduction</a> + </li> + <li class="none"> + <a href="plugin-info.html">Goals</a> + </li> + <li class="none"> + <a href="usage.html">Usage</a> + </li> + <li class="none"> + <strong>FAQ</strong> + </li> + <li class="none"> + <a href="changing-scm-impl.html">Change Scm implementation</a> + </li> + <li class="none"> + <a href="http://www.apache.org/licenses/"; class="externalLink">License</a> + </li> + <li class="none"> + <a href="download.html">Download</a> + </li> + </ul> + <h5>Examples</h5> + <ul> + <li class="none"> + <a href="examples/changing-heading-date-format.html">Changing the Heading Date Format</a> + </li> + <li class="none"> + <a href="examples/modifying-scm-links.html">Modifying SCM Links</a> + </li> + <li class="none"> + <a href="examples/selecting-reports.html">Selecting Reports</a> + </li> + <li class="none"> + <a href="examples/configuration-date-type.html">Using Date Type</a> + </li> + <li class="none"> + <a href="examples/configuration-range-type.html">Using Range Type</a> + </li> + <li class="none"> + <a href="examples/configuration-tag-type.html">Using Tag Type</a> + </li> + <li class="none"> + <a href="examples/using-perforce.html">Using Perforce</a> + </li> + </ul> + <h5>Project Documentation</h5> + <ul> + <li class="collapsed"> + <a href="project-info.html">Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html">Project Reports</a> + </li> + </ul> + <h5>Maven Projects</h5> + <ul> + <li class="none"> + <a href="../../ant-tasks/index.html">Ant Tasks</a> + </li> + <li class="none"> + <a href="../../archetype/index.html">Archetype</a> + </li> + <li class="none"> + <a href="../../doxia/index.html">Doxia</a> + </li> + <li class="none"> + <a href="../../jxr/index.html">JXR</a> + </li> + <li class="none"> + <a href="../../maven-1.x/index.html">Maven 1.x</a> + </li> + <li class="none"> + <a href="../../index.html">Maven 2 & 3</a> + </li> + <li class="none"> + <a href="../../pom/index.html">Parent POMs</a> + </li> + <li class="none"> + <a href="../index.html">Plugins</a> + </li> + <li class="none"> + <a href="../../plugin-tools/index.html">Plugin Tools</a> + </li> + <li class="none"> + <a href="../../scm/index.html">SCM</a> + </li> + <li class="none"> + <a href="../../shared/index.html">Shared Components</a> + </li> + <li class="none"> + <a href="../../skins/index.html">Skins</a> + </li> + <li class="none"> + <a href="../../surefire/index.html">Surefire</a> + </li> + <li class="none"> + <a href="../../wagon/index.html">Wagon</a> + </li> + </ul> + <h5>ASF</h5> + <ul> + <li class="none"> + <a href="http://www.apache.org/foundation/how-it-works.html"; class="externalLink">How Apache Works</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/"; class="externalLink">Foundation</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/sponsorship.html"; class="externalLink">Sponsoring Apache</a> + </li> + <li class="none"> + <a href="http://www.apache.org/foundation/thanks.html"; class="externalLink">Thanks</a> + </li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img 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><a name="top">Frequently Asked Questions</a><a name="Frequently_Asked_Questions"></a></h2> +<ol style="list-style-type: decimal"> +<li><a href="#What_is_the_difference_between_the_Changelog_plugin_and_the_Changes_plugin">What is the difference between the Changelog plugin and the Changes plugin?</a></li> +<li><a href="#What_is_Software_Configuration_Management_or_SCM">What is Software Configuration Management or SCM?</a></li> +<li><a href="#Why_do_the_dates_look_weird_in_the_report_when_I_use_the_dateFormat_parameter">Why do the dates look weird in the report when I use the dateFormat parameter?</a></li> +<li><a href="#How_can_I_debug_the_SCM_command">How can I debug the SCM command?</a></li> +<li><a href="#My_changelog_report_is_blank_but_it_shouldnt_be">My changelog report is blank, but it shouldn't be</a></li> +<li><a href="#Where_can_I_find_a_working_configuration_for_this_plugin">Where can I find a working configuration for this plugin?</a></li> +<li><a href="#How_do_I_use_this_plugin_with_Perforce">How do I use this plugin with Perforce?</a></li> +<li><a href="#The_Developer_Activity_report_is_blank_but_the_other_reports_are_fine">The Developer Activity report is blank, but the other reports are fine</a></li> +<li><a href="#I_think_Ive_found_a_bug_in_this_plugin_what_do_I_do">I think I've found a bug in this plugin, what do I do?</a></li> +<li><a href="#Why_do_the_child_modules_of_my_multi_module_project_have_wrong_SCM_URLs">Why do the child modules of my multi module project have wrong SCM URLs?</a></li></ol></div> +<dl> +<dt><a name="What_is_the_difference_between_the_Changelog_plugin_and_the_Changes_plugin">What is the difference between the Changelog plugin and the Changes plugin?</a></dt> <dd> - <p> + +<p> The Changelog plugin generates reports based on the changes in the Software Configuration Management or SCM while the Changes plugin generates reports either from a changes.xml file or from the JIRA issue management system. For more information about the changes plugin, see - <a href="http://maven.apache.org/plugins/maven-changes-plugin/";>http://maven.apache.org/plugins/maven-changes-plugin</a> + <a class="externalLink" href="http://maven.apache.org/plugins/maven-changes-plugin/";>http://maven.apache.org/plugins/maven-changes-plugin</a> </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="What_is_Software_Configuration_Management_or_SCM">What is Software Configuration Management or SCM?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="What_is_Software_Configuration_Management_or_SCM">What is Software Configuration Management or SCM?</a></dt> <dd> - <p> - According to Roger Pressman (in his book) Software Engineering: A Practitioner's Approach, SCM is a <em>"set of activities + +<p> + According to Roger Pressman (in his book) Software Engineering: A Practitioner's Approach, SCM is a <i>"set of activities designed to control change by identifying the work products that are likely to change, establishing relationships among them, defining mechanisms for managing different versions of these work products, controlling the changes imposed, and - auditing and reporting on the changes made."</em> + auditing and reporting on the changes made."</i> </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="Why_do_the_dates_look_weird_in_the_report_when_I_use_the_dateFormat_parameter">Why do the dates look weird in the report when I use the dateFormat parameter?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="Why_do_the_dates_look_weird_in_the_report_when_I_use_the_dateFormat_parameter">Why do the dates look weird in the report when I use the dateFormat parameter?</a></dt> <dd> - <p> - The <code>dateFormat</code> parameter is used when parsing the dates + +<p> + The <tt>dateFormat</tt> parameter is used when parsing the dates from the log entries retrieved from your SCM system. It can - <strong>not</strong> be used to format the dates in the report. If + <b>not</b> be used to format the dates in the report. If you try to do this the parsed dates will be wrong and the dates in the report even more so. They can look like this - <code>0020-05-27</code> for a file that was changed on 14 december + <tt>0020-05-27</tt> for a file that was changed on 14 december 2005. </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="How_can_I_debug_the_SCM_command">How can I debug the SCM command?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="How_can_I_debug_the_SCM_command">How can I debug the SCM command?</a></dt> <dd> - <p> + +<p> When you generate the report, you will see output like this on the command line: -<div class="source"><pre> +</p> +<div class="source"> +<pre> [INFO] [changelog:changelog] [INFO] Generating changed sets xml to: .../target/changelog.xml [INFO] Executing: svn --non-interactive log -v -r "{2007-06-13 22:22:09 +0000}:{2007-07-14 22:22:09 +0000}" http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-site-plugin -</pre> -</div> - - Copy the SCM command (everything after <code>Executing:</code>) and +</pre></div> + Copy the SCM command (everything after <tt>Executing:</tt>) and try to run it by itself on the command line. If it doesn't work on the command line there's probably something wrong with the - <code><scm></code> element in your <code>pom.xml</code>. - </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="My_changelog_report_is_blank_but_it_shouldnt_be">My changelog report is blank, but it shouldn't be</a></dt> + <tt><scm></tt> element in your <tt>pom.xml</tt>. + + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="My_changelog_report_is_blank_but_it_shouldnt_be">My changelog report is blank, but it shouldn't be</a></dt> <dd> - <p> + +<p> The first thing to check is what data the changelog plugin managed to pull out of your SCM system. In the file - <code>target/changelog.xml</code> you will find that data. Have a + <tt>target/changelog.xml</tt> you will find that data. Have a look and see if the data in the file seems correct. If it is not correct, then you are not getting the data you expected from your SCM system. Please check your changelog plugin configuration. </p> - <p> + +<p> If that doesn't help, you can try to run the maven-scm-plugin from the command line. The maven-changelog-plugin uses Maven SCM under the hood and running the maven-scm-plugin is a great way of verifying - that the <code><scm></code> element in your - <code>pom.xml</code> file is correct. Try this on the command line: -<div class="source"><pre> + that the <tt><scm></tt> element in your + <tt>pom.xml</tt> file is correct. Try this on the command line: +</p> +<div class="source"> +<pre> mvn scm:changelog -</pre> -</div> - +</pre></div> It should show you the latest changes made in your SCM. It uses the default settings, but you can change these by specifying parameters on the command line. Read more about this in - <a href="http://maven.apache.org/scm/plugins/examples/scm-advance-features.html";>the scm-plugin documentation</a>. - </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="Where_can_I_find_a_working_configuration_for_this_plugin">Where can I find a working configuration for this plugin?</a></dt> + <a class="externalLink" href="http://maven.apache.org/scm/plugins/examples/scm-advance-features.html";>the scm-plugin documentation</a>. + + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="Where_can_I_find_a_working_configuration_for_this_plugin">Where can I find a working configuration for this plugin?</a></dt> <dd> - <p> + +<p> The plugin itself is configured to generate a changelog report. This is done using the bare minimum of configuration. Have a look at the - <code><scm></code> and - <code><reporting>/<plugins></code> elements in the - <a href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changelog-plugin/pom.xml";>pom.xml</a> + <tt><scm></tt> and + <tt><reporting>/<plugins></tt> elements in the + <a class="externalLink" href="http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-changelog-plugin/pom.xml";>pom.xml</a> of this plugin. The generated report is found <a href="changelog.html">here</a>. </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="How_do_I_use_this_plugin_with_Perforce">How do I use this plugin with Perforce?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="How_do_I_use_this_plugin_with_Perforce">How do I use this plugin with Perforce?</a></dt> <dd> - <p> - You have to specify your <code>clientspec</code> in the - <code><systemProperties></code> element of this plugin's + +<p> + You have to specify your <tt>clientspec</tt> in the + <tt><systemProperties></tt> element of this plugin's <configuration> element. -<div class="source"><pre> +</p> +<div class="source"> +<pre> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-changelog-plugin</artifactId> @@ -389,96 +328,96 @@ mvn scm:changelog <property> <name>maven.scm.perforce.clientspec.name</name> <value>your-client-spec-name</value> - </property> - </systemProperties> - </configuration> - </plugin> -</pre> -</div> - - </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="The_Developer_Activity_report_is_blank_but_the_other_reports_are_fine">The Developer Activity report is blank, but the other reports are fine</a></dt> + </property> + </systemProperties> + </configuration> + </plugin> +</pre></div> + + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="The_Developer_Activity_report_is_blank_but_the_other_reports_are_fine">The Developer Activity report is blank, but the other reports are fine</a></dt> <dd> - <p> + +<p> You need to add - <a href="http://maven.apache.org/ref/current/maven-model/maven.html#class_developer";><code><developer></code></a> - elements in your <code>pom.xml</code> file. Their id:s need to match + <a class="externalLink" href="http://maven.apache.org/ref/current/maven-model/maven.html#class_developer";><tt><developer></tt></a> + elements in your <tt>pom.xml</tt> file. Their id:s need to match the userid:s that are used in your SCM system. Only checkins made by a developer found in the pom will be added to the Developer Activity report. </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="I_think_Ive_found_a_bug_in_this_plugin_what_do_I_do">I think I've found a bug in this plugin, what do I do?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="I_think_Ive_found_a_bug_in_this_plugin_what_do_I_do">I think I've found a bug in this plugin, what do I do?</a></dt> <dd> - <p> + +<p> Please follow these steps in the order they come. </p> - <ol> - <li> + +<ol style="list-style-type: decimal"> + +<li> Read all the FAQs on this page. </li> - <li> + +<li> Ask a question on the user list. Please supply the necessary information so that the people on the list can help you. This - includes the <code><scm></code> element from your - <code>pom.xml</code>, your plugin configuration plus a rich + includes the <tt><scm></tt> element from your + <tt>pom.xml</tt>, your plugin configuration plus a rich description of what happens and what you expected to happen. </li> - <li> + +<li> Create an issue in <a href="issue-tracking.html">JIRA</a>. </li> </ol> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr /> -</dd> -<dt><a name="Why_do_the_child_modules_of_my_multi_module_project_have_wrong_SCM_URLs">Why do the child modules of my multi module project have wrong SCM URLs?</a></dt> + +<p align="right"><a href="#top">[top]</a></p><hr /></dd> +<dt><a name="Why_do_the_child_modules_of_my_multi_module_project_have_wrong_SCM_URLs">Why do the child modules of my multi module project have wrong SCM URLs?</a></dt> <dd> - <p> + +<p> The short answer is that they don't. This is usually a misunderstanding of how the SCM URLs are inherited. </p> - <p> + +<p> If you only define an <scm> element in the parent POM, the child modules will interit a value for their SCM URLs. The path to a - child directory, when using the aggregator, is <em>not</em> used when + child directory, when using the aggregator, is <i>not</i> used when constructing the SCM URLs. Only the artifactId is used. </p> - <p> + +<p> If you want to examine what your POM looks like, including the SCM URLs, you can run this command: -<div class="source"><pre> +</p> +<div class="source"> +<pre> mvn help:effective-pom -</pre> -</div> - - </p> - <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table></dd> -</dl> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2002-2010 - - The Apache Software Foundation - - - - - - - - - - <a href="http://maven.apache.org/privacy-policy.html";>Privacy Policy</a></div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> +</pre></div> + + +<p align="right"><a href="#top">[top]</a></p></dd></dl> + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + © 2002-2014 + The Apache Software Foundation + + - <a href="http://maven.apache.org/privacy-policy.html";>Privacy Policy</a>. + Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation. + </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> \ No newline at end of file
