path: root/src/ResConfig.c

/*

Copyright 1987, 1988, 1998  The Open Group

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation.

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of The Open Group shall not be
used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization from The Open Group.

*/
/*****************************************************************

(C) COPYRIGHT International Business Machines Corp. 1992,1997
    All Rights Reserved

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
THE IBM CORPORATION BE LIABLE FOR ANY CLAIM, DAMAGES, INCLUDING,
BUT NOT LIMITED TO CONSEQUENTIAL OR INCIDENTAL DAMAGES, OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the IBM Corporation shall
not be used in advertising or otherwise to promote the sale, use or other
dealings in this Software without prior written authorization from the IBM
Corporation.

******************************************************************/

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include "Intrinsic.h"
#include "IntrinsicI.h"
#include "Core.h"
#include "CoreP.h"
#include "ShellP.h"
#include "StringDefs.h"
#include "ResConfigP.h"
#include <X11/Xatom.h>
#include <stdio.h>
#include <stdlib.h>

#define MAX_BUFFER 512

static void _search_child(Widget, char *, char *, char *, char *, char, char *);
static void _set_and_search(Widget, char *, char *, char *, char *, char,
                            char *);
static int _locate_children(Widget, Widget **);

/*
 * NAME: _set_resource_values
 *
 * FUNCTION:
 *      This function sets the value on the widget.  It must first determine
 *      if the last part is a valid resource for that widget.  (eg.
 *      labelString is a valid resource for label but not for bulletin board)
 *      It must also add the resource to the application's resource database
 *      and then query it out using specific resource strings that it builds
 *      from the widget information.  This ensures that a customizing tool
 *      on-the-fly paradigm is followed:  an application that is
 *      instantaneously updated should look the same as one that is restarted
 *      and uses the .Xdefaults file.
 *
 * PARAMETERS:
 *      w               the widget to match
 *      resource        the resource string to be matched
 *      value           the value to be set
 *      last_part       the last resource part (e.g. *background)
 *
 * RETURN VALUES: void
 *
 * ERRORS: none
 */
