=============================================
muless - hypertextual less 
(C) 1999 by M. Andreoli <andreoli@pisoft.it>
=============================================

Description
-------------
muless is a programmable pager less-like, with title, messages bar,
and keyboard events.
The call-back routine is specified with -e switch and can be a shell
script (see "Events and control-program").  
The control-program react to keyboard's event rewriting the input-file
and sending the USR1 (kill -10) signal to calling process.

muless support iso-latin keycode.


Se also "muless -h"

Installation
-------------

			** INSTALL in Linux **

	# mkdir muless
	# tar -C muless -zxf muless.tgz
	# cd muless ; make
	# make install  (copy muless in /usr/local/bin)


			** INSTALL in muLinux **

Unpack muless.tgz and copy "muless" binary in /usr/bin

	# cp muless.tgz /tmp
	# gzip -dc muless.tgz | tar -xf-
	# cp muless /usr/bin

			** TECH NOTES **

Demos
---------

Try the *.demo (not in xterm). 

Only fm.demo, br.demo, mon.demo work on muLinux without awk.

muless mode
------------

Switch -l (less) , -m (mutt) and -x (lynx). Mode "less" can be reached
renaming muless->less or making a symlink.

Hyper-textual Links
--------------------

Enclose the link between this tags:

		control-a this is a link control-b

You can insert this  codes (ascii \0 and \1) with "vi":

		control-v control-a
		control-v control-b
		

Events and control-program
--------------------------

The 'prog' is started (via fork) as :

			prg "event" pid name

"event" part is bound to muless "mode":

        less:           event="key nome-file"
        mutt:           event="key row-number row-contents"
        lynx:           event="key row-number link"



"name" is the instance-name of calling process, useful in scripting.

If 'prog' send the USR1 (10) signal to this pid, muless reload the file.

Additional rows in input file, like: 

        :T: top title 
	:B: bottom menu 
	:S: status message 

can simulate -t, -b options and control "status message" (last row).


Monochrome screens
--------------------

-M options, or in the environment: 
		
	export HAS_COLOR=FALSE


Refresh mode
-------------

	muless -r seconds  file

Es:
		muless -r 2 -t "Uptime monitor" /proc/uptime

Note:
-r swich can be used in conjuntion with -e swith.
