<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri","sans-serif";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Hi folks,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">We’ve introduced a new auto-versioning feature to the starlingx build tools, which will use a count of git commits in the package’s base directory in calculating the TIS_PATCH_VER:<o:p></o:p></p>
<p class="MsoNormal">PKG_GITREVCOUNT<o:p></o:p></p>
<p class="MsoNormal"><a href="https://review.opendev.org/727837">https://review.opendev.org/727837</a><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">To use this, you can just set TIS_PATCH_VER=PKG_GITREVCOUNT in your build_srpm.data file. The count is based on commits in the PKG_BASE directory, ie. the same directory with the “centos” dir that contains the build_srpm.data file. For
example, with this set in stx/config/tsconfig/centos/build_srpm.data, the TIS_PATCH_VER will be set to the number of commits in stx/config/tsconfig. This provides for independent versioning of packages in repos with multiple packages.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Optionally, you can also set PKG_BASE_SRCREV, if you want to set an initial reference point for the commit count. For example, if I have updated the base version of a package from 1.0.0 to 2.0.0 in commit SHA a1b2c3d4, and I only want to
count commits from that point, then I would set PKG_BASE_SRCREV=a1b2c3d4 in the build_srpm.data file.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">This operates similar to the existing GITREVCOUNT and TIS_BASE_SRCREV variables that are used when a package is building from a separate subgit, and wants to set the version based on commits in that subgit.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Additionally, both GITREVCOUNT and PKG_GITREVCOUNT can be combined. If you have a package that is using GITREVCOUNT for a separate subgit, but also has local content, you can add PKG_GITREVCOUNT:<o:p></o:p></p>
<p class="MsoNormal">TIS_PATCH_VER=GITREVCOUNT+PKG_GITREVCOUNT<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">As well, you can manually increment the value:<o:p></o:p></p>
<p class="MsoNormal">TIS_PATCH_VER=PKG_GITREVCOUNT+4<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The packages in starlingx/config have now been updated to use PKG_GITREVCOUNT for the TIS_PATCH_VER, if you want to see a simple example:<o:p></o:p></p>
<p class="MsoNormal"><a href="https://review.opendev.org/727838">https://review.opendev.org/727838</a><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">We can start rolling out similar changes to other packages to move to auto-versioning as appropriate.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Please let me know if you have any questions.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Cheers,<o:p></o:p></p>
<p class="MsoNormal">Don.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Arial","sans-serif";color:#333333">Don Penney</span></b><span style="font-size:10.0pt;font-family:"Arial","sans-serif";color:#333333">, Developer,
</span><b><span style="font-size:10.0pt;font-family:"Arial","sans-serif";color:#CC0000">Wind River</span></b><br>
<br>
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</body>
</html>