From a289f16d666a167abba490586ba5bf88f2e47602 Mon Sep 17 00:00:00 2001
From: Jaro <jaro@argonaut-constellation.org>
Date: Wed, 17 May 2023 07:07:24 +0200
Subject: [PATCH] Describe manual testing of pagination.

---
 CHANGELOG.md |  3 +++
 TESTING.md   | 49 ++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 51 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b8c8907..b24275f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,9 @@
 
 ## 1.0.0.1 -- TBD
 
+* Added another test with "shaped runs" format to allow manual testing of
+  pagination.
+
 ## 1.0.0.0 -- 2023-05-15
 
 * Added new `Data.Text.ParagraphLayout.Rich` interface to support rich text.
diff --git a/TESTING.md b/TESTING.md
index 5d35442..0661919 100644
--- a/TESTING.md
+++ b/TESTING.md
@@ -36,7 +36,7 @@ Steps:
         and checking the file's modification time.
 
 
-## Script 2: Verify visual output
+## Script 2: Verify visual output for a whole paragraph
 
 Goals:
 
@@ -103,3 +103,50 @@ Steps:
       h. The vertical space between the baselines of two adjacent lines
          appears equal.
 
+      i. The text begins at the top of the window, with only a small amount
+         of blank space below the top of the window that is not large enough to
+         insert another line of text.
+
+## Script 3: Verify visual output for pagination
+
+Goals:
+
+  - To identify possible visual problems created by Balkón splitting up
+    a paragraph into pages.
+
+Prerequisites:
+
+  - Access to files from the Git repository of Balkón.
+
+  - Successfully built Typograffiti.
+    See previous script.
+
+  - Successfully verified visual output for a whole paragraph.
+    See previous script.
+
+Steps:
+
+  1. Run Typograffiti with the font path, face index, pixel size,
+     and scale set according to the contents of the file
+     `.golden/shapedRuns/spannedLoremIpsum20emPage3.fontInfo` from Balkón,
+     and with input set to be read from the file
+     `.golden/shapedRuns/spannedLoremIpsum20emPage3.golden` from Balkón.
+
+  2. Verify that text is displayed in the output window.
+
+  3. If necessary, resize the window so that the whole paragraph can be seen.
+
+  4. Verify all of the following:
+
+      a. There are three lines of text displayed.
+
+      b. These three lines look exactly the same as lines 7 through 9
+         of the paragraph from the previous script.
+
+      c. All displayed lines are aligned to the left edge of the output,
+         without any indentation.
+
+      d. The text begins at the top of the window, with only a small amount
+         of blank space below the top of the window that is not large enough to
+         insert another line of text.
+
-- 
2.30.2