static void
_set_resource_values(Widget w, char *resource, char *value, char *last_part)
{
    XrmDatabase db = NULL;
    char *resource_name = NULL;
    char *resource_class = NULL;
    char *return_type;
    XrmValue return_value;
    char *resource_value;
    Widget cur = w;
    char *temp;
    XtResourceList resources_return = NULL;
    Cardinal num_resources_return = 0;
    Cardinal res_index;
    Boolean found_resource = False;
    Display *dpy;
    XrmDatabase tmp_db;

    if (last_part == NULL)
        return;

    if (!XtIsWidget(w)) {
        if (w == 0 || w->core.parent == 0)
            return;
        dpy = XtDisplay(w->core.parent);
    }
    else {
        dpy = XtDisplay(w);
    }
    tmp_db = XtDatabase(dpy);

    /*
     * get a list of all the valid resources for this widget
     */
    XtGetResourceList(w->core.widget_class,
                      &resources_return, &num_resources_return);

    /*
     * try to match the last_part of the resource string with
     * a resource in this resource list
     */
    for (res_index = 0; res_index < num_resources_return; res_index++) {
        if ((strcmp(last_part,
                    resources_return[res_index].resource_name) == 0) ||
            (strcmp(last_part,
                    resources_return[res_index].resource_class) == 0)) {
            found_resource = True;
            break;
        }
    }

    /*
     * if resource is not a valid resource for this widget
     * or the resource name or class are NULL
     * then exit this function
     */
    if (!found_resource
        || !resources_return[res_index].resource_name
        || !resources_return[res_index].resource_class) {
        XtFree((char *) resources_return);
        return;
    }

    /*
     * build the full resource name and class specifications so
     * that you can query the resource database
     *      eg: .app.button1.foreground
     *          .App.XmPushButton.Foreground
     */
    while (cur != NULL) {
        /*
         * create resource name string
         */
        if (resource_name) {
            XtAsprintf(&temp, ".%s%s", cur->core.name, resource_name);
            XtFree(resource_name);
        }
        else if (!XtIsWidget(cur) || !cur->core.name) {
            cur = XtParent(cur);
            continue;
        }
        else {
            XtAsprintf(&temp, ".%s", cur->core.name);
        }
        resource_name = temp;

        /*
         * create resource class string
         */
        if ((XtIsTopLevelShell(cur)) && (XtParent(cur) == NULL)) {
            ApplicationShellWidget top = (ApplicationShellWidget) (cur);

            if (resource_class) {
                XtAsprintf(&temp, ".%s%s",
                           top->application.class, resource_class);
            }
            else {
                XtAsprintf(&temp, ".%s", top->application.class);
            }
        }
        else {
            if (resource_class) {
                XtAsprintf(&temp, ".%s%s",
                           cur->core.widget_class->core_class.class_name,
                           resource_class);
            }
            else {
                XtAsprintf(&temp, ".%s",
                           cur->core.widget_class->core_class.class_name);
            }
        }

        XtFree(resource_class);
        resource_class = temp;

        cur = XtParent(cur);
    }

    /*
     * add the resource name to the end of the resource name string
     */
    XtAsprintf(&temp, "%s.%s", resource_name,
               resources_return[res_index].resource_name);

    XtFree(resource_name);
    resource_name = temp;

    /*
     * add the resource class to the end of the resource class string
     */
    XtAsprintf(&temp, "%s.%s", resource_class,
               resources_return[res_index].resource_class);

    XtFree(resource_class);
    resource_class = temp;

#ifdef DEBUG
    fprintf(stderr, "resource_name = %s\n", resource_name);
    fprintf(stderr, "resource_class = %s\n", resource_class);
#endif

    /*
     * put the resource and its value in a resource database and
     * then query it back out again using the specific name and
     * class resource strings that were built above.  This is
     * necessary to maintain a precedence similar to the .Xdefaults
     * file
     */
    XrmPutStringResource(&db, resource, value);
    XrmMergeDatabases(db, &tmp_db);
    XrmGetResource(tmp_db, resource_name, resource_class,
                   &return_type, &return_value);
    if (return_type)
        resource_value = XtNewString(return_value.addr);
    else
        resource_value = XtNewString(value);

#ifdef DEBUG
    fprintf(stderr,
            "Apply:\n\twidget = %s\n\tlast_part = %s\n\tvalue = %s\n",
            (w->core.name == NULL) ? "NULL" : w->core.name,
            resources_return[res_index].resource_name, resource_value);
#endif
    /*
     * use XtVaSetValues with XtVaTypedArg to convert the value of
     * type String the the same type as the resource (last_part).
     * Then set the value.
     */
    XtVaSetValues(w,
                  XtVaTypedArg, resources_return[res_index].resource_name,
                  XtRString, resource_value, strlen(resource_value) + 1, NULL);

    XtFree((char *) resources_return);
    XtFree(resource_name);
    XtFree(resource_class);
    XtFree(resource_value);
}

/*
 * NAME: _apply_values_to_children
 *
 * FUNCTION:
 *      Once the resource string matches the value must be applied to
 *      all children if applicable. (eg. App*Form.background must apply
 *      background to all children of the Form widget)
 *
 * PARAMETERS:
 *      w               the widget to match
 *      remainder       the part of the resource string left over
 *      resource        the resource string to be matched
 *      value           the value to be set
 *      last_token      the last * or . before the final resoruce part
 *      last_part       the last resource part (e.g. *background)
 *
 * RETURN VALUES: void
 *
 * ERRORS: none
 */
static void
_apply_values_to_children(Widget w,
                          char *remainder,
                          char *resource,
                          char *value,
                          char last_token,
                          char *last_part)
{
    int i;
    int num_children;
    Widget *children;

    /*
     * Recursively search through the children
     */
    num_children = _locate_children(w, &children);

    for (i = 0; i < num_children; i++) {

#ifdef DEBUG
        if (XtIsWidget(children[i]) && XtIsWidget(w))
            fprintf(stderr, "searching child %s of parent %s\n",
                    children[i]->core.name, w->core.name);
        else
            fprintf(stderr, "searching child (NULL) of parent %s\n",
                    w->core.name);
        if (!XtIsWidget(children[i]))
            fprintf(stderr, "children[%d] is NOT a widget\n", i);
        if (!XtIsWidget(w))
            fprintf(stderr, "w is NOT a widget\n");
#endif

        _set_resource_values(children[i], resource, value, last_part);
        _apply_values_to_children(children[i], remainder,
                                  resource, value, last_token, last_part);
    }

    XtFree((char *) children);
}

