mirror of
https://github.com/louisrubet/rpn
synced 2024-11-16 07:47:26 +01:00
README to README.md
This commit is contained in:
parent
eb269358d0
commit
dad0708d12
2 changed files with 249 additions and 274 deletions
274
README
274
README
|
@ -1,274 +0,0 @@
|
|||
========================================================================
|
||||
Reverse Polish Notation language
|
||||
Inspired by Hewlett-Packard RPL language
|
||||
HP28S user manual is provided as a reference
|
||||
========================================================================
|
||||
|
||||
This project plans to create a clone of HP RPN calculator language,
|
||||
including at least stack, store, branch, test, trig and logs commands
|
||||
of HP28S RPL implementation.
|
||||
|
||||
Following objects are managed: numbers, binaries, symbols, strings,
|
||||
programs, plus keywords (ie langage commands and flow controls).
|
||||
|
||||
The special feature of this language is to make no difference between
|
||||
keywords and functions, even user functions.
|
||||
|
||||
Numbers (ie scalars) are in 128-bit quadruple precision format (long
|
||||
double).
|
||||
Binaries are 64-bits longwords format (long long int).
|
||||
|
||||
A GNU-readline-based interactive editor with autocompletion is provided.
|
||||
|
||||
Language extensions will soon be included:
|
||||
- file objects and functions,
|
||||
- date and time objects and functions,
|
||||
- shell-calling objects with return code, stdout and stderr treatment,
|
||||
- loading and saving stack, variables, programs from / to filesystem
|
||||
|
||||
========================================================================
|
||||
Here is a list of HP28s reserved words.
|
||||
|
||||
New commands (nonexistent in RPL) are tagged with * in column new.
|
||||
Commands already implemented are tagged with * in column impl.
|
||||
Tested commands are tagged with * in column tested.
|
||||
|
||||
category command new impl. tested
|
||||
|
||||
GENERAL nop * * *
|
||||
GENERAL help/h/? * *
|
||||
GENERAL quit/exit/q * *
|
||||
GENERAL test * *
|
||||
GENERAL verbose * *
|
||||
GENERAL std *
|
||||
GENERAL fix *
|
||||
GENERAL sci *
|
||||
GENERAL version * *
|
||||
GENERAL uname * *
|
||||
GENERAL edit *
|
||||
|
||||
REAL + *
|
||||
REAL - *
|
||||
REAL neg *
|
||||
REAL * *
|
||||
REAL / *
|
||||
REAL inv *
|
||||
REAL % *
|
||||
REAL %CH *
|
||||
REAL ^ *
|
||||
REAL sqrt * *
|
||||
REAL sq * *
|
||||
REAL mod * *
|
||||
|
||||
STACK drop *
|
||||
STACK swap *
|
||||
STACK roll
|
||||
STACK dup *
|
||||
STACK over
|
||||
STACK dup2 *
|
||||
STACK drop2 *
|
||||
STACK rot *
|
||||
STACK list->
|
||||
STACK rolld
|
||||
STACK pick *
|
||||
STACK dupn
|
||||
STACK dropn
|
||||
STACK depth *
|
||||
STACK ->list
|
||||
STACK load_stack * *
|
||||
STACK save_stack * *
|
||||
|
||||
STORE
|
||||
STORE sto *
|
||||
STORE rcl *
|
||||
STORE purge *
|
||||
STORE sto+
|
||||
STORE sto-
|
||||
STORE sto*
|
||||
STORE sto/
|
||||
STORE sneg
|
||||
STORE sinv
|
||||
STORE sconj
|
||||
STORE erase * *
|
||||
STORE vars * *
|
||||
STORE include *
|
||||
STORE load_vars *
|
||||
STORE save_vars *
|
||||
|
||||
PROGRAM eval *
|
||||
PROGRAM load_prog *
|
||||
PROGRAM save_prog *
|
||||
|
||||
ALGEBRA neg * *
|
||||
ALGEBRA colct
|
||||
ALGEBRA expan
|
||||
ALGEBRA size
|
||||
ALGEBRA form
|
||||
ALGEBRA obsub
|
||||
ALGEBRA exsub
|
||||
ALGEBRA taylr
|
||||
ALGEBRA isol
|
||||
ALGEBRA quad,
|
||||
ALGEBRA show
|
||||
ALGEBRA obget
|
||||
ALGEBRA exget
|
||||
|
||||
BINARY + *
|
||||
BINARY - *
|
||||
BINARY * *
|
||||
BINARY / *
|
||||
BINARY dec *
|
||||
BINARY hex *
|
||||
BINARY oct *
|
||||
BINARY bin *
|
||||
BINARY stws
|
||||
BINARY rcws
|
||||
BINARY rl
|
||||
BINARY rr
|
||||
BINARY rlb
|
||||
BINARY rrb
|
||||
BINARY r->b *
|
||||
BINARY b->r *
|
||||
BINARY sl
|
||||
BINARY sr
|
||||
BINARY slb
|
||||
BINARY srb
|
||||
BINARY asr
|
||||
BINARY and
|
||||
BINARY or
|
||||
BINARY xor
|
||||
BINARY not
|
||||
|
||||
STRING + *
|
||||
STRING ->str *
|
||||
STRING str-> *
|
||||
STRING chr
|
||||
STRING num
|
||||
STRING ->lcd
|
||||
STRING lcd->
|
||||
STRING pos
|
||||
STRING sub
|
||||
STRING size
|
||||
STRING disp
|
||||
|
||||
BRANCH
|
||||
BRANCH if *
|
||||
BRANCH then *
|
||||
BRANCH else *
|
||||
BRANCH end *
|
||||
BRANCH start *
|
||||
BRANCH for *
|
||||
BRANCH next *
|
||||
BRANCH step *
|
||||
BRANCH ift
|
||||
BRANCH ifte
|
||||
BRANCH do
|
||||
BRANCH until
|
||||
BRANCH end
|
||||
BRANCH while
|
||||
BRANCH repeat
|
||||
BRANCH end
|
||||
|
||||
TEST
|
||||
TEST != *
|
||||
TEST > *
|
||||
TEST >= *
|
||||
TEST < *
|
||||
TEST <= *
|
||||
TEST sf
|
||||
TEST cf
|
||||
TEST fs?
|
||||
TEST fc?
|
||||
TEST fs?c
|
||||
TEST fc?c
|
||||
TEST and *
|
||||
TEST or *
|
||||
TEST xor *
|
||||
TEST not *
|
||||
TEST same *
|
||||
TEST == *
|
||||
TEST stof
|
||||
TEST rclf
|
||||
TEST type
|
||||
|
||||
TRIG
|
||||
TRIG pi * *
|
||||
TRIG sin *
|
||||
TRIG asin *
|
||||
TRIG cos *
|
||||
TRIG acos *
|
||||
TRIG tan *
|
||||
TRIG atan *
|
||||
TRIG p→r
|
||||
TRIG r→p
|
||||
TRIG r→c
|
||||
TRIG c→r
|
||||
TRIG arg
|
||||
TRIG →hms
|
||||
TRIG hms→
|
||||
TRIG hms+
|
||||
TRIG hms-
|
||||
TRIG d→r *
|
||||
TRIG r→d *
|
||||
|
||||
LOGS
|
||||
LOGS log *
|
||||
LOGS alog *
|
||||
LOGS ln *
|
||||
LOGS exp *
|
||||
LOGS lnp1
|
||||
LOGS expm
|
||||
LOGS sinh *
|
||||
LOGS asinh *
|
||||
LOGS cosh *
|
||||
LOGS acosh *
|
||||
LOGS tanh *
|
||||
LOGS atanh *
|
||||
|
||||
|
||||
Not yet
|
||||
=======
|
||||
|
||||
MEMORY
|
||||
mem, menu, order, path, home, crdir, vars, clusr,
|
||||
|
||||
STAT
|
||||
∑dat, ∑par, ∑+, ∑-, n∑, cl∑, sto∑, rcl∑, tot, mean, sdev, var, max∑,
|
||||
min∑, col∑, corr, cov, lr, predev, utpc, utpf, utpn, utpt, comb, perm
|
||||
|
||||
PRINT
|
||||
pr1, prst, prvar, prlcd, cr, trac, prstc, prusr, prmd
|
||||
|
||||
SOLV
|
||||
steq, rceq, isol, quad, show, root,
|
||||
|
||||
PLOT
|
||||
ppar, steq, rceq, pmin, pmax, indep, draw, res, axes, centr, *w, *h,
|
||||
sto∑, rcl∑, col∑, scl∑, drw∑, cllcd, digtiz
|
||||
|
||||
CURSOR
|
||||
ins, del, ← → ↑ ↓, cmd, undo, last, ml, rdx, prmd
|
||||
|
||||
CONTRL
|
||||
sst, halt, abort, kill, wait, key, bepp, cllcd, disp, clmf, errn,
|
||||
errm
|
||||
|
||||
CATALOG
|
||||
next, prev, scan, use, fetch, quit
|
||||
|
||||
UNITS
|
||||
convert
|
||||
|
||||
CUSTOM
|
||||
menu, custom
|
||||
|
||||
========================================================================
|
||||
Other standard files:
|
||||
README
|
||||
TODO
|
||||
|
||||
========================================================================
|
||||
Other notes:
|
||||
Compiled with g++ Makefile generated by automake.
|
||||
External dependencies needed: automake, readline (libreadline-dev)
|
||||
========================================================================
|
249
README.md
Normal file
249
README.md
Normal file
|
@ -0,0 +1,249 @@
|
|||
# **R**everse **P**olish **N**otation language
|
||||
Inspired by Hewlett-Packard RPL language
|
||||
|
||||
**HP28S** user manual is provided as a reference
|
||||
|
||||
- This project plans to create a clone of **Hewlett Packard RPN calculator language**, including at least STACK, STORE, BRANCH, TEST, TRIG and LOGS commands of HP28S RPL implementation.
|
||||
|
||||
- Following objects are managed: numbers, binaries, symbols, strings,
|
||||
programs, plus keywords (ie langage commands and flow controls).
|
||||
|
||||
- The special feature of this language is to make no difference between
|
||||
keywords and functions, even user functions.
|
||||
|
||||
- Numbers (ie scalars) are in 128-bit quadruple precision format (long
|
||||
double). Binaries are 64-bits longwords format (long long int).
|
||||
|
||||
- A GNU-readline-based interactive editor with autocompletion is provided.
|
||||
|
||||
- Language extensions will soon be included:
|
||||
- file objects and functions,
|
||||
- date and time objects and functions,
|
||||
- shell-calling objects with return code, stdout and stderr treatment,
|
||||
- loading and saving | STACK |, variables, | PROGRAM |s from / to filesystem
|
||||
|
||||
## Here is a list of HP28s reserved words.
|
||||
|
||||
New commands (nonexistent in RPL) are tagged with * in column new.
|
||||
Commands already implemented are tagged with * in column impl.
|
||||
| TEST |ed commands are tagged with * in column | TEST |ed.
|
||||
|
||||
| Période | Qui | Consommé | Consommé tot. |
|
||||
| ------- | ------- | -------- | ------------- |
|
||||
| < S36 | Adel | 1 | 1 / 38 |
|
||||
|
||||
| category | command | new | implemented | tested |
|
||||
| -------- | ------- | --- | ----------- | ------ |
|
||||
| GENERAL | nop |*| *| *|
|
||||
| GENERAL | help/h/? | * | *| |
|
||||
| GENERAL | quit/exit/q| *| *| |
|
||||
| GENERAL | test | * | *| |
|
||||
| GENERAL | verbose | * | *| |
|
||||
| GENERAL | std | | *| |
|
||||
| GENERAL | fix | | *| |
|
||||
| GENERAL | sci | | *| |
|
||||
| GENERAL | version | * | *| |
|
||||
| GENERAL | uname | * | *| |
|
||||
| GENERAL | edit | | *| |
|
||||
| REAL | + | | *| |
|
||||
| REAL | - | | *| |
|
||||
| REAL | neg | | *| |
|
||||
| REAL | * | | *| |
|
||||
| REAL | / | | *| |
|
||||
| REAL | inv | | *| |
|
||||
| REAL | % | | *| |
|
||||
| REAL | %CH | | *| |
|
||||
| REAL | ^ | | *| |
|
||||
| REAL | sqrt | * | *| |
|
||||
| REAL | sq | * | *| |
|
||||
| REAL | mod |*| *| |
|
||||
| STACK | drop | | *| |
|
||||
| STACK | swap | | *| |
|
||||
| STACK | roll | | | |
|
||||
| STACK | dup | | *| |
|
||||
| STACK | over | | | |
|
||||
| STACK | dup2 | | *| |
|
||||
| STACK | drop2 | | *| |
|
||||
| STACK | rot | | *| |
|
||||
| STACK | list-> | | | |
|
||||
| STACK | rolld | | | |
|
||||
| STACK | pick | | *| |
|
||||
| STACK | dupn | | | |
|
||||
| STACK | dropn | | | |
|
||||
| STACK | depth | | *| |
|
||||
| STACK | ->list | | | |
|
||||
| STACK | load_store | * | *| |
|
||||
| STACK | save_store | * | *| |
|
||||
| STORE | sto | | * | |
|
||||
| STORE | rcl | | * | |
|
||||
| STORE | purge | | * | |
|
||||
| STORE | sto+ | | | |
|
||||
| STORE | sto- | | | |
|
||||
| STORE | sto* | | | |
|
||||
| STORE | sto/ | | | |
|
||||
| STORE | sneg | | | |
|
||||
| STORE | sinv | | | |
|
||||
| STORE | sconj | | | |
|
||||
| STORE | erase | | * | * |
|
||||
| STORE | vars | | * | * |
|
||||
| STORE | include | | | |
|
||||
| STORE | load_vars | | | |
|
||||
| STORE | save_vars | | | |
|
||||
| PROGRAM | eval | | * | |
|
||||
| PROGRAM | load_prog | | | |
|
||||
| PROGRAM | save_prog | | | |
|
||||
| ALGEBRA | neg | | * | * |
|
||||
| ALGEBRA | colct | | | |
|
||||
| ALGEBRA | expan | | | |
|
||||
| ALGEBRA | size | | | |
|
||||
| ALGEBRA | form | | | |
|
||||
| ALGEBRA | obsub | | | |
|
||||
| ALGEBRA | exsub | | | |
|
||||
| ALGEBRA | taylr | | | |
|
||||
| ALGEBRA | isol | | | |
|
||||
| ALGEBRA | quad | | | |
|
||||
| ALGEBRA | show | | | |
|
||||
| ALGEBRA | obget | | | |
|
||||
| ALGEBRA | exget | | | |
|
||||
| BINARY | + | | * | * |
|
||||
| BINARY | - | | * | * |
|
||||
| BINARY | * | | * | * |
|
||||
| BINARY | / | | * | * |
|
||||
| BINARY | dec | | * | * |
|
||||
| BINARY | hex | | * | * |
|
||||
| BINARY | oct | | * | * |
|
||||
| BINARY | bin | | * | * |
|
||||
| BINARY | stws | | | |
|
||||
| BINARY | rcws | | | |
|
||||
| BINARY | rl | | | |
|
||||
| BINARY | rr | | | |
|
||||
| BINARY | rlb | | | |
|
||||
| BINARY | rrb | | | |
|
||||
| BINARY | r->b | | * | * |
|
||||
| BINARY | b->r | | * | * |
|
||||
| BINARY | sl | | | |
|
||||
| BINARY | sr | | | |
|
||||
| BINARY | slb | | | |
|
||||
| BINARY | srb | | | |
|
||||
| BINARY | asr | | | |
|
||||
| BINARY | and | | * | * |
|
||||
| BINARY | or | | * | * |
|
||||
| BINARY | xor | | * | * |
|
||||
| BINARY | not | | * | * |
|
||||
| STRING | + | | * | |
|
||||
| STRING | ->str | | * | |
|
||||
| STRING | str-> | | * | |
|
||||
| STRING | chr | | | |
|
||||
| STRING | num | | | |
|
||||
| STRING | ->lcd | | | |
|
||||
| STRING | lcd-> | | | |
|
||||
| STRING | pos | | | |
|
||||
| STRING | sub | | | |
|
||||
| STRING | size | | | |
|
||||
| STRING | disp | | | |
|
||||
| BRANCH |
|
||||
| BRANCH | if | | * | * |
|
||||
| BRANCH | then | | * | * |
|
||||
| BRANCH | else | | * | * |
|
||||
| BRANCH | end | | * | * |
|
||||
| BRANCH | start | | * | * |
|
||||
| BRANCH | for | | * | * |
|
||||
| BRANCH | next | | * | * |
|
||||
| BRANCH | step | | * | * |
|
||||
| BRANCH | ift | | | |
|
||||
| BRANCH | ifte | | | |
|
||||
| BRANCH | do | | | |
|
||||
| BRANCH | until | | | |
|
||||
| BRANCH | end | | | |
|
||||
| BRANCH | while | | | |
|
||||
| BRANCH | repeat | | | |
|
||||
| BRANCH | end | | | |
|
||||
| TEST | != | | * | |
|
||||
| TEST | > | | * | |
|
||||
| TEST | >= | | * | |
|
||||
| TEST | < | | * | |
|
||||
| TEST | <= | | * | |
|
||||
| TEST | sf | | | |
|
||||
| TEST | cf | | | |
|
||||
| TEST | fs? | | | |
|
||||
| TEST | fc? | | | |
|
||||
| TEST | fs?c | | | |
|
||||
| TEST | fc?c | | | |
|
||||
| TEST | and | | * | |
|
||||
| TEST | or | | * | |
|
||||
| TEST | xor | | * | |
|
||||
| TEST | not | | * | |
|
||||
| TEST | same | | * | |
|
||||
| TEST | == | | * | |
|
||||
| TEST | stof | | | |
|
||||
| TEST | rclf | | | |
|
||||
| TEST | type | | | |
|
||||
| TRIG | pi | | * | * |
|
||||
| TRIG | sin | | * | |
|
||||
| TRIG | asin | | * | |
|
||||
| TRIG | cos | | * | |
|
||||
| TRIG | acos | | * | |
|
||||
| TRIG | tan | | * | |
|
||||
| TRIG | atan | | * | |
|
||||
| TRIG | p→r | | | |
|
||||
| TRIG | r→p | | | |
|
||||
| TRIG | r→c | | | |
|
||||
| TRIG | c→r | | | |
|
||||
| TRIG | arg | | | |
|
||||
| TRIG | →hms | | | |
|
||||
| TRIG | hms→ | | | |
|
||||
| TRIG | hms+ | | | |
|
||||
| TRIG | hms- | | | |
|
||||
| TRIG | d→r | | * | |
|
||||
| TRIG | r→d | | * | |
|
||||
| LOGS | log | | * | |
|
||||
| LOGS | alog | | * | |
|
||||
| LOGS | ln | | * | |
|
||||
| LOGS | exp | | * | |
|
||||
| LOGS | lnp1 | | | |
|
||||
| LOGS | expm | | | |
|
||||
| LOGS | sinh | | * | |
|
||||
| LOGS | asinh | | * | |
|
||||
| LOGS | cosh | | * | |
|
||||
| LOGS | acosh | | * | |
|
||||
| LOGS | tanh | | * | |
|
||||
| LOGS | atanh | | * | |
|
||||
|
||||
### Further
|
||||
|
||||
**MEMORY**
|
||||
mem, menu, order, path, home, crdir, vars, clusr,
|
||||
|
||||
**STAT**
|
||||
∑dat, ∑par, ∑+, ∑-, n∑, cl∑, sto∑, rcl∑, tot, mean, sdev, var, max∑,
|
||||
min∑, col∑, corr, cov, lr, predev, utpc, utpf, utpn, utpt, comb, perm
|
||||
|
||||
**PRINT**
|
||||
pr1, prst, prvar, prlcd, cr, trac, prstc, prusr, prmd
|
||||
|
||||
**SOLV**
|
||||
steq, rceq, isol, quad, show, root,
|
||||
|
||||
**PLOT**
|
||||
ppar, steq, rceq, pmin, pmax, indep, draw, res, axes, centr, *w, *h,
|
||||
sto∑, rcl∑, col∑, scl∑, drw∑, cllcd, digtiz
|
||||
|
||||
**CURSOR**
|
||||
ins, del, ← → ↑ ↓, cmd, undo, last, ml, rdx, prmd
|
||||
|
||||
**CONTRL**
|
||||
sst, halt, abort, kill, wait, key, bepp, cllcd, disp, clmf, errn,
|
||||
errm
|
||||
|
||||
**CATALOG**
|
||||
next, prev, scan, use, fetch, quit
|
||||
|
||||
**UNITS**
|
||||
convert
|
||||
|
||||
**CUSTOM**
|
||||
menu, custom
|
||||
|
||||
## Notes
|
||||
Compiled with g++ Makefile generated by automake.
|
||||
External dependencies needed: automake, readline (libreadline-dev)
|
Loading…
Reference in a new issue