From 176fcab8bf401e9b2f7fc6c37a7da6f9bef1f905 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Tue, 29 Jul 2025 20:01:28 +0200
Subject: [PATCH 01/28] Add first ideas for Technical Reference page for
 justification codes

---
 doc/techref/index.md               |  1 +
 doc/techref/justification_codes.md | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+)
 create mode 100755 doc/techref/justification_codes.md

diff --git a/doc/techref/index.md b/doc/techref/index.md
index 9d6367ac055..0380c229290 100644
--- a/doc/techref/index.md
+++ b/doc/techref/index.md
@@ -14,5 +14,6 @@ fonts.md
 text_formatting.md
 patterns.md
 encodings.md
+justification_codes.md
 environment_variables.md
 ```
diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
new file mode 100755
index 00000000000..5b0ea9655f3
--- /dev/null
+++ b/doc/techref/justification_codes.md
@@ -0,0 +1,22 @@
+Justification codes
+===================
+
+To adjust the position of plot embellishments, such as scalbars, directional roses,
+colorbars, legends, and images, user can adjust the *reference* and *anchor* points.
+
+Pass to `position` parameter and if already implemented `justify`.
+
+Reference point inside / outside of the map bounding box **j** / **J**.
+
+Anchor point **+j**.
+
+For both, specify a two-character (order independent) code. Choose from
+
+- Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
+- Horizontal: **L**\(eft), **C**\(entre), **R**\(ight)
+
+Besides **j** / **J**, the reference point can be set based on
+
+- **g**: Map coordinates as *longitude*\/\ *latitude*
+- **n**: Normalized bounding box coordinates as *nx*\/\ *ny*
+- **x**: Plot coordinates as *x*\/\ *y*

From 34d4409562b14bb6dfa84e59435852f89df630cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Tue, 29 Jul 2025 20:11:13 +0200
Subject: [PATCH 02/28] Remove execution permission

---
 doc/techref/justification_codes.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 mode change 100755 => 100644 doc/techref/justification_codes.md

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
old mode 100755
new mode 100644

From 9e493a257454b57be23a4f17ddfaacd6eeacbf63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Tue, 29 Jul 2025 21:59:16 +0200
Subject: [PATCH 03/28] Update

---
 doc/techref/justification_codes.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 5b0ea9655f3..58431711bd0 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -6,7 +6,8 @@ colorbars, legends, and images, user can adjust the *reference* and *anchor* poi
 
 Pass to `position` parameter and if already implemented `justify`.
 
-Reference point inside / outside of the map bounding box **j** / **J**.
+Reference point inside / outside of the map bounding box **j** (lower-case) / **J**
+(upper-case), respectively.
 
 Anchor point **+j**.
 
@@ -17,6 +18,6 @@ For both, specify a two-character (order independent) code. Choose from
 
 Besides **j** / **J**, the reference point can be set based on
 
-- **g**: Map coordinates as *longitude*\/\ *latitude*
-- **n**: Normalized bounding box coordinates as *nx*\/\ *ny*
-- **x**: Plot coordinates as *x*\/\ *y*
+- **g**: Map coordinates as *longitude*/*latitude*
+- **n**: Normalized bounding box coordinates as *nx*/*ny*
+- **x**: Plot coordinates as *x*/*y*

From 2a222cf1c2da32f8ecfedf9c7a5d6cc65e0b294d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 30 Jul 2025 11:54:45 +0200
Subject: [PATCH 04/28] Focus on two-letter codes

---
 doc/techref/justification_codes.md | 21 ++++-----------------
 1 file changed, 4 insertions(+), 17 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 58431711bd0..c21208f38b5 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -1,23 +1,10 @@
 Justification codes
 ===================
 
-To adjust the position of plot embellishments, such as scalbars, directional roses,
-colorbars, legends, and images, user can adjust the *reference* and *anchor* points.
-
-Pass to `position` parameter and if already implemented `justify`.
-
-Reference point inside / outside of the map bounding box **j** (lower-case) / **J**
-(upper-case), respectively.
-
-Anchor point **+j**.
-
-For both, specify a two-character (order independent) code. Choose from
+To adjust the position of plot embellishments, such as scalebars, directional roses,
+colorbars, legends, and images, user can adjust the *reference* and *anchor* points
+(see seperate TR page TODO). To set these points a two-character (order-independent)
+code is used. Choose from
 
 - Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
 - Horizontal: **L**\(eft), **C**\(entre), **R**\(ight)
-
-Besides **j** / **J**, the reference point can be set based on
-
-- **g**: Map coordinates as *longitude*/*latitude*
-- **n**: Normalized bounding box coordinates as *nx*/*ny*
-- **x**: Plot coordinates as *x*/*y*

From e591ac235ae1aff1c6feb310793eb26617b89234 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 30 Jul 2025 11:58:42 +0200
Subject: [PATCH 05/28] Adjust docs

---
 doc/techref/justification_codes.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index c21208f38b5..a94c6286d9d 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -2,9 +2,8 @@ Justification codes
 ===================
 
 To adjust the position of plot embellishments, such as scalebars, directional roses,
-colorbars, legends, and images, user can adjust the *reference* and *anchor* points
-(see seperate TR page TODO). To set these points a two-character (order-independent)
-code is used. Choose from
+colorbars, legends, and images, users can pass a two-character (order-independent)
+code. Choose from
 
 - Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
 - Horizontal: **L**\(eft), **C**\(entre), **R**\(ight)

From 80c34004fb56cdb501af638e230fb4197814aa4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 15:35:16 +0200
Subject: [PATCH 06/28] Add code for sektch to explain justification codes

---
 doc/techref/justification_codes.md | 93 +++++++++++++++++++++++++++++-
 1 file changed, 91 insertions(+), 2 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index a94c6286d9d..4a894628351 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -1,5 +1,8 @@
-Justification codes
-===================
+---
+file_format: mystnb
+---
+
+# Justification codes
 
 To adjust the position of plot embellishments, such as scalebars, directional roses,
 colorbars, legends, and images, users can pass a two-character (order-independent)
@@ -7,3 +10,89 @@ code. Choose from
 
 - Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
 - Horizontal: **L**\(eft), **C**\(entre), **R**\(ight)
+
+
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Script to generate sketches so visualize justification codes.
+"""
+import pygmt
+
+size = 5
+x = [-size, 0, size, size, size, 0, -size, -size, 0]
+y = [-size, -size, -size, 0, size, size, size, 0, 0]
+codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+
+
+# %%
+# -----------------------------------------------------------------------------
+fig = pygmt.Figure()
+fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
+
+fig.text(
+    font="15p,1,red",
+    x=x,
+    y=y,
+    text=codes,
+    justify=codes,
+    offset="j0.5c/0.5c+v2p,gray30",
+)
+
+fig.plot(x=x, y=y, style="c0.3c", fill="lightred", no_clip=True)
+
+fig.text(
+    font="15p",
+    offset="j0.5c/0.5c",
+    no_clip=True,
+    x=[size, size, size, -size, 0, size],
+    y=[size, 0, -size, size, size, size],
+    justify=["ML", "ML", "ML", "BC", "BC", "BC"],
+    text=[
+        "@%1%T@%%op", "@%1%M@%%iddle", "@%1%B@%%ottom", "@%1%L@%%eft",
+        "@%1%C@%%enter", "@%1%R@%%ight"
+    ],
+)
+
+fig.show(width=600)
+
+
+# %%
+# -----------------------------------------------------------------------------
+fig = pygmt.Figure()
+fig.basemap(projection="H10c", region="g", frame=0)
+
+for code in codes:
+    fig.text(
+        font="15p,1,red",
+        position=code,
+        justify=code,
+        text=code,
+        offset="j0.5c/0.5c+v2p,gray30",
+    )
+    fig.text(font="10p,lightred", position=code, justify="MC", text="●", no_clip=True)
+
+fig.show(width=600)
+
+
+# %%
+# -----------------------------------------------------------------------------
+fig = pygmt.Figure()
+fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
+
+fig.colorbar(cmap="navia", frame=0, position="jMC+w10c/2c+h")
+
+for code in codes:
+    fig.text(
+        font="10p,1,red",
+        position=code,
+        justify=code,
+        text=code,
+        offset="j0.3c/0.3c+v1p,gray30",
+    )
+fig.plot(x=x, y=y, style="c0.2c", fill="lightred", no_clip=True)
+
+fig.show(width=600)
+```

