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 source files
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 that 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.4.17 with glibc 2.2.5
	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        shh@thathost.com
        Lindealleen 18 A        http://shh.thathost.com/
        N-0487 Oslo
        Norway


License
-------

This program is released under the Artistic License:

  http://www.opensource.org/licenses/artistic-license.html

Comments (even as simple as "I use your program") are very welcome.
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!

