XrmMergeDatabases

XrmMergeDatabases(3X11)		XLIB FUNCTIONS	      XrmMergeDatabases(3X11)



NAME
       XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge
       resource databases

SYNTAX
       void XrmMergeDatabases(XrmDatabase source_db, *target_db);

       void XrmCombineDatabase(XrmDatabase source_db, XrmDatabase *tar-
	      get_db);

       Status XrmCombineFileDatabase(char *filename, XrmDatabase *target_db,
	      Bool override);

ARGUMENTS
       source_db Specifies the resource database that is to be merged into
		 the target database.

       target_db Specifies the resource database into which the source
		 database is to be merged.

       filename	 Specifies the resource database file name.

       override	 Specifies whether source entries override target ones.

DESCRIPTION
       Calling the XrmMergeDatabases function is equivalent to calling the
       XrmCombineDatabase function with an override argument of True.

       The XrmCombineDatabase function merges the contents of one database
       into another.  If the same specifier is used for an entry in both
       databases, the entry in the source_db will replace the entry in the
       target_db if override is True; otherwise, the entry in source_db is
       discarded.  If target_db contains NULL, XrmCombineDatabase simply
       stores source_db in it.	Otherwise, source_db is destroyed by the
       merge, but the database pointed to by target_db is not destroyed.  The
       database entries are merged without changing values or types, regard-
       less of the locales of the databases.  The locale of the target
       database is not modified.

       The XrmCombineFileDatabase function merges the contents of a resource
       file into a database.  If the same specifier is used for an entry in
       both the file and the database, the entry in the file will replace the
       entry in the database if override is True; otherwise, the entry in the
       file is discarded.  The file is parsed in the current locale.  If the
       file cannot be read, a zero status is returned; otherwise, a nonzero
       status is returned.  If target_db contains NULL, XrmCombineFile-
       Database creates and returns a new database to it.  Otherwise, the
       database pointed to by target_db is not destroyed by the merge.	The
       database entries are merged without changing values or types, regard-
       less of the locale of the database.  The locale of the target database
       is not modified.

SEE ALSO
       XrmGetResource(3X11), XrmInitialize(3X11), XrmPutResource(3X11)
       Xlib - C Language X Interface



						      XrmMergeDatabases(3X11)