/*
 * NAME: _search_child
 *
 * FUNCTION:
 *      descends through each child of the tree
 *
 * PARAMETERS:
 *      w               the widget whose children are to be searched
 *      indx            index into the resource string
 *      remainder       the remaining part of the resource string
 *      resource        the resource string to be matched
 *      value           the value to be applied
 *      last_token      the last * or . before the final resoruce part
 *      last_part       the last resource part (e.g. *background)
 *
 * RETURN VALUES: none
 *
 * ERRORS: none
 */
static void
_search_child(Widget w,
              char *indx,
              char *remainder,
              char *resource,
              char *value,
              char last_token,
              char *last_part)
{
    int i;
    int num_children;
    Widget *children;

    /*
     * Recursively search through the children
     */
    num_children = _locate_children(w, &children);
    for (i = 0; i < num_children; i++) {
        _set_and_search(children[i], indx, remainder, resource,
                        value, last_token, last_part);
    }

    XtFree((char *) children);
}

/*
 * NAME: _get_part
 *
 * FUNCTION:
 *      This routine will return the token and following part of the resource
 *      when given the current index it will update the index accordingly
 *
 * PARAMETERS:
 *      remainder       the part of the resource string left over
 *      indx            the index into the resource string
 *      part            the parsed off part of the resource string
 *
 * RETURN VALUES:
 *      char            the token (* or . or ?) preceding the resource part
 *      indx            the index into the resource string
 *      part            the parsed off part of the resource string
 *
 * ERRORS: none
 */
static char
_get_part(char *remainder _X_UNUSED, char **indx, char **part)
{
    char buffer[MAX_BUFFER];
    char *buf_ptr;
    char token = **indx;
    int i = 0;

    /*
     * copy the remainder part into the buffer
     */
    buf_ptr = buffer;
    (*indx)++;                  /* get rid of the token         */
    while (**indx && (**indx != '.') && (**indx != '*')) {
        *buf_ptr++ = *(*indx)++;
        if (++i >= MAX_BUFFER - 1)
            break;
    }
    *buf_ptr = '\0';

    *part = XtNewString(buffer);        /* return a new string to part  */

    if (strcmp(*indx, "") == 0)
        *indx = NULL;

    return (token);             /* return the token             */
}

/*
 * NAME: _match_resource_to_widget
 *
 * FUNCTION:
 *      This function matches the resource part to the widget name or class
 *
 * PARAMETERS:
 *      w               the widget to match
 *      part            the parsed off part of the resource string
 *
 * RETURN VALUES:
 *      Boolean         true if a match occurs
 *
 * ERRORS: none
 */
static Boolean
_match_resource_to_widget(Widget w, char *part)
{
    /*
     * Match any widget at this level if the ? is used
     */
    if (strcmp(part, "?") == 0)
        return (True);

    /*
     * if the object is really a widget then its name can be matched
     * otherwise only use its class.  Note that if you try to reference
     * a widget name when the object is not a widget, you may get a
     * core dump from an invalid pointer reference.
     */
    if (XtIsWidget(w)) {
        if ((strcmp(w->core.name, part) == 0) ||
            (strcmp(w->core.widget_class->core_class.class_name, part) == 0))
            return (True);
        else
            return (False);
    }
    else {
        if ((strcmp(w->core.widget_class->core_class.class_name, part) == 0))
            return (True);
        else
            return (False);
    }
}

/*
 * NAME: _set_and_search
 *
 * FUNCTION:
 *      The algorithm to search the widget tree and apply a resource string
 *
 * PARAMETERS:
 *      w               the widget to match
 *      indx            the index into the resource string
 *      remainder       the part of the resource string left over
 *      resource        the resource string to be matched
 *      value           the value to be set
 *      last_token      the last * or . before the final resoruce part
 *      last_part       the last resource part (e.g. *background)
 *
 * RETURN VALUES: none
 *
 * ERRORS: none
 *
 * ALGORITHM:
 * loop (look at all children)
 *      if (resource segment and current widget match)
 *              if '.'
 *                      if at end of resource string
 *                              set values (    .=over all children
 *                                              *=this widget only)
 *                      else
 *                              descend the widget tree
 *                              and parse off resource segment
 *                      exit the loop
 *              if '*'
 *                      if at end of resource string
 *                              set values (    .=over all children
 *                                              *=this widget only)
 *                      descend and parse
 *      else
 *              if '.'
 *                      continue looping
 *              if '*'
 *                      descend but don't parse
 *                      continue looping
 * end loop
 *
 * NOTE:  the _set_resource_values routine will not allow a value to be
 *      set on a resource against the rules of the resource database manager
 */
