bonsai/harakit
4
4
Fork 3
Code Issues 41 Pull Requests 2 Projects 1 Releases 35 Activity

rpn.1: fixes clunkiness

Browse Source
This commit is contained in:
Emma Tebibyte 2024-06-17 23:16:25 -06:00
parent 53d5a1db73
commit 1b299f8ee1
Signed by: emma
GPG Key ID: 06FA419A1698C270
1 changed files with 15 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/rpn.1
View File

@ -4,7 +4,7 @@
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license, .\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>. .\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
.\" .\"
.TH RPN 1 2024-06-06 "Bonsai Core Utilites 0.13.8" .TH RPN 1 2024-06-17 "Bonsai Core Utilites 0.13.8"
.SH NAME .SH NAME
rpn \(en reverse polish notation evaluation rpn \(en reverse polish notation evaluation
.\" .\"
@ -18,12 +18,12 @@ rpn
Evaluate reverse polish notation. Evaluate reverse polish notation.
The program evaluates reverse polish notation expressions either read from the The program evaluates reverse polish notation expressions read either from the
standard input or parsed from provided arguments. See the STANDARD INPUT standard input or parsed from provided arguments. See the STANDARD INPUT
section. section.
Upon evaluation, the program will print the resulting number on the stack to the Upon evaluation, the resulting number on the stack will be printed to the
standard output. Any further specified numbers will be placed at the end of the standard output. Any further numbers specified will be placed at the end of the
stack. stack.
For information on for reverse polish notation syntax, see For information on for reverse polish notation syntax, see
@ -31,8 +31,8 @@ For information on for reverse polish notation syntax, see
.\" .\"
.SH STANDARD INPUT .SH STANDARD INPUT
If arguments are passed, they are interpreted as an expression to be If arguments are specified, they are interpreted as an expression to be
evaluated. Otherwise, it reads whitespace-delimited numbers and operations from evaluated. Otherwise, whitespace-delimited numbers and operations are read from
the standard input. the standard input.
.\" .\"
.SH DIAGNOSTICS .SH DIAGNOSTICS
@ -46,11 +46,13 @@ error message and continue accepting input.
.SH CAVEATS .SH CAVEATS
Due to precision constraints and the way floats are represented in accordance Due to precision constraints and the way floats are represented in accordance
with the IEEE Standard for Floating Point Arithmetic (\fIIEEE 754\fP), with the
floating-point arithmetic has rounding errors. This is somewhat curbed by using .I IEEE Standard for Floating Point Arithmetic
the machine epsilon as provided by the Rust standard library to which to round (\fIIEEE 754\fP), floating-point arithmetic has rounding errors. This is
numbers. Because of this, variation is expected in the number of decimal places somewhat curbed by using the machine epsilon as provided by the Rust standard
the program can handle based on the platform and hardware of any given machine. library to which numbers are rounded. Because of this, variation is expected in
the number of decimal places the program can handle based on the platform and
hardware of any given machine.
.\" .\"
.SH RATIONALE .SH RATIONALE
@ -63,8 +65,8 @@ program. A
pre-dates the standardized pre-dates the standardized
.BR bc (1p), .BR bc (1p),
the latter originally being a preprocessor for the former, and was included in the latter originally being a preprocessor for the former, and was included in
UNIX v2 onward. While it implements reverse polish notation, it still suffers Second Edition UNIX and onward. While it implements reverse polish notation, it
from being unable to accept an expression as an argument. still suffers from being unable to accept an expression as an argument.
.\" .\"
.SH AUTHOR .SH AUTHOR