How to use the rl functions.
=============================

From the main application:

	- call rl_init(char *prompt, int length, int hist)

where: 
	prompt is the prompt that will be used for the command line input.
		if NULL, then a default prompt of ">" is used.
	length is the maximum command length in characters
		if 0, then a default, see rl.h, will be used.
	hist is the number of commands to keep in the history.
		if 0, then a default, see rl.h, will be used.
		There is also a maximum value imposed (see rl.h)

	If rl_init() return 0 then the calling application should bail out.
	rl_init() returns !0 on success.

To get a input line:

	(char *)line = rl_getline().

	rl_getline() returns a pointer to a line of input.
	The buffer will be reused at the next call to rl_getline() so, users
	should copy the buffer contain to a secure place if they need to keep
	the information it contains across more then one rl_getline() call.

	rl_getline() does not return a empty line. If the user did not
	enter any characters on the input line, then rl_getline() shows
	a new prompt.

	rl_getline() returns NULL on end of input. This means either the user
	has hit ^D or fgets() on stdin return NULL.

The SIGINT signal (or any other signals for that mather) are not handled my the rl
functions. In the event of a SIGINT, the calling application should send a "\r\n"
sequence to the stdin and call rl_getline() again.

There is currently no support for the SIGWINCH signal indicating the input window
size has changed. rl_getline() polls the current window size each time it is called
so the proper size will be used on the next command input.

The 'h' and 'history' command are handled internaly bu rl_getline(). Thus they are
reserved commands and should be documented properly by the calling application's 
help facility. The usage of these command is:

h|history [n]

where n is an optional argument that sets the maximum number of command line
that will be keaped in the history list. 'n' must be between 1 and DEF_MAXHIST (see rl.h).
Without any arguments, a list of the current history is displayed.

link with librl.a
