 @@ -1,14 +1,14 @@
-.\" $NetBSD: bc.1,v 1.6 2021/01/07 20:37:33 uwe Exp $
+.\" $NetBSD: bc.1,v 1.7 2021/01/07 21:21:35 uwe Exp $
 .\"
 .\" bc.1 - the bc manual
 .\"
 .\" Copyright (C) 1991-1994, 1997, 2000, 2003, 2012-2017 Free Software Foundation, Inc.
 .\" Copyright (C) 2004, 2017 Philip A. Nelson
 .\" Copyright (C) 2017 Thomas Klausner
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 @@ -118,27 +118,28 @@ has a length of 7 and a scale of 3.
 .El
 .Ss VARIABLES
 Numbers are stored in two types of variables, simple variables and
 arrays.
 Both simple variables and array variables are named.
 Names begin with a letter followed by any number of letters, digits and
 underscores.
 All letters must be lower case.
 (Full alpha-numeric names are an extension.
 In POSIX
 .Nm
 all names are a single lower case letter.)
 The type of variable is clear by the context
-because all array variable names will be followed by brackets ([]).
+because all array variable names will be followed by brackets
 .Pq Ql [] .
 .Pp
 There are four special variables,
 .Ic scale ,
 .Ic ibase ,
 .Ic obase ,
 and
 .Ic last .
 .Ic scale
 defines how some operations use digits after the decimal point.
 The default value of
 .Ic scale
 is 0.
 .Ic ibase
 @@ -146,41 +147,41 @@ and
 .Ic obase
 define the conversion base for input and output numbers.
 The default for both input and output is base 10.
 .Ic last
 (an extension) is a variable that has the value of the last
 printed number.
 These will be discussed in further detail where appropriate.
 All of these variables may have values assigned to them
 as well as used in expressions.
 .Ss COMMENTS
 Comments in
 .Nm
 start with the characters
-.Dq Ic /*
+.Ql /*
 and end with the characters
-.Dq Ic */ .
+.Ql */ .
 Comments may start anywhere and appear as a single space in the input.
 (This causes comments to delimit other input items.
 For example, a comment can not be found in the middle of
 a variable name.)
 Comments include any newlines (end of line) between
 the start and the end of the comment.
 .Pp
 To support the use of scripts for
 .Nm ,
 a single line comment has been added as an extension.
 A single line comment starts at a
-.Dq Ic #
+.Ql #
 character and continues to the next end of the line.
 The end of line
 character is not part of the comment and is processed normally.
 .Ss EXPRESSIONS
 The numbers are manipulated by expressions and statements.
 Since the language was designed to be interactive, statements and expressions
 are executed as soon as possible.
 There is no
 .Dq main
 program.
 Instead, code is executed as it is encountered.
 (Functions, discussed in
 detail later, are defined when encountered.)
 @@ -195,33 +196,35 @@ by the variable
 The legal values of
 .Ic ibase
 are 2 through 36.
 (Base values greater than 16 are an extension.)
 Assigning a value outside this range to
 .Ic ibase
 will result in a value of 2 or 36.
 Input numbers may contain the characters 0-9 and A-Z.
 (Note: They must be capitals.
 Lower case letters are variable names.)
 Single digit numbers always
 have the value of the digit regardless of the value of
 .Ic ibase .
-(i.e. A = 10.)
+(i.e.\&
 .Ql A
 =\~10.)
 For multi-digit numbers,
 .Nm
 changes all input digits greater or equal to ibase to the value of
 .Ic ibase - 1 .
 This makes the number
-.Dq ZZZ
+.Ql ZZZ
 always be the largest 3 digit number of the input base.
 .Pp
 Full expressions are similar to many other high level languages.
 Since there is only one kind of number, there are no rules for mixing
 types.
 Instead, there are rules on the scale of expressions.
 Every expression has a scale.
 This is derived from the scale of original
 numbers, the operation performed and in many cases, the value of the
 variable
 .Ic scale .
 Legal values of the variable
 .Ic scale
 @@ -352,72 +355,88 @@ The boolean
 operators are:
 .Bl -tag -width 15n
 .It Ic "!expr"
 The result is 1 if expr is 0.
 .It Ic "expr && expr"
 The result is 1 if both expressions are non-zero.
 .It Ic "expr || expr"
 The result is 1 if either expression is non-zero.
 .El
 .Pp
 The expression precedence is as follows: (lowest to highest)
 .Bl -enum -offset indent
 .It
-|| operator, left associative
+.Ql ||
 operator, left associative
 .It
-&& operator, left associative
+.Ql &&
 operator, left associative
 .It
-! operator, nonassociative
+.Ql \&!
 operator, nonassociative
 .It
 Relational operators, left associative
 .It
 Assignment operator, right associative
 .It
-+ and - operators, left associative
+.Ql +
 and
 .Ql -
 operators, left associative
 .It
-*, / and % operators, left associative
+.Ql * ,
 .Ql /
 and
 .Ql %
 operators, left associative
 .It
-^ operator, right associative
+.Ql ^
 operator, right associative
 .It
-unary - operator, nonassociative
+unary
 .Ql -
 operator, nonassociative
 .It
