Update jenkins jobs configuration

Change-Id: I40b16621ec3390cf78e55e44af2b11dc71140364
Signed-off-by: Junchun Guan <junchunx.guan@intel.com>

diff --git a/jenkins-jobs/configs/GBS-local-build-with-package-list/config.xml b/jenkins-jobs/configs/GBS-local-build-with-package-list/config.xml
index df7a4ef..b245c96 100644 (file)
--- a/jenkins-jobs/configs/GBS-local-build-with-package-list/config.xml
+++ b/jenkins-jobs/configs/GBS-local-build-with-package-list/config.xml
@@ -1,76 +1,83 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <project>
   <actions/>
-  <description>This jenkins job is used to  build  Tizen  sources.&#xd;
-This job is based on &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; and  &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system&quot;&gt;GBS&lt;/a&gt;.  Developers can reconfigure&#xd;
-this job to run periodically, of course can be triggered at anytime needed.&lt;/p&gt;&#xd;
-&lt;p&gt;Using this job, developers can specify a list of packages, which just have&#xd;
+  <description>&lt;p&gt;This job is  designed for Tizen package building, image creation and build&#xd;
+artifacts publishing by using &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; and &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system&quot;&gt;GBS&lt;/a&gt; as basis. It can be reconfigured&#xd;
+to run periodically or be manually triggered whenever needed.&lt;/p&gt;&#xd;
+&lt;p&gt;With &lt;strong&gt;PUBLISH&lt;/strong&gt; option enabled, build artifacts, including build reports,&#xd;
+repos and images, will be synchronized to respective download servers.&lt;/p&gt;&#xd;
+&lt;p&gt;Before using this job, it is highly recommended that &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/developer-guide/creating-tizen-image-scratch&quot;&gt;Creating a Tizen Image&#xd;
+from Scratch&lt;/a&gt; , which is the manual equivalent of this job, is read and well&#xd;
+understood.&lt;/p&gt;&#xd;
+&lt;p&gt;This job is designed for building part of the packages based on users’&#xd;
+customization, that is , developers can specify a list of packages which just have&#xd;
 been updated in remote repos, and check if the final image can work well&#xd;
-with these changes of packages. To use this job, one remote repo must be&#xd;
-specified, which can be used to get ks file and required by &lt;cite&gt;gbs build&lt;/cite&gt;.&#xd;
-An example of remote repo is shown below:&lt;/p&gt;&#xd;
-&lt;pre class=&quot;literal-block&quot;&gt;&#xd;
-http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/&#xd;
-&lt;/pre&gt;&#xd;
-&lt;p&gt;With &lt;strong&gt;PUBLISH&lt;/strong&gt; enabled, build artifacts, including build reports, repos and&#xd;
-images, will be synchronized to respective download servers.&lt;/p&gt;&#xd;
-&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; To get a better understanding of this job, it is highly recommended&#xd;
-that the following document, which provides instructions of the corresponding&#xd;
-manual operations, is read and well understood:&#xd;
-&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/developer-guide/creating-tizen-image-scratch&quot;&gt;Creating a Tizen Image from Scratch&lt;/a&gt;&lt;/p&gt;&#xd;
-&lt;p&gt;The following options are supported by this jenkins job:&lt;/p&gt;&#xd;
+with these changes of packages.&lt;/p&gt;&#xd;
+&lt;p&gt;To use this job, one remote repo must be specified, from which the building&#xd;
+packages required by GBS and the ks file required by MIC can be obtained.&lt;/p&gt;&#xd;
+&lt;p&gt;An example of remote repo is shown below:&lt;/p&gt;&#xd;
+&lt;blockquote&gt;&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/&quot;&gt;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/&lt;/a&gt;&lt;/blockquote&gt;&#xd;
+&lt;p&gt;Supported options are shown below:&lt;/p&gt;&#xd;
 &lt;dl class=&quot;docutils&quot;&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_URL&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;&lt;p class=&quot;first&quot;&gt;The manifest url, which should be recognized by &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command,&#xd;
