shhmsg - library for displaying messages.
=========================================

This is a set of functions for very simple message handling in
terminal based programs. To use these in your own programs, include
shhmsg.h, and link with the library. You should also call the function
msgSetName at startup, to indicate what program identification should
be used in the error messages.

Most functions accept printf-like variable arguments.


Overview of files
-----------------

What follows is a brief overview. Please refer to the c-sources for
detailed descriptions. There are no manual pages yet, and probably
will never be, unless someone writes them for me.

errno.c
	Functions for displaying messages depending on the current
	errno-value. 

error.c
	Non-fatal (non-aborting) error message function.

fatal.c
	Fatal error message function. Aborts the program.

message.c
	The function in this file works quite like printf, but it is
	possible to make this function silent by setting a flag.

progname.c
	For setting the name of the program. This name is used in
	error messages, in the traditional Unix-ish way.

streams.c
	Handles the reassignment of streams, so the functions can output
	to any user defined file stream.

verbose.c
	printf-like function that takes an additional parmeter
	specifying verbosity level of the message. This lets the user
	filter less interresting messages.


Documentation
-------------

The file shhmsg.txt (contributed by Louis W. Erickson) describes the
use of the library.


Portability
-----------

The library has (more or less recently) been compiled and `tested' on
the following systems:

	IRIX Release 5.2 IP22
	GNU/Linux 2.1.6
	SunOS Release 4.1.3_U1
	ULTRIX V4.4 (Rev. 69)

All compilations were done using GNU's gcc, and GNU's make.


Author
------

The program is written by

	Sverre H. Huseby
	Kurvn. 30
	N-0495 Oslo
	Norway

	sverrehu@ifi.uio.no
	http://www.ifi.uio.no/~sverrehu/

You can use and copy this for free. If you decide to use it, please do
me three small favours:

	1. Tell me! (E-mail, postcard, letter, whatever. If you wish
	   to give me something, please send a bottle of your
	   favourite beer (making this BeerWare))
	2. Let your friends and favourite download site have a copy!
	   (with all files intact, please..)
	3. Report any bugs you find!

