doc/api/helium/target-sf-compare-to-baseline.html
author Simon Howkins <simonh@symbian.org>
Tue, 30 Mar 2010 13:57:59 +0100
changeset 952 ea541face66b
parent 627 56a1d97e7c73
permissions -rw-r--r--
Re-apply changes to allow sources.csv to specify a revision by a *local* tag in the web repository. Uses "hg id" instead of "hg in", so not affected by the aborts we had previously. And no need for an empty repo this time either.


<?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>