The slsh_readline_init function is used to initialize the
S-Lang readline interface for use by an slsh-based application with
name appname. If defines an intrinsic variable called
__RL_APP__ whose value is given by appname. If the
file $HOME/.slrlinerc file exists, it will be loaded into the
interpreter. This file together with the __RL_APP__ variable
may be used by the user to customize the interface by, e.g., reading
previous history files, etc.
The slsh_readline function utilizes the S-Lang readline
interface to read input from the terminal using the specified prompt.
If two parameters are given, the value of the first one must be a
RLine_Type object obtained previously from the
slsh_readline_new function.
This function may be used to implement an alternative update hook
for the specified readline object. The hook must have one of the
following signatures, depending upon whether or not the optional
funcdata was given:
This function may be used to specify a function to be called by
slsh_readline after to the editing loop before returning to
the caller. It must have one of
the following signatures:
This function is used to set a callback function that will get
called when the readline routines sense that the display width has
changed. It must have one of the following signatures:
The second form must be used if a funcdata argument was
passed to the slsh_set_readline_update_hook function. The
width argument to the callback function in an integer that
specifies the new width.
If the func argument is NULL, then the callback function
will be cleared.