mention Solaris BUGS in regress.pl(1)

2 files changed, 21 insertions, 2 deletions

diff --git a/INSTALL b/INSTALL
index 5f75342d..2f353aeb 100644
--- a/INSTALL
+++ b/INSTALL
@@ -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 33c89a1a..3777ec49 100644
--- a/regress/regress.pl.1
+++ b/regress/regress.pl.1
@@ -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.