#1109 and #1041 Documentation update

10 years ago · 64db9012ef
parent a0a4713830
commit 64db9012ef
3 changed files with 291 additions and 0 deletions
--- a/contrib/buildserver/Exiv2-trunk/config.xml
+++ b/contrib/buildserver/Exiv2-trunk/config.xml
@ -0,0 +1,215 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<matrix-project plugin="matrix-project@1.6">
+  <actions/>
+  <description>Exiv2 builds</description>
+  <logRotator class="hudson.tasks.LogRotator">
+    <daysToKeep>20</daysToKeep>
+    <numToKeep>20</numToKeep>
+    <artifactDaysToKeep>-1</artifactDaysToKeep>
+    <artifactNumToKeep>-1</artifactNumToKeep>
+  </logRotator>
+  <keepDependencies>false</keepDependencies>
+  <properties>
+    <hudson.plugins.svn__release__mgr.JobPropertyImpl plugin="svn-release-mgr@1.2">
+      <maxRevisions>30</maxRevisions>
+    </hudson.plugins.svn__release__mgr.JobPropertyImpl>
+    <hudson.model.ParametersDefinitionProperty>
+      <parameterDefinitions>
+        <hudson.model.BooleanParameterDefinition>
+          <name>Win32</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>x64</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>static</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>dll</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>release</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>debug</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>tests</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>teste</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>testv</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>testx</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>msvc</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.ChoiceParameterDefinition>
+          <name>Builder</name>
+          <description></description>
+          <choices class="java.util.Arrays$ArrayList">
+            <a class="string-array">
+              <string>2005</string>
+              <string>2003</string>
+              <string>2008</string>
+              <string>2010</string>
+              <string>2012</string>
+            </a>
+          </choices>
+        </hudson.model.ChoiceParameterDefinition>
+        <hudson.model.ChoiceParameterDefinition>
+          <name>ACTION</name>
+          <description></description>
+          <choices class="java.util.Arrays$ArrayList">
+            <a class="string-array">
+              <string>/rebuild</string>
+              <string>/build</string>
+              <string>/clean</string>
+              <string>/upgrade</string>
+            </a>
+          </choices>
+        </hudson.model.ChoiceParameterDefinition>
+        <hudson.model.ChoiceParameterDefinition>
+          <name>BuildEnv</name>
+          <description></description>
+          <choices class="java.util.Arrays$ArrayList">
+            <a class="string-array">
+              <string>native</string>
+              <string>CMake</string>
+            </a>
+          </choices>
+        </hudson.model.ChoiceParameterDefinition>
+        <hudson.model.ChoiceParameterDefinition>
+          <name>COMPILER</name>
+          <description></description>
+          <choices class="java.util.Arrays$ArrayList">
+            <a class="string-array">
+              <string>G++</string>
+              <string>Clang</string>
+            </a>
+          </choices>
+        </hudson.model.ChoiceParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>macosx</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>linux</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>cygwin</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>mingw</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.StringParameterDefinition>
+          <name>COMMENT</name>
+          <description></description>
+          <defaultValue>None</defaultValue>
+        </hudson.model.StringParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>expat</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>zlib</name>
+          <description></description>
+          <defaultValue>true</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>libssh</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>curl</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+        <hudson.model.BooleanParameterDefinition>
+          <name>openssl</name>
+          <description></description>
+          <defaultValue>false</defaultValue>
+        </hudson.model.BooleanParameterDefinition>
+      </parameterDefinitions>
+    </hudson.model.ParametersDefinitionProperty>
+  </properties>
+  <scm class="hudson.scm.SubversionReleaseSCM" plugin="svn-release-mgr@1.2">
+    <locations>
+      <hudson.scm.SubversionReleaseSCM_-ModuleLocation>
+        <remote>svn://dev.exiv2.org/svn/trunk</remote>
+        <local>.</local>
+      </hudson.scm.SubversionReleaseSCM_-ModuleLocation>
+    </locations>
+    <useUpdate>false</useUpdate>
+  </scm>
+  <canRoam>true</canRoam>
+  <disabled>true</disabled>
+  <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
+  <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
+  <triggers>
+    <hudson.triggers.SCMTrigger>
+      <spec>H/10 * * * *
+</spec>
+      <ignorePostCommitHooks>false</ignorePostCommitHooks>
+    </hudson.triggers.SCMTrigger>
+  </triggers>
+  <concurrentBuild>true</concurrentBuild>
+  <axes>
+    <hudson.matrix.LabelAxis>
+      <name>label</name>
+      <values>
+        <string>cygwin</string>
+        <string>linux</string>
+        <string>macosx</string>
+        <string>mingw</string>
+        <string>msvc</string>
+      </values>
+    </hudson.matrix.LabelAxis>
+  </axes>
+  <builders>
+    <hudson.tasks.Shell>
+      <command>./contrib/buildserver/jenkins_build.sh
+</command>
+    </hudson.tasks.Shell>
+  </builders>
+  <publishers/>
+  <buildWrappers/>
+  <executionStrategy class="hudson.matrix.DefaultMatrixExecutionStrategyImpl">
+    <runSequentially>false</runSequentially>
+  </executionStrategy>
+</matrix-project>
--- a/contrib/buildserver/ReadMe.txt
+++ b/contrib/buildserver/ReadMe.txt
@ -0,0 +1,72 @@
+contrib/buildserver/ReadMe.txt
+------------------------------
+
+737 rmills@rmillsmm:~/gnu/exiv2/trunk/contrib/buildserver $ dir
+User Documentation and Scripts
+-rw-r--r--@ 1 rmills  staff    63B 15 Dec 22:26 ReadMe.txt                <---- This file
+-rwxr-xr-x@ 1 rmills  staff   440B 15 Dec 23:07 cmakeDailyAll.sh*         <---- run cmake_daily.sh on all platforms
+-rwxr-xr-x@ 1 rmills  staff   424B 14 Dec 23:12 testDailyAll.sh*          <---- run test_daily.sh on all platform
+
+Documentation and Scripts used by Jenkins
+-rwxr-xr-x+ 1 rmills  staff    11K 15 Dec 22:17 jenkins_build.sh*         <---- Primary build script (called by Jenkins)
+-rw-r--r--+ 1 rmills  staff   6.3K 15 Dec 22:17 jenkins_build.bat         <---- Windows build script (called by jenkins_build.sh)
+-rwxr-xr-x@ 1 rmills  staff   5.8K 14 Dec 21:55 cmake_daily.sh*           <---- Builds exiv2 using cmake on all platforms
+-rwxr-xr-x@ 1 rmills  staff   3.6K 15 Dec 05:49 test_daily.sh*            <---- Called by Jenkins to sync and build all platforms
+-rw-r--r--@ 1 rmills  staff   4.0K 14 Dec 18:31 dailyReadMe.txt           <---- Template for the bundle ReadMe.txt generated by cmake_daily.sh
+
+
+Buildserver Configuration
+-------------------------
+
+The buildserver configuration scripts are located here:
+
+523 rmills@rmillsmbp:/mmHD/Users/Shared/Jenkins/Home/jobs $ dir
+drwxr-xr-x  1 rmills  staff   296B 16 Dec 10:22 Exiv2-trunk/
+drwxr-xr-x  1 rmills  staff   296B 16 Dec 10:22 test-cmake-daily/
+drwxr-xr-x  1 rmills  staff   264B 16 Dec 02:47 trunk-cmake-daily/
+drwxrwxrwx  1 rmills  staff   296B 13 Dec 23:07 Exiv2-videow-refactoring/
+drwxr-xr-x  1 rmills  staff   296B 12 May  2015 Exiv2-jenkins/
+drwxr-xr-x  1 rmills  staff   330B  2 May  2015 Exiv2-video-write/
+
+540 rmills@rmillsmbp:/mmHD/Users/Shared/Jenkins/Home/jobs/Exiv2-trunk $ dir
+-rw-r--r--  1 rmills  staff   8.1K 16 Dec 10:22 config.xml                <-- the build magic
+drwxr-xr-x  1 rmills  staff   264B 29 Dec  2014 configurations/           <--- history of config/build
+drwxr-xr-x  1 rmills  staff   1.2K 15 Dec 22:38 builds/                   <-- logs
+-rw-r--r--  1 rmills  staff    78B 16 Dec 10:26 scm-polling.log           <-- name says it all
+lrwxr-xr-x  1 rmills  staff    22B 15 Dec 22:26 lastStable@ -> builds/lastStableBuild
+lrwxr-xr-x  1 rmills  staff    26B 15 Dec 22:26 lastSuccessful@ -> builds/lastSuccessfulBuild
+-rw-r--r--  1 rmills  staff     5B 15 Dec 22:26 nextBuildNumber
+-rw-r--r--  1 rmills  staff    46B 15 Dec 22:26 svnexternals.txt          <-- don't know (nothing important)
+541 rmills@rmillsmbp:/mmHD/Users/Shared/Jenkins/Home/jobs/Exiv2-trunk $
+
+I've added Exiv2-trunk/config.xml to the repos.  I'll add something to jenkins_build.sh to keep it up to date.
+
+Buildserver Scripts
+-------------------
+
+Stable scripts and unlikely to change
+Exiv2-trunk (and selected branches):
+Runs: when svn trunk changes
+./contrib/buildserver/jenkins_build.sh
+
+Caution: older branches have jenkins_build.sh and jenkins_build.bat
+         in the root of the repos
+
+Volatile Scripts - still work in progress
+trunk-cmake-daily:
+Runs: 2am every day
+ssh rmills@rmillsmm                         'cd ~/gnu/exiv2/buildserver ; /usr/local/bin/svn update . ; contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-kubuntu                 'cd ~/gnu/exiv2/buildserver ; /usr/local/bin/svn update . ; contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-w7                      'cd ~/gnu/exiv2/buildserver ; /usr/local/bin/svn update . ; contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-w7 'export PLATFORM=msvc;cd ~/gnu/exiv2/buildserver ; /usr/local/bin/svn update . ; contrib/buildserver/cmake_daily.sh'
+
+test-cmake-daily:
+Runs: 5am every day
+ssh rmills@rmillsmm         'PLATFORM=macosx ~/gnu/exiv2/buildserver/contrib/buildserver/test_daily.sh'
+ssh rmills@rmillsmm-kubuntu 'PLATFORM=linux  ~/gnu/exiv2/buildserver/contrib/buildserver/test_daily.sh'
+ssh rmills@rmillsmm-w7      'PLATFORM=cygwin ~/gnu/exiv2/buildserver/contrib/buildserver/test_daily.sh'
+ssh rmills@rmillsmm-w7      'PLATFORM=msvc   ~/gnu/exiv2/buildserver/contrib/buildserver/test_daily.sh'
+
+Robin Mills
+robin@clanmills.com
+2015-12-16
--- a/contrib/buildserver/cmakeDailyAll.sh
+++ b/contrib/buildserver/cmakeDailyAll.sh
@ -0,0 +1,4 @@
+ssh rmills@rmillsmm                           'cd ~/gnu/exiv2/buildserver;contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-kubuntu                   'cd ~/gnu/exiv2/buildserver;contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-w7                        'cd ~/gnu/exiv2/buildserver;contrib/buildserver/cmake_daily.sh'
+ssh rmills@rmillsmm-w7 'export PLATFORM=msvc ; cd ~/gnu/exiv2/buildserver;contrib/buildserver/cmake_daily.sh'