This sample C code demonstrates the use of a messages macros file that allows
software to be written that functions correctly on both locale capable
and non-locale capable operating systems.  To compile with message catalog
support built in, ensure that the define -DNLS is contained within the CFLAGS
makefile variable.  To compile without message catalog support, remove the
-DNLS define from the CFLAGS variable in the makefile.

Simply type "make" to compile the software and the message catalog.  You must
have installed the gencat software beforehand for the software to compile the
message catalog.

After compilation, typing "foobar" will result in the binary printing out the
default messages stored within itself.  This is because it cannot find
the location for the message catalog.  To get it to access the message
catalog, you need to correctly specify the NLSPATH environment variable.
This specifies the directories the operating system searches to find the
message catalogs requested by the software.

	In csh: (tcsh)
	% setenv NLSPATH `pwd`/%N

	In sh: (bash)
	% export NLSPATH=`pwd`/%N

The software will now access the messages stored within the foobar.cat message
catalog.

Patrick D'Cruze (pdcruze@orac.iinet.com.au)
