Module Name: src
Committed By: uwe
Date: Thu Jan 7 20:37:33 UTC 2021
Modified Files:
src/external/bsd/bc/dist: bc.1
Log Message:
bc(1): Use .Fn and .Fa for functions and their arguments.
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/external/bsd/bc/dist/bc.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/bsd/bc/dist/bc.1
diff -u src/external/bsd/bc/dist/bc.1:1.5 src/external/bsd/bc/dist/bc.1:1.6
--- src/external/bsd/bc/dist/bc.1:1.5 Thu Jan 7 20:22:34 2021
+++ src/external/bsd/bc/dist/bc.1 Thu Jan 7 20:37:33 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: bc.1,v 1.5 2021/01/07 20:22:34 uwe Exp $
+.\" $NetBSD: bc.1,v 1.6 2021/01/07 20:37:33 uwe Exp $
.\"
.\" bc.1 - the bc manual
.\"
@@ -411,10 +411,10 @@ They all appear as
See the section on functions for user defined functions.
The standard functions are:
.Bl -tag -width 20n
-.It Ic length ( Ar expression )
+.It Fn length expression
The value of the length function is the number of significant digits in the
expression.
-.It Ic read ( )
+.It Fn read
The read function (an extension) will read a number from the standard
input, regardless of where the function occurs.
Beware, this can cause problems with the mixing of data and program in
@@ -426,10 +426,10 @@ The value of the read function is the nu
the standard input using the current value of the variable
.Ic ibase
for the conversion base.
-.It Ic scale ( Ar expression )
+.It Fn scale expression
The value of the scale function is the number of digits after the decimal
point in the expression.
-.It Ic sqrt ( Ar expression )
+.It Fn sqrt expression
The value of the sqrt function is the square root of the expression.
If
the expression is negative, a run time error is generated.
@@ -813,7 +813,7 @@ Changes of
.Ic ibase
will be ignored during the execution of the function except for the
standard function
-.Ic read ,
+.Fn read ,
which will always use the current value
of
.Ic ibase
@@ -863,22 +863,22 @@ px(1)
.Ed
.Pp
Since
-.Ar py
+.Fn py
is not a void function, the call of
-.Ar py ( 1 )
+.Ql py(1)
prints the desired output and then prints a second line that is the value of
the function.
Since the value of a function that is not given an
explicit return statement is zero, the zero is printed.
For
-.Ar px ( 1 ) ,
+.Ql px(1) ,
no zero is printed because the function is a void function.
.Pp
Also, call by variable for arrays was added.
To declare
a call by variable array, the declaration of the array parameter in the
function definition looks like
-.Do Ar name [ ] Dc .
+.Do Fa name Ns Li [] Dc .
The call to the
function remains the same as call by value arrays.
.Ss MATH LIBRARY
@@ -891,18 +891,33 @@ The math functions will calculate their
results to the scale set at the time of their call.
The math library defines the following functions:
.Bl -tag -width 15n
-.It Ic s ( Ar x )
-The sine of x, x is in radians.
-.It Ic c ( Ar x )
-The cosine of x, x is in radians.
-.It Ic a ( Ar x )
-The arctangent of x, arctangent returns radians.
-.It Ic l ( Ar x )
-The natural logarithm of x.
-.It Ic e ( Ar x )
-The exponential function of raising e to the value x.
-.It Ic j ( n , x )
-The Bessel function of integer order n of x.
+.It Fn s x
+The sine of
+.Fa x ,
+.Fa x
+is in radians.
+.It Fn c x
+The cosine of
+.Fa x ,
+.Fa x
+is in radians.
+.It Fn a x
+The arctangent of
+.FA x ,
+arctangent returns radians.
+.It Fn l x
+The natural logarithm of
+.Fa x .
+.It Fn e x
+The exponential function of raising
+.Va e
+to the value
+.Fa x .
+.It Fn j n x
+The Bessel function of integer order
+.Fa n
+of
+.Fa x .
.El
.Sh ENVIRONMENT
The following environment variables are processed by
