GenericMappingTools · gd-a · Jul 9, 2020 · Jul 10, 2020 · Jul 10, 2020 · Jul 11, 2020
diff --git a/.azure-pipelines.yml b/.azure-pipelines.yml
@@ -17,24 +17,6 @@ variables:
 
 jobs:
 
-- job:
-  displayName: 'Code Checker'
-
-  steps:
-  - bash: |
-      set -x -e
-      cd src
-      bash gmt_make_PSL_strings.sh
-      bash gmt_make_enum_dicts.sh
-      bash gmt_make_module_purpose.sh
-      cd ..
-      # check if any files are changed
-      if [ $(git ls-files -m) ]; then
-        git diff HEAD
-        exit 1
-      fi
-    displayName: Check if any C codes and headers need to be manually updated
-
 # Lint Checker
 - job:
   displayName: 'Lint Checker'
@@ -67,7 +49,26 @@ jobs:
     BUILD_DOCS: false
     DEPLOY_DOCS: false
     PACKAGE: false
-    TEST: false
+    RUN_TESTS: false
+
+  steps:
+  - template: ci/azure-pipelines-linux.yml
+
+# Linux - Compile only (no GDAL et. al.)
+########################################################################################
+- job:
+  displayName: 'Linux | Compile only (GDAL et. al. excluded)'
+  condition: ne(variables['Build.Reason'], 'Schedule')
+
+  pool:
+    vmImage: 'ubuntu-18.04'
+
+  variables:
+    BUILD_DOCS: false
+    DEPLOY_DOCS: false
+    PACKAGE: false
+    RUN_TESTS: false
+    EXCLUDE_OPTIONAL: true
 
   steps:
   - template: ci/azure-pipelines-linux.yml
@@ -86,7 +87,7 @@ jobs:
     BUILD_DOCS: true
     DEPLOY_DOCS: true
     PACKAGE: true
-    TEST: false
+    RUN_TESTS: false
 
   steps:
   - template: ci/azure-pipelines-linux.yml
@@ -104,7 +105,7 @@ jobs:
     BUILD_DOCS: false
     DEPLOY_DOCS: false
     PACKAGE: false
-    TEST: true
+    RUN_TESTS: true
 
   steps:
   - template: ci/azure-pipelines-linux.yml
@@ -122,7 +123,7 @@ jobs:
     BUILD_DOCS: false
     DEPLOY_DOCS: false
     PACKAGE: false
-    TEST: false
+    RUN_TESTS: false
 
   steps:
   - template: ci/azure-pipelines-mac.yml
@@ -140,7 +141,7 @@ jobs:
     BUILD_DOCS: true
     DEPLOY_DOCS: false
     PACKAGE: true
-    TEST: false
+    RUN_TESTS: false
 
   steps:
   - template: ci/azure-pipelines-mac.yml
@@ -158,7 +159,7 @@ jobs:
     BUILD_DOCS: false
     DEPLOY_DOCS: false
     PACKAGE: false
-    TEST: true
+    RUN_TESTS: true
 
   steps:
   - template: ci/azure-pipelines-mac.yml
@@ -240,6 +241,13 @@ jobs:
         containerImage: ubuntu:16.04
       Ubuntu1804:   # CMake 3.10.2 + GNU 7.4.0
         containerImage: ubuntu:18.04
+      Debian9:      # CMake 3.7.2 + GNU 6.3.0
+        containerImage: debian:stretch
+      Debian10:     # CMake 3.13.4 + GNU 8.3.0
+        containerImage: debian:buster
+      DebianSid:    # CMake 3.16.3 + GNU 10.1.0
+        containerImage: debian:sid
+
 
   container:
     image: $[ variables['containerImage'] ]

