From 816efa700784986fc8ec056f45fbfa1576fdbc84 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 15 Mar 2023 15:32:10 +0100
Subject: [PATCH 01/21] Add gallery example to show usage of dcw parameter in
 Figure.coast

---
 examples/gallery/maps/country_polygons.py | 36 +++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 examples/gallery/maps/country_polygons.py

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
new file mode 100644
index 00000000000..a1b14c6fca3
--- /dev/null
+++ b/examples/gallery/maps/country_polygons.py
@@ -0,0 +1,36 @@
+"""
+Highlight country polygons
+--------------------------
+The :meth:`pygmt.Figure.coast` method allows to 
+highlight country polygons via the ``dcw`` 
+parameter.
+"""
+
+# sphinx_gallery_thumbnail_number = 2
+
+
+import pygmt
+
+fig = pygmt.Figure()
+
+fig.basemap(region=[-12, 32, 34, 62],
+          projection="M6c") 
+    
+fig.coast(land="gray",
+          water="white",
+          dcw=["GB+gseagreen", "IT+p0.75p,red3", "ES+p0.75p,magenta4,-",
+              "RO+p1p,black,.", "DE+gorange+p1p,dodgerblue4"],   
+         )
+fig.show()
+
+###############################################################################
+# To highlight continents instead of single countries ...
+
+fig = pygmt.Figure()
+
+
+fig.coast(region="d", projection="H10c", land="gray", water="white", frame="afg",
+         dcw=["=EU+gseagreen", "=AF+gred3", "=NA+gmagenta4",
+              "=SA+gorange", "=AS+gdodgerblue4", "=OC+gtomato", "=AN+ggray30"])   
+
+fig.show()

From 9d323f533a9c03b9f2d6c30642478148be7997ac Mon Sep 17 00:00:00 2001
From: actions-bot <58130806+actions-bot@users.noreply.github.com>
Date: Wed, 15 Mar 2023 14:34:09 +0000
Subject: [PATCH 02/21] [format-command] fixes

---
 examples/gallery/maps/country_polygons.py | 40 ++++++++++++++++-------
 1 file changed, 29 insertions(+), 11 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a1b14c6fca3..be77dcce374 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -13,14 +13,19 @@
 
 fig = pygmt.Figure()
 
-fig.basemap(region=[-12, 32, 34, 62],
-          projection="M6c") 
-    
-fig.coast(land="gray",
-          water="white",
-          dcw=["GB+gseagreen", "IT+p0.75p,red3", "ES+p0.75p,magenta4,-",
-              "RO+p1p,black,.", "DE+gorange+p1p,dodgerblue4"],   
-         )
+fig.basemap(region=[-12, 32, 34, 62], projection="M6c")
+
+fig.coast(
+    land="gray",
+    water="white",
+    dcw=[
+        "GB+gseagreen",
+        "IT+p0.75p,red3",
+        "ES+p0.75p,magenta4,-",
+        "RO+p1p,black,.",
+        "DE+gorange+p1p,dodgerblue4",
+    ],
+)
 fig.show()
 
 ###############################################################################
@@ -29,8 +34,21 @@
 fig = pygmt.Figure()
 
 
-fig.coast(region="d", projection="H10c", land="gray", water="white", frame="afg",
-         dcw=["=EU+gseagreen", "=AF+gred3", "=NA+gmagenta4",
-              "=SA+gorange", "=AS+gdodgerblue4", "=OC+gtomato", "=AN+ggray30"])   
+fig.coast(
+    region="d",
+    projection="H10c",
+    land="gray",
+    water="white",
+    frame="afg",
+    dcw=[
+        "=EU+gseagreen",
+        "=AF+gred3",
+        "=NA+gmagenta4",
+        "=SA+gorange",
+        "=AS+gdodgerblue4",
+        "=OC+gtomato",
+        "=AN+ggray30",
+    ],
+)
 
 fig.show()