static void
_set_and_search(Widget w,
                char *indx,
                char *remainder,
                char *resource,
                char *value,
                char last_token,
                char *last_part)
{
    char *part;
    char *local_index = indx;
    char token;

    /*
     * parse off one part, return token and the new index
     */
    token = _get_part(remainder, &local_index, &part);

    if (_match_resource_to_widget(w, part)) {
        if (token == '.') {
            if (local_index == NULL) {
                if (last_token == '.') {
                    _set_resource_values(w, resource, value, last_part);
                }
                else if (last_token == '*') {
                    _set_resource_values(w, resource, value, last_part);
                    _apply_values_to_children(w,
                                              remainder, resource, value,
                                              last_token, last_part);
                }
            }
            else
                _search_child(w, local_index, remainder,
                              resource, value, last_token, last_part);
            XtFree(part);
            return;
        }
        if (token == '*') {
            if (local_index == NULL) {
                if (last_token == '.') {
                    _set_resource_values(w, resource, value, last_part);
                }
                else if (last_token == '*') {
                    _set_resource_values(w, resource, value, last_part);
                    _apply_values_to_children(w,
                                              remainder, resource, value,
                                              last_token, last_part);
                }
            }
            else
                _search_child(w, local_index, remainder,
                              resource, value, last_token, last_part);
        }
    }
    else {                      /* if the widget name and class don't match the part */
        /* if (token == '.') just continue looping */

        if (token == '*') {
            _search_child(w, indx, remainder, resource, value,
                          last_token, last_part);
        }
    }

    XtFree(part);
}

/*
 * NAME: _get_last_part
 *
 * FUNCTION:
 *      This routine will parse off the last segment of a resource string
 *      and its token and return them.  the remainder of resource is also
 *      returned.  strcoll is used to guarantee no problems with
 *      international strings.
 *
 * PARAMETERS:
 *      remainder       the part of the resource string left over
 *      part            the parsed off part of the resource string
 *
 * RETURN VALUES:
 *      char            the token (* or . or ?) preceding the resource part
 *      remainder       the part of the resource string left over
 *      part            the parsed off part of the resource string
 *
 * ERRORS: none
 */
static char
_get_last_part(char *remainder, char **part)
{
    char *loose, *tight;

    loose = strrchr(remainder, '*');
    tight = strrchr(remainder, '.');

    if ((loose == NULL) && (tight == NULL)) {
        *part = XtNewString(remainder);
        return ('.');
    }
    if ((loose == NULL) || (tight && (strcoll(loose, tight) < 0))) {
        *tight++ = '\0';        /* shorten the remainder string */
        *part = XtNewString(tight);
        return ('.');
    }
    if ((tight == NULL) || (loose && (strcoll(tight, loose) < 0))) {
        *loose++ = '\0';
        *part = XtNewString(loose);
        return ('*');
    }
    *part = NULL;

    return ('0');               /* error - return 0 */
}

/*
 * NAME: _search_widget_tree
 *
 * FUNCTION:
 *      This function tries to match a resource string to the widgets
 *      it applies to.  The functions it invokes to do this then set
 *      the value for that resource to each widget.
 *
 *      The resource string has to be parsed into the following format:
 *              resource = App*Form*button1.background
 *              remainder = *Form*button1
 *              last_part = background          last_token = .
 *      As the widget tree is recursively descended, these variables are
 *      passed.  The remainder is parsed at each level in the widget
 *      tree as the _set_and_search function attempts to match
 *      the resource part (eg. part = Form  token = *) to a widget.  When
 *      the entire resource string has been matched, the _set_resource_values
 *      functions is called to apply the value to the widget or widgets.
 *
 * PARAMETERS:
 *      w               a widget from whose toplevel shell ancestor
 *                      the search will start
 *      resource        the resource string to match
 *      value           the value to apply
 *
 * RETURN VALUES: none
 *
 * ERRORS: none
 */
