#
# In particular, this should not be used as an example of modern Perl
# programming techniques.
+# This legacy library is deprecated and will be removed in a future
+# release of perl.
#
# Suggested alternative: Math::BigInt
-#
+
+warn( "The 'bigint.pl' legacy library is deprecated and will be"
+ . " removed in the next major release of perl. Please use the"
+ . " Math::BigInt module instead." );
+
# arbitrary size integer math package
#
# by Mark Biggar
# '+0' canonical zero value
# ' -123 123 123' canonical value '-123123123'
# '1 23 456 7890' canonical value '+1234567890'
-# Output values always always in canonical form
+# Output values always in canonical form
#
# Actual math is done in an internal format consisting of an array
# whose first element is the sign (/^[+-]$/) and whose remaining