doc/api/helium/target-sf-compare-to-baseline.html
author Simon Howkins <simonh@symbian.org>
Wed, 07 Oct 2009 11:06:27 +0100
changeset 647 4d2a89833fea
parent 627 56a1d97e7c73
permissions -rw-r--r--
Created a dedicated sf-log-to-brag target so it can take care of the commonality of the task, including the creation of the directory for XML output.


<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE HTML PUBLIC "-//w3c//dtd xhtml 1.0 strict//en"
      "http://www.w3.org/tr/xhtml1/dtd/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">


<head>
    <meta name="keywords" content="helium"/>
    <meta http-equiv="content-type" content="text/html+xml; charset=iso-8859-1"/>
    <link rel="stylesheet" href="stylesheet.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:   '',
        VERSION:    '0'
      };
    </script>
    <script type="text/javascript" src="../_static/jquery.js"></script>

    <script type="text/javascript" src="../_static/interface.js"></script>
    <script type="text/javascript" src="../_static/doctools.js"></script>
    
    <title>Target sf-compare-to-baseline</title>
</head>


<body>
<!-- ========= start of top navbar ======= -->
<a name="navbar_top"><!-- --></a>
<a href="#skip-navbar_top" title="skip navigation links"></a>
<table border="0" width="100%" cellpadding="1" cellspacing="0" summary="">
<tr>
<td colspan="2" bgcolor="#eeeeff" class="navbarcell1">
<a name="navbar_top_firstrow"><!-- --></a>
<table border="0" cellpadding="0" cellspacing="3" summary="">
  <tr align="center" valign="top">
  <td bgcolor="#ffffff" class="navbarcell1"> &#160;<a href="overview-summary.html"><font class="navbarfont1"><b>overview</b></font>&#160;</a></td>

  <td bgcolor="#ffffff" class="navbarcell1">    <a href="deprecated-list.html"><font class="navbarfont1"><b>deprecated</b></font></a>&#160;</td>
    
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="properties-table.html"><font class="navbarfont1"><b>properties-table</b></font></a>&#160;</td>  
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="index-1.html"><font class="navbarfont1"><b>index</b></font></a>&#160;</td>
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="help.html"><font class="navbarfont1"><b>help</b></font></a>&#160;</td>
  </tr>
</table>
</td>
<td align="right" valign="top" rowspan="3"><em>
<b>Helium API</b></em>

</td>
</tr>

<tr>
<td bgcolor="white" class="navbarcell2"><font size="-2">
&#160;prev&#160;
&#160;next</font></td>
<td bgcolor="white" class="navbarcell2"><font size="-2">
  <a href="index.html?overview-summary.html" target="_top"><b>frames</b></a>  &#160;
&#160;<a href="overview-summary.html" target="_top"><b>no frames</b></a>  &#160;

&#160;<script type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<a href="allclasses-noframe.html"><b>all classes</b></a>');
  }
  //-->
</script>
<noscript>
  <a href="allclasses-noframe.html"><b>all classes</b></a>
</noscript>


</font></td>
</tr>
</table>
<a name="skip-navbar_top"></a>
<!-- ========= end of top navbar ========= -->
    <hr/>


    
<h2>Target sf-compare-to-baseline</h2>

<p><b>Location</b></p>
<p>    <tt class="docutils literal"><a href="/d:/maintools/sf-config/common/build.postbuild.xml#L560">d:\maintools\sf-config\common\build.postbuild.xml:560:</a></tt>  
</p>

<p><b>Conditional execution</b></p>        
<p>Target <b>is</b> run if property defined: <code>sf-utilities-available</code></p>
<hr/>

<h3>Description</h3>
<p>
</p>
<p/>
<hr/>


<h3>Target external Dependency</h3>
<p> 
<table class="docutils" width="50%">
    <tr>
        <th class="head">Name</th>
    </tr>
        <tr>
                    <td>perl</td>
            </tr>
        <tr>
                    <td>perl</td>
            </tr>
</table>
</p>


<h3>Property dependencies</h3>


