From b5399bc8fa63b1fbed69850da98dc5eb8fad97d6 Mon Sep 17 00:00:00 2001
From: Jeremy Baxter <jeremy@baxters.nz>
Date: Tue, 18 Jun 2024 19:24:59 +1200
Subject: [PATCH] esv.1: document passage line length detection

---
 esv.1 | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/esv.1 b/esv.1
index 64acc1c..6798f2a 100644
--- a/esv.1
+++ b/esv.1
@@ -1,4 +1,4 @@
-.Dd $Mdocdate: June 17 2024 $
+.Dd $Mdocdate: June 18 2024 $
 .Dt ESV 1
 .Os
 .Sh NAME
@@ -67,11 +67,27 @@ Exclude headings.
 .It Fl h
 Include headings (the default).
 .It Fl l Ar length
-Limit the width of text passage lines at
+Limit the length of lines in passages at
 .Ar length
 characters. If
 .Ar length
-is 0, do not limit them at all.
+is 0, do not set a limit on line length.
+.Pp
+If this option is not given,
+the line length limit will fall back on the value provided in
+the configuration file;
+see
+.Xr esv.conf 5 .
+.Pp
+If there is no value present in the configuration file,
+.Nm
+will get the width of the terminal,
+and will use this as the line length limit,
+unless the terminal's width is greater than 78,
+in which case the line length limit will be set to 78.
+This heuristic exists for readability purposes,
+and you can always override it by specifying your preference in
+.Xr esv.conf 5 .
 .It Fl N
 Exclude verse numbers.
 .It Fl n