From e8e2441db094573d156e06d230e1de8fe222da10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 16:39:30 +0200
Subject: [PATCH 07/28] Split script

---
 doc/techref/justification_codes.md | 36 ++++++++++++++++++++++++------
 1 file changed, 29 insertions(+), 7 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 4a894628351..2ab23dad721 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -26,9 +26,6 @@ x = [-size, 0, size, size, size, 0, -size, -size, 0]
 y = [-size, -size, -size, 0, size, size, size, 0, 0]
 codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
 
-
-# %%
-# -----------------------------------------------------------------------------
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 
@@ -57,10 +54,22 @@ fig.text(
 )
 
 fig.show(width=600)
+```
+
+
+Non-rectangular geographic basemap:
 
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Script to generate sketches so visualize justification codes for a non-rectangular geographic basemap.
+"""
+import pygmt
+
+codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
 
-# %%
-# -----------------------------------------------------------------------------
 fig = pygmt.Figure()
 fig.basemap(projection="H10c", region="g", frame=0)
 
@@ -75,10 +84,23 @@ for code in codes:
     fig.text(font="10p,lightred", position=code, justify="MC", text="●", no_clip=True)
 
 fig.show(width=600)
+```
+
 
+Compasses, scalebars, legends, colorbars, text strings, etc. can also be abstracted by a rectangle.
+
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Script to generate sketches so visualize justification code for a colorbar.
+"""
+import pygmt
+
+size = 5
+codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
 
-# %%
-# -----------------------------------------------------------------------------
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
 

From 14234fc01d85e514901e6e52152996ecdc52a489 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 19:55:22 +0200
Subject: [PATCH 08/28] Add sketch for reference and anchor point

---
 doc/techref/justification_codes.md | 62 +++++++++++++++++++++++++++---
 1 file changed, 56 insertions(+), 6 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 2ab23dad721..e078cfa3d8c 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -30,7 +30,7 @@ fig = pygmt.Figure()
 fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 
 fig.text(
-    font="15p,1,red",
+    font="15p,1,black",
     x=x,
     y=y,
     text=codes,
@@ -38,7 +38,7 @@ fig.text(
     offset="j0.5c/0.5c+v2p,gray30",
 )
 
-fig.plot(x=x, y=y, style="c0.3c", fill="lightred", no_clip=True)
+fig.plot(x=x, y=y, style="c0.3c", fill="steelblue", no_clip=True)
 
 fig.text(
     font="15p",
@@ -75,13 +75,13 @@ fig.basemap(projection="H10c", region="g", frame=0)
 
 for code in codes:
     fig.text(
-        font="15p,1,red",
+        font="15p,1,black",
         position=code,
         justify=code,
         text=code,
         offset="j0.5c/0.5c+v2p,gray30",
     )
-    fig.text(font="10p,lightred", position=code, justify="MC", text="●", no_clip=True)
+    fig.text(font="10p,steelblue", position=code, justify="MC", text="●", no_clip=True)
 
 fig.show(width=600)
 ```
@@ -108,13 +108,63 @@ fig.colorbar(cmap="navia", frame=0, position="jMC+w10c/2c+h")
 
 for code in codes:
     fig.text(
-        font="10p,1,red",
+        font="10p,1,black",
         position=code,
         justify=code,
         text=code,
         offset="j0.3c/0.3c+v1p,gray30",
     )
-fig.plot(x=x, y=y, style="c0.2c", fill="lightred", no_clip=True)
+fig.plot(x=x, y=y, style="c0.2c", fill="steelblue", no_clip=True)
+
+fig.show(width=600)
+```
+
+
+Reference and anchor points:
+
+
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Reference and anchor points.
+"""
+import pygmt
+
+size = 5
+x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
+y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
+codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
+y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
+
+fig = pygmt.Figure()
+fig.basemap(projection="X12c/6c", region=[-size, size, -size, size], frame=0)
+
+fig.text(
+    text=codes,
+    x=x1,
+    y=y1,
+    justify=codes,
+    offset="j0.5c/0.25c+v1p,gray30",
+    font="10p,1,black",
+)
+
+fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
+
+fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
+fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
+
+fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
+fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
+
+fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
+fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
+fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
+
+fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
+fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
 
 fig.show(width=600)
 ```

From b119946218afab57300d4f6debe0849046d37454 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 19:59:44 +0200
Subject: [PATCH 09/28] Adjust cmap for better contrast

---
 doc/techref/justification_codes.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index e078cfa3d8c..b54907647f9 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -104,7 +104,7 @@ codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
 
-fig.colorbar(cmap="navia", frame=0, position="jMC+w10c/2c+h")
+fig.colorbar(cmap="acton", frame=0, position="jMC+w10c/2c+h")
 
 for code in codes:
     fig.text(
@@ -122,7 +122,6 @@ fig.show(width=600)
 
 Reference and anchor points:
 
-
 ```{code-cell}
 ---
 tags: [remove-input]

