]> gerrit.simantics Code Review - simantics/platform.git/blobdiff - releng/doc/release.html
Fixed documentation dumping scripts.
[simantics/platform.git] / releng / doc / release.html
index e92cd1e6e4338ecd50a40f85bd578aff2453d36a..126c76cd889489ed514ec46d3e8111b771850cf6 100644 (file)
@@ -1,7 +1,7 @@
 <!DOCTYPE html>\r
 <html>\r
 <head>\r
-<title>MarkdownPad Document</title>\r
+<title>release</title>\r
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />\r
 <style type="text/css">\r
 /* GitHub stylesheet for MarkdownPad (http://markdownpad.com) */\r
@@ -359,28 +359,41 @@ git checkout release/x.y.z[.w]
 </code></pre>\r
 </li>\r
 <li>\r
-<p>Edit the beginning of the file <code>releng/org.simantics.sdk.build.targetdefinition/simantics.target</code></p>\r
+<p>Edit all target platform files in  <code>releng/org.simantics.sdk.build.targetdefinition/</code>, i.e.</p>\r
+<ul>\r
+<li><code>simantics.target</code></li>\r
+<li><code>org.simantics.sdk.build.targetdefinition.target</code></li>\r
+<li><code>org.simantics.sdk.build.targetdefinition-semantum.target</code></li>\r
+</ul>\r
+<p>At the beginning of each .target file, increment <code>sequenceNumber</code> by 1</p>\r
 <pre><code>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;no&quot;?&gt;\r
 &lt;?pde version=&quot;3.8&quot;?&gt;\r
-&lt;target name=&quot;Simantics 1.25.0&quot; sequenceNumber=&quot;10&quot;&gt;\r
-&lt;locations&gt;\r
-&lt;location includeAllPlatforms=&quot;true&quot; includeConfigurePhase=&quot;false&quot; includeMode=&quot;slicer&quot; includeSource=&quot;true&quot; type=&quot;InstallableUnit&quot;&gt;\r
-&lt;unit id=&quot;org.simantics.sdk.feature.group&quot; version=&quot;1.25.0&quot;/&gt;\r
-&lt;repository location=&quot;http://www.simantics.org/download/master/sdk&quot;/&gt;\r
-&lt;/location&gt;\r
+&lt;target name=&quot;Simantics x.y.z[.w]&quot; sequenceNumber=&quot;11&quot;&gt;\r
+</code></pre>\r
+<p>Next, replace the following rows in those files:</p>\r
+<pre><code>&lt;repository location=&quot;http://www.simantics.org/download/master/sdk&quot;/&gt;\r
+&lt;repository location=&quot;http://www.simantics.org/download/master/external-components/maven&quot;/&gt;\r
+&lt;repository location=&quot;http://www.simantics.org/download/master/external-components/manual&quot;/&gt;\r
+</code></pre>\r
+<p>with</p>\r
+<pre><code>&lt;repository location=&quot;http://www.simantics.org/download/release/x.y.z[.w]/sdk&quot;/&gt;\r
+&lt;repository location=&quot;http://www.simantics.org/download/release/x.y.z[.w]/external-components/maven&quot;/&gt;\r
+&lt;repository location=&quot;http://www.simantics.org/download/release/x.y.z[.w]/external-components/manual&quot;/&gt;\r
 </code></pre>\r
-<ul>\r
-<li>Change <code>&lt;repository location=</code> value to <code>http://www.simantics.org/download/release/x.y.z[.w]/sdk</code></li>\r
-<li>Increment <code>sequenceNumber</code> by 1</li>\r
-</ul>\r
 </li>\r
 </ol>\r
 <h3>Initialize release branch distribution web site</h3>\r
 <ul>\r
-<li>Run the [SDK/Simantics SDK](https://www.simantics.org/jenkins/job/SDK/job/Simantics SDK) build with parameters:\r
+<li>Run <a href="https://www.simantics.org/jenkins/job/SDK/job/Deploy%20External%20Components%20to%20Web/">SDK/Deploy External Components to Web</a> build with parameters:\r
 <ul>\r
-<li><code>REFSPEC: refs/heads/release/x.y.z[.w]</code></li>\r
-<li><code>PUBLISHED_BRANCH_NAME: release/x.y.z[.w]</code></li>\r
+<li><strong>GERRIT_REFNAME:</strong> <code>release/x.y.z[.w]</code></li>\r
+<li><strong>PUBLISH_ARTIFACTS:</strong> <code>true</code></li>\r
+</ul>\r
+</li>\r
+<li>Run the <a href="https://www.simantics.org/jenkins/job/SDK/job/Simantics%20SDK/">SDK/Simantics SDK</a> build with parameters:\r
+<ul>\r
+<li><strong>GERRIT_REFNAME:</strong> <code>release/x.y.z[.w]</code></li>\r
+<li><strong>PUBLISH_ARTIFACTS:</strong> <code>true</code></li>\r
 </ul>\r
 </li>\r
 </ul>\r
@@ -428,14 +441,11 @@ git push origin --tags
 <p>Note The -m argument must be supplied to create an <a href="https://git-scm.com/book/en/v2/Git-Basics-Tagging">annotated tag</a>.\r
 Only annotated or signed tags can be pushed to Gerrit.</p>\r
 </blockquote>\r
-<h2>Tag documentation wikis</h2>\r
-<p>Tag documentation wiki using <a href="./tag.sh">tag.sh</a> script.</p>\r
-<p>The wiki documentation is mainly in MediaWiki installations. The only sane way to tag the documentation is to clone it:</p>\r
-<ul>\r
-<li>Copy the wiki installation from wiki to ${release_version}/wiki</li>\r
-<li>Copy the trunk wiki MySQL database into a new version</li>\r
-<li>Reconfigure the tagged wiki (LocalSettings.php) to use the copied database and no longer allow any edits</li>\r
-</ul>\r
+<h2>Dump documentation wikis</h2>\r
+<p>Dump documentation wiki using <a href="./dump-wikis.sh">dump-wikis.sh</a> script.</p>\r
+<p>The wiki documentation is mainly in MediaWiki installations. The only\r
+sane way to tag the documentation is to back up the mysql database\r
+backing the wiki.</p>\r
 <h2>Compile change log entry</h2>\r
 <ul>\r
 <li>Edit the <a href="https://www.simantics.org/redmine/projects/simantics-platform/wiki/ChangeLog">main page</a> and add a a link for release x.y.z[.w].</li>\r