[ADD/WIP] Timeouts in stanza awaiting

Querying for a MUC will not take longer than 10 seconds, now.

src/include/Parsee.h

@@ -115,8 +115,13 @@ extern void ParseeRequest(HttpServerContext *, void *);
 /* A pthread callback used for listening to a component */
 extern void * ParseeXMPPThread(void *data);
 
-/* Wait for a specific stanza with an ID */
-extern XMLElement * ParseeAwaitStanza(char *identifier);
+/** Wait for any stanza with an "id" attribute of {identifier}, 
+ * with an optional timeout in milliseconds of {ts} if it is positive.
+ * --------
+ * UB-If: called in the XMPP dispatcher thread itself
+ * Returns: NULL | XMLElement[LA:HEAP]
+ * Modifies: NONE */
+extern XMLElement * ParseeAwaitStanza(char *identifier, int64_t ts);
 
 /* Finds the room a DM is associated to, from a Matrix user and a Jabber 
  * ID. */

src/include/XMPP.h

@@ -46,12 +46,18 @@ typedef struct MUCInfo {
     XMLElement *iq_reply;
 } MUCInfo;
 
-/* Queries a MUC's existence, and if $[out] is set, stores information 
- * pertaining the MUC itself from an <iq> query, to be freed by 
- * XMPPFreeMUCInfo */
+/** Queries a MUC's existence, and if {out} is set, stores information 
+ * pertaining the MUC itself from an IQ query.
+ * ----------------------------------------------------------------------
+ * Modifies: *out[TBFB:XMPPFreeMUCInfo]
+ * See-Also: XMPPGetMUCName, XMPPFreeMUCInfo */
 extern bool XMPPQueryMUC(XMPPComponent *jabber, char *muc, MUCInfo *out);
 
-/* Retrieves the MUC's name from an IQ reply */
+/** Retrieves the MUC's name from an IQ reply
+ * ----------------------------------------------------------------------
+ * Returns: The MUC's name[LA:HEAP] | NULL
+ * Modifies: NOTHING
+ * See-Also: XMPPQueryMUC, XMPPFreeMUCInfo */
 extern char * XMPPGetMUCName(MUCInfo info);
 
 extern void XMPPFreeMUCInfo(MUCInfo info);