Aucune description

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

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