Function:     GgiSetResources

Purpose:      Modify default fallback resources for Ggi

Category:     USER-INTERFACE, SYSTEM

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"
              char **resources;

              GgiSetResources(resources);

                 resources  -  fallback resources as defined by the Xt,
                               the X Toolkit: a NULL-terminated array
                               of character pointers.

Description:  GgiSetResources allows the programmer to deviate from the
              default fallback resources defined by Ggi. Examples of things
              that can be modified are colours and fonts. A practical way
              of doing this is to inspect the resource string in this source
              file (ggi.c) and then define any new or deviating strings.

              There is a limited possiblity for setting resources of
              individual elements. This can only be done for elements
              created by GgiLabel(), GgiButton() or GgiMenu(). The name
              to be used in the resource specification is the text string
              used when GgiLabel was called, or the keyword without the
              equals sign for GgiButton and GgiMenu.

              GgiSetResources must be called before any element is created,
              i.e. in the initialization phase of the program.

Updates:      Jan 13, 1998: JPT, Document created.
              Jun 23, 1999: JPT, Specified resources now are merged.
              Dec 14, 2001: JPT, Fixed documentation w.r.t. argument.