diff options
Diffstat (limited to 'doc/gawktexi.in')
| -rw-r--r-- | doc/gawktexi.in | 40 |
1 files changed, 30 insertions, 10 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 198f3700..7b4c2a8b 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -54,7 +54,7 @@ @c applies to and all the info about who's publishing this edition @c These apply across the board. -@set UPDATE-MONTH April, 2022 +@set UPDATE-MONTH June, 2022 @set VERSION 5.1 @set PATCHLEVEL 1 @@ -281,13 +281,13 @@ Fax: +1-617-542-2652 Email: <email>gnu@@gnu.org</email> URL: <ulink url="https://www.gnu.org">https://www.gnu.org/</ulink></literallayout> -<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993, 1996–2005, 2007, 2009–2021 +<literallayout class="normal">Copyright © 1989, 1991, 1992, 1993, 1996–2005, 2007, 2009–2022 Free Software Foundation, Inc. All Rights Reserved.</literallayout> @end docbook @ifnotdocbook -Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2021 @* +Copyright @copyright{} 1989, 1991, 1992, 1993, 1996--2005, 2007, 2009--2022 @* Free Software Foundation, Inc. @end ifnotdocbook @sp 2 @@ -921,7 +921,7 @@ particular records in a file and perform operations upon them. * Computer Arithmetic:: A quick intro to computer math. * Math Definitions:: Defining terms used. * MPFR features:: The MPFR features in @command{gawk}. -* MPFR Deprecated:: MPFR features are deprecated! +* MPFR On Parole:: MPFR features are on parole! * MPFR Intro:: MPFR General introduction. * FP Math Caution:: Things to know. * Inexactness of computations:: Floating point math is not exact. @@ -4109,10 +4109,16 @@ if @command{gawk} is not compiled to use the GNU MPFR and MP libraries As of @value{PVERSION} 5.2, the arbitrary precision arithmetic features in @command{gawk} -are @emph{deprecated}. They will be removed from @command{gawk} in 2024. +are ``on parole.'' +The primary maintainer is no longer willing to support this feature, +but another member of the development team has stepped up to take it over. +As long as this situation reamins stable, MPFR will be supported. If it +changes, the MPFR support will be removed from @command{gawk}. +@ignore If you use this option, @command{gawk} generates a warning message. Create the environment variable @env{GAWK_NO_MPFR_WARN} with an arbitrary value in order to silence the warning. +@end ignore @item @option{-n} @itemx @option{--non-decimal-data} @@ -4696,9 +4702,11 @@ in milliseconds. On systems that do not support the @code{usleep()} system call, the value is rounded up to an integral number of seconds. +@ignore @item GAWK_NO_MPFR_WARN Specifies that @command{gawk} should not print a deprecation warning when used with the @option{-M}/@option{--bignum} options. +@end ignore @item GAWK_READ_TIMEOUT Specifies the time, in milliseconds, for @command{gawk} to @@ -33058,21 +33066,24 @@ This @value{SECTION} briefly describes arbitrary-precision arithmetic in @command{gawk}. @menu -* MPFR Deprecated:: MPFR features are deprecated! +* MPFR On Parole:: MPFR features are on parole! * MPFR Intro:: MPFR General introduction. @end menu -@node MPFR Deprecated -@subsection Arbitrary Precision Arithmetic is Deprecated! +@node MPFR On Parole +@subsection Arbitrary Precision Arithmetic is On Parole! As of @value{PVERSION} 5.2, arbitrary precision arithmetic in @command{gawk} -is @emph{deprecated}. It will be removed from @command{gawk} in 2024. +is ``on parole.'' The primary @command{gawk} maintainer is no +longer maintaining it. Fortunately, a volunteer from the development +team has agreed to take it over. -This feature is deprecated because its inclusion was a mistake. It has +This feature is on parole because its inclusion was a mistake. It has led to endless bug reports, misuse of the feature and public abuse of the maintainer, for no real increased value. +@ignore If you use this feature, you should start working now to find a different toolset with which to accomplish your goals.@footnote{Of course, you can always continue to use a version of @command{gawk} that still supports @@ -33082,6 +33093,15 @@ If the feature is very important to you, then consider if you are willing to volunteer to maintain it, so that it can continue to be included in @command{gawk}. If that is the case, contact the maintainer to discuss it with him. You may do so by submitting a bug report. +@end ignore + +If the situation with support changes, the feature will be removed +from @command{gawk}. + +If you use this feature, you should consider finding a different +toolset with which to accomplish your goals.@footnote{Of course, you can +always continue to use a version of @command{gawk} that still supports +arbitrary precision arithmetic. It simply will be unmaintained.} @node MPFR Intro @subsection Arbitrary Precision Introduction |