From 732e8f9cb90710181826aa1de35066688aee1a69 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 15 Mar 2023 15:36:02 +0100
Subject: [PATCH 03/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index be77dcce374..3a95eb2933f 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,8 +1,8 @@
 """
 Highlight country polygons
 --------------------------
-The :meth:`pygmt.Figure.coast` method allows to 
-highlight country polygons via the ``dcw`` 
+The :meth:`pygmt.Figure.coast` method allows to
+highlight country polygons via the ``dcw``
 parameter.
 """
 

From fc7233295e45e4c4dd0ee9253524b435b6d9a44d Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Mon, 1 May 2023 19:06:44 +0200
Subject: [PATCH 04/21] Apply suggestions from code review

Co-authored-by: Will Schlitzer <schlitzer90@gmail.com>
---
 examples/gallery/maps/country_polygons.py | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 3a95eb2933f..a8882e7a93b 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,9 +1,10 @@
 """
 Highlight country polygons
 --------------------------
-The :meth:`pygmt.Figure.coast` method allows to
+The :meth:`pygmt.Figure.coast` method can
 highlight country polygons via the ``dcw``
-parameter.
+parameter. It accepts the country code, and 
+can draw its borders and add a color to its landmass.
 """
 
 # sphinx_gallery_thumbnail_number = 2
@@ -19,17 +20,23 @@
     land="gray",
     water="white",
     dcw=[
+        # Great Britain with seagrean land
         "GB+gseagreen",
+        # Italy with a red border
         "IT+p0.75p,red3",
+        # Spain with a magenta dashed border
         "ES+p0.75p,magenta4,-",
+        # Romania with a black dotted border
         "RO+p1p,black,.",
+        # Germany with orange land and a blue border
         "DE+gorange+p1p,dodgerblue4",
     ],
 )
 fig.show()
 
 ###############################################################################
-# To highlight continents instead of single countries ...
+# Entire continents can also be highlighted by adding "=" in 
+front of the continent code to differentiate it from a country code.
 
 fig = pygmt.Figure()
 
@@ -41,12 +48,19 @@
     water="white",
     frame="afg",
     dcw=[
+        # Europe
         "=EU+gseagreen",
+        # Africa
         "=AF+gred3",
+        # North America
         "=NA+gmagenta4",
+        # South America
         "=SA+gorange",
+        # Asia
         "=AS+gdodgerblue4",
+        # Oceania
         "=OC+gtomato",
+        # Antarctica
         "=AN+ggray30",
     ],
 )

