Add README.uts from Hal Morris.

p4raw-id: //depot/perl@11324

Author: jhi

MANIFEST

@@ -1821,6 +1821,7 @@ README.qnx		Notes about QNX port
 README.solaris		Notes about Solaris port
 README.threads		Notes about multithreading
 README.tru64		Notes about Tru64
+README.uts		Notes about UTS
 README.vmesa		Notes about VM/ESA port
 README.vms		Notes about installing the VMS port
 README.vos		Notes about Stratus VOS port

README.uts

@@ -0,0 +1,107 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see perlpod manpage) which is
+specially designed to be readable as is.
+
+=head1 NAME
+
+perluts - Perl under UTS
+
+=head1 SYNOPSIS
+
+This document can be read I<as is>: as F<README.uts>, or you
+can read it after you build your package using "man perluts".
+
+The purpose is to help you build Perl for UTS, which, if you
+follow these instructions, should be easy, and result in
+a solidly working installation.
+
+=head1 DESCRIPTION
+
+Perl 5.7.2 (Developmental) or Perl 5.8.x (forthcoming) for UTS
+
+=head1 BUILDING PERL ON UTS
+
+NOTE: Some sites have redefined the way uname works, and if yours
+does this, special steps must be taken so that Configure can
+recognize your system as a UTS system.  To see if you are in
+this category, issue the command "uname -a".  It should look
+something like:
+
+  uts juno 4 4.4 9672 370
+
+At any rate, the first field should be "uts".  If this is not
+the case; supposing it is, say telcoUTS, create a script, uts/uname
+(i.e. uname, in the subdirectory "uts" of the main Perl source dir):
+   # uname
+   /usr/bin/uname "$@" | sed -e 's/^telcoUTS/uts/'
+
+and when you execute Configure, do it as below, except for adding
+PATH=uts:$PATH as a prefix.  I.e. do:
+
+   PATH=uts:$PATH ./Configure ...
+
+There is no need to do an interactive configure, just type
+
+  ./Configure -de [-Dusedevel] [-Doptimize=-g ] 2>&1 | tee Conf.out
+
+"-Dusedevel" may be required to configure Perl 5.7.2 non-interactively.
+Use -Doptimize=-g if you want to run Perl under sdb or gdb, OR
+if you want to be able to use the -D command line flags to perl,
+which are occasionally useful in debugging perl scripts.
+
+In this and the following steps, the "2>&1 | tee XXX.out" records all
+output from the process, which will be useful if anything unexpected
+goes wrong.
+
+Then do the compilation with
+
+  make 2>&1 | tee make.out
+
+Finally, test using
+
+  make test 2>&1 | tee make-test.out
+
+In the output, the only failures you should see should look like:
+
+   lib/Math/BigInt/t/bigfltpm.........Use of uninitialized value ...
+   FAILED at test 57
+   lib/Math/BigInt/t/bigintc..........ok
+   lib/Math/BigInt/t/bigintpm.........FAILED at test 204
+   lib/Math/BigInt/t/mbimbf...........Use of uninitialized value ...
+   Illegal division by zero at ../lib/Math/BigInt/Calc.pm line 314.
+   FAILED at test 71
+   lib/Math/Complex...................exp: OVERFLOW
+   FAILED at test 250
+   lib/Math/Trig......................exp: OVERFLOW
+   ok
+   lib/Memoize/t/array................ok
+   	...
+   lib/Net/protoent...................ok
+   lib/Net/servent....................FAILED at test 0
+
+This means that everything passes except for some problems in the
+packages "Math::BigInt", "Math::Complex", and "Math::Trig".
+The lib/Net/servent failure seems to be a bug in the test
+program.  To confirm this, from the main Perl source dir, do:
+
+   LD_LIBRARY_PATH=`pwd` ./perl -Ilib lib/Net/servent.t
+
+and it should output
+
+   1..3
+   ok 1
+   ok 2
+   ok 3
+
+=head1 Installing the built perl on UTS
+
+Run the command "make install"
+
+=head1 AUTHOR
+
+   Hal Morris
+   UTS Global LLC
+   email: [email protected]
+
+=cut
+

pod/buildtoc.PL

@@ -82,6 +82,7 @@ if (-d "pod") {
     perlplan9
     perlsolaris
     perltru64
+    perluts
     perlvmesa
     perlvms             
     perlvos             

pod/perl.pod

@@ -131,6 +131,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perlqnx		Perl notes for QNX
     perlsolaris 	Perl notes for Solaris
     perltru64		Perl notes for Tru64
+    perluts             Perl notes for UTS
     perlvmesa		Perl notes for VM/ESA
     perlvms		Perl notes for VMS
     perlvos		Perl notes for Stratus VOS

pod/perl572delta.pod

@@ -678,15 +678,7 @@ These tests fail because of yet unresolved floating point inaccuracies.
 
 =head2 UTS
 
-Many floating point inaccuracies:
-
-  op/numconvert              511,657,658,659,665-667,831,991,1151
-  op/pack                    10,22,149,156
-  op/sprintf                 8,10,13,102-107,134-135,146-153,159-162
-  lib/Math/BigInt/bigintpm   1145,1183
-  lib/Math/Complex           250,257,514,521,722-724,
-                             934,935,945,949,955,956,975,976
-  ext/POSIX/POSIX            14
+There are a few known test failures, see L<perluts>.
 
 =head2 VMS
 

pod/perltoc.pod

@@ -2241,8 +2241,8 @@ Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
 Test::Simple, Text::Abbrev, Text::Balanced, Text::ParseWords,
 Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash,
 Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
-Time::localtime, Time::tm, UNIVERSAL, Unicode::UCD, User::grent,
-User::pwent, Win32
+Time::localtime, Time::tm, UNIVERSAL, UnicodeCD, User::grent, User::pwent,
+Win32
 
 =item Extension Modules
 
@@ -6670,6 +6670,22 @@ Digital UNIX formerly known as DEC OSF/1) systems
 
 =back
 
+=head2 perluts - Perl under UTS
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUILDING PERL ON UTS
+
+=item Installing the built perl on UTS
+
+=item AUTHOR
+
+=back
+
 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
 
 =over 4
@@ -8917,7 +8933,8 @@ C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
 
 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
-C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
+C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
+C<versiononly>, C<vi>, C<voidflags>
 
 =item x