Received: by ATHENA-PO-2.MIT.EDU (5.45/4.7) id AA17219; Fri, 13 Oct 89 15:57:39 EDT
Received: from [18.72.0.113] by ATHENA.MIT.EDU with SMTP
	id AA13746; Fri, 13 Oct 89 15:56:26 EDT
Received: by ELRIC.MIT.EDU (5.61/4.7) id AA16402; Fri, 13 Oct 89 15:56:17 -0400
Message-Id: <8910131956.AA16402@ELRIC.MIT.EDU>
To: motif@ATHENA.MIT.EDU
From: Chris VanHaren <vanharen@MIT.EDU>
Subject: new version of MotifUtilities library available.
Date: Fri, 13 Oct 89 15:56:11 EDT
Sender: vanharen@ATHENA.MIT.EDU

There is yet another installment of the MotifUtilities library now
avaialable.  This "release" incorporates 4 new functions.  They are
described below.  These descriptions are taken from the "document" file
in the source directory.
	(attach motifdev; more /mit/motifdev/projects/util/document)

I hope you find them useful.  The first 3 should help standardize things
a bit across our applications, and the last is one I threw in because I
found myself doing it a lot, and thought others might want to use the
function too.  If we ever build a better Help browser, that function may
disappear...

As always, bug reports, flames, comments, suggestions to me
(vanharen@mit.edu), please.
						-Chris.

 *****************************************************************************

	void MuSetAppPath(path)
		char *path;
/*
 * Takes a path and sets the application defaults directory variable
 * XAPPLRESDIR to that path.  Assumes that the path passed in is
 * terminated by a /.
 */

This should be called before XtInitialize().

e.g.:
	MuSetAppPath("/some/path/name/");
	toplevel = XtInitialize("toplevel", "Appname", NULL, 0, &argc, argv);

 *****************************************************************************

	void MuSetUidPath(path)
		char *path;
/*
 * Takes a path and adds path/%N.uid to UIDPATH if it already exists,
 * or creates a new UIDPATH with that in it if it doesn't.  Assumes
 * that the path passed in is terminated by a /.
 */

This should be called before MrmOpenHierarchy().  The name-list passed
to MrmOpenHierarchy should NOT contain the ".uid" extension.

e.g.:
	MuSetPath("/some/path/name/");
	MrmOpenHierarchy((MrmCount) 1, "myapplication", NULL, &Hierarchy);

 *****************************************************************************

	int MuSetIconPixmap(w, path, file)
		Widget w;
		char *path;
		char *file;
/*
 * Takes a widget (the top-level widget of the application), a path
 * and a bitmap filename and installs the file as the icon pixmap for
 * the program.  Assumes that the path passed in is terminated by a /.
 * Returns MrmSUCCESS if it succeeds, MrmFAILURE otherwise.
 */

 *****************************************************************************

	void MuHelpFile(filename)
		char *filename;
/*
 *  This function takes a filename as its argument, stats the file to find
 *  it's length, malloc's enough space to hold the text, reads it in,
 *  then calls MuHelp with that string.
 */

 ************************ END ** END ** END ** END ***********************