-++ and -- operators, nonassociative
+.Ql ++
 and
 .Ql --
 operators, nonassociative
 .El
 .Pp
 This precedence was chosen so that POSIX compliant
 .Nm
 programs will run correctly.
 This will cause the use of the relational and logical operators to
 have some unusual behavior when used with assignment expressions.
 Consider the expression:
-.Dl Ic a = 3 < 5
+.Dl a = 3 < 5
 .Pp
 Most C programmers would assume this would assign the result of
-.Dq Ic 3 < 5
+.Dq Li 3 < 5
 (the value 1) to the variable
-.Dq Ic a .
+.Va a .
 What this does in
 .Nm
 is assign the value 3 to the variable
-.Dq Ic a
+.Va a
 and then compare 3 to 5.
 It is best to use parenthesis when using relational and logical operators
 with the assignment operators.
 .Pp
 There are a few more special expressions that are provided in
 .Nm .
 These have to do with user defined functions and standard functions.
 They all appear as
-.Do Ar name ( Ar parameters ) Dc .
+.Do Ar name Ns Li \&( Ns Ar parameters Ns Li \&) Dc .
 See the section on functions for user defined functions.
 The standard functions are:
 .Bl -tag -width 20n
 .It Fn length expression
 The value of the length function is the number of significant digits in the
 expression.
 .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
 the standard input.
 The best use for this function is in a previously written program that
 needs input from the user, but never allows program code to be input
 @@ -452,27 +471,29 @@ An improperly placed newline will cause
 Because newlines
 are statement separators, it is possible to hide a newline by using
 the backslash character.
 The sequence
 .Dq Ic \e<nl> ,
 where <nl> is the newline appears to
 .Nm
 as whitespace instead of a newline.
 A statement list is a series of statements separated by semicolons and
 newlines.
 The following is a list of
 .Nm
 statements and what they do:
-(Things enclosed in brackets ([]) are optional parts of the
+(Things enclosed in brackets
 .Pq Oo Oc
 are optional parts of the
 statement.)
 .Bl -tag -width 15n
 .It Ar expression
 This statement does one of two things.
 If the expression starts with
 .Ao Ar variable Ac Ao Ar assignment Ac ... ,
 it is considered to be an assignment statement.
 If the expression is not an assignment statement, the
 expression is evaluated and printed to the output.
 After the number is printed, a newline is printed.
 For example,
 .Dq Ic a=1
 is an assignment statement and
 @@ -508,71 +529,73 @@ Due to the interactive nature of
 printing a number causes the side effect of assigning the printed value to the
 special variable
 .Ic last .
 This allows the user to recover the last value printed without having
 to retype the expression that printed the number.
 Assigning to
 .Ic last
 is legal and will
 overwrite the last printed value with the assigned value.
 The newly assigned value will remain until the next number is printed
 or another value is assigned to
 .Ic last .
 (Some installations may allow the
-use of a single period (.) which is not part of a number as a short
+use of a single period
-hand notation for
+.Pq Ql \&.
 which is not part of a number as a short hand notation for
 .Ic last . )
 .It Ar "string"
 The
 .Ar string
 is printed to the output.
 Strings start with a double quote
 character and contain all characters until the next double quote character.
 All characters are take literally, including any newline.
 No newline character is printed after the string.
 .It Ic  print Ar list
 The
 .Ic print
 statement (an extension) provides another method of output.
 The
 .Ar list
 is a list of strings and expressions separated by commas.
 Each string or expression is printed in the order of the list.
 No terminating newline is printed.
 Expressions are evaluated and their
 value is printed and assigned to the variable
 .Ic last .
 Strings in the
 .Ic print
 statement are printed to the output and may contain special characters.
-Special characters start with the backslash character (\e).
+Special characters start with the backslash character
 .Pq Ql \e .
 The special characters recognized by
 .Nm
 are
-.Sq a
+.Ql a
 (alert or bell),
-.Sq b
+.Ql b
 (backspace),
-.Sq f
+.Ql f
 (form feed),
-.Sq n
+.Ql n
 (newline),
-.Sq r
+.Ql r
 (carriage return),
-.Sq q
+.Ql q
 (double quote),
-.Sq t
+.Ql t
 (tab), and
-.Sq \e
+.Ql \e
 (backslash).
 Any other character following the backslash will be ignored.
 .It { Ar statement_list }
 This is the compound statement.
 It allows multiple statements to be grouped together for execution.
 .It Ic if ( Ar expression ) Ar statement1 [ Ic else Ar statement2 ]
 The
 .Ic if
 statement evaluates the
 .Ar expression
 and executes
 .Ar statement1
 or
 @@ -637,27 +660,27 @@ or
 are missing, nothing is evaluated at the point they would be evaluated.
 If
 .Ar expression2
 is missing, it is the same as substituting the value 1 for
 .Ar expression2 .
 (The optional expressions are an
 extension.
 POSIX
 .Nm
 requires all three expressions.)
 The following is equivalent code for the
 .Ic for
 statement:
-.Bd -literal
+.Bd -literal -offset indent
 expression1;
 while (expression2) {
    statement;
    expression3;
+}
 .Ed
 .It Ic break
 This statement causes a forced exit of the most recent enclosing
 .Ic while
 statement or
 .Ic for
 statement.
 .It Ic continue