<p> 
<table class="docutils" width="50%">
    <tr>
        <th class="head">Name</th><th class="head">Edit status</th>
    </tr>
    <tr>
        <td colspan="2">User editable properties</td>
    </tr>
                    <tr>
                        <td><a href="property-build.drive.html" title="<p>Substed drive where the build is performed. if not defined then helium should search next available build drive letter and subst autometically</p>" target="classframe"><tt class="docutils literal">build.drive</tt></a></td><td><a href="help.html" title="Help" target="classframe">recommended</a></td>
                    </tr>
    <tr>
        <td colspan="2">Internal properties</td>
    </tr>
                    <tr>
                        <td><a href="property-build.log.dir.html" title="<p>This is where the build logs are stored.</p>" target="classframe"><tt class="docutils literal">build.log.dir</tt></a></td><td><a href="help.html" title="Help" target="classframe">discouraged</a></td>
                    </tr>
</table>
</p>

<hr/>


<h3>Target dependencies</h3>
<p align="center">
<img src="target-sf-compare-to-baseline.dot.png" alt="sf-compare-to-baseline dependencies" usemap="#dependencies"
     style="border-style: none"/>
<map name="dependencies" id="dependencies">
<area shape="rect" id="node1" href="target-sf-compare-to-baseline.html" title="sf&#45;compare&#45;to&#45;baseline" alt="" coords="159,53,340,101">
<area shape="rect" id="node5" href="target-sf-diamondize-bom.html" title="sf&#45;diamondize&#45;bom" alt="" coords="401,5,556,53">
<area shape="rect" id="node9" href="target-sf-check-utilities-dir.html" title="sf&#45;check&#45;utilities&#45;dir" alt="" coords="401,77,556,125">
<area shape="rect" id="node2" href="target-sf-postbuild.html" title="sf&#45;postbuild" alt="" coords="5,53,107,101">
<area shape="rect" id="node6" href="target-sf-record-proj-conf-bom.html" title="sf&#45;record&#45;proj&#45;conf&#45;bom" alt="" coords="608,5,792,53">
</map>
</p>
<hr/>


<h3>Source code</h3>
<pre>
    &lt;target name=&quot;sf-compare-to-baseline&quot; depends=&quot;sf-diamondize-bom,sf-check-utilities-dir&quot; if=&quot;sf-utilities-available&quot;&gt;
        &lt;property name=&quot;sf.releasenotes.wiki.txt&quot; value=&quot;${build.log.dir}/releaseNotes.wiki.txt&quot;/&gt;
        &lt;delete file=&quot;${sf.releasenotes.wiki.txt}&quot;/&gt;
        &lt;!-- FCL usage --&gt;
        &lt;exec executable=&quot;perl&quot; dir=&quot;${build.drive}/utilities/releaseAutomation/&quot; output=&quot;${build.log.dir}/fcls4releasenotes.log&quot;&gt;
            &lt;arg value=&quot;${build.drive}/utilities/releaseAutomation/fcls4releasenotes.pl&quot;/&gt;
            &lt;arg value=&quot;--pdkname1=${sf.previous.pdk.tag}&quot;/&gt;
            &lt;arg value=&quot;--pdkloc2=${build.log.dir}&quot;/&gt;
        &lt;/exec&gt;
        &lt;!-- Mercurial comparison --&gt;
        &lt;echo file=&quot;${sf.releasenotes.wiki.txt}&quot; append=&quot;true&quot;&gt;== Mercurial Comparison ==${line.separator}${line.separator}&lt;/echo&gt;
        &lt;if&gt;
            &lt;isset property=&quot;sf.previous.pdk.tag&quot;/&gt;
            &lt;then&gt;
                &lt;echo file=&quot;${sf.releasenotes.wiki.txt}&quot; append=&quot;true&quot;&gt;The Mercurial changes from Nokia were delivered as a bulk update based on '''XXXXXXXXXXXXXXXXXXXXXX'''.${line.separator}${line.separator}List of the Mercurial changes (files added/removed/modified) between ${sf.previous.pdk.tag} and PDK '''XXXXX''' - [[Media:XXXX.txt]].${line.separator}${line.separator}A short study of the results concentrating on the added and removed files has identified these significant package changes:${line.separator}${line.separator}&lt;/echo&gt;
                &lt;if&gt;
                    &lt;istrue value=&quot;${sf.spec.sourcesync.archive}&quot;/&gt;
                    &lt;then&gt;
                        &lt;echo file=&quot;${sf.releasenotes.wiki.txt}&quot; append=&quot;true&quot;&gt;'''Information cannot be derived as source was synced with archive option'''&quot;${line.separator}${line.separator}&lt;/echo&gt;
                    &lt;/then&gt;
                    &lt;else&gt;
                        &lt;exec executable=&quot;perl&quot; dir=&quot;${build.drive}/&quot; output=&quot;${sf.releasenotes.wiki.txt}&quot; append=&quot;true&quot;&gt;
                            &lt;arg value=&quot;${build.drive}/utilities/releaseAutomation/mercurialComparison.pl&quot;/&gt;
                            &lt;arg value=&quot;${build.log.dir}/BOM/build-info.xml&quot;/&gt;
                            &lt;arg value=&quot;${sf.previous.pdk.tag}&quot;/&gt;
                            &lt;arg value=&quot;${build.log.dir}/mercurialComparison.tsv&quot;/&gt;
                        &lt;/exec&gt;
                    &lt;/else&gt;
                &lt;/if&gt;
            &lt;/then&gt;
            &lt;else&gt;
                &lt;echo file=&quot;${sf.releasenotes.wiki.txt}&quot; append=&quot;true&quot;&gt;'''Information cannot be provided as the tag for the previous PDK was not provided to the build'''&quot;${line.separator}${line.separator}&lt;/echo&gt;
            &lt;/else&gt;
        &lt;/if&gt;
        
        &lt;!-- Code churn --&gt;
        &lt;!-- TODO? --&gt;
        &lt;fixcrlf file=&quot;${sf.releasenotes.wiki.txt}&quot;/&gt;
    &lt;/target&gt;
