From 99652e43589d97e2ea1e61ff7af0a0ea36417b7b Mon Sep 17 00:00:00 2001
From: Ingo Schwarze <schwarze@openbsd.org>
Date: Wed, 6 Mar 2019 15:58:10 +0000
Subject: mention Solaris BUGS in regress.pl(1)

---
 INSTALL              |  7 ++++---
 regress/regress.pl.1 | 22 ++++++++++++++++++++--
 2 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/INSTALL b/INSTALL
index 558574b9..3c09f3f2 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,4 +1,4 @@
-$Id: INSTALL,v 1.22 2018/07/31 15:34:00 schwarze Exp $
+$Id: INSTALL,v 1.23 2019/03/06 15:58:10 schwarze Exp $
 
 About the portable mandoc distribution
 --------------------------------------
@@ -18,7 +18,7 @@ tech@ mailing list, too.
 
 Enjoy using the mandoc toolset!
 
-Ingo Schwarze, Karlsruhe, August 2018
+Ingo Schwarze, Karlsruhe, March 2019
 
 
 Installation
@@ -67,7 +67,8 @@ variables into "configure.local" and go back to step 4.
 7. Optionally run the regression suite.
 Basically, that amounts to "cd regress && ./regress.pl".
 But you should probably look at "./mandoc -l regress/regress.pl.1"
-first.
+first.  In particular, regarding Solaris systems, look at the BUGS
+section of that manual page.
 
 8. Run "sudo make install".  If you intend to build a binary
 package using some kind of fake root mechanism, you may need a
diff --git a/regress/regress.pl.1 b/regress/regress.pl.1
index 6870b4cb..04a56912 100644
--- a/regress/regress.pl.1
+++ b/regress/regress.pl.1
@@ -1,4 +1,4 @@
-.\"	$Id: regress.pl.1,v 1.3 2017/07/18 18:47:06 schwarze Exp $
+.\"	$Id: regress.pl.1,v 1.4 2019/03/06 15:58:11 schwarze Exp $
 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: July 18 2017 $
+.Dd $Mdocdate: March 6 2019 $
 .Dt REGRESS.PL 1
 .Os
 .Sh NAME
@@ -145,3 +145,21 @@ The
 subdirectory of the regression suite is not included.
 It uses a Makefile structure that differs vastly from the
 rest of the suite.
+.Sh BUGS
+On Oracle Solaris 11,
+.Xr diff 1
+does not support the
+.Fl a
+option.
+Delete that option from the following line in this script:
+.Pp
+.Dl my @diff = qw(diff -au);
+.Pp
+The C library function
+.Xr wcwidth 3
+is known to be buggy on Solaris, which may cause failures in the
+regression suite, usually because output lines containing affected
+Unicode characters wrap too early.
+.Pp
+The regression suite does not work at all on Solaris 10 or earlier
+because the Perl interpreter provided with those systems is too old.
-- 
cgit v1.2.3-56-ge451