-for example: &lt;cite&gt;review.tizen.org:scm/manifest&lt;/cite&gt;, where &lt;cite&gt;review.tizen.org&lt;/cite&gt;&#xd;
-is the alias name set in ~/.ssh, like:&lt;/p&gt;&#xd;
-&lt;pre class=&quot;literal-block&quot;&gt;&#xd;
-Host review.tizen.org&#xd;
+&lt;dd&gt;&lt;p class=&quot;first&quot;&gt;This option specifies the manifest URL, which will be recognized by the&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command, for example, in &lt;cite&gt;tizen:scm/manifest&lt;/cite&gt;,&#xd;
+&lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org Gerrit, whereas&#xd;
+&lt;cite&gt;tizen&lt;/cite&gt; is the alias set in ~/.ssh/config, an example of&#xd;
+~/.ssh/config is shown below:&lt;/p&gt;&#xd;
+&lt;pre class=&quot;last literal-block&quot;&gt;&#xd;
+Host tizen review.tizen.org&#xd;
 Hostname review.tizen.org&#xd;
 Port 29418&#xd;
 User &amp;lt;username&amp;gt;&#xd;
 #ProxyCommand connect -S &amp;lt;proxy&amp;gt;:&amp;lt;port&amp;gt; %h %p&#xd;
 &lt;/pre&gt;&#xd;
-&lt;p class=&quot;last&quot;&gt;and, &lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org gerrit.&lt;/p&gt;&#xd;
 &lt;/dd&gt;&#xd;
-&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_BRANCHES&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the manifest branch used for syncing code, this&#xd;
+&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_BRANCH&lt;/tt&gt;&lt;/dt&gt;&#xd;
+&lt;dd&gt;This option specifies the manifest branch used for synchronizing code, this&#xd;
 value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command directly.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PROFILE&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the target profile, valid values: &lt;cite&gt;IVI&lt;/cite&gt;, &lt;cite&gt;Mobile&lt;/cite&gt;.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the profile used for building, currently, the valid&#xd;
+values are &lt;cite&gt;IVI&lt;/cite&gt; and &lt;cite&gt;Mobile&lt;/cite&gt;&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;ARCH&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the arch to be built, valid values: &lt;cite&gt;i586&lt;/cite&gt; and&#xd;
-&lt;cite&gt;armv7l&lt;/cite&gt;.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the arch to be built, currently the valid values are&#xd;
+i586 and armv7l.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;REMOTE_REPOS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;The remote repos for doing local full build using gbs, and get ks file for&#xd;
-image creation.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the remote repos from which packages are obtained&#xd;
+during package building. Valid remote repos must contans tizen repo data,&#xd;
+including buildata, images and repos in it, for example:&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&quot;&gt;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&lt;/a&gt;&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;KS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;Specify the ks file name used to create images. The avaliable names&#xd;
-should be in  &lt;strong&gt;REMOTE_REPO&lt;/strong&gt;  specified  above, multiple ks can be&#xd;
-specified seperate by space.&lt;/dd&gt;&#xd;
-&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PACKAGE_LIST&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the package list, in which the full path of each&#xd;
-package is listed line by line.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the ks file based on which MIC performs the image&#xd;
+creation. Valid values are the ones contained in the specified remote repo.&#xd;
+List of multiple ks files, in which the names are separated by spaces,&#xd;
+is supported as well.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;BUILD_RDEPS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option enables the building with dependency,that is, packages that&#xd;
-depend on packages in &lt;cite&gt;PACKAGE_LIST&lt;/cite&gt; will be built in correct dependency&#xd;
-order.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option enables the building with dependency, that is, packages that&#xd;
+have dependent packages will be built in correct dependency order.&lt;/dd&gt;&#xd;
+&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PACKAGE_LIST&lt;/tt&gt;&lt;/dt&gt;&#xd;
+&lt;dd&gt;This option specifies the package list in which packages to be built are&#xd;
+listed per line. The format must be the full path in remote Gerrit.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PARALEL_THREADS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option determines how many builder gbs should run in parallel&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the number of builders GBS runs in parallel. Valid&#xd;
+value is non-negative integer.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;EXCLUDE_PACKAGES&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the packages that does not participate in building.&#xd;
-And also can be used to break dependency cycles.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the packages that will be excluded during package&#xd;
+building. This option also can be used to break dependency cycles. Multiple&#xd;
+packages must be separated by comma(,)&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;BUILD_ARGS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;Specify more gbs build options. For more gbs build options and usage&#xd;
-refer to &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.  Default value: empty.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies more GBS build options, which will be passed to &lt;cite&gt;gbs&#xd;
+build&lt;/cite&gt; command. Multiple options are supported, different options must be&#xd;
+seperated by space, For more information about gbs build options, refer to&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PUBLISH&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option enables the publishing of build artifacts to respective&#xd;
-download servers. Build artifacts include report, images and repos.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option enables the publishing of build artifacts, including build&#xd;
+reports, images and repos.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PUBLISH_URL&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;Specify the  URL  address to publish build artifacts. The format of&#xd;
-&lt;cite&gt;PUBLISH_URL&lt;/cite&gt; should be the same as rsync format which can be a local&#xd;
-path or  remote url like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.&#xd;
-This option only take effect if PUBLISH is enabled.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the URL address to publish build artifacts. The&#xd;
+format of PUBLISH_URL must be the same as rsync format, which can be a&#xd;
+local path or remote URL like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.&lt;/dd&gt;&#xd;
 &lt;/dl&gt;</description>
   <keepDependencies>false</keepDependencies>
   <properties>