</pre>


    <hr/>
<!-- ========= start of top navbar ======= -->
<a name="navbar_top"><!-- --></a>
<a href="#skip-navbar_top" title="skip navigation links"></a>
<table border="0" width="100%" cellpadding="1" cellspacing="0" summary="">
<tr>
<td colspan="2" bgcolor="#eeeeff" class="navbarcell1">
<a name="navbar_top_firstrow"><!-- --></a>
<table border="0" cellpadding="0" cellspacing="3" summary="">
  <tr align="center" valign="top">
  <td bgcolor="#ffffff" class="navbarcell1"> &#160;<a href="overview-summary.html"><font class="navbarfont1"><b>overview</b></font>&#160;</a></td>

  <td bgcolor="#ffffff" class="navbarcell1">    <a href="deprecated-list.html"><font class="navbarfont1"><b>deprecated</b></font></a>&#160;</td>
    
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="properties-table.html"><font class="navbarfont1"><b>properties-table</b></font></a>&#160;</td>  
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="index-1.html"><font class="navbarfont1"><b>index</b></font></a>&#160;</td>
  <td bgcolor="#eeeeff" class="navbarcell1">    <a href="help.html"><font class="navbarfont1"><b>help</b></font></a>&#160;</td>
  </tr>
</table>
</td>
<td align="right" valign="top" rowspan="3"><em>
<b>Helium API</b></em>

</td>
</tr>

<tr>
<td bgcolor="white" class="navbarcell2"><font size="-2">
&#160;prev&#160;
&#160;next</font></td>
<td bgcolor="white" class="navbarcell2"><font size="-2">
  <a href="index.html?overview-summary.html" target="_top"><b>frames</b></a>  &#160;
&#160;<a href="overview-summary.html" target="_top"><b>no frames</b></a>  &#160;

&#160;<script type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<a href="allclasses-noframe.html"><b>all classes</b></a>');
  }
  //-->
</script>
<noscript>
  <a href="allclasses-noframe.html"><b>all classes</b></a>
</noscript>


</font></td>
</tr>
</table>
<a name="skip-navbar_top"></a>
<!-- ========= end of top navbar ========= -->
    <font size="-2">Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: http://www.eclipse.org/legal/epl-v10.html</font>
 </body>

</html>