mandoc: mention Solaris BUGS in regress.pl(1)

mandoc: mention Solaris BUGS in regress.pl(1)

[schwarze]

Log Message:
-----------
mention Solaris BUGS in regress.pl(1)

Modified Files:
--------------
    mandoc:
        INSTALL
    mandoc/regress:
        regress.pl.1

Revision Data
-------------
Index: INSTALL
===================================================================
RCS file: /home/cvs/mandoc/mandoc/INSTALL,v
retrieving revision 1.22
retrieving revision 1.23
diff -LINSTALL -LINSTALL -u -p -r1.22 -r1.23
--- INSTALL
+++ 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 
 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
Index: regress.pl.1
===================================================================
RCS file: /home/cvs/mandoc/mandoc/regress/regress.pl.1,v
retrieving revision 1.3
retrieving revision 1.4
diff -Lregress/regress.pl.1 -Lregress/regress.pl.1 -u -p -r1.3 -r1.4
--- regress/regress.pl.1
+++ 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.
--
 To unsubscribe send an email to source+unsubscribe@mandoc.bsd.lv