From 2c64a687b038bdfd06524beadbca9159d31ce189 Mon Sep 17 00:00:00 2001
From: Konstantin Kushnir <chpock@gmail.com>
Date: Sun, 8 Dec 2024 19:49:19 +0000
Subject: [PATCH] Add a new schema for Jenkins configuration

---
 CHANGELOG.md                    |   3 +-
 hrc/hrc/proto.hrc               |  12 +-
 hrc/hrc/scripts/jenkinsfile.hrc | 585 ++++++++++++++++++++++++++++++++
 3 files changed, 598 insertions(+), 2 deletions(-)
 create mode 100644 hrc/hrc/scripts/jenkinsfile.hrc

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5ec0b43..faee305 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -36,7 +36,7 @@
 - Use the new shell-posix schema for shell scripts by default
 - [json] highlight JSON object keys
 - rename lib/default.hrc to lib/def.hrc
-- move 'default' type implementation from proto.hrc to base/default.hrc 
+- move 'default' type implementation from proto.hrc to base/default.hrc
 
 ### Added
 - New package type of base - all packed. Hrc and hrd files in one archive. Directory 'auto' not in archive.
@@ -74,6 +74,7 @@
 - [hcl] add a new schema for HashiCorp HCL
 - [terraform] add a new schema for HashiCorp Terraform
 - [dockerfile] add a new schema for Dockerfile
+- [jenkinsfile] add a new schema for Jenkins configuration (Jenkinsfile)
 
 ## [1.2.0] - 2021-09-12
 
diff --git a/hrc/hrc/proto.hrc b/hrc/hrc/proto.hrc
index 5f81ef9..605b61c 100644
--- a/hrc/hrc/proto.hrc
+++ b/hrc/hrc/proto.hrc
@@ -223,7 +223,6 @@
         <filename>/\.groovy$/i</filename>
         <filename>/\.gdsl$/i</filename>
         <filename>/\.gradle$/i</filename>
-        <filename>/Jenkinsfile/i</filename>
         <firstline>/^import/</firstline>
         <firstline>/^#!groovy/</firstline>
         <parameters>
@@ -232,6 +231,17 @@
             <param name="spaces-as-errors" value="false" description="Shows trailing spaces as error" />
         </parameters>
     </prototype>