@@ -78,29 +85,31 @@ This option only take effect if PUBLISH is enabled.&lt;/dd&gt;&#xd;
       <parameterDefinitions>
         <hudson.model.StringParameterDefinition>
           <name>MANIFEST_URL</name>
-          <description>&lt;p class=&quot;first&quot;&gt;The manifest url, which should be recognized by &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command,
-for example: &lt;cite&gt;review.tizen.org:scm/manifest&lt;/cite&gt;, where &lt;cite&gt;review.tizen.org&lt;/cite&gt;
-is the alias name set in ~/.ssh, like:&lt;/p&gt;
-&lt;pre class=&quot;literal-block&quot;&gt;
-Host review.tizen.org
+          <description>&lt;p class=&quot;first&quot;&gt;This option specifies the manifest URL, which will be recognized by the
+&lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command, for example, in &lt;cite&gt;tizen:scm/manifest&lt;/cite&gt;,
+&lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org Gerrit, whereas
+&lt;cite&gt;tizen&lt;/cite&gt; is the alias set in ~/.ssh/config, an example of
+~/.ssh/config is shown below:&lt;/p&gt;
+&lt;pre class=&quot;last literal-block&quot;&gt;
+Host tizen review.tizen.org
 Hostname review.tizen.org
 Port 29418
 User &amp;lt;username&amp;gt;
 #ProxyCommand connect -S &amp;lt;proxy&amp;gt;:&amp;lt;port&amp;gt; %h %p
 &lt;/pre&gt;
-&lt;p class=&quot;last&quot;&gt;and, &lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org gerrit.&lt;/p&gt;
 </description>
           <defaultValue>review.tizen.org:scm/manifest</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>MANIFEST_BRANCH</name>
-          <description>This option specifies the manifest branch used for syncing code, this
+          <description>This option specifies the manifest branch used for synchronizing code, this
 value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command directly.</description>
           <defaultValue>tizen</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.ChoiceParameterDefinition>
           <name>PROFILE</name>
-          <description>This option specifies the target profile, valid values: &lt;cite&gt;IVI&lt;/cite&gt;, &lt;cite&gt;Mobile&lt;/cite&gt;.</description>
+          <description>This option specifies the profile used for building, currently, the valid
+values are &lt;cite&gt;IVI&lt;/cite&gt; and &lt;cite&gt;Mobile&lt;/cite&gt;</description>
           <choices class="java.util.Arrays$ArrayList">
             <a class="string-array">
               <string>ivi</string>
@@ -110,9 +119,10 @@ value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;ht
         </hudson.model.ChoiceParameterDefinition>
         <hudson.model.TextParameterDefinition>
           <name>REMOTE_REPOS</name>
-          <description>The remote repos for doing local full build using gbs, and get ks file for
-image creation. Example:
-http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/</description>
+          <description>This option specifies the remote repos from which packages are obtained
+during package building. Valid remote repos must contans tizen repo data,
+including buildata, images and repos in it, for example:
+&lt;a class=&quot;reference external&quot; href=&quot;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&quot;&gt;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&lt;/a&gt;</description>
           <defaultValue>https://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140214.10</defaultValue>
         </hudson.model.TextParameterDefinition>
         <hudson.model.StringParameterDefinition>
@@ -133,13 +143,12 @@ For multiple ks file use spaces to separate them:
         <hudson.model.TextParameterDefinition>
           <name>PACKAGE_LIST</name>
           <description>Specify the packages list to be built, and one line for per package. The format should be the detail path in remote gerrit.</description>
-          <defaultValue>apps/core/preloaded/menu-screen
-apps/core/preloaded/settings
-</defaultValue>
+          <defaultValue>apps/core/preloaded/menu-screenapps/core/preloaded/settings</defaultValue>
         </hudson.model.TextParameterDefinition>
         <hudson.model.ChoiceParameterDefinition>
           <name>ARCH</name>
-          <description>This option specifies the arch to be built, valid values: &lt;cite&gt;i586&lt;/cite&gt;</description>
+          <description>This option specifies the arch to be built, currently the valid values are
+i586 and armv7l.</description>
           <choices class="java.util.Arrays$ArrayList">
             <a class="string-array">
               <string>ia32</string>
@@ -149,32 +158,36 @@ apps/core/preloaded/settings
         </hudson.model.ChoiceParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>PARALEL_THREADS</name>
-          <description>This option determines how many builder gbs should run in parallel.</description>
+          <description>This option specifies the number of builders GBS runs in parallel. Valid
+value is non-negative integer.</description>
           <defaultValue>4</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>EXCLUDE_PACKAGES</name>
-          <description>This option specifies the packages that does not participate in building.
-And also can be used to break dependency cycles.</description>
+          <description>This option specifies the packages that will be excluded during package
+building. This option also can be used to break dependency cycles. Multiple
+packages must be separated by comma(,)</description>
           <defaultValue>texinfo,aul,gettext</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>BUILD_ARGS</name>
-          <description>Specify more gbs build options. For more gbs build options and usage
-refer to &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.  Default value: empty.</description>
+          <description>This option specifies more GBS build options, which will be passed to &lt;cite&gt;gbs
+build&lt;/cite&gt; command. Multiple options are supported, different options must be
+seperated by space, For more information about gbs build options, refer to
+&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.</description>
           <defaultValue></defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.BooleanParameterDefinition>
           <name>PUBLISH</name>
-          <description>This option enables the publishing of build artifacts to respective download servers. Build artifacts include report, images and repos..</description>
+          <description>This option enables the publishing of build artifacts, including build
+reports, images and repos.</description>
           <defaultValue>true</defaultValue>
         </hudson.model.BooleanParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>PUBLISH_URL</name>
-          <description>Specify the  URL  address to publish build artifacts. The format of
-&lt;cite&gt;PUBLISH_URL&lt;/cite&gt; should be the same as rsync format which can be a local
-path or  remote url like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.
-This option only take effect if PUBLISH is enabled.</description>
+          <description>This option specifies the URL address to publish build artifacts. The
+format of PUBLISH_URL must be the same as rsync format, which can be a
+local path or remote URL like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.</description>
           <defaultValue></defaultValue>
         </hudson.model.StringParameterDefinition>
       </parameterDefinitions>
@@ -185,7 +198,7 @@ This option only take effect if PUBLISH is enabled.</description>
   <disabled>false</disabled>
   <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
   <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
-  <triggers/>
+  <triggers class="vector"/>
   <concurrentBuild>false</concurrentBuild>
   <builders>
     <hudson.tasks.Shell>

diff --git a/jenkins-jobs/configs/GBS-local-full-build/config.xml b/jenkins-jobs/configs/GBS-local-full-build/config.xml
index e2d63f1..7eb5d58 100644 (file)
--- a/jenkins-jobs/configs/GBS-local-full-build/config.xml
+++ b/jenkins-jobs/configs/GBS-local-full-build/config.xml
@@ -1,57 +1,63 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <project>
   <actions/>
-  <description>This jenkins job is used to  build  Tizen  sources.&#xd;
-This job is based on &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; and  &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system&quot;&gt;GBS&lt;/a&gt;.  Developers can reconfigure&#xd;
-this job to run periodically, of course can be triggered at anytime needed.&lt;/p&gt;&#xd;
-&lt;p&gt;With &lt;strong&gt;PUBLISH&lt;/strong&gt; enabled, build artifacts, including build reports, repos and&#xd;
-images, will be synchronized to respective download servers.&lt;/p&gt;&#xd;
-&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; To get a better understanding of this job, it is highly recommended&#xd;
-that the following document, which provides instructions of the corresponding&#xd;
-manual operations, is read and well understood:&#xd;
-&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/developer-guide/creating-tizen-image-scratch&quot;&gt;Creating a Tizen Image from Scratch&lt;/a&gt;&lt;/p&gt;&#xd;
-&lt;p&gt;The following options are supported by this jenkins job:&lt;/p&gt;&#xd;
+  <description>&lt;p&gt;This job is  designed for Tizen package building, image creation and build&#xd;
+artifacts publishing by using &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; and &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system&quot;&gt;GBS&lt;/a&gt; as basis. It can be reconfigured&#xd;
+to run periodically or be manually triggered whenever needed.&lt;/p&gt;&#xd;
+&lt;p&gt;With &lt;strong&gt;PUBLISH&lt;/strong&gt; option enabled, build artifacts, including build reports,&#xd;
+repos and images, will be synchronized to respective download servers.&lt;/p&gt;&#xd;
+&lt;p&gt;Before using this job, it is highly recommended that &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/developer-guide/creating-tizen-image-scratch&quot;&gt;Creating a Tizen Image&#xd;
+from Scratch&lt;/a&gt; , which is the manual equivalent of this job, is read and well&#xd;
+understood.&lt;/p&gt;&#xd;
+&lt;p&gt;Supported options are shown below:&lt;/p&gt;&#xd;
 &lt;dl class=&quot;docutils&quot;&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_URL&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;&lt;p class=&quot;first&quot;&gt;The manifest url, which should be recognized by &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command,&#xd;
-for example: &lt;cite&gt;review.tizen.org:scm/manifest&lt;/cite&gt;, where &lt;cite&gt;review.tizen.org&lt;/cite&gt;&#xd;
-is the alias name set in ~/.ssh, like:&lt;/p&gt;&#xd;
-&lt;pre class=&quot;literal-block&quot;&gt;&#xd;
-Host review.tizen.org&#xd;
+&lt;dd&gt;&lt;p class=&quot;first&quot;&gt;This option specifies the manifest URL, which will be recognized by the&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command, for example, in &lt;cite&gt;tizen:scm/manifest&lt;/cite&gt;,&#xd;
+&lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org Gerrit, whereas&#xd;
+&lt;cite&gt;tizen&lt;/cite&gt; is the alias set in ~/.ssh/config, an example of&#xd;
+~/.ssh/config is shown below:&lt;/p&gt;&#xd;
+&lt;pre class=&quot;last literal-block&quot;&gt;&#xd;
+Host tizen review.tizen.org&#xd;
 Hostname review.tizen.org&#xd;
 Port 29418&#xd;
 User &amp;lt;username&amp;gt;&#xd;
 #ProxyCommand connect -S &amp;lt;proxy&amp;gt;:&amp;lt;port&amp;gt; %h %p&#xd;
 &lt;/pre&gt;&#xd;
-&lt;p class=&quot;last&quot;&gt;and, &lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org gerrit.&lt;/p&gt;&#xd;
 &lt;/dd&gt;&#xd;
-&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_BRANCHES&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the manifest branch used for syncing code, this&#xd;
+&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;MANIFEST_BRANCH&lt;/tt&gt;&lt;/dt&gt;&#xd;
+&lt;dd&gt;This option specifies the manifest branch used for synchronizing code, this&#xd;
 value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command directly.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PROFILE&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the target profile, valid values: &lt;cite&gt;IVI&lt;/cite&gt;, &lt;cite&gt;Mobile&lt;/cite&gt;.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the profile used for building, currently, the valid&#xd;
+values are &lt;cite&gt;IVI&lt;/cite&gt; and &lt;cite&gt;Mobile&lt;/cite&gt;&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;ARCH&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the arch to be built, valid values: &lt;cite&gt;i586&lt;/cite&gt; and&#xd;
-&lt;cite&gt;armv7l&lt;/cite&gt;.&lt;/dd&gt;&#xd;
-&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;REMOTE_REPOS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;The remote repos for doing local full build using gbs, and get ks file for&#xd;
-image creation.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the arch to be built, currently the valid values are&#xd;
+i586 and armv7l.&lt;/dd&gt;&#xd;
+&lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;REMOTE_REPOS (optional)&lt;/tt&gt;&lt;/dt&gt;&#xd;
+&lt;dd&gt;This option specifies the remote repos from which packages are obtained&#xd;
+during package building. Valid remote repos must contans tizen repo data,&#xd;
+including buildata, images and repos in it, for example:&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&quot;&gt;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&lt;/a&gt;&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PARALEL_THREADS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option determines how many builder gbs should run in parallel&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the number of builders GBS runs in parallel. Valid&#xd;
+value is non-negative integer.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;EXCLUDE_PACKAGES&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option specifies the packages that does not participate in building.&#xd;
-And also can be used to break dependency cycles.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the packages that will be excluded during package&#xd;
+building. This option also can be used to break dependency cycles. Multiple&#xd;
+packages must be separated by comma(,)&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;BUILD_ARGS&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;Specify more gbs build options. For more gbs build options and usage&#xd;
-refer to &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.  Default value: empty.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies more GBS build options, which will be passed to &lt;cite&gt;gbs&#xd;
+build&lt;/cite&gt; command. Multiple options are supported, different options must be&#xd;
+seperated by space, For more information about gbs build options, refer to&#xd;
+&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PUBLISH&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;This option enables the publishing of build artifacts to respective&#xd;
-download servers. Build artifacts include report, images and repos.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option enables the publishing of build artifacts, including build&#xd;
+reports, images and repos.&lt;/dd&gt;&#xd;
 &lt;dt&gt;&lt;tt class=&quot;docutils literal&quot;&gt;PUBLISH_URL&lt;/tt&gt;&lt;/dt&gt;&#xd;
-&lt;dd&gt;Specify the  URL  address to publish build artifacts. The format of&#xd;
-&lt;cite&gt;PUBLISH_URL&lt;/cite&gt; should be the same as rsync format which can be a local&#xd;
-path or  remote url like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.&#xd;
-This option only take effect if PUBLISH is enabled.&lt;/dd&gt;&#xd;
+&lt;dd&gt;This option specifies the URL address to publish build artifacts. The&#xd;
+format of PUBLISH_URL must be the same as rsync format, which can be a&#xd;
+local path or remote URL like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.&lt;/dd&gt;&#xd;
 &lt;/dl&gt;</description>
   <keepDependencies>false</keepDependencies>
   <properties>
@@ -59,29 +65,30 @@ This option only take effect if PUBLISH is enabled.&lt;/dd&gt;&#xd;
       <parameterDefinitions>
         <hudson.model.StringParameterDefinition>
           <name>MANIFEST_URL</name>
-          <description>&lt;p class=&quot;first&quot;&gt;The manifest url, which should be recognized by &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command,
-for example: &lt;cite&gt;review.tizen.org:scm/manifest&lt;/cite&gt;, where &lt;cite&gt;review.tizen.org&lt;/cite&gt;
-is the alias name set in ~/.ssh, like:&lt;/p&gt;
-&lt;pre class=&quot;literal-block&quot;&gt;
-Host review.tizen.org
+          <description>&lt;p class=&quot;first&quot;&gt;This option specifies the manifest URL, which will be recognized by the
+&lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command, for example, in &lt;cite&gt;tizen:scm/manifest&lt;/cite&gt;,
+&lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org Gerrit, whereas
+&lt;cite&gt;tizen&lt;/cite&gt; is the alias set in ~/.ssh/config, an example of
+~/.ssh/config is shown below:&lt;/p&gt;
+&lt;pre class=&quot;last literal-block&quot;&gt;
+Host tizen review.tizen.org
 Hostname review.tizen.org
 Port 29418
 User &amp;lt;username&amp;gt;
 #ProxyCommand connect -S &amp;lt;proxy&amp;gt;:&amp;lt;port&amp;gt; %h %p
-&lt;/pre&gt;
-&lt;p class=&quot;last&quot;&gt;and, &lt;cite&gt;scm/manifest&lt;/cite&gt; is the manifest path in remote tizen.org gerrit.&lt;/p&gt;
-</description>
+&lt;/pre&gt;</description>
           <defaultValue>review.tizen.org:scm/manifest</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>MANIFEST_BRANCH</name>
-          <description>This option specifies the manifest branch used for syncing code, this
+          <description>This option specifies the manifest branch used for synchronizing code, this
 value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;http://en.wikipedia.org/wiki/Repo_%28script%29&quot;&gt;repo&lt;/a&gt; command directly.</description>
           <defaultValue>tizen</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.ChoiceParameterDefinition>
           <name>PROFILE</name>
-          <description>This option specifies the target profile, valid values: &lt;cite&gt;IVI&lt;/cite&gt;, &lt;cite&gt;Mobile&lt;/cite&gt;.</description>
+          <description>This option specifies the profile used for building, currently, the valid
+values are &lt;cite&gt;IVI&lt;/cite&gt; and &lt;cite&gt;Mobile&lt;/cite&gt;</description>
           <choices class="java.util.Arrays$ArrayList">
             <a class="string-array">
               <string>ivi</string>
@@ -91,14 +98,16 @@ value will be passed to &lt;a class=&quot;reference external&quot; href=&quot;ht
         </hudson.model.ChoiceParameterDefinition>
         <hudson.model.TextParameterDefinition>
           <name>REMOTE_REPOS</name>
-          <description>The remote repos for doing local full build using gbs, and get ks file for
-image creation. Example:
-http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/</description>
-          <defaultValue>https://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140214.10</defaultValue>
+          <description>This option specifies the remote repos from which packages are obtained
+during package building. Valid remote repos must contans tizen repo data,
+including buildata, images and repos in it, for example:
+&lt;a class=&quot;reference external&quot; href=&quot;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&quot;&gt;http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140305.14/&lt;/a&gt;</description>
+          <defaultValue></defaultValue>
         </hudson.model.TextParameterDefinition>
         <hudson.model.ChoiceParameterDefinition>
           <name>ARCH</name>
-          <description>This option specifies the arch to be built, valid values: &lt;cite&gt;i586&lt;/cite&gt;</description>
+          <description>This option specifies the arch to be built, currently the valid values are
+i586 and armv7l.</description>
           <choices class="java.util.Arrays$ArrayList">
             <a class="string-array">
               <string>i586</string>
@@ -108,32 +117,36 @@ http://download.tizen.org/releases/daily/tizen/ivi/ivi/tizen_20140212.7/</descri
         </hudson.model.ChoiceParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>PARALEL_THREADS</name>
-          <description>This option determines how many builder gbs should run in parallel.</description>
+          <description>This option specifies the number of builders GBS runs in parallel. Valid
+value is non-negative integer.</description>
           <defaultValue>4</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>EXCLUDE_PACKAGES</name>
-          <description>This option specifies the packages that does not participate in building.
-And also can be used to break dependency cycles.</description>
+          <description>This option specifies the packages that will be excluded during package
+building. This option also can be used to break dependency cycles. Multiple
+packages must be separated by comma(,)</description>
           <defaultValue>texinfo,aul,gettext</defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>BUILD_ARGS</name>
-          <description>Specify more gbs build options. For more gbs build options and usage
-refer to &lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.  Default value: empty.</description>
-          <defaultValue>platform/upstream/image-configurations</defaultValue>
+          <description>This option specifies more GBS build options, which will be passed to &lt;cite&gt;gbs
+build&lt;/cite&gt; command. Multiple options are supported, different options must be
+seperated by space, For more information about gbs build options, refer to
+&lt;a class=&quot;reference external&quot; href=&quot;https://source.tizen.org/documentation/reference/git-build-system/usage/gbs-build&quot;&gt;gbs build usage&lt;/a&gt;.</description>
+          <defaultValue></defaultValue>
         </hudson.model.StringParameterDefinition>
         <hudson.model.BooleanParameterDefinition>
           <name>PUBLISH</name>
-          <description>This option enables the publishing of build artifacts to respective download servers. Build artifacts include report, images and repos..</description>
+          <description>This option enables the publishing of build artifacts, including build
+reports, images and repos.</description>
           <defaultValue>true</defaultValue>
         </hudson.model.BooleanParameterDefinition>
         <hudson.model.StringParameterDefinition>
           <name>PUBLISH_URL</name>
-          <description>Specify the  URL  address to publish build artifacts. The format of
-&lt;cite&gt;PUBLISH_URL&lt;/cite&gt; should be the same as rsync format which can be a local
-path or  remote url like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.
-This option only take effect if PUBLISH is enabled.</description>
+          <description>This option specifies the URL address to publish build artifacts. The
+format of PUBLISH_URL must be the same as rsync format, which can be a
+local path or remote URL like: &lt;cite&gt;user&amp;#64;hostname:/path/to/publish_dir&lt;/cite&gt;.</description>
           <defaultValue></defaultValue>
         </hudson.model.StringParameterDefinition>
       </parameterDefinitions>
@@ -144,7 +157,7 @@ This option only take effect if PUBLISH is enabled.</description>
   <disabled>false</disabled>
   <blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
   <blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
-  <triggers/>
+  <triggers class="vector"/>
   <concurrentBuild>false</concurrentBuild>
   <builders>
     <hudson.tasks.Shell>