static void
_search_widget_tree(Widget w, char *resource, char *value)
{
    Widget parent = w;
    char *last_part;
    char *remainder = NULL;
    char last_token;
    char *loose, *tight;
    int loose_len, tight_len;

    /*
     * Find the root of the tree given any widget
     */
    while (XtParent(parent) != NULL) {
        parent = XtParent(parent);
    }
#ifdef DEBUG
    if (XtIsWidget(w) && XtIsWidget(parent))
        fprintf(stderr, "widget = %s parent = %s\n",
                w->core.name, parent->core.name);
    else
        fprintf(stderr, "widget = NULL parent = NULL\n");
#endif

    /*
     * parse off the Class name that was prepended to this string in
     * a customizing tool
     */
    loose = strchr(resource, '*');
    tight = strchr(resource, '.');
    if ((loose == NULL) && (tight == NULL))
        return;

    loose_len = (loose) ? (int) strlen(loose) : 0;
    tight_len = (tight) ? (int) strlen(tight) : 0;

    if ((loose == NULL) || (tight_len > loose_len))
        remainder = XtNewString(tight);
    else if ((tight == NULL) || (loose_len > tight_len))
        remainder = XtNewString(loose);

    /*
     * Parse last segment off of resource string, (eg. background, font,
     * etc.)
     */
    if (remainder) {
        last_token = _get_last_part(remainder, &last_part);
        /*
         * this case covers resources of only one level (eg. *background)
         */
        if (remainder[0] == 0) {
            _set_resource_values(w, resource, value, last_part);
            if (last_token == '*')
                _apply_values_to_children(parent, remainder, resource,
                                          value, last_token, last_part);
            /*
             * all other resource strings are recursively applied to the widget tree.
             * Prepend a '.' to the remainder string if there is no leading token.
             */
        }
        else {
            char *indx, *copy;

            if (remainder[0] != '*' && remainder[0] != '.') {
                XtAsprintf(&copy, ".%s", remainder);
                XtFree(remainder);
                remainder = copy;
            }
            indx = remainder;
            _set_and_search(parent, indx, remainder, resource, value,
                            last_token, last_part);
        }

        XtFree(remainder);
        XtFree(last_part);
    }
}

/*
 * NAME: _locate_children
 *
 * FUNCTION:
 *      returns a list of all of a widget's children
 *
 * PARAMETERS:
 *      w               the parent to search for its children
 *      children        the list of children that is created
 *      normal          flag for normal children
 *      popup           flag for popup children
 *
 * RETURN VALUES:
 *      int             the number of children
 *      children        the list of children found
 *
 * ERRORS: none
 */
static int
_locate_children(Widget parent, Widget **children)
{
    CompositeWidget comp = (CompositeWidget) parent;
    Cardinal i;
    int num_children = 0;
    int current = 0;

    /*
     * count the number of children
     */
    if (XtIsWidget(parent))
        num_children =
            (int) ((Cardinal) num_children + parent->core.num_popups);
    if (XtIsComposite(parent))
        num_children =
            (int) ((Cardinal) num_children + comp->composite.num_children);
    if (num_children == 0) {
        *children = NULL;
        return (0);
    }

    *children = (Widget *)
        XtMalloc((Cardinal) (sizeof(Widget) * (size_t) num_children));

    if (XtIsComposite(parent)) {
        for (i = 0; i < comp->composite.num_children; i++) {
            (*children)[current] = comp->composite.children[i];
            current++;
        }
    }

    if (XtIsWidget(parent)) {
        for (i = 0; i < parent->core.num_popups; i++) {
            (*children)[current] = comp->core.popup_list[i];
            current++;
        }
    }

    return (num_children);
}

#ifdef DEBUG
/*
 * NAME: dump_widget_tree
 *
 * FUNCTION:
 *      recursively printout entire widget tree
 *
 * PARAMETERS:
 *      w               the widget to match
 *      indent          the amount to indent each line
 *
 * RETURN VALUES: void
 *
 * ERRORS: none
 */
static void
dump_widget_tree(Widget w, int indent)
{
    int i, j;
    int num_children;
    Widget *children;

    /*
     * Recursively search through the children
     */
    num_children = _locate_children(w, &children);
    indent += 2;
    for (i = 0; i < num_children; i++) {
        if (children[i] != NULL) {
            for (j = 0; j < indent; j++)
                fprintf(stderr, " ");
            if (XtIsWidget(children[i])) {
                fprintf(stderr, "(%s)\t", children[i]->core.name);
                fprintf(stderr, "(%s)\n",
                        children[i]->core.widget_class->core_class.class_name);
            }
            else {
                fprintf(stderr, "(NULL)\t");
                fprintf(stderr, "(%s)\n",
                        children[i]->core.widget_class->core_class.class_name);
            }
        }
        dump_widget_tree(children[i], indent);
    }

    XtFree((char *) children);
}
#endif