From 06fadaee1d5918f1da57563a1bfd9ad082f633bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 20:15:00 +0200
Subject: [PATCH 10/28] Adjust cmap for better contrast

---
 doc/techref/justification_codes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index b54907647f9..26b2fa92294 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -104,7 +104,7 @@ codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
 
-fig.colorbar(cmap="acton", frame=0, position="jMC+w10c/2c+h")
+fig.colorbar(cmap="hawaii", frame=0, position="jMC+w10c/2c+h")
 
 for code in codes:
     fig.text(

From 5bd36a3dd2171953862abd1846534f36a21e8ca3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 20:25:23 +0200
Subject: [PATCH 11/28] Adjust font size

---
 doc/techref/justification_codes.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 26b2fa92294..3be1aefcd9d 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -75,7 +75,7 @@ fig.basemap(projection="H10c", region="g", frame=0)
 
 for code in codes:
     fig.text(
-        font="15p,1,black",
+        font="10p,1,black",
         position=code,
         justify=code,
         text=code,
@@ -112,7 +112,7 @@ for code in codes:
         position=code,
         justify=code,
         text=code,
-        offset="j0.3c/0.3c+v1p,gray30",
+        offset="j0.3c/0.15c+v1p,gray30",
     )
 fig.plot(x=x, y=y, style="c0.2c", fill="steelblue", no_clip=True)
 
@@ -146,7 +146,7 @@ fig.text(
     x=x1,
     y=y1,
     justify=codes,
-    offset="j0.5c/0.25c+v1p,gray30",
+    offset="j0.5c/0.2c+v1p,gray30",
     font="10p,1,black",
 )
 

From 839054bdbfc01a5140567d0960c55790e11ef8c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 20:30:59 +0200
Subject: [PATCH 12/28] No equal offsets in x and y directions

---
 doc/techref/justification_codes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 3be1aefcd9d..189f4f644aa 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -139,7 +139,7 @@ x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
 y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
 
 fig = pygmt.Figure()
-fig.basemap(projection="X12c/6c", region=[-size, size, -size, size], frame=0)
+fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 
 fig.text(
     text=codes,

From 4267fe37778a1b1f4878a437ea00289fa47cd790 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Fri, 1 Aug 2025 20:40:00 +0200
Subject: [PATCH 13/28] Use consistent order in justification codes

---
 doc/techref/justification_codes.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 189f4f644aa..07dbdf90967 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -24,7 +24,7 @@ import pygmt
 size = 5
 x = [-size, 0, size, size, size, 0, -size, -size, 0]
 y = [-size, -size, -size, 0, size, size, size, 0, 0]
-codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
@@ -48,8 +48,8 @@ fig.text(
     y=[size, 0, -size, size, size, size],
     justify=["ML", "ML", "ML", "BC", "BC", "BC"],
     text=[
-        "@%1%T@%%op", "@%1%M@%%iddle", "@%1%B@%%ottom", "@%1%L@%%eft",
-        "@%1%C@%%enter", "@%1%R@%%ight"
+        "@%1%T@%%op", "@%1%M@%%iddle", "@%1%B@%%ottom",
+        "@%1%L@%%eft", "@%1%C@%%enter", "@%1%R@%%ight"
     ],
 )
 
@@ -68,7 +68,7 @@ Script to generate sketches so visualize justification codes for a non-rectangul
 """
 import pygmt
 
-codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 
 fig = pygmt.Figure()
 fig.basemap(projection="H10c", region="g", frame=0)
@@ -99,7 +99,7 @@ Script to generate sketches so visualize justification code for a colorbar.
 import pygmt
 
 size = 5
-codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
@@ -134,7 +134,7 @@ import pygmt
 size = 5
 x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
 y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
-codes =  ["BL","BC", "BR", "MR", "TR", "CT", "LT", "LM", "MC"]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
 y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
 

From b59e858c20e1ca538df9cc8177bbe61a2710e54c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Sat, 2 Aug 2025 14:53:49 +0200
Subject: [PATCH 14/28] Improve docs

---
 doc/techref/justification_codes.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 07dbdf90967..cf54b5eee07 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -17,7 +17,7 @@ code. Choose from
 tags: [remove-input]
 ---
 """
-Script to generate sketches so visualize justification codes.
+Script showing the justification codes used in GMT / PyGMT.
 """
 import pygmt
 
@@ -64,7 +64,7 @@ Non-rectangular geographic basemap:
 tags: [remove-input]
 ---
 """
-Script to generate sketches so visualize justification codes for a non-rectangular geographic basemap.
+Script showing justification codes for non-rectangular geographic basemaps.
 """
 import pygmt
 
@@ -94,7 +94,7 @@ Compasses, scalebars, legends, colorbars, text strings, etc. can also be abstrac
 tags: [remove-input]
 ---
 """
-Script to generate sketches so visualize justification code for a colorbar.
+Script showing justification codes for plot embellishments, e.g., a colorbar.
 """
 import pygmt
 
@@ -127,7 +127,7 @@ Reference and anchor points:
 tags: [remove-input]
 ---
 """
-Reference and anchor points.
+Script explaining reference and anchor points.
 """
 import pygmt
 

From 29e07bdd0a1bd3d927a8a94b8942774dc41cf0ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Sat, 2 Aug 2025 22:04:28 +0200
Subject: [PATCH 15/28] Try defining variables ones

---
 doc/techref/justification_codes.md | 40 +++++++++++-------------------
 1 file changed, 14 insertions(+), 26 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index cf54b5eee07..45ea17ffa8c 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -22,8 +22,10 @@ Script showing the justification codes used in GMT / PyGMT.
 import pygmt
 
 size = 5
-x = [-size, 0, size, size, size, 0, -size, -size, 0]
-y = [-size, -size, -size, 0, size, size, size, 0, 0]
+x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
+y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
+x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
+y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
 codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 
 fig = pygmt.Figure()
@@ -31,14 +33,14 @@ fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 
 fig.text(
     font="15p,1,black",
-    x=x,
-    y=y,
+    x=x1,
+    y=y1,
     text=codes,
     justify=codes,
     offset="j0.5c/0.5c+v2p,gray30",
 )
 
-fig.plot(x=x, y=y, style="c0.3c", fill="steelblue", no_clip=True)
+fig.plot(x=x1, y=y1, style="c0.3c", fill="steelblue", no_clip=True)
 
 fig.text(
     font="15p",
@@ -48,8 +50,12 @@ fig.text(
     y=[size, 0, -size, size, size, size],
     justify=["ML", "ML", "ML", "BC", "BC", "BC"],
     text=[
-        "@%1%T@%%op", "@%1%M@%%iddle", "@%1%B@%%ottom",
-        "@%1%L@%%eft", "@%1%C@%%enter", "@%1%R@%%ight"
+        "@%1%T@%%op",
+        "@%1%M@%%iddle",
+        "@%1%B@%%ottom",
+        "@%1%L@%%eft",
+        "@%1%C@%%enter",
+        "@%1%R@%%ight",
     ],
 )
 
@@ -66,10 +72,6 @@ tags: [remove-input]
 """
 Script showing justification codes for non-rectangular geographic basemaps.
 """
-import pygmt
-
-codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
-
 fig = pygmt.Figure()
 fig.basemap(projection="H10c", region="g", frame=0)
 
@@ -96,11 +98,6 @@ tags: [remove-input]
 """
 Script showing justification codes for plot embellishments, e.g., a colorbar.
 """
-import pygmt
-
-size = 5
-codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
-
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
 
@@ -114,7 +111,7 @@ for code in codes:
         text=code,
         offset="j0.3c/0.15c+v1p,gray30",
     )
-fig.plot(x=x, y=y, style="c0.2c", fill="steelblue", no_clip=True)
+fig.plot(x=x1, y=y1, style="c0.2c", fill="steelblue", no_clip=True)
 
 fig.show(width=600)
 ```
@@ -129,15 +126,6 @@ tags: [remove-input]
 """
 Script explaining reference and anchor points.
 """
-import pygmt
-
-size = 5
-x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
-y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
-codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
-x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
-y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
-
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 

From 0303e69bd28839bd666b03701e1a6570674fb211 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Mon, 4 Aug 2025 20:01:48 +0200
Subject: [PATCH 16/28] Add docs

---
 doc/techref/justification_codes.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 45ea17ffa8c..9820295c66e 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -11,6 +11,7 @@ code. Choose from
 - Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
 - Horizontal: **L**\(eft), **C**\(entre), **R**\(ight)
 
+The possible nine justification codes are visualized in the sketch below:
 
 ```{code-cell}
 ---
@@ -62,8 +63,8 @@ fig.text(
 fig.show(width=600)
 ```
 
-
-Non-rectangular geographic basemap:
+For a non-rectangular geographic basemap the justification codes refer to the plot or map
+bounding box:
 
 ```{code-cell}
 ---
@@ -89,7 +90,9 @@ fig.show(width=600)
 ```
 
 
-Compasses, scalebars, legends, colorbars, text strings, etc. can also be abstracted by a rectangle.
+Plot embellishments such as scalebars, directional roses, legends, colorbars as well
+as text strings can also be abstracted as rectangles. The justification codes are
+shown exemplary for a colorbar.
 
 ```{code-cell}
 ---

From e1656bbd54f040c52a193caca48ffc1bffff1955 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Mon, 4 Aug 2025 20:07:01 +0200
Subject: [PATCH 17/28] Move content for reference and anchor point to seperate
 file

---
 doc/techref/justification_codes.md     | 40 -----------------------
 doc/techref/reference_anchor_points.md | 44 ++++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 40 deletions(-)
 create mode 100755 doc/techref/reference_anchor_points.md

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 9820295c66e..0c286881256 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -118,43 +118,3 @@ fig.plot(x=x1, y=y1, style="c0.2c", fill="steelblue", no_clip=True)
 
 fig.show(width=600)
 ```
-
-
-Reference and anchor points:
-
-```{code-cell}
----
-tags: [remove-input]
----
-"""
-Script explaining reference and anchor points.
-"""
-fig = pygmt.Figure()
-fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
-
-fig.text(
-    text=codes,
-    x=x1,
-    y=y1,
-    justify=codes,
-    offset="j0.5c/0.2c+v1p,gray30",
-    font="10p,1,black",
-)
-
-fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
-
-fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
-fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
-
-fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
-fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
-
-fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
-fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
-fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
-
-fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
-fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
-
-fig.show(width=600)
-```
diff --git a/doc/techref/reference_anchor_points.md b/doc/techref/reference_anchor_points.md
new file mode 100755
index 00000000000..57e849b6bb8
--- /dev/null
+++ b/doc/techref/reference_anchor_points.md
@@ -0,0 +1,44 @@
+---
+file_format: mystnb
+---
+
+# Reference and anchor points
+
+xxx
+
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Script explaining reference and anchor points.
+"""
+fig = pygmt.Figure()
+fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
+
+fig.text(
+    text=codes,
+    x=x1,
+    y=y1,
+    justify=codes,
+    offset="j0.5c/0.2c+v1p,gray30",
+    font="10p,1,black",
+)
+
+fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
+
+fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
+fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
+
+fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
+fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
+
+fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
+fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
+fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
+
+fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
+fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
+
+fig.show(width=600)
+```

From c5cf5a8b82feccda32afd6342d3326f8f46b867d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Mon, 4 Aug 2025 20:07:56 +0200
Subject: [PATCH 18/28] Update index

---
 doc/techref/index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/techref/index.md b/doc/techref/index.md
index 0380c229290..ce8b504bb61 100644
--- a/doc/techref/index.md
+++ b/doc/techref/index.md
@@ -15,5 +15,6 @@ text_formatting.md
 patterns.md
 encodings.md
 justification_codes.md
+reference_anchor_points.md
 environment_variables.md
 ```

From b7076a7f50483094e128470cca9e63ac77168d07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Mon, 4 Aug 2025 20:14:08 +0200
Subject: [PATCH 19/28] Add import and variable definitions

---
 doc/techref/reference_anchor_points.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/techref/reference_anchor_points.md b/doc/techref/reference_anchor_points.md
index 57e849b6bb8..b9e01b9b96d 100755
--- a/doc/techref/reference_anchor_points.md
+++ b/doc/techref/reference_anchor_points.md
@@ -13,6 +13,15 @@ tags: [remove-input]
 """
 Script explaining reference and anchor points.
 """
+import pygmt
+
+size = 5
+x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
+y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
+x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
+y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
+
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
 

From 6bc33897ca25799b74d05169fcad88b4636a594c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 6 Aug 2025 19:50:51 +0200
Subject: [PATCH 20/28] Use Unix LF

---
 doc/techref/reference_anchor_points.md | 106 ++++++++++++-------------
 1 file changed, 53 insertions(+), 53 deletions(-)

diff --git a/doc/techref/reference_anchor_points.md b/doc/techref/reference_anchor_points.md
index b9e01b9b96d..c282f7155a6 100755
--- a/doc/techref/reference_anchor_points.md
+++ b/doc/techref/reference_anchor_points.md
@@ -1,53 +1,53 @@
----
-file_format: mystnb
----
-
-# Reference and anchor points
-
-xxx
-
-```{code-cell}
----
-tags: [remove-input]
----
-"""
-Script explaining reference and anchor points.
-"""
-import pygmt
-
-size = 5
-x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
-y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
-x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
-y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
-codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
-
-fig = pygmt.Figure()
-fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
-
-fig.text(
-    text=codes,
-    x=x1,
-    y=y1,
-    justify=codes,
-    offset="j0.5c/0.2c+v1p,gray30",
-    font="10p,1,black",
-)
-
-fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
-
-fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
-fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
-
-fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
-fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
-
-fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
-fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
-fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
-
-fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
-fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
-
-fig.show(width=600)
-```
+---
+file_format: mystnb
+---
+
+# Reference and anchor points
+
+xxx
+
+```{code-cell}
+---
+tags: [remove-input]
+---
+"""
+Script explaining reference and anchor points.
+"""
+import pygmt
+
+size = 5
+x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
+y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
+x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
+y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
+codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
+
+fig = pygmt.Figure()
+fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
+
+fig.text(
+    text=codes,
+    x=x1,
+    y=y1,
+    justify=codes,
+    offset="j0.5c/0.2c+v1p,gray30",
+    font="10p,1,black",
+)
+
+fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
+
+fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
+fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
+
+fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
+fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
+
+fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
+fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
+fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
+
+fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
+fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
+
+fig.show(width=600)
+```

From 0ce44f87300c5419862add3253a88c041e59f22c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 6 Aug 2025 19:55:24 +0200
Subject: [PATCH 21/28] Remove execution permission

---
 doc/techref/reference_anchor_points.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 mode change 100755 => 100644 doc/techref/reference_anchor_points.md

diff --git a/doc/techref/reference_anchor_points.md b/doc/techref/reference_anchor_points.md
old mode 100755
new mode 100644

From 786b014baa88e9c5ec205acfc96e026d347217eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Sun, 10 Aug 2025 12:02:49 +0200
Subject: [PATCH 22/28] Adjust colormap

---
 doc/techref/justification_codes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 0c286881256..807ee662008 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -104,7 +104,7 @@ Script showing justification codes for plot embellishments, e.g., a colorbar.
 fig = pygmt.Figure()
 fig.basemap(projection="X10c/2c", region=[-size, size, -size, size], frame=0)
 
-fig.colorbar(cmap="hawaii", frame=0, position="jMC+w10c/2c+h")
+fig.colorbar(cmap="buda", frame=0, position="jMC+w10c/2c+h")
 
 for code in codes:
     fig.text(

From 873a1ba09a93dbd84bd840dfb467b2cae567c749 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Sun, 10 Aug 2025 20:04:50 +0200
Subject: [PATCH 23/28] Remove reference anchor points content

---
 doc/techref/index.md                   |  1 -
 doc/techref/reference_anchor_points.md | 53 --------------------------
 2 files changed, 54 deletions(-)
 delete mode 100644 doc/techref/reference_anchor_points.md

diff --git a/doc/techref/index.md b/doc/techref/index.md
index ce8b504bb61..0380c229290 100644
--- a/doc/techref/index.md
+++ b/doc/techref/index.md
@@ -15,6 +15,5 @@ text_formatting.md
 patterns.md
 encodings.md
 justification_codes.md
-reference_anchor_points.md
 environment_variables.md
 ```
diff --git a/doc/techref/reference_anchor_points.md b/doc/techref/reference_anchor_points.md
deleted file mode 100644
index c282f7155a6..00000000000
--- a/doc/techref/reference_anchor_points.md
+++ /dev/null
@@ -1,53 +0,0 @@
----
-file_format: mystnb
----
-
-# Reference and anchor points
-
-xxx
-
-```{code-cell}
----
-tags: [remove-input]
----
-"""
-Script explaining reference and anchor points.
-"""
-import pygmt
-
-size = 5
-x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
-y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
-x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
-y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
-codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
-
-fig = pygmt.Figure()
-fig.basemap(projection="X10c/6c", region=[-size, size, -size, size], frame=0)
-
-fig.text(
-    text=codes,
-    x=x1,
-    y=y1,
-    justify=codes,
-    offset="j0.5c/0.2c+v1p,gray30",
-    font="10p,1,black",
-)
-
-fig.plot(x=x2[0:-1], y=y2[0:-1], fill="bisque")
-
-fig.plot(x=-size, y=size, style="s0.6c", fill="lightred", no_clip=True)
-fig.plot(x=x1, y=y1, style="c0.25c", fill="steelblue", no_clip=True)
-
-fig.plot(x=-3, y=1, style="s0.6c", fill="orange")
-fig.plot(x=x2, y=y2, style="c0.15c", fill="darkblue")
-
-fig.plot(x=[-5, -3], y=[5, 1], pen="0.5p,black")
-fig.plot(x=[-5, -3], y=[1, 1], pen="0.5p,black,2_2")
-fig.plot(x=[-3, -3], y=[1, 5], pen="0.5p,black,2_2")
-
-fig.text(x=-4, y=1, text="dx", offset="0c/0.2c")
-fig.text(x=-3, y=3, text="dy", offset="-0.2c/0c")
-
-fig.show(width=600)
-```

From 4233f320a8dd4482b2d74e46319684136647522a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 13 Aug 2025 21:09:38 +0200
Subject: [PATCH 24/28] Remove unneeded variables

---
 doc/techref/justification_codes.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index 807ee662008..f5152cb3f04 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -25,8 +25,6 @@ import pygmt
 size = 5
 x1 = [-size, 0, size, size, size, 0, -size, -size, 0]
 y1 = [-size, -size, -size, 0, size, size, size, 0, 0]
-x2 = [-3, -2, -1, -1, -1, -2, -3, -3, -2]
-y2 = [-1, -1, -1, 0, 1, 1, 1, 0, 0]
 codes = ["BL", "BC", "BR", "MR", "TR", "TC", "TL", "ML", "MC"]
 
 fig = pygmt.Figure()

From d827aec33f34a8ef4db1f09b322d95ef014f9e42 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 13 Aug 2025 21:13:13 +0200
Subject: [PATCH 25/28] Adjust docs

---
 doc/techref/justification_codes.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doc/techref/justification_codes.md b/doc/techref/justification_codes.md
index f5152cb3f04..284b716521c 100644
--- a/doc/techref/justification_codes.md
+++ b/doc/techref/justification_codes.md
@@ -5,7 +5,7 @@ file_format: mystnb
 # Justification codes
 
 To adjust the position of plot embellishments, such as scalebars, directional roses,
-colorbars, legends, and images, users can pass a two-character (order-independent)
+colorbars, legends, text, and images, users can pass a two-character (order-independent)
 code. Choose from
 
 - Vertical: **T**\(op), **M**\(iddle), **B**\(ottom)
@@ -61,7 +61,7 @@ fig.text(
 fig.show(width=600)
 ```
 
-For a non-rectangular geographic basemap the justification codes refer to the plot or map
+For a non-rectangular geographic basemap, the justification codes refer to the map
 bounding box:
 
 ```{code-cell}
@@ -88,8 +88,7 @@ fig.show(width=600)
 ```
 
 
-Plot embellishments such as scalebars, directional roses, legends, colorbars as well
-as text strings can also be abstracted as rectangles. The justification codes are
+Plot embellishments can be abstracted as rectangles. Here, the justification codes are
 shown exemplary for a colorbar.
 
 ```{code-cell}

From 04f7fccf3d2a83f7d43a8696eed5be3a82ebcc0b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 20 Aug 2025 10:45:48 +0200
Subject: [PATCH 26/28] TEST: list for alias needs at least two enteries

---
 pygmt/src/grdcut.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pygmt/src/grdcut.py b/pygmt/src/grdcut.py
index 0b8d2d766bc..2ebf5bb96e3 100644
--- a/pygmt/src/grdcut.py
+++ b/pygmt/src/grdcut.py
@@ -53,6 +53,7 @@ def grdcut(
 
     {aliases}
       - J = projection
+      - R = region
 
     Parameters
     ----------

From a39d10dbfa9295283777b4f4869306813e9033aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 20 Aug 2025 12:16:25 +0200
Subject: [PATCH 27/28] TEST: Revert

---
 pygmt/src/grdcut.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pygmt/src/grdcut.py b/pygmt/src/grdcut.py
index 2ebf5bb96e3..0b8d2d766bc 100644
--- a/pygmt/src/grdcut.py
+++ b/pygmt/src/grdcut.py
@@ -53,7 +53,6 @@ def grdcut(
 
     {aliases}
       - J = projection
-      - R = region
 
     Parameters
     ----------

From c1b9227b348258a48c2988dba6698857190f6030 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yvonne=20Fr=C3=B6hlich?= <yvonne.froehlich@kit.edu>
Date: Wed, 20 Aug 2025 12:17:34 +0200
Subject: [PATCH 28/28] TEST: Copy list from coast method

---
 pygmt/src/grdcut.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pygmt/src/grdcut.py b/pygmt/src/grdcut.py
index 0b8d2d766bc..7428b616624 100644
--- a/pygmt/src/grdcut.py
+++ b/pygmt/src/grdcut.py
@@ -52,7 +52,7 @@ def grdcut(
     Full GMT docs at :gmt-docs:`grdcut.html`.
 
     {aliases}
-      - J = projection
+       - J = projection
 
     Parameters
     ----------