From 5e0825726fb2f36dd55e946e7b8714b244f2c172 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Fri, 25 Sep 2020 19:13:04 +1000
Subject: doc/ms.ms: Fix warnings.

warning: file 'stdin', around line 287:
  table wider than line width
warning: file 'stdin', around line 278:
  table squeezed horizontally to fit line length
warning: file 'stdin', around line 532:
  table wider than line width
warning: file 'stdin', around line 532:
  column separation set to zero
troff: stdin:807: warning [p 8, 6.7i, div '3tbd2,1', 0.7i]: cannot adjust line

* Simplify table formats, expanding only one column (the one that needs
  it).  Left-adjust column headings since the table will take up the
  page width anyway.

* Use a different hack to force tagged paragraph bodies to the next line
  even when the tag is short enough for both it and the first body line
  to fit.  I chose \h'$INDENT_ARGUMENT_TO_IP' over the existing \p,
  which produces unavoidable adjustment warnings.  (That is, you can
  _suppress_ the warning by simply not enabling "break" warnings in the
  first place, but there seems to be no way here to use \p without
  _causing_ the warning.)

  My \h solution would be a shooting offense in a man(7) document but
  this is Sparta^Wms(7).  Feedback welcome on more idiomatic ways to
  contrive the desired effect; my ms-fu is not the best.

The document produces ms.ps quiescently now.
---
 doc/ms.ms | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

(limited to 'doc')

diff --git a/doc/ms.ms b/doc/ms.ms
index ff21b7f43..6e839cf36 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -272,9 +272,9 @@ Cover page macros
 Use the following macros to create a cover page for your document
 in the order shown.
 .TS H
-box expand;
-cb cb
-afCWw(1i) lw(5i) .
+box;
+lb lb
+lf(CR) lx.
 Macro	Description
 _
 .TH
@@ -517,9 +517,9 @@ The
 macros provide a variety of methods to highlight
 or emphasize text:
 .TS H
-box expand;
-cb cb
-afCWw(1.6i) Aw(4.4i) .
+box;
+lb lb
+lf(CR) lx.
 Macro	Description
 _
 .TH
@@ -792,8 +792,8 @@ T{
 A glossary-style list:
 \&.IP lawyers 0.4i
 Two or more attorneys.
-\&.IP guns
-\\p Firearms, preferably
+\&.IP guns\[rs]h\[aq]0.4i\[aq]
+Firearms, preferably
 large-caliber.
 \&.IP money
 Gotta pay for those
@@ -803,8 +803,8 @@ T}	T{
 A glossary-style list:
 .IP lawyers 0.4i
 Two or more attorneys.
-.IP guns
-\p Firearms, preferably large-caliber.
+.IP guns\h'0.4i'
+Firearms, preferably large-caliber.
 .IP money
 Gotta pay for those lawyers and guns!
 T}
-- 
cgit v1.2.1