From 347b86909c021327d6a7e0a3b2b51f0b50176692 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Fri, 5 May 2023 08:47:59 +0200
Subject: [PATCH 05/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a8882e7a93b..f1becca7e79 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,6 +1,6 @@
 """
-Highlight country polygons
---------------------------
+Highlight country and continent polygons
+----------------------------------------
 The :meth:`pygmt.Figure.coast` method can
 highlight country polygons via the ``dcw``
 parameter. It accepts the country code, and 
@@ -36,7 +36,7 @@
 
 ###############################################################################
 # Entire continents can also be highlighted by adding "=" in 
-front of the continent code to differentiate it from a country code.
+# front of the continent code to differentiate it from a country code.
 
 fig = pygmt.Figure()
 

From a82b0b16bb4b54c5bcab6cd262887c1231ccc823 Mon Sep 17 00:00:00 2001
From: actions-bot <58130806+actions-bot@users.noreply.github.com>
Date: Fri, 5 May 2023 06:53:20 +0000
Subject: [PATCH 06/21] [format-command] fixes

---
 examples/gallery/maps/country_polygons.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index f1becca7e79..2846ad1b99a 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -35,7 +35,7 @@
 fig.show()
 
 ###############################################################################
-# Entire continents can also be highlighted by adding "=" in 
+# Entire continents can also be highlighted by adding "=" in
 # front of the continent code to differentiate it from a country code.
 
 fig = pygmt.Figure()

From 2c89ed01b888e8aa2941588f4fcc2d9f14ad933a Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Fri, 5 May 2023 08:57:51 +0200
Subject: [PATCH 07/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 2846ad1b99a..22ade7a87f6 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -3,7 +3,7 @@
 ----------------------------------------
 The :meth:`pygmt.Figure.coast` method can
 highlight country polygons via the ``dcw``
-parameter. It accepts the country code, and 
+parameter. It accepts the country code, and
 can draw its borders and add a color to its landmass.
 """
 

From 28780febb62b4859a1be1afb3f4d64fabf43e2e0 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Fri, 5 May 2023 09:36:02 +0200
Subject: [PATCH 08/21] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>
---
 examples/gallery/maps/country_polygons.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 22ade7a87f6..a7ab4f2de68 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -14,7 +14,11 @@
 
 fig = pygmt.Figure()
 
-fig.basemap(region=[-12, 32, 34, 62], projection="M6c")
+fig.basemap(
+    region=[-12, 32, 34, 62],
+    projection="M6c",
+    frame=True,
+)
 
 fig.coast(
     land="gray",
@@ -35,12 +39,11 @@
 fig.show()
 
 ###############################################################################
-# Entire continents can also be highlighted by adding "=" in
+# Entire continents can also be highlighted by adding ``"="`` in
 # front of the continent code to differentiate it from a country code.
 
 fig = pygmt.Figure()
 
-
 fig.coast(
     region="d",
     projection="H10c",

From 6d84c00dc07f8babd5bc8c717529b7ca2620c821 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 9 Aug 2023 09:49:52 +0200
Subject: [PATCH 09/21] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>
---
 examples/gallery/maps/country_polygons.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a7ab4f2de68..c79c6b4e30c 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -36,6 +36,7 @@
         "DE+gorange+p1p,dodgerblue4",
     ],
 )
+
 fig.show()
 
 ###############################################################################

From 9aaa6c62e58c561eaca84460dfbc381188b5f560 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Fri, 25 Aug 2023 10:16:34 +0200
Subject: [PATCH 10/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index c79c6b4e30c..ddf6190d919 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -70,3 +70,25 @@
 )
 
 fig.show()
+
+###############################################################################
+# If available, states/territories of a country can be highlighted, too.
+
+fig = pygmt.Figure()
+
+fig.coast(
+    region=[-130, -70, 24, 52],
+    projection="L-100/35/33/45/12c",
+    land="gray",
+    shorelines="1/0.5p",
+    borders=["1/0.8p,black", "2/0.2p,black"],
+    frame=True,
+    dcw=[
+        # Texas with orange fill
+        "US.TX+gorange",
+        # Kentucky with blue outline
+        "US.KY+p1p,blue",
+    ],
+)
+
+fig.show()

From 0bc785b2790d7c915262126354e3fa6c2fbf0ef6 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Sat, 26 Aug 2023 16:40:57 +0200
Subject: [PATCH 11/21] Update examples/gallery/maps/country_polygons.py
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>
---
 examples/gallery/maps/country_polygons.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index ddf6190d919..a0ada7b4c5d 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -80,8 +80,8 @@
     region=[-130, -70, 24, 52],
     projection="L-100/35/33/45/12c",
     land="gray",
-    shorelines="1/0.5p",
-    borders=["1/0.8p,black", "2/0.2p,black"],
+    shorelines="1/0.5p,gray30",
+    borders=["1/0.8p,gray30", "2/0.2p,gray30"],
     frame=True,
     dcw=[
         # Texas with orange fill

From 5ec5d24ddd697ed884489f0f66a82c68cd6103df Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Tue, 29 Aug 2023 09:25:01 +0200
Subject: [PATCH 12/21] add full country name examples

---
 examples/gallery/maps/country_polygons.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a0ada7b4c5d..8d74b57f097 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -3,8 +3,12 @@
 ----------------------------------------
 The :meth:`pygmt.Figure.coast` method can
 highlight country polygons via the ``dcw``
-parameter. It accepts the country code, and
-can draw its borders and add a color to its landmass.
+parameter. It accepts the country code or
+full country name and can draw its borders 
+and add a color to its landmass. It's also
+possible to define multiple countries at 
+once by separating the indiviudal names 
+with commas.
 """
 
 # sphinx_gallery_thumbnail_number = 2
@@ -24,7 +28,7 @@
     land="gray",
     water="white",
     dcw=[
-        # Great Britain with seagrean land
+        # Great Britain (country code) with seagrean land
         "GB+gseagreen",
         # Italy with a red border
         "IT+p0.75p,red3",
@@ -34,6 +38,11 @@
         "RO+p1p,black,.",
         # Germany with orange land and a blue border
         "DE+gorange+p1p,dodgerblue4",
+        # France (full country name) with a steelblue border
+        "France+p1p,steelblue",
+        # Norway, Sweden and Finland (multiple countries) with pink 
+        # land and pink3 borders
+        "Norway,Sweden,Finland+gpink+p0.2p,pink3",
     ],
 )
 

From 6031018d5840f3f16134c5192cd206a7cc9bfe6d Mon Sep 17 00:00:00 2001
From: actions-bot <58130806+actions-bot@users.noreply.github.com>
Date: Tue, 29 Aug 2023 07:28:57 +0000
Subject: [PATCH 13/21] [format-command] fixes

---
 examples/gallery/maps/country_polygons.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 8d74b57f097..9834f115099 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -40,7 +40,7 @@
         "DE+gorange+p1p,dodgerblue4",
         # France (full country name) with a steelblue border
         "France+p1p,steelblue",
-        # Norway, Sweden and Finland (multiple countries) with pink 
+        # Norway, Sweden and Finland (multiple countries) with pink
         # land and pink3 borders
         "Norway,Sweden,Finland+gpink+p0.2p,pink3",
     ],

From 3f1b3b538f9b05c75e434a28700a18b2d17cab83 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Tue, 29 Aug 2023 09:31:01 +0200
Subject: [PATCH 14/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 9834f115099..367f4d7834c 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -6,8 +6,8 @@
 parameter. It accepts the country code or
 full country name and can draw its borders 
 and add a color to its landmass. It's also
-possible to define multiple countries at 
-once by separating the indiviudal names 
+possible to define multiple countries at
+once by separating the indiviudal names
 with commas.
 """
 

From 50ecea397ae2b18ffe14c1db828a61c6c1f0e12e Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Tue, 29 Aug 2023 10:08:11 +0200
Subject: [PATCH 15/21] remove tw

---
 examples/gallery/maps/country_polygons.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 367f4d7834c..48f436c74f9 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -4,7 +4,7 @@
 The :meth:`pygmt.Figure.coast` method can
 highlight country polygons via the ``dcw``
 parameter. It accepts the country code or
-full country name and can draw its borders 
+full country name and can draw its borders
 and add a color to its landmass. It's also
 possible to define multiple countries at
 once by separating the indiviudal names

From 10beaa4ec7abd898ac36486b6b043174b2c2e053 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Tue, 29 Aug 2023 12:22:53 +0200
Subject: [PATCH 16/21] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Yvonne Fröhlich <94163266+yvonnefroehlich@users.noreply.github.com>
---
 examples/gallery/maps/country_polygons.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index 48f436c74f9..a8a2e3330cc 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -18,15 +18,12 @@
 
 fig = pygmt.Figure()
 
-fig.basemap(
-    region=[-12, 32, 34, 62],
-    projection="M6c",
-    frame=True,
-)
-
 fig.coast(
+    region=[-12, 32, 34, 72],
+    projection="M6c",
     land="gray",
     water="white",
+    frame=True,
     dcw=[
         # Great Britain (country code) with seagrean land
         "GB+gseagreen",

From ee8105bec950f0a3a66a070e3373fca7d2309231 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 30 Aug 2023 08:22:38 +0200
Subject: [PATCH 17/21] Apply suggestions from code review

Co-authored-by: Wei Ji <23487320+weiji14@users.noreply.github.com>
---
 examples/gallery/maps/country_polygons.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a8a2e3330cc..c8e82c91ddc 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -20,10 +20,11 @@
 
 fig.coast(
     region=[-12, 32, 34, 72],
-    projection="M6c",
+    # Lambert Azimuthal Equal Area lon0/lat0/horizon/width
+    projection="A10/52/25/6c",
     land="gray",
     water="white",
-    frame=True,
+    frame="afg",
     dcw=[
         # Great Britain (country code) with seagrean land
         "GB+gseagreen",

From c965eb84c454a273759c8fcabd587d398e117953 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 30 Aug 2023 08:24:22 +0200
Subject: [PATCH 18/21] shorten file length

---
 examples/gallery/maps/country_polygons.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index c8e82c91ddc..ed72fdd1663 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,14 +1,11 @@
 """
 Highlight country and continent polygons
 ----------------------------------------
-The :meth:`pygmt.Figure.coast` method can
-highlight country polygons via the ``dcw``
-parameter. It accepts the country code or
-full country name and can draw its borders
-and add a color to its landmass. It's also
-possible to define multiple countries at
-once by separating the indiviudal names
-with commas.
+The :meth:`pygmt.Figure.coast` method can highlight country polygons 
+via the ``dcw`` parameter. It accepts the country code or full 
+country name and can draw its borders and add a color to its landmass. 
+It's also possible to define multiple countries at once by separating 
+the indiviudal names with commas.
 """
 
 # sphinx_gallery_thumbnail_number = 2

From 0318459cadc89c7a2ecbb122c4adf6af4402fc39 Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 30 Aug 2023 08:25:06 +0200
Subject: [PATCH 19/21] Update country_polygons.py

---
 examples/gallery/maps/country_polygons.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index ed72fdd1663..af329ceeeb8 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,10 +1,10 @@
 """
 Highlight country and continent polygons
 ----------------------------------------
-The :meth:`pygmt.Figure.coast` method can highlight country polygons 
-via the ``dcw`` parameter. It accepts the country code or full 
-country name and can draw its borders and add a color to its landmass. 
-It's also possible to define multiple countries at once by separating 
+The :meth:`pygmt.Figure.coast` method can highlight country polygons
+via the ``dcw`` parameter. It accepts the country code or full
+country name and can draw its borders and add a color to its landmass.
+It's also possible to define multiple countries at once by separating
 the indiviudal names with commas.
 """
 

From d24d0f839473cbd0a9b799613a4e9e353048c57a Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Wed, 30 Aug 2023 08:50:47 +0200
Subject: [PATCH 20/21] Add "state" to title

Added also "state" to the title since now we're showing 3 different use-cases.
---
 examples/gallery/maps/country_polygons.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index af329ceeeb8..a8d5bea0e20 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -1,6 +1,6 @@
 """
-Highlight country and continent polygons
-----------------------------------------
+Highlight country, continent and state polygons
+-----------------------------------------------
 The :meth:`pygmt.Figure.coast` method can highlight country polygons
 via the ``dcw`` parameter. It accepts the country code or full
 country name and can draw its borders and add a color to its landmass.
@@ -8,7 +8,7 @@
 the indiviudal names with commas.
 """
 
-# sphinx_gallery_thumbnail_number = 2
+# sphinx_gallery_thumbnail_number = 1
 
 
 import pygmt

From c7003faac3d325d8336b4d0776ffc6ea852fe13c Mon Sep 17 00:00:00 2001
From: Michael Grund <23025878+michaelgrund@users.noreply.github.com>
Date: Thu, 31 Aug 2023 09:13:19 +0200
Subject: [PATCH 21/21] use thinner linewidth

---
 examples/gallery/maps/country_polygons.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/examples/gallery/maps/country_polygons.py b/examples/gallery/maps/country_polygons.py
index a8d5bea0e20..2437cff0fd4 100644
--- a/examples/gallery/maps/country_polygons.py
+++ b/examples/gallery/maps/country_polygons.py
@@ -26,15 +26,15 @@
         # Great Britain (country code) with seagrean land
         "GB+gseagreen",
         # Italy with a red border
-        "IT+p0.75p,red3",
+        "IT+p0.5p,red3",
         # Spain with a magenta dashed border
-        "ES+p0.75p,magenta4,-",
+        "ES+p0.5p,magenta4,-",
         # Romania with a black dotted border
-        "RO+p1p,black,.",
+        "RO+p0.75p,black,.",
         # Germany with orange land and a blue border
-        "DE+gorange+p1p,dodgerblue4",
+        "DE+gorange+p0.5p,dodgerblue4",
         # France (full country name) with a steelblue border
-        "France+p1p,steelblue",
+        "France+p0.5p,steelblue",
         # Norway, Sweden and Finland (multiple countries) with pink
         # land and pink3 borders
         "Norway,Sweden,Finland+gpink+p0.2p,pink3",