comparison libpurple/xmlnode.h @ 29681:4548c114e953

propagate from branch 'im.pidgin.pidgin' (head 371b6104658ad98c418ac711643192c2e34428ea) to branch 'im.pidgin.cpw.attention_ui' (head 2b6154716621ea07b8e3ea452bace17539e83494)

29680:ce876e58cf6a

/**
 * Creates a node from a XML File.  Calling this on the
 * root node of an XML document will parse the entire document
 * into a tree of nodes, and return the xmlnode of the root.
 *
 * @param str  The string of xml.
 * @param description  The description of the file being parsed
 * @process  The utility that is calling xmlnode_from_file
 *
 * @return The new node.
 *
 * @since 2.6.0
 */
xmlnode *xmlnode_from_file(const char *dir, const char *filename,
			   const char *description, const char *process);

29681:4548c114e953

/**
 * Creates a node from a XML File.  Calling this on the
 * root node of an XML document will parse the entire document
 * into a tree of nodes, and return the xmlnode of the root.
 *
 * @param dir  The directory where the file is located
 * @param filename  The filename
 * @param description  A description of the file being parsed. Displayed to
 * 			the user if the file cannot be read.
 * @param process  The subsystem that is calling xmlnode_from_file. Used as
 * 			the category for debugging.
 *
 * @return The new node or NULL if an error occurred.
 *
 * @since 2.6.0
 */
xmlnode *xmlnode_from_file(const char *dir, const char *filename,
			   const char *description, const char *process);