/*
 * NAME: _XtResourceConfiguationEH
 *
 * FUNCTION:
 *      This function is the event handler for the on-the-fly communication
 *      with a resource customization tool.  This event handler must be
 *      registered for the toplevel shell of each app.  This is best done
 *      in the _XtCreatePopupShell and _XtAppCreateShell functions in Xt's
 *      Create.c source file.
 *
 *      The property used to communicate with a customizing tool is
 *      placed on the toplevel shell window of the application.  The
 *      customizing tool places a property on this window which causes
 *      this event handler to be invoked via the PropertyNotify event.
 *      This event handler reads the property and then deletes it from
 *      the server.  The contents of the property are a resource string
 *      and value.  The event handler then calls functions to walk the
 *      applications widget tree, determining which widgets are affected
 *      by the resource string, and then applying the value with XtSetValues.
 *
 * PARAMETERS:
 *      w               the widget that invoked this event handler
 *      client_data     not used
 *      event           the event structure
 *
 * RETURN VALUES: none
 *
 * ERRORS: none
 */
void
_XtResourceConfigurationEH(Widget w,
                           XtPointer client_data _X_UNUSED,
                           XEvent *event)
{
    Atom actual_type;
    int actual_format;
    unsigned long nitems;
    unsigned long leftover;
    char *data = NULL;
    char *data_ptr;

#ifdef DEBUG
    int indent = 0;
#endif
    XtPerDisplay pd;

#ifdef DEBUG
    fprintf(stderr, "in _XtResourceConfiguationEH atom = %u\n",
            (unsigned) event->xproperty.atom);
    fprintf(stderr, "    window = %x\n", (unsigned) XtWindow(w));
    if (XtIsWidget(w))
        fprintf(stderr, "    widget = %zx   name = %s\n", (size_t) w,
                w->core.name);
#endif

    pd = _XtGetPerDisplay(XtDisplay(w));

    /*
     * The window on which a customizing tool places the property
     * is determined at this point.  It should be the applications
     * toplevel shell window.
     *
     * A customizing tool sends a "ping" to the application on
     * the RCM_INIT property.  The application answers the ping
     * by deleting the property.
     */
    if (event->xproperty.atom == pd->rcm_init) {
        XDeleteProperty(XtDisplay(w), XtWindow(w), pd->rcm_init);

#ifdef DEBUG
        if (XtIsWidget(w))
            fprintf(stderr, "%s\n", w->core.name);
        else
            fprintf(stderr, "NULL name\n");
        dump_widget_tree(w, indent);

        fprintf(stderr, "answer ping\n");
#endif
    }

    /*
     * This event handler ignores any property notify events that
     * are not RCM_INIT or RCM_DATA
     */
    if (event->xproperty.atom != pd->rcm_data)
        return;

    /*
     * Retrieve the data from the property
     */
#ifdef DEBUG
    fprintf(stderr, "receiving RCM_DATA property\n");
#endif
    if (XGetWindowProperty(XtDisplay(w),
                           XtWindow(w),
                           pd->rcm_data, 0L, 8192L,
                           TRUE, XA_STRING,
                           &actual_type, &actual_format, &nitems, &leftover,
                           (unsigned char **) &data) == Success &&
        actual_type == XA_STRING && actual_format == 8) {
        /*
         *      data format is:
         *
         *      resource_length, resource, value
         *
         *      convert the resource_length to a long, skip over it, put a
         *      zero byte at the end of the resource, and pick off the
         *      resource and value fields.
         */
        if (data) {
            char *data_end = data + nitems;
            char *data_value;
            unsigned long resource_len;

            resource_len = strtoul(data, &data_ptr, 10);

            if (data_ptr != (char *) data) {
                data_ptr++;
                data_value = data_ptr + resource_len;
            }
            else                /* strtoul failed to convert a number */
                data_ptr = data_value = NULL;

            if (data_value > data_ptr && data_value < data_end) {
                char *resource;
                char *value;

                *data_value++ = '\0';

                resource = XtNewString(data_ptr);
                value = XtNewString(data_value);
#ifdef DEBUG
                fprintf(stderr, "resource_len=%lu\n", resource_len);
                fprintf(stderr, "resource = %s\t value = %s\n",
                        resource, value);
#endif
                /*
                 * descend the application widget tree and
                 * apply the value to the appropriate widgets
                 */
                _search_widget_tree(w, resource, value);

                XtFree(resource);
                XtFree(value);
            }
        }
    }

    XFree((char *) data);
}