1 files changed, 31 insertions, 19 deletions

diff --git a/lib/msun/man/lgamma.3 b/lib/msun/man/lgamma.3
index ec094cccaa92..97630d10cd09 100644
--- a/lib/msun/man/lgamma.3
+++ b/lib/msun/man/lgamma.3
@@ -75,11 +75,14 @@ The external integer
 .Fa signgam
 returns the sign of \(*G(x).
 .Pp
-.Fn gamma x
+.Fn gamma
+and
+.Fn gammaf
+are deprecated aliases for
+.Fn lgamma
 and
-.Fn gammaf x
-return \(*G(x), with no effect on
-.Fa signgam .
+.Fn lgammaf ,
+respectively.
 .Sh IDIOSYNCRASIES
 Do not use the expression
 .Dq Li signgam\(**exp(lgamma(x))
@@ -94,16 +97,14 @@ Only after
 or
 .Fn lgammaf
 has returned can signgam be correct.
-.Pp
-For arguments in its range,
-.Fn gamma
-and
-.Fn gammaf
-is preferred, as for positive arguments
-it is accurate to within one unit in the last place.
-Exponentiation of
-.Fn lgamma
-will lose up to 10 significant bits.
+.\".Pp
+.\"For arguments in its range,
+.\".Fn gamma
+.\"is preferred, as for positive arguments
+.\"it is accurate to within one unit in the last place.
+.\"Exponentiation of
+.\".Fn lgamma
+.\"will lose up to 10 significant bits.
 .Sh RETURN VALUES
 .Fn gamma ,
 .Fn gammaf ,
@@ -120,9 +121,9 @@ and
 .Va errno
 is set to
 .Er ERANGE .
-For large non-integer negative values,
-.Fn gamma
-will underflow.
+\."For large non-integer negative values,
+\.".Fn gamma
+\."will underflow.
 .Sh SEE ALSO
 .Xr math 3
 .Sh HISTORY
@@ -133,9 +134,20 @@ function appeared in
 The
 .Fn gamma
 function appeared in
-.Bx 4.4 .
+.Bx 4.4
+as a function which computed \(*G(x).
+This version was used in
+.Fx 1.1 .
 The name
 .Fn gamma
 was originally dedicated to the
 .Fn lgamma
-function, so some old code may no longer be compatible.
+function,
+and that usage was restored by switching to Sun's fdlibm in
+.Fx 1.1.5 .
+The
+.St -isoC-99
+standard specifies a function
+.Fn tgamma
+for computing \(*G(x).
+This function is currently unimplemented in this library.