diff --git a/.github/ISSUE_TEMPLATE/release_checklist.md b/.github/ISSUE_TEMPLATE/release_checklist.md
@@ -23,9 +23,10 @@ assignees: ''
 - [ ] reserve a DOI on [zenodo](https://zenodo.org) (@PaulWessel)
 - [ ] run `src/gmt_make_*.sh` to update some .c and .h files
 - [ ] run `admin/gs_check.sh` to test if latest ghostscript version works
-- [ ] update changelog
+- [ ] update [changelog](/doc/rst/source/changes.rst)
 - [ ] update INSTALL.md
 - [ ] check if there are any warnings when build the documentation
+- [ ] add one new entry in `doc/rst/_static/version_switch.js` if it's a minor release
 - [ ] check/set values in `cmake/ConfigDefault.cmake`
     - [ ] `GMT_VERSION_YEAR` is current year
     - [ ] `GMT_PACKAGE_VERSION_*` is correctly set

diff --git a/.github/workflows/code-validator.yml b/.github/workflows/code-validator.yml
@@ -0,0 +1,45 @@
+# Workflow to validify the consistence of the codes
+
+on:
+  push:
+    branches:
+      - master
+      - '[0-9]+.[0-9]+'
+  pull_request:
+
+name: Code Validator
+
+jobs:
+  code-validator:
+    name: Code Validator
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v2
+
+      - name: Check PSL_strings.h
+        run: |
+          cd src/
+          bash gmt_make_PSL_strings.sh
+          if [ $(git ls-files -m) ]; then git --no-pager diff HEAD; exit 1; fi
+          cd ..
+
+      - name: Check gmt_enum_dict.h
+        run: |
+          cd src/
+          bash gmt_make_enum_dicts.sh
+          if [ $(git ls-files -m) ]; then git --no-pager diff HEAD; exit 1; fi
+          cd ..
+
+      - name: Check module purposes
+        run: |
+          cd src/
+          bash gmt_make_module_purpose.sh
+          if [ $(git ls-files -m) ]; then git --no-pager diff HEAD; exit 1; fi
+          cd ..
+
+      - name: Check GMT version year
+        run: |
+          current_year=$(date +%Y)
+          gmt_version_year=$(grep GMT_VERSION_YEAR cmake/ConfigDefault.cmake | awk -F'"' '{print $2}')
+          if [ "$current_year" != "$gmt_version_year" ]; then exit 1; fi
diff --git a/INSTALL.md b/INSTALL.md
@@ -37,6 +37,18 @@ In addition to the GMT installer, you also need to download and install
 [GraphicsMagick](http://www.graphicsmagick.org/) if you want to create
 animated GIFs.
 
+**NOTE:**
+At the installation step, you may get the warning message:
+
+> Warning! Failed to add GMT to PATH. Please add the GMT bin path to PATH manually.
+
+Usually it means your system variable **PATH** is already too long and the GMT
+installer can't add its path to the variable. As it says, you need to ignore
+the warning message, and then manually add the GMT bin path
+(e.g., `C:\programs\gmt6`) to **PATH** after finishing the installation.
+If you don't know how to manually modify **PATH**, just search Google for
+"How to change windows path variable".
+
 ## macOS
 
 ### Application Bundle
@@ -136,7 +148,12 @@ These three GMT versions cannot live side by side.
 
 ### Fedora
 
-GMT 6 packages are available for **Fedora 31 or newer**. Install it via:
+**NOTE:** The Fedora official repository may provide an old GMT version.
+If you need the latest GMT version, you can follow the instruction
+["Install latest GMT on Fedora"](https://github.com/GenericMappingTools/gmt/wiki/Install-latest-GMT-on-Fedora)
+in the wiki.
+
+Install GMT via:
 
     dnf install GMT dcw-gmt gshhg-gmt-nc4 gshhg-gmt-nc4-full gshhg-gmt-nc4-high ghostscript
 
@@ -148,58 +165,35 @@ You may also install other optional dependencies for more capabilities within GM
 ### RHEL/CentOS
 
 GMT binary packages are available from Extra Packages for Enterprise Linux (EPEL).
-However, EPEL is far behind packaging a recent version.
-We provide [the GMT official RPM repository](https://copr.fedorainfracloud.org/coprs/genericmappingtools/gmt)
-to allow RHEL/CentOS users access the latest GMT releases in an easy way.
-
-For RHEL/CentOS, run:
-
-    # install epel-release
-    yum install epel-release
 
-    # Enable the PowerTools repository (RHEL/CentOS 8 only)
-	yum config-manager --set-enabled PowerTools
+**NOTE:** The EPEL repository may provide an old GMT version.
+If you need the latest GMT version, you can follow the instruction
+["Install latest GMT on RHEL/CentOS"](https://github.com/GenericMappingTools/gmt/wiki/Install-latest-GMT-on-RHEL-CentOS)
+in the wiki.
 
-    # enable the RPM repository (RHEL/CentOS 7 or 8 ONLY)
-    yum install yum-plugin-copr
-    yum copr enable genericmappingtools/gmt
+Install GMT via:
 
-    # enable the RPM repository (RHEL/CentOS 6 ONLY)
-    wget https://copr.fedorainfracloud.org/coprs/genericmappingtools/gmt/repo/epel-6/genericmappingtools-gmt-epel-6.repo -O /etc/yum.repos.d/genericmappingtools-gmt-epel-6.repo
-
-    # Install GMT
-    yum install gmt
-
-    # Update to the latest version if available
-    yum update gmt
+    yum install epel-release
+    yum install GMT dcw-gmt gshhg-gmt-nc4 gshhg-gmt-nc4-full gshhg-gmt-nc4-high ghostscript
 
 You may also install other optional dependencies for more capabilities within GMT:
 
     yum localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-`rpm -E %rhel`.noarch.rpm
-    yum install GraphicsMagick ffmpeg gdal
-
-**Note**:
-If you already installed the GMT packages provided by EPEL,
-you have to uninstall them before installing the new GMT packages provided
-by the official GMT repository. You can uninstall the older packages by:
-
-    yum remove GMT dcw-gmt gshhg-gmt-nc4 gshhg-gmt-nc4-full gshhg-gmt-nc4-high
+    yum install ffmpeg
 
 ### Ubuntu/Debian
 
-GMT 6 packages are available for Ubuntu 20.04 (Focal Fossa) and Debian 11 (Bullseye/Testing).
-Install it via
-
-    sudo apt-get install gmt gmt-dcw gmt-gshhg
-
-**Note** that the above command will install GMT 5.4 for older Ubuntu/Debian versions,
-e.g. Ubuntu 18.04 Bionic Beaver and Debian 10 Buster/Stable.
+**NOTE:** The Ubuntu/Debian official repositories may provide old GMT versions.
 If you want the latest GMT 6.x release, your best bet then is to
 [build the latest release from source](BUILDING.md).
 Keep in mind that Ubuntu 16.04 LTS for mysterious reasons does not
 include the [supplemental modules](https://docs.generic-mapping-tools.org/latest/modules.html#supplemental-modules),
 but you can obtain them by [building from source](BUILDING.md) or upgrading to Ubuntu 18.04 LTS (or newer).
 
+Install GMT via:
+
+    sudo apt-get install gmt gmt-dcw gmt-gshhg
+
 Install other GMT dependencies (some are optional) via:
 
     # required
@@ -209,35 +203,8 @@ Install other GMT dependencies (some are optional) via:
 
 ### ArchLinux
 
-It's easier to manage installed content and dependencies than directly
-building and manually `make install` in ArchLinux.
-
-    # Full update system packages first
-    sudo pacman -Syu
-
-    # Install tools for building AUR packages
-    sudo pacman -S base-devel
-
-    # Use git command to clone non-official AUR repo of gmt
-    # Here are two options. **You just have to clone one of them:**
-    # If you encounter some problems in those repo,
-    # you can report to the authors first, or choose another one to clone
-    git clone https://aur.archlinux.org/gmt.git
-
-    # alternative repo, for testing stable/rc release in version 6.x branch
-    git clone https://aur.archlinux.org/gmt6.git gmt
-
-    # Optional recommended packages
-    git clone https://aur.archlinux.org/gmt-coast.git
-    git clone https://aur.archlinux.org/gmt-cpt-city.git
-    git clone https://aur.archlinux.org/gmt-dcw.git
-
-    # use makepkg to build packages and use pacman to install
-    cd gmt
-    makepkg -sc
-    sudo pacman -U *.pkg.tar.xz
-
-**Note**: Binary packages of gmt are still not available in [ArchlinuxCN repo](https://www.archlinuxcn.org/archlinux-cn-repo-and-mirror) yet.
+ArchLinux official repository doesn't provide GMT packages, but AUR (ArchLinux User Repository) does.
+You can follow the [Install latest GMT on ArchLinux](https://github.com/GenericMappingTools/gmt/wiki/Install-latest-GMT-on-ArchLinux) in the wiki.
 
 ## Cross Platform Install Instructions
 

diff --git a/README.md b/README.md
@@ -101,7 +101,7 @@ GMT may be linked with these libraries (* means optional):
 [Linear Algebra Package (LAPACK*)](http://www.netlib.org/lapack/),
 [Basic Linear Algebra Subprograms (BLAS*)](http://www.netlib.org/blas/), and
 [ZLIB*](https://www.zlib.net). GMT may call these executables:
-GDAL (ogr2ogr, gdal_info), [Ghostscript](https://www.ghostscript.com),
+GDAL (ogr2ogr, gdal_translate), [Ghostscript](https://www.ghostscript.com),
 [FFmpeg](https://www.ffmpeg.org),
 [xdg-open](https://www.freedesktop.org/wiki/Software/xdg-utils/), and
 [GraphicsMagick](http://www.graphicsmagick.org).
diff --git a/admin/build-release.sh b/admin/build-release.sh
@@ -125,4 +125,6 @@ echo "build-release.sh: Place gmt-${Version}-src.tar.* on the ftp site" >&2
 if [ -f gmt-${Version}-darwin-x86_64.dmg ]; then
 	echo "build-release.sh: Place gmt-${Version}-darwin-x86_64.dmg on the ftp site" >&2
 fi
-#scp gmt-${Version}-darwin-x86_64.dmg gmt-${Version}-src.tar.* ftp:/export/ftp1/ftp/pub/pwessel/release
+if [ "${USER}" = "pwessel" ]; then	# Place file in pwessel SOEST ftp release directory
+	scp gmt-${Version}-darwin-x86_64.dmg gmt-${Version}-src.tar.* ftp.soest.hawaii.edu:/export/ftp1/ftp/pub/pwessel/release
+fi