Keine Beschreibung

Paul Onions 27955a72f1 Added mention of the example file. vor 10 Jahren
data 5a1eaf2c25 Improved format of stack-effect strings. vor 10 Jahren
examples 17c2207ceb Tidied up calculator selection code. vor 11 Jahren
LICENCE 3b7843ea2b Added LICENCE file. vor 11 Jahren
README 27955a72f1 Added mention of the example file. vor 10 Jahren
rpl-base.el aec64b04bd Apropos function now working. vor 11 Jahren
rpl-edb.el 5a1eaf2c25 Improved format of stack-effect strings. vor 10 Jahren
rpl-tools.el 17c2207ceb Tidied up calculator selection code. vor 11 Jahren
sysrpl-mode.el 17c2207ceb Tidied up calculator selection code. vor 11 Jahren

README

RPL-TOOLS
=========

Useful tools for working with RPL source code, the native language of
HP48/49/50-series calculators.

In its present state really only provides `sysrpl-mode' for editing
SysRPL source files. This mode implements syntax highlighting and
documentation lookup, using data extracted from Carsten Dominik's
``entries.db'' system RPL entries database[1].

To install rpl-tools, clone the Mercurial repository to somewhere in
your Emac's `load-path' with

hg clone http://bitbucket.org/pdo/rpl-tools

then add the following to your ~/.emacs file

(require 'rpl-tools)
(add-to-list 'sysrpl-mode-hook 'eldoc-mode)

where the latter command activates the minor eldoc-mode in
sysrpl-mode. This causes a stack-effect diagram to be displayed in
the minibuffer whenever the cursor is on a SysRPL word.

More info can be displayed with the `sysrpl-apropos-thing-at-point'
command, bound to C-c C-a by default, which pops up another window
with any extra information available for the supplied word (by default
the one under the cursor).

Note: sysrpl-mode is not bound to any particular file extension by
default, so to enable it for any particular buffer you will have to
issue the command

M-x sysrpl-mode

to place the current buffer into sysrpl-mode. Alternatively you can
use the standard Emacs file local variable feature to embed the mode
name into the first line of a file. See the included example in
examples/timedone.s for details.


REFERENCES
==========

[1] Carsten Dominik's SysRPL entries database
http://staff.science.uva.nl/~dominik/hpcalc/entries/index.html

--
Paul Onions
25 May 2014
paul.onions@acm.org