+    <prototype name="jenkinsfile" group="scripts" description="Jenkinsfile">
+        <location link="scripts/jenkinsfile.hrc"/>
+        <filename>/^Jenkins[Ff]ile\..+$/</filename>
+        <filename>/^.+\.Jenkins[Ff]ile/</filename>
+        <filename>/^Jenkins[Ff]ile$/</filename>
+        <filename>/\.gdsl$/i</filename>
+        <firstline weight='3'>/(^|\n)\s*pipeline\s+\{\s*$/</firstline>
+        <firstline weight='3'>/(^|\n)\s*node\s+\{\s*$/</firstline>
+        <firstline weight='3'>/(^|\n)\s*node\([^\)]\)\s+\{\s*$/</firstline>
+        <firstline weight='3'>/(^|\n)\s*import\s+org\.jenkinsci\./</firstline>
+    </prototype>
 
     <prototype name="rust" group="main" description="Rust">
         <location link="base/rust.hrc" />
diff --git a/hrc/hrc/scripts/jenkinsfile.hrc b/hrc/hrc/scripts/jenkinsfile.hrc
new file mode 100644
index 0000000..f2ddcd0
--- /dev/null
+++ b/hrc/hrc/scripts/jenkinsfile.hrc
@@ -0,0 +1,585 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE hrc PUBLIC "-//Cail Lomecb//DTD Colorer HRC take5//EN"
+  "http://colorer.sf.net/2003/hrc.dtd">
+<hrc version="take5"
+     xmlns="http://colorer.sf.net/2003/hrc"
+     xmlns:xinc="http://www.w3.org/2001/XInclude"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xsi:schemaLocation="http://colorer.sf.net/2003/hrc http://colorer.sf.net/2003/hrc.xsd">
+
+<annotation>
+    <documentation>
+        Jenkinsfile
+
+        Notes:
+            It is not a comprehensive Jenkins goovy DSL syntax analyzer,
+            but it highlights the basic building blocks. Methods are divided
+            into 4 categories for easier navigation in Jenkinsfile:
+              - main methods
+              - configuration
+              - conditions
+              - others
+
+        Links:
+            https://github.com/jakovistuk/script2/blob/master/src/main/resources/idea.gdsl
+            https://github.com/jaydubb12/jenkins-dsl-pipelines/blob/main/src/main/jenkins.gdsl
+
+        Home: https://github.com/chpock/ck.colorer-schemes
+        Send requests there for bug fixes and features.
+    </documentation>
+    <contributors><![CDATA[
+        Konstantin Kushnir <chpock@gmail.com>
+    ]]></contributors>
+
+    <appinfo>
+        <prototype name="jenkinsfile" group="scripts" description="Jenkinsfile">
+            <location link="scripts/jenkinsfile.hrc"/>
+            <filename>/^Jenkins[Ff]ile\..+$/</filename>
+            <filename>/^.+\.Jenkins[Ff]ile/</filename>
+            <filename>/^Jenkins[Ff]ile$/</filename>
+            <filename>/\.gdsl$/i</filename>
+            <firstline weight='3'>/(^|\n)\s*pipeline\s+\{\s*$/</firstline>
+            <firstline weight='3'>/(^|\n)\s*node\s+\{\s*$/</firstline>
+            <firstline weight='3'>/(^|\n)\s*node\([^\)]\)\s+\{\s*$/</firstline>
+            <firstline weight='3'>/(^|\n)\s*import\s+org\.jenkinsci\./</firstline>
+        </prototype>
+    </appinfo>
+</annotation>
+
+<type name="jenkinsfile">
+
+<region name="Text" parent="def:Text"/>
+<region name="Comment" parent="def:Comment"/>
+<region name="String"  parent="def:String"/>
+<region name="StringEdge" parent="def:StringEdge"/>
+
+<region name="Symbol" parent="def:Symbol"/>
+<region name="SymbolStrong" parent="def:SymbolStrong"/>
+
+<region name="Variable" parent="def:Var"/>
+<region name="Constant" parent="def:Constant"/>
+
+<region name="MainMethod" parent="def:ClassKeyword"/>
+<region name="ConditionMethod" parent="def:InterfaceKeyword"/>
+<region name="ConfigurationMethod" parent="def:StructKeyword"/>
+<region name="OtherMethod" parent="def:FunctionKeyword"/>
+
+<region name="Insertion" parent="def:Insertion"/>
+
+<region name="Error" parent="def:Error"/>
+
+<!-- for testing -->
+<region name="Test" parent="def:URL"/>
+<region name="Test2" parent="def:TODO"/>
+
+<scheme name="jenkinsfile">
+    <inherit scheme="def:unixCommentFirstline">
+        <virtual scheme="def:def" subst-scheme="script"/>
+    </inherit>
+</scheme>
+
+<scheme name="script">
+
+    <block start="/^\s*(pipeline|node)\s+((\{))/" end="/(\})/" scheme="pipeline"
+        region01="MainMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(node)\M\(/" end="//" scheme="node" region01="MainMethod"/>
+
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="pipeline-keywords"/>
+        <virtual scheme="groovy" subst-scheme="pipeline"/>
+    </inherit>
+
+</scheme>
+
+<scheme name="keywords"/>
+
+<scheme name="groovy">
+
+    <keywords region="Constant" ignorecase="no">
+        <word name="$class"/>
+    </keywords>
+
+    <inherit scheme="groovy:groovy">
+        <virtual scheme="groovy:groovy" subst-scheme="groovy"/>
+    </inherit>
+
+    <block start="/\b\M\w+(\s*\{|\(|\s+\w|\s+\$|\s+&quot;|\s+&apos;)?=/"
+        end="/~\w+\m(\s*\{|\(|\s+\w|\s+\$|\s+&quot;|\s+&apos;)?=/"
+        scheme="keywords"/>
+
+</scheme>
+
+
+<!-- node(...) { ... } -->
+
+<scheme name="node">
+    <block start="/(\()/" end="/(\))/" scheme="groovy"
+        region00="def:PairStart" region10="def:PairEnd"
+        region01="SymbolStrong"  region11="SymbolStrong"/>
+    <block start="/\)?#1\s+(\{)/" end="/(\})/" scheme="pipeline"
+        region00="def:PairStart" region10="def:PairEnd"
+        region01="SymbolStrong"  region11="SymbolStrong"/>
+</scheme>
+
+<!-- pipeline/node -->
+
+<scheme name="pipeline">
+
+    <regexp match="/^\s*(agent)\s+(any|none)\b/" region1="ConfigurationMethod" region2="Constant"/>
+
+    <block start="/^\s*(environment)\s+((\{))/" end="/(\})/" scheme="environment"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(agent)\s+((\{))/" end="/(\})/" scheme="agent"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(tools?)\s+((\{))/" end="/(\})/" scheme="tool"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(options)\s+((\{))/" end="/(\})/" scheme="options"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(parameters)\s+((\{))/" end="/(\})/" scheme="parameters"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(triggers)\s+((\{))/" end="/(\})/" scheme="triggers"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(when)\s+((\{))/" end="/(\})/" scheme="when"
+        region01="ConditionMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <!--
+        Unfortunately, it is not possible to highlight shell scripts in constructs
+        like "sh ...", because the parameter to "sh" is actually a groovy string that
+        is first parsed by groovy, and then the result of the parsing is passed to
+        the shell. This means that shell variables are represented as \$VARNAME and
+        ${ ... } parts are GStrings. It also violates some sensitive shell syntax rules,
+        such as heredocs when the closing word must be strictly at the beginning
+        of the line. All these makes shell highlighting error prone.
+    -->
+
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="pipeline-keywords"/>
+        <virtual scheme="groovy" subst-scheme="pipeline"/>
+    </inherit>
+
+</scheme>
+
+<scheme name="pipeline-keywords">
+
+    <keywords region="MainMethod" ignorecase="no">
+        <word name="pipeline"/>
+        <word name="stages"/>
+        <word name="stage"/>
+        <word name="steps"/>
+        <word name="step"/>
+        <word name="post"/>
+        <word name="parallel"/>
+        <word name="node"/>
+        <word name="milestone"/>
+        <word name="always"/>
+        <word name="cleanup"/>
+    </keywords>
+
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="ansiColor"/>
+        <word name="parameters"/>
+        <word name="triggers"/>
+        <word name="library"/>
+        <word name="libraryResource"/>
+        <word name="properties"/>
+        <word name="checkoutToSubdirectory"/>
+        <word name="maven"/>
+        <!-- stage methods -->
+        <word name="failFast"/>
+    </keywords>
+
+    <keywords region="ConditionMethod" ignorecase="no">
+        <!-- pipeline methods -->
+        <word name="when"/>
+        <word name="isUnix"/>
+        <word name="input"/>
+        <word name="waitUntil"/>
+        <!-- post methods -->
+        <word name="success"/>
+        <word name="failure"/>
+        <word name="unstable"/>
+        <word name="changed"/>
+        <word name="fixed"/>
+        <word name="regression"/>
+        <word name="aborted"/>
+        <word name="unsuccessful"/>
+    </keywords>
+
+    <keywords region="OtherMethod" ignorecase="no">
+        <!-- pipeline methods -->
+        <word name="echo"/>
+        <word name="jiraComment"/>
+        <word name="jiraIssueSelector"/>
+        <word name="jiraIssueSelector"/>
+        <word name="jiraSearch"/>
+        <word name="build"/>
+        <word name="ec2"/>
+        <word name="error"/>
+        <word name="mail"/>
+        <word name="readTrusted"/>
+        <word name="resolveScm"/>
+        <word name="retry"/>
+        <word name="script"/>
+        <word name="sleep"/>
+        <word name="timeout"/>
+        <word name="withCredentials"/>
+        <word name="withEnv"/>
+        <word name="wrap"/>
+        <word name="ws"/>
+        <word name="catchError"/>
+        <word name="dockerFingerprintRun"/>
+        <word name="envVarsForTool"/>
+        <word name="getContext"/>
+        <word name="withContext"/>
+        <!-- stage methods -->
+        <word name="warnError"/>
+        <!-- steps methods -->
+        <word name="timestamp"/>
+        <word name="bat"/>
+        <word name="checkout"/>
+        <word name="cleanWs"/>
+        <word name="deleteDir"/>
+        <word name="dir"/>
+        <word name="fileExists"/>
+        <word name="git"/>
+        <word name="junit"/>
+        <word name="load"/>
+        <word name="powershell"/>
+        <word name="publishHTML"/>
+        <word name="pwd"/>
+        <word name="readFile"/>
+        <word name="sh"/>
+        <word name="stash"/>
+        <word name="tee"/>
+        <word name="tm"/>
+        <word name="touch"/>
+        <word name="unstash"/>
+        <word name="unzip"/>
+        <word name="updateIdP"/>
+        <word name="updateTrustPolicy"/>
+        <word name="validateDeclarativePipeline"/>
+        <word name="wrap"/>
+        <word name="writeCSV"/>
+        <word name="writeFile"/>
+        <word name="writeJSON"/>
+        <word name="writeMavenPom"/>
+        <word name="writeYaml"/>
+        <word name="zip"/>
+        <word name="archive"/>
+        <word name="container"/>
+        <word name="dockerFingerprintFrom"/>
+        <word name="unarchive"/>
+        <word name="withDockerContainer"/>
+        <word name="withDockerRegistry"/>
+        <word name="withDockerServer"/>
+        <word name="aliyunOSSUpload"/>
+        <word name="archiveArtifacts"/>
+        <word name="buildName"/>
+        <word name="buildDescription"/>
+        <word name="publishIssues"/>
+        <word name="scanForIssues"/>
+        <word name="acceptGitLabMR"/>
+        <word name="addEmbeddableBadgeConfiguration"/>
+        <word name="addGitLabMRComment"/>
+        <word name="awaitDeploymentCompletion"/>
+        <word name="awsIdentity"/>
+        <word name="cfInvalidate"/>
+        <word name="cfnCreateChangeSet"/>
+        <word name="cfnDelete"/>
+        <word name="cfnDeleteStackSet"/>
+        <word name="cfnDescribe"/>
+        <word name="cfnExecuteChangeSet"/>
+        <word name="cfnExports"/>
+        <word name="cfnUpdate"/>
+        <word name="cfnUpdateStackSet"/>
+        <word name="cfnValidate"/>
+        <word name="containerLog"/>
+        <word name="deployAPI"/>
+        <word name="dockerNode"/>
+        <word name="ec2ShareAmi"/>
+        <word name="ecrDeleteImage"/>
+        <word name="ecrListImages"/>
+        <word name="ecrLogin"/>
+        <word name="findFiles"/>
+        <word name="gitlabBuilds"/>
+        <word name="gitlabCommitStatus"/>
+        <word name="httpRequest"/>
+        <word name="listAWSAccounts"/>
+        <word name="lock"/>
+        <word name="nodesByLabel"/>
+        <word name="readCSV"/>
+        <word name="readJSON"/>
+        <word name="readManifest"/>
+        <word name="readMavenPom"/>
+        <word name="readProperties"/>
+        <word name="readYaml"/>
+        <word name="s3Copy"/>
+        <word name="s3Delete"/>
+        <word name="s3DoesObjectExist"/>
+        <word name="s3Download"/>
+        <word name="s3FindFiles"/>
+        <word name="s3PresignURL"/>
+        <word name="s3Upload"/>
+        <word name="setAccountAlias"/>
+        <word name="sha1"/>
+        <word name="snsPublish"/>
+        <word name="updateGitlabCommitStatus"/>
+        <word name="warnError"/>
+        <word name="withAWS"/>
+        <word name="podTemplate"/>
+    </keywords>
+
+</scheme>
+
+<scheme name="agent">
+
+    <block start="/^\s*(docker)\s+((\{))/" end="/(\})/" scheme="agent-docker"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(kubernetes)\s+((\{))/" end="/(\})/" scheme="agent-kubernetes"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <block start="/^\s*(node)\s+((\{))/" end="/(\})/" scheme="agent-node"
+        region01="ConfigurationMethod"
+        region02="def:PairStart" region10="def:PairEnd"
+        region03="SymbolStrong"  region11="SymbolStrong"/>
+
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="agent-keywords"/>
+    </inherit>
+
+</scheme>
+
+<scheme name="agent-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="node"/>
+        <word name="label"/>
+        <word name="customerWorkspace"/>
+        <word name="docker"/>
+        <word name="dockerfile"/>
+        <word name="kubernetes"/>
+    </keywords>
+</scheme>
+
+<scheme name="agent-docker">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="agent-docker-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="agent-docker-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="image"/>
+        <word name="args"/>
+        <word name="label"/>
+        <word name="alwaysPull"/>
+        <word name="registryUrl"/>
+        <word name="registryCredentialsId"/>
+    </keywords>
+</scheme>
+
+<scheme name="agent-kubernetes">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="agent-kubernetes-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="agent-kubernetes-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="label"/>
+        <word name="cloud"/>
+        <word name="defaultContainer"/>
+        <word name="yaml"/>
+        <word name="yamlFile"/>
+    </keywords>
+</scheme>
+
+<scheme name="agent-node">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="agent-node-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="agent-node-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="label"/>
+        <word name="customWorkspace"/>
+    </keywords>
+</scheme>
+
+<scheme name="tool">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="tool-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="tool-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="maven"/>
+        <word name="jdk"/>
+        <word name="nodejs"/>
+    </keywords>
+</scheme>
+
+<scheme name="options">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="options-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="options-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="buildDiscarder"/>
+        <word name="timestamps"/>
+        <word name="skipStagesAfterUnstable"/>
+        <word name="skipDefaultCheckout"/>
+        <word name="preserveStashes"/>
+        <word name="parallelsAlwaysFailFast"/>
+        <word name="disableResume"/>
+        <word name="disableConcurrentBuilds"/>
+        <word name="retry"/>
+        <word name="timeout"/>
+        <word name="lock"/>
+        <word name="ansiColor"/>
+    </keywords>
+</scheme>
+
+<scheme name="parameters">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="parameters-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="parameters-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="choice"/>
+        <word name="booleanParam"/>
+        <word name="string"/>
+    </keywords>
+</scheme>
+
+<scheme name="triggers">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="triggers-keywords"/>
+    </inherit>
+</scheme>
+
+<scheme name="triggers-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="cron"/>
+        <word name="upstream"/>
+        <word name="pollSCM"/>
+        <word name="bitbucketPush"/>
+    </keywords>
+</scheme>
+
+<scheme name="environment">
+
+    <regexp match="/^\s*([\w_-]+)\s*(=)/" region1="Variable" region2="Symbol"/>
+
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="environment-keywords"/>
+    </inherit>
+
+</scheme>
+
+<scheme name="environment-keywords">
+    <keywords region="ConfigurationMethod" ignorecase="no">
+        <word name="credentials"/>
+    </keywords>
+    <keywords region="OtherMethod" ignorecase="no">
+        <word name="pwd"/>
+    </keywords>
+</scheme>
+
+<scheme name="when">
+    <inherit scheme="groovy">
+        <virtual scheme="keywords" subst-scheme="when-keywords"/>
+        <virtual scheme="groovy" subst-scheme="when"/>
+    </inherit>
+</scheme>
+
+<scheme name="when-keywords">
+    <keywords region="ConditionMethod" ignorecase="no">
+        <word name="branch"/>
+        <word name="buildingTag"/>
+        <word name="changelog"/>
+        <word name="changeset"/>
+        <word name="changeRequest"/>
+        <word name="environment"/>
+        <word name="equals"/>
+        <word name="expression"/>
+        <word name="tag"/>
+        <word name="not"/>
+        <word name="allOf"/>
+        <word name="anyOf"/>
+        <word name="triggeredBy"/>
+    </keywords>
+</scheme>
+
+</type>
+</hrc>
+
+<!-- ***** BEGIN LICENSE BLOCK *****
+   - Version: MPL 1.1/GPL 2.0/LGPL 2.1
+   -
+   - The contents of this file are subject to the Mozilla Public License Version
+   - 1.1 (the "License"); you may not use this file except in compliance with
+   - the License. You may obtain a copy of the License at
+   - http://www.mozilla.org/MPL/
+   -
+   - Software distributed under the License is distributed on an "AS IS" basis,
+   - WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+   - for the specific language governing rights and limitations under the
+   - License.
+   -
+   - The Original Code is the Colorer Library.
+   -
+   - The Initial Developer of the Original Code is
+   - Cail Lomecb <cail@nm.ru>.
+   - Portions created by the Initial Developer are Copyright (C) 1999-2008
+   - the Initial Developer. All Rights Reserved.
+   -
+   - Contributor(s):
+   - Konstantin Kushnir <chpock@gmail.com>.
+   -
+   - Alternatively, the contents of this file may be used under the terms of
+   - either the GNU General Public License Version 2 or later (the "GPL"), or
+   - the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+   - in which case the provisions of the GPL or the LGPL are applicable instead
+   - of those above. If you wish to allow use of your version of this file only
+   - under the terms of either the GPL or the LGPL, and not to allow others to
+   - use your version of this file under the terms of the MPL, indicate your
+   - decision by deleting the provisions above and replace them with the notice
+   - and other provisions required by the LGPL or the GPL. If you do not delete
+   - the provisions above, a recipient may use your version of this file under
+   - the terms of any one of the MPL, the GPL or the LGPL.
+   -
+   - ***** END LICENSE BLOCK ***** -->