**** RPL Shell: an interactive numerical shell **** http://www.astro.umd.edu/~rauch/RPLsh/ Author: Kevin Rauch, University of Maryland Files and directories are organized as follows: MANIFEST a complete list of files you should have received NEWS summarizes significant changes and bug fixes PROBLEMS known issues running RPLsh on the supported platforms README this file... bin/ binary executables and scripts for the current platform doc/ documentation on RPLsh test/ Makefile and sample RPLsh scripts testing a few basic functions Quick start guide: ----------------- 1) Put the bin/ directory in your PATH, or move its contents to somewhere more convenient. 2) Start the rplsh executable! The command `rplsh -h' will summarize usage. For Unix users, the recommended way to start an interactive session is via the xrpl script, which starts the program in its own xterm window, and also forces special keys (such as function keys) to return preset escape sequences recognized by the program. You can give the script both X toolkit arguments and rplsh arguments, but all X arguments must come first, and end with a -- (even if there are no rplsh-specific arguments). Example: xrpl -geometry 80x24 -fn 7x13 -- Platform-specific notes: ----------------------- [MS-DOS (msdos-x86)] * The msdos-x86 executable requires DPMI services. This comes standard on many systems (including MS Windows), but if you get complaints about "no DPMI", download the free DJGPP DPMI server package ( http://www.delorie.com/djgpp/dl/ofc/simtel/v2misc/csdpmi5b.zip ) and place the cwsdpmi.exe executable in the same directory as rplsh.exe. The DPMI host should load automatically when you run RPLsh. [Mac OS X (macx-ppc)] * The macx-ppc executable was built with GNU ncurses (the native curses library is very limited, and insufficient to compile the program). To run it you will need to download the ncurses terminfo database, also available from the download page. Unpack it anywhere you find convenient, then set your TERMINFO environment variable to the location of the terminfo/ directory.