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        sverrehu@online.no
        Kurvn. 30               http://home.sol.no/~sverrehu/
        N-0495 Oslo
        Norway

You can use and copy this for _free_, but I would be very happy if you
send me an E-mail and tell me that you use it. If you insist on paying
something, please donate some money to an organization that strives to
make the world a better place for everyone.

I don't like bugs, so please help me removing them by reporting
whatever you find!

