release: update some comments
[olsrd.git] / release / release.bash
1 #!/bin/bash
2
3 set -e
4 set -u
5
6
7 # ##############################################################################
8 # # Settings
9 # ##############################################################################
10
11 declare MODE_BRANCH="branch"
12 declare MODE_RELEASE="release"
13
14 declare MODE_BRANCH_TXT="Branch"
15 declare MODE_BRANCH_TXT_LOWER="branch"
16 declare MODE_RELEASE_TXT="Release"
17 declare MODE_RELEASE_TXT_LOWER="release"
18
19 declare MODE_TXT=""
20 declare MODE_TXT_LOWER=""
21
22
23 # The digit representation of a basic version can be in the format 0.6.4
24 declare versionRegexDigitsBasic="([[:digit:]]+\.[[:digit:]]+\.[[:digit:]]+)"
25
26 # The digit representation of a release branch version can be in the format
27 # 0.6.4 or 0.6.4.1
28 declare versionRegexDigits="${versionRegexDigitsBasic}(\.[[:digit:]]+)?"
29
30 # The version for source code can be in the format:
31 # - 0.6.4 or 0.6.4.1 or pre-0.6.4 or pre-0.6.4.1
32 declare versionRegexSources="(|pre-)(${versionRegexDigits})"
33
34 # The version for a release tag is in the format v0.6.4 or v0.6.4.1
35 declare versionRegexReleaseTag="v(${versionRegexDigits})"
36
37 # A release branch is in the format release-0.6.4 or release-0.6.4.1
38 declare relBranchRegex="release-(${versionRegexDigits})"
39
40
41
42
43 # ##############################################################################
44 # # Functions
45 # ##############################################################################
46
47 #
48 # Print script usage
49 #
50 function usage() {
51   echo ""
52   echo "  $(basename "${script}") ${MODE_BRANCH} 0.6.4"
53   echo "    - create the release branch for version 0.6.4"
54   echo "  $(basename "${script}") ${MODE_RELEASE}"
55   echo "    - release the (checked-out) release branch"
56 }
57
58
59 #
60 # Trim a string: remove spaces from the beginning and end of the string
61 #
62 # 1=string to trim
63 # return=trimmed string
64 function stringTrim() {
65   if [[ -z "${1}" ]]; then
66     return
67   fi
68
69   # remove leading whitespace characters
70   local var="${1#${1%%[![:space:]]*}}"
71
72   # remove trailing whitespace characters
73   echo "${var%${var##*[![:space:]]}}"
74 }
75
76
77 #
78 # Get the canonical path of a file or directory
79 # This is the physical path without any links
80 #
81 # 1=the file or directory
82 function pathCanonicalPath() {
83   local src="$(stringTrim "${1}")"
84
85   if [[ -h "${src}" ]] && [[ -d "${src}" ]]; then
86     # src is a link to a directory
87     pushd . &> /dev/null
88     cd -P "${src}" &> /dev/null
89     pwd -P
90     popd &> /dev/null
91     return
92   fi
93
94   # we're not dealing with a directory here
95   while [[ -h "${src}" ]]; do
96     # keep getting the link target while src is a link
97     src="$(ls -la "${src}" | \
98            sed -r 's#^.*?[[:space:]]+->[[:space:]]+(.*)$#\1#')"
99   done
100   # src is no longer a link here
101
102   pushd . &> /dev/null
103   cd -P "$(dirname "${src}")" &> /dev/null
104   echo "$(pwd -P)/$(basename "${src}")"
105   popd &> /dev/null
106 }
107
108
109 #
110 # Determine whether a given directory is a git repository directory
111 #
112 # 1=directory
113 # return=0 not a git dir, 1 a git dir
114 function gitIsGitDirectory() {
115   local place="$(stringTrim "${1}")"
116
117   local -i result=1
118   if [[ -d "${place}" ]]; then
119     pushd "${place}" &> /dev/null
120     set +e
121     git rev-parse --git-dir &> /dev/null
122     result=${?}
123     set -e
124     popd &> /dev/null
125   fi
126
127   if [[ ${result} -ne 0 ]]; then
128     echo "0"
129   else
130     echo "1"
131   fi
132 }
133
134
135 #
136 # Go into the root of the checkout and check some key files
137 #
138 function checkIsOlsrdGitCheckout() {
139   if [[ "$(gitIsGitDirectory ".")" == "0" ]] || \
140      [[ ! -r ./Makefile.inc ]] || \
141      [[ ! -r ./files/olsrd.conf.default.full ]]; then
142     echo "* You do not appear to be running the script from an olsrd git checkout"
143     exit 1
144   fi
145 }
146
147
148 #
149 # Check that a signing key is configured
150 #
151 function checkGitSigningKeyIsConfigured() {
152   local gpgKeyId="$(git config --get user.signingkey)"
153   if [[ -z "${gpgKeyId}" ]]; then
154     cat >&1 << EOF
155 * No signing key is setup for git, please run
156     git config --global user.signingkey <key ID>
157
158   You can get keys and IDs by running 'gpg --list-keys'
159 EOF
160     exit 1
161   fi
162
163   #
164   # Check that the signing key is present
165   #
166         set +e
167         gpg --list-key "${gpgKeyId}" &> /dev/null
168         local -i gpgKeyIdPresentResult=${?}
169         set -e
170         if [[ ${gpgKeyIdPresentResult} -ne 0 ]]; then
171           cat >&1 << EOF
172 * Your signing key with ID ${gpgKeyId} is not found, please run
173     git config --global user.signingkey <key ID>
174   to setup a valid key ID.
175
176   You can get keys and IDs by running 'gpg --list-keys'
177 EOF
178           exit 1
179         fi
180 }
181
182
183 #
184 # Get the version digits from a release tag version
185 #
186 # 1=release tag version
187 # return=version digits
188 function getVersionDigitsFromReleaseTag() {
189   echo "$(stringTrim "${1}")" | sed -r "s/${versionRegexReleaseTag}/\1/"
190 }
191
192
193 #
194 # Get the previous release tag and check
195 #
196 declare prevRelTagVersion=""
197 function getPrevRelTag() {
198   set +e
199   prevRelTagVersion="$(git describe --abbrev=0 | \
200                        grep -E "^${versionRegexReleaseTag}$")"
201   set -e
202   if [[ -z "${prevRelTagVersion}" ]]; then
203     echo "* Could not find the previous release tag"
204     exit 1
205   fi
206 }
207
208
209 #
210 # Get the next version digits by incrementing the micro digit
211 #
212 # 1=version in format 0.6.4 or 0.6.4.1
213 # return=incremented version in format 0.6.5
214 function getNextVersionDigitsMicro() {
215   local version="$(stringTrim "${1}")"
216   local -a versionDigits=( ${version//\./ } )
217   local -i versionMicroNext=$(( ${versionDigits[2]} + 1 ))
218   echo "${versionDigits[0]}.${versionDigits[1]}.${versionMicroNext}"
219 }
220
221
222 #
223 # Get the next version digits by incrementing the patchlevel digit
224 #
225 # 1=version in format 0.6.4 or 0.6.4.0
226 # return=incremented version in format 0.6.4.1
227 function getNextVersionDigitsPatchLevel() {
228   local version="$(stringTrim "${1}")"
229   local -a versionDigits=( ${version//\./ } )
230   local -i versionPatchLevelNext=1
231   if [[ ${#versionDigits[*]} -ne 3 ]]; then
232     versionPatchLevelNext=$(( ${versionDigits[3]} + 1 ))
233   fi
234   echo "${versionDigits[0]}.${versionDigits[1]}.${versionDigits[2]}.${versionPatchLevelNext}"
235 }
236
237
238 #
239 # Adjust the branch name so that we can release 0.6.4.x from the
240 # release-0.6.4 branch
241 #
242 # prevTagVersionDigits  relBranchVersionDigits  relBranchVersionDigits (adjusted)
243 #       0.6.4                   0.6.4                   0.6.4.1
244 #       0.6.4                   0.6.5                   -
245 #       0.6.4                   0.6.4.5                 -
246 #       0.6.4                   0.6.5.5                 -
247 #       0.6.4.5                 0.6.4                   0.6.4.6
248 #       0.6.4.5                 0.6.5                   -
249 #       0.6.4.5                 0.6.4.6                 -
250 #       0.6.4.5                 0.6.5.6                 -
251 function adjustBranchName() {
252   local -a prevTagVersionDigitsArray=( ${prevTagVersionDigits//\./ } )
253   local -a relBranchVersionDigitsArray=( ${relBranchVersionDigits//\./ } )
254   local -i prevTagVersionDigitsCount=${#prevTagVersionDigitsArray[*]}
255   local -i relBranchVersionDigitsCount=${#relBranchVersionDigitsArray[*]}
256   local prevTagVersionTrain="$(echo "$(stringTrim "${prevTagVersionDigits}")" | \
257                                sed -r "s/${versionRegexDigits}/\1/")"
258
259   if  [[ "${prevTagVersionDigits}" == "${relBranchVersionDigits}" ]] || \
260      ([[ "${prevTagVersionTrain}"  == "${relBranchVersionDigits}" ]] && \
261       [[ ${prevTagVersionDigitsCount}   -eq 4 ]] && \
262       [[ ${relBranchVersionDigitsCount} -eq 3 ]]); then
263     relBranchVersionDigits="$(getNextVersionDigitsPatchLevel "${prevTagVersionDigits}")"
264   fi
265 }
266
267
268 #
269 # Check that the new version is incrementing
270 #
271 # 1=last version
272 # 2=new version
273 function checkVersionIncrementing() {
274   local lastVersion="$(stringTrim "${1}")"
275   local newVersion="$(stringTrim "${2}")"
276   local errorstr="* The new version ${newVersion} is not greater than the previous version ${lastVersion}"
277
278   local -a lastVersionDigits=( ${lastVersion//\./ } )
279   local -a newVersionDigits=( ${newVersion//\./ } )
280
281   # if the last version is in the format 0.6.4 then assume 0.6.4.0
282   if [[ ${#lastVersionDigits[*]} -ne 4 ]]; then
283     lastVersionDigits[3]=0
284   fi
285
286   # if the new version is in the format 0.6.4 then assume 0.6.4.0
287   if [[ ${#newVersionDigits[*]} -ne 4 ]]; then
288     newVersionDigits[3]=0
289   fi
290
291   # major
292   if [[ ${newVersionDigits[0]} -lt ${lastVersionDigits[0]} ]]; then
293     echo "${errorstr}"
294     exit 1
295   fi
296   if [[ ${newVersionDigits[0]} -gt ${lastVersionDigits[0]} ]]; then
297     return
298   fi
299
300   # minor
301   if [[ ${newVersionDigits[1]} -lt ${lastVersionDigits[1]} ]]; then
302     echo "${errorstr}"
303     exit 1
304   fi
305   if [[ ${newVersionDigits[1]} -gt ${lastVersionDigits[1]} ]]; then
306     return
307   fi
308
309   # micro
310   if [[ ${newVersionDigits[2]} -lt ${lastVersionDigits[2]} ]]; then
311     echo "${errorstr}"
312     exit 1
313   fi
314   if [[ ${newVersionDigits[2]} -gt ${lastVersionDigits[2]} ]]; then
315     return
316   fi
317
318   # patch level
319   if [[ ${newVersionDigits[3]} -lt ${lastVersionDigits[3]} ]]; then
320     echo "${errorstr}"
321     exit 1
322   fi
323   if [[ ${newVersionDigits[3]} -gt ${lastVersionDigits[3]} ]]; then
324     return
325   fi
326
327   # everything is equal
328   echo "${errorstr}"
329   exit 1
330 }
331
332
333 #
334 # Commit the current changes, allow an empty commit, or amend (when the commit
335 # message is the same as that of the last commit)
336 #
337 # 1=non-zero to allow an empty commit
338 # 2=commit message
339 function commitChanges() {
340   local -i allowEmpty=${1}
341   local msg="$(stringTrim "${2}")"
342
343   local lastMsg="$(git log -1 --format="%s")"
344   lastMsg="$(stringTrim "${lastMsg}")"
345   local extra=""
346   if [[ ${allowEmpty} -ne 0 ]]; then
347     extra="${extra} --allow-empty"
348   fi
349   if [[ "${msg}" == "${lastMsg}" ]]; then
350     extra="${extra} --amend"
351   fi
352   set +e
353   git commit -s -q ${extra} -m "${msg}" &> /dev/null
354   set -e
355 }
356
357
358 #
359 # Update the version in all relevant files
360 #
361 # 1=the new version (in the format of versionRegexSources)
362 function updateVersions() {
363   local newVersion="$(stringTrim "${1}")"
364
365   #
366   # Adjust debug settings in Makefile.inc
367   #
368   local src="Makefile.inc"
369   sed -ri \
370    -e 's/^[[:space:]]*DEBUG[[:space:]]*?=.*$/DEBUG ?= 1/' \
371    -e 's/^[[:space:]]*NO_DEBUG_MESSAGES[[:space:]]*?=.*$/NO_DEBUG_MESSAGES ?= 0/' \
372    "${src}"
373   set +e
374   git add "${src}"
375   set -e
376
377
378   #
379   # Adjust version in Makefile
380   #
381   local src="Makefile"
382   sed -ri "s/^([[:space:]]*VERS[[:space:]]*=[[:space:]]*)${versionRegexSources}[[:space:]]*\$/\1${newVersion}/" "${src}"
383   set +e
384   git add "${src}"
385   set -e
386
387
388   #
389   # Adjust version in win32 gui installer
390   #
391   local src="gui/win32/Inst/installer.nsi"
392   local grepStr="^([[:space:]]*MessageBox[[:space:]]+MB_YESNO[[:space:]]+\".+?[[:space:]]+olsr\.org[[:space:]]+)${versionRegexSources}([[:space:]]+.+?\"[[:space:]]+IDYES[[:space:]]+NoAbort)[[:space:]]*$"
393   local replStr="\1${newVersion}\6"
394   sed -ri "s/${grepStr}/${replStr}/" "${src}"
395   set +e
396   git add "${src}"
397   set -e
398
399
400   #
401   # Adjust version in win32 gui front-end
402   #
403   local src="gui/win32/Main/Frontend.rc"
404   local grepStr="^([[:space:]]*CAPTION[[:space:]]+\"olsr\.org[[:space:]]+Switch[[:space:]]+)${versionRegexSources}([[:space:]]*\")[[:space:]]*\$"
405   local replStr="\1${newVersion}\6"
406   sed -ri "s/${grepStr}/${replStr}/" "${src}"
407   set +e
408   git add "${src}"
409   set -e
410 }
411
412
413 #
414 # Sign a text file
415 #
416 # 1=the text file
417 function signTextFile() {
418   local txtFile="$(stringTrim "${1}")"
419   gpg -u "$(git config --get user.name)" --clearsign "${txtFile}"
420   mv "${txtFile}.asc" "${txtFile}"
421 }
422
423
424
425
426 # ##############################################################################
427 # # Main
428 # ##############################################################################
429
430 declare script="$(pathCanonicalPath "${0}")"
431 declare scriptDir="$(dirname "${script}")"
432 declare baseDir="$(dirname "${scriptDir}")"
433
434 cd "${baseDir}"
435
436
437 #
438 # Check the number of arguments
439 #
440 if [[ ${#} -lt 1 ]]; then
441   echo "* Need at least 1 argument:"
442   usage
443   exit 1
444 fi
445
446
447 #
448 # Get the mode and check it
449 #
450 declare mode="$(stringTrim "${1}")"
451 shift 1
452 if [[ ! "${mode}" == "${MODE_BRANCH}" ]] && \
453    [[ ! "${mode}" == "${MODE_RELEASE}" ]]; then
454   echo "* Wrong mode: ${mode}"
455   usage
456   exit 1
457 fi
458
459
460 #
461 # Further mode/argument parsing
462 #
463 declare branchVersion=""
464 if [[ "${mode}" == "${MODE_BRANCH}" ]]; then
465   MODE_TXT="${MODE_BRANCH_TXT}"
466   MODE_TXT_LOWER="${MODE_BRANCH_TXT_LOWER}"
467
468   #
469   # Get the branch version to create
470   #
471   if [[ ${#} -ne 1 ]]; then
472     echo "* Need the version to branch:"
473     usage
474     exit 1
475   fi
476   branchVersion="$(stringTrim "${1}")"
477   shift 1
478
479   #
480   # Check branch version
481   #
482   if [[ -z "$(echo "${branchVersion}" | grep -E "^${versionRegexDigitsBasic}\$")" ]]; then
483     echo "* Version to branch ${branchVersion} has invalid format"
484     echo "  Expected format is: 0.6.4"
485     exit 1
486   fi
487 else
488   MODE_TXT="${MODE_RELEASE_TXT}"
489   MODE_TXT_LOWER="${MODE_RELEASE_TXT_LOWER}"
490
491   if [[ ${#} -ne 0 ]]; then
492     echo "* Need no additional arguments."
493     usage
494     exit 1
495   fi
496 fi
497
498
499 checkIsOlsrdGitCheckout
500
501 if [[ "${mode}" == "${MODE_RELEASE}" ]]; then
502   checkGitSigningKeyIsConfigured
503 fi
504
505 getPrevRelTag
506 declare prevTagVersionDigits="$(getVersionDigitsFromReleaseTag "${prevRelTagVersion}")"
507
508
509 #
510 # Get the current branch and check that we're on a release branch (for the
511 # release mode) or on the master branch (for the branch mode)
512 #
513 declare relBranch="$(git rev-parse --abbrev-ref HEAD)"
514 declare relBranch="$(stringTrim "${relBranch}")"
515 if [[ "${mode}" == "${MODE_BRANCH}" ]]; then
516   if [[ -z "$(echo "${relBranch}" | grep -E "^master\$")" ]]; then
517     echo "* You are not on the master branch"
518     exit 1
519   fi
520   relBranch="release-${branchVersion}"
521
522   # check that the branch does not yet exist
523   declare -i branchTestResult=0
524   set +e
525   git rev-parse --abbrev-ref "${relBranch}" &> /dev/null
526   branchTestResult=${?}
527   set -e
528   if [[ ${branchTestResult} -eq 0 ]]; then
529     echo "* Branch ${relBranch} already exists"
530     exit 1
531   fi
532 else
533   if [[ -z "$(echo "${relBranch}" | grep -E "^${relBranchRegex}\$")" ]]; then
534     echo "* You are not on a release branch (format: release-0.6.4 or release-0.6.4.1)"
535     exit 1
536   fi
537 fi
538
539
540 #
541 # Get the version to release from the current branch
542 #
543 declare relBranchVersionDigits=""
544 if [[ "${mode}" == "${MODE_BRANCH}" ]]; then
545   relBranchVersionDigits="${branchVersion}"
546 else
547   relBranchVersionDigits="$(echo "${relBranch}" | \
548                             sed -r "s/${relBranchRegex}/\1/")"
549   adjustBranchName
550 fi
551
552 declare relTagVersion="v${relBranchVersionDigits}"
553 declare relBranchVersionDigitsNextMicro="$(getNextVersionDigitsMicro "${relBranchVersionDigits}")"
554 declare relBranchVersionDigitsNextPatchLevel="$(getNextVersionDigitsPatchLevel "${relBranchVersionDigits}")"
555
556
557 #
558 # Check that the version is incrementing
559 #
560 checkVersionIncrementing "${prevTagVersionDigits}" "${relBranchVersionDigits}"
561
562
563 #
564 # Confirm the branch/release
565 #
566 cat >&1 << EOF
567
568
569 * All checks pass, ready to ${MODE_TXT_LOWER} ${relBranchVersionDigits}.
570
571   * The previous version found is: ${prevTagVersionDigits}
572     Note: If this is not the version you were expecting, then maybe that
573           version wasn't merged into this branch.
574   * Continuing will DESTROY any modifications you currently have in your tree!
575
576 EOF
577 read -p "Press [enter] to continue or CTRL-C to exit..."
578 echo ""
579 echo ""
580
581
582 #
583 # Clean up the checkout
584 #
585 echo "Cleaning the git checkout..."
586 git clean -fdq
587 git reset -q --hard
588
589
590 if [[ "${mode}" == "${MODE_BRANCH}" ]]; then
591   #
592   # Update the versions for branch
593   #
594   echo "Updating the version to pre-${relBranchVersionDigits}..."
595   updateVersions "pre-${relBranchVersionDigits}"
596   commitChanges 1 "${MODE_TXT} ${relTagVersion}"
597
598   # create release branch
599   echo "Creating the release branch ${relBranch}..."
600   git branch "${relBranch}"
601
602
603   #
604   # Update the version to the next release
605   #
606   echo "Updating the version to pre-${relBranchVersionDigitsNextMicro}..."
607   updateVersions "pre-${relBranchVersionDigitsNextMicro}"
608   commitChanges 0 "Update version after ${MODE_TXT_LOWER} of ${relTagVersion}"
609 else
610   #
611   # Update the versions for release
612   #
613   echo "Updating the version to ${relBranchVersionDigits}..."
614   updateVersions "${relBranchVersionDigits}"
615   commitChanges 1 "${MODE_TXT} ${relTagVersion}"
616
617
618   #
619   # Generate the changelog
620   #
621   echo "Generating the changelog..."
622   declare src="CHANGELOG"
623   declare dst="mktemp -q -p . -t "${src}.XXXXXXXXXX""
624   cat > "${dst}" << EOF
625 ${relBranchVersionDigits} -------------------------------------------------------------------
626
627 EOF
628   git rev-list --pretty=short "${prevRelTagVersion}..HEAD" | \
629     git shortlog -w80 -- >> "${dst}"
630   cat "${src}" >> "${dst}"
631   mv "${dst}" "${src}"
632   set +e
633   git add "${src}"
634   set -e
635   commitChanges 1 "${MODE_TXT} ${relTagVersion}"
636
637
638   #
639   # Tag the release
640   #
641   echo "Tagging ${relTagVersion}..."
642   set +e
643   git tag -d "${relTagVersion}" &> /dev/null
644   set -e
645   git tag -s -m "OLSRd release ${relBranchVersionDigits}" "${relTagVersion}"
646
647
648   #
649   # Update the version to the next release
650   #
651   echo "Updating the version to pre-${relBranchVersionDigitsNextPatchLevel}..."
652   updateVersions "pre-${relBranchVersionDigitsNextPatchLevel}"
653   commitChanges 1 "Update version after ${MODE_TXT_LOWER} of ${relTagVersion}"
654
655
656   #
657   # Update the version (on the master branch) to the next release
658   #
659   echo "Updating the version to pre-${relBranchVersionDigitsNextMicro} on the master branch..."
660   git checkout -q master
661   git clean -fdq
662   git reset -q --hard
663   updateVersions "pre-${relBranchVersionDigitsNextMicro}"
664   commitChanges 0 "Update version after ${MODE_TXT_LOWER} of ${relTagVersion}"
665   git checkout -q "${relBranch}"
666   git clean -fdq
667   git reset -q --hard
668
669
670   #
671   # Make the release tarballs
672   #
673   echo "Generating the release tarballs..."
674   declare tarFile="${scriptDir}/olsrd-${relBranchVersionDigits}.tar"
675   declare tarGzFile="${tarFile}.gz"
676   declare tarBz2File="${tarFile}.bz2"
677   git archive --format=tar --prefix="olsrd-${relBranchVersionDigits}/" --output="${tarFile}" "${relTagVersion}"
678   gzip   -c "${tarFile}" > "${tarGzFile}"
679   bzip2  -c "${tarFile}" > "${tarBz2File}"
680   rm -f "${tarFile}"
681   echo "Generating the release tarball checksums..."
682   declare md5File="${scriptDir}/MD5SUM-${relBranchVersionDigits}"
683   declare sha256File="${scriptDir}/SHA256SUM-${relBranchVersionDigits}"
684   md5sum    "${tarGzFile}" "${tarBz2File}" > "${md5File}"
685   sha256sum "${tarGzFile}" "${tarBz2File}" > "${sha256File}"
686   echo "Signing the release tarball checksums..."
687   signTextFile "${md5File}"
688   signTextFile "${sha256File}"
689 fi
690
691
692 echo "Done."
693
694
695 echo ""
696 echo ""
697 echo "==================="
698 echo "=   Git Updates   ="
699 echo "==================="
700 echo "Branch : master"
701 echo "Branch : ${relBranch}"
702 if [[ "${mode}" == "${MODE_RELEASE}" ]]; then
703   echo "Tag    : ${relTagVersion}"
704   echo ""
705   echo ""
706
707
708   echo "==================="
709   echo "= Generated Files ="
710   echo "==================="
711   cat >&1 << EOF
712 ${tarGzFile}
713 ${tarBz2File}
714 ${md5File}
715 ${sha256File}"
716 EOF
717 fi
718
719
720 echo ""
721 echo ""
722 echo "==================="
723 echo "= Manual Actions  ="
724 echo "==================="
725 if [[ "${mode}" == "${MODE_RELEASE}" ]]; then
726   echo "1. Check that everything is in order. For example, run:"
727   echo "     gitk master ${relBranch} ${relTagVersion}"
728   echo "2. Push. For example, run:"
729   echo "     git push origin master ${relBranch} ${relTagVersion}"
730   echo "3. Upload the generated files to"
731   echo "     http://www.olsr.org/releases/${relBranchVersionDigits}"
732   echo "4. Add a release article on olsr.org."
733   echo ""
734 else
735   echo "1. Check that everything is in order. For example, run:"
736   echo "     gitk master ${relBranch}"
737   echo "2. Push. For example, run:"
738   echo "     git push origin master ${relBranch}"
739   echo "3. Send a 'release branch created' email to olsr-dev@lists.olsr.org."
740